Barion-Pixel-API-referencia

Barion Pixel API referencia

Hozzájárulás (grantConsent, rejectConsent)

• Látogató szándéka: A látogató megadja vagy visszavonja/módosítja a cookie hozzájárulását a Barion Pixelre vonatkozóan.
• Hol kell implementálni: A weboldal saját hozzájárulás-kezelőjében.
• Miért van erre szükség: A weboldal látogatói adatainak a felhasználása a GDPR-nak megfelelően hozzájárulásukhoz kötött.

A hozzájárulási események határozzák meg, hogy melyik elküldött adatot használhatjuk fel marketing célokra. Kétfajta esemény definiált a felhasználó hozzájárulásának az ellenőrzésére. A "grantConsent" eseményt akkor kell küldeni, amikor a látogató elfogadja a cookie szabályzatban foglaltakat és egyértelmű kifejezését teszi, hogy a Barion használhatja az adatait marketing célokra. Ennek az események a küldését a weboldal hozzájárulás-kezelője vezérel ("Elfogadom", "OK", "Egyetértek", stb. gombok), annak helyes implementációja kizárólag a weboldal felelőssége. A "rejectConsent" eseményt akkor kell küldeni, amikor a látogató elutasítja a cookie-ra vonatkozó azon részt, amely a Barion Pixel marketing célú felhasználását is tartalmazza. Megjegyzendő, hogy a Barion marketing hozzájárulásának elutasítása nem jelenti azt, hogy nem lesz az adat továbbítva is a Barion felé (kivéve consent események), mivel a Barion jogos érdeke szerint ezen adatok felhasználásra kerülnek csalások megelőzés céljából. Az elutasítással viszont az adat abból a munkamenetből marketing célra egyáltalán nem lesz felhasználva annak ellenére, hogy továbbítva lett a Barion felé. Minden hozzájárulási eseményt a Pixel 'consent' függvényének meghívásával küldjünk el, lásd a példákat lent. A Barion kifejezetten ajánlja a szabályozásnak megfelelő hozzájárulás-kezelő használatát. Az ajánlásunkról részletesen itt tájékozódhatsz.

Példák a consent események implementációira

   
        bp('consent', 'grantConsent');
        bp('consent', 'rejectConsent');
    

Ügyféladatok titkosítása (setEncryptedEmail, setEncryptedPhone)

• Kiváltó esemény: Klikkelés vagy oldal betöltődés. Folyamatosan elérhető vagy egyszeri alkalommal megadott ügyfél azonosító, amennyiben az email vagy telefonszám.
• Látogató szándéka: A látogató bármilyen okból megadja az email címét (telefonszámát). Ez lehet regisztráció, belépés/belépett állapot, vásárláshoz megadott adat, hírlevél feliratkozás stb.
• Miért van erre szükség: A third-party cookie-k kivezetése után is, a GDPR-nak megfelelő módon azonosítani tudjuk a visszatérő látogatókat a pontos adatgyűjtés érdekében.

Nem titkosított érzékeny ügyféladatot nem gyűjtünk. Minden adatot SHA-1 titkosítással tárolunk, amely nem visszafejthető, így a valódi email cím/telefonszám nem kerül elmentésre. A tikosítás a Barion oldalán is megtörténik, azonban az adat SHA-1 titkosítást követően is beküldhető, azt automatikusan felismerjük. Minden egyéb esetben hibaüzenetet küldünk. Az emailt kisbetűkkel kérjük elküldeni, a telefonszámot pedig úgy ahogyan az ügyfél begépelte.

Példák a setEncryptedEmail / setEncryptedPhone események implementációira

   
        bp('identity','setEncryptedEmail', '[email protected]');
        bp('identity','setEncryptedPhone', '+36301234567');
    

VAGY

   
        var hashedEmailAddress = sha1('[email protected]');
        bp('identity','setEncryptedEmail', hashedEmailAddress);

        var hashedPhone = sha1('+36301234567');
        bp('identity','setEncryptedPhone', hashedPhone);

    

Tartalom megtekintése (contentView)

• Kiváltó esemény: Minimum a termék oldalak oldalbetöltődései, preferáltan minden oldal oldalbetöltődése.
• Látogató szándéka: Egy oldal megtekintése, ahol megtekint egy terméket, elolvas egy cikket valamilyen témában vagy valamilyen információt szerez a megtekintett oldalról.
• Miért van erre szükség: A termékleírások segítenek többet megtudni a termékekről, illetve a látogatói viselkedés trendekről.

Ezt az eseményt akkor kell küldeni, amikor a látogató megtekint egy oldalt, amely vagy egy megvásárolható terméket ír le vagy olyan oldalon jár, ahol információt szerez be valamiről (pl.: hírek, leírások, cikkek, blogbejegyzések stb.). Amennyiben nem termékoldalról van szó a name kulcsba az oldal címe általában megfelelően leírja az adott oldal tartalmát.

contentView esemény kulcsai

kulcs	kötelező	típus	leírás
contentType	IGEN	text	Amennyiben ez termék oldal -mint minimum követelmény- ott ez az érték legyen "Product". Egyébként meg válassz a lehetséges értékek közül, amelyik a leginkább illeszkedik hozzá: Page/Product/Article/Promotion/Banner/Misc.
currency	IGEN (contentType="Product" esetén)	szöveg (ISO 4217)	A deviza amiben a termék ára megjelent, preferáltan a három betűs ISO 4217 formátumban (pl. HUF, EUR).
id	IGEN	text	Egy egyedi azonosító a termékre, promócióra, oldalra vonatkozóan úgy, mint a SKU, promóció ID vagy az oldal ID-ja.
name	IGEN	text	Termékoldal esetén a termék teljes neve (pl.: Red Bull 24 db-os karton), egyéb helyeken pl. az oldal címe. Vedd figyelembe, hogy a terméknév az valamennyi event esetén konzisztensen ugyanaz kell, hogy legyen!
quantity	IGEN (contentType="Product" esetén)	float	A termék mennyisége, ahogyan alapértelmezetten betöltődik az oldal.
unit	IGEN (contentType="Product" esetén)	text	A termék mennyiségének mértékegysége (pl.: darab, kg, ml).
unitPrice	IGEN (contentType="Product" esetén)	float	A termék egy mennyiségének az ára.
brand	NEM	text	A termék márkája.
category	NEM	text	A termék többszintű kategorizálása (preferáltan pl. 'téli|ruhák|cipők', elválasztva '|'-al) vagy egyszíntű kategóriája (pl. 'téli cipők' or 'nyári cipők').
contents	NEM	array	Egy JS objektumok tömbje, amelyben egyesével részletezzük az egyes termékeket. További részleteket lásd alább.
creative	NEM	text	A neve vagy a leírása a promóciónak úgy, mint a promóció képének fájlneve vagy a szlogenje.
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
ean	NEM	text	A termék cikkszáma amennyiben az elérhető.
imageUrl	NEM	text	A megtekintett objektum (pl. termék) képének URL-je.
list	NEM	text	A betöltött oldal funkciója szerinti besorolása a lehetséges értékkészletből: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc.
positioning	NEM	text	A termék pozíciója (pl.: 2) egy listában vagy egy termékcsoportban, vagy a promóció pozíciója az oldalon (pl.: banner_helye_1).
step	NEM	integer	Ha az oldal a fizetési folyamat során jelenik meg akkor a folyamat lépésének a sorszáma ez. 1-el kezdődik a folyamat indítása (lásd initiateCheckout esemény).
variant	NEM	text	A termék variánsainak lehetséges értékei (pl. egy mobiltelefon színe vagy egy koncert esemény helyszíne és ideje).

(*Lehetőség van hozzáadni egyedi kulcsokat)

Content view esemény bekötésére példák:

Fizikai termékekre // Termékoldalra

       var contentViewProperties = {
           'contentType': 'Product',
           'currency': 'HUF',
           'id': 'item_42',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'quantity': 10.0,
           'unit': 'pcs.',
           'unitPrice': 4990.0,
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
           'list': 'ProductPage',
           'variant': 'hardcover'
       }

       // Főoldali termék promócióra
       var contentViewProperties = {
           'contentType': 'Promotion',
           'currency': 'HUF',
           'id': 'item_42',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'quantity': 10.0,
           'unit': 'pcs.',
           'unitPrice': 4990.0,
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'creative': 'book_promo_02',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
           'list': 'HomePage',
           'positioning': '2',
           'variant': 'hardcover'
       }

       // Fizetési folyamatban promótált termékre
       var contentViewProperties = {
           'contentType': 'Promotion',
           'currency': 'HUF',
           'id': 'item_42',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'quantity': 10.0,
           'unit': 'pcs.',
           'unitPrice': 4990.0,
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'creative': 'also_bought_05',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
           'list': 'Checkout',
           'positioning': '5',
           'step': 2,
           'variant': 'hardcover'
       }

       bp('track', 'contentView', contentViewProperties);

Jegyárusító helyeknek // Termékoldalra

       var contentViewProperties = {
           'contentType': 'Product',
           'currency': 'GBP',
           'id': 'metalica_12',
           'name': 'Metallica',
           'quantity': 1.0,
           'unit': 'pcs.',
           'unitPrice': 300.0,
           'category': 'Pop|Metal',
           'customerValue': 150.0,
           'imageUrl': "https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg",
           'list': 'ProductPage',
           'variant': '2019.06.08 20:00|Slane Castle'
       }

       // Főoldali termék promócióra
       var contentViewProperties = {
           'contentType': 'Promotion',
           'currency': 'GBP',
           'id': 'metalica_12',
           'name': 'Metallica',
           'quantity': 1.0,
           'unit': 'pcs.',
           'unitPrice': 300.0,
           'category': 'Pop|Metal',
           'creative': 'metallica_promo_02',
           'customerValue': 150.0,
           'imageUrl': "https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg",
           'list': 'HomePage',
           'positioning': '2',
           'variant': '2019.06.08 20:00|Slane Castle'
       }

       // Fizetési folyamatban promótált termékre
       var contentViewProperties = {
           'contentType': 'Promotion',
           'currency': 'GBP',
           'id': 'metalica_12',
           'name': 'Metallica',
           'quantity': 1.0,
           'unit': 'pcs.',
           'unitPrice': 300.0,
           'category': 'Pop|Metal',
           'creative': 'also_bought_05',
           'customerValue': 150.0,
           'imageUrl': "https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg",
           'list': 'Checkout',
           'positioning': '5',
           'step': 2,
           'variant': '2019.06.08 20:00|Slane Castle'
       }

       bp('track', 'contentView', contentViewProperties);

Kosárba helyezés (addToCart)

• Kiváltó esemény: Kattintás ami azt eredményezi, hogy a termék valóban kosárba kerül.
• Látogató szándéka: Kiválasztja a terméket vásárlás céljából.
• Miért van erre szükség: A látogató ezzel a szándékával erős affinitást jelez a termék megvásárlására.

A kosárba helyezés esemény, ahogy a neve is sugallja, ahhoz a szándékhoz kapcsolódik, amikor a látogató egy terméket felvesz a kosarába. Általában ez azt is jelenti, hogy úgy dönt megvásárolja azt a terméket vagy szolgáltatást, és ebből a célból adta hozzá a termékét a kosarához. Még ha a webhelyed a szó legszorosabb értelmében nem is használja a kosárba helyezés funkciót mert mondjuk nincsen kosár, akkor is van egy pont a látogató munkamenetében, ahol úgy dönt, hogy tervezi megvásárolni az általa kiválasztott terméket. Ezt a szándékot hivatott ez az esemény itt elküldeni nekünk, tehát arra a gomb(ok)ra kattintva kell ezt az eseményt elküldeni, ami a legjobban leírja ezt a szándékot. Például a „Vásárlás”, "Kosárba" vagy a „Lefoglal” felirattal ellátott gombok.

addTocart esemény kulcsai

kulcs	kötelező	típus	leírás
contentType	IGEN	text	Általában ez az érték ennél az eseménynél "Product".
currency	IGEN	text (ISO 4217)	Ebben a devizában van a termék ára feltüntetve, preferáltan a 3 betűs ISO 4217 formátumban (pl.: HUF, EUR).
id	IGEN	text	Egyedi azonosítója a terméknek a webshopban (pl. SKU).
name	IGEN	text	A teljes neve a terméknek, amit a kosárhoz adsz (pl. 24 db-os Red Bull karton).
quantity	IGEN	float	A kosárhoz adott termék mennyisége.
totalItemPrice	IGEN	float	A teljes ára a kosárba tett terméknek az adott devizában.
unit	IGEN	text	A termékek mértékegysége (pl. darab, kg, óra).
unitPrice	IGEN	float	Egy egységnyi termék ára a megadott devizában.
brand	NEM	text	A termék márkája.
category	NEM	text	A terméknek többszintű kategorizálása (preferáltan pl. 'téli|ruhák|cipők', elválasztva '|'-al) vagy egyszíntű kategóriája (pl. 'téli cipők' or 'nyári cipők').
contents	NEM	array	Egy JS objektumok tömbje, amiben termékenként definiáljuk a kulcsokat. További részleteket lásd a speciális kulcsoknál.
coupon	NEM	text	A kuponkód, amit felhasználtunk amikor a kosárba tettük a terméket.
creative	NEM	text	A neve vagy a címe adott termék(ek)et hirdető promóciónak. Például a promóció kép fájlneve vagy a szlogenje, ami a terméket automatikusan kosárba teszi.
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
ean	NEM	text	A termék cikkszáma amennyiben az elérhető.
list	NEM	text	A betöltött oldal funkciója szerinti besorolása a lehetséges értékkészletből: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc.
positioning	NEM	text	A termék pozíciója egy termék listában. (pl. 2).
step	NEM	integer	Ha az oldal a fizetési folyamat során jelenik meg akkor a folyamat lépésének a sorszáma ez. 1-el kezdődik a folyamat indítása (initiateCheckout).
variant	NEM	text	A termék variánsainak lehetséges értékei (pl. egy mobiltelefon színe vagy egy koncert esemény helyszíne és ideje).

(*Lehetőség van hozzáadni egyedi kulcsokat)

Kosárba helyezés implementációra példa:

Fizikai termékre // példa egyszerű termékre

       var addToCartProperties = {
           'contentType': 'Product',
           'currency': 'HUF',
           'id': 'item_42',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'quantity': 10.0,
           'totalItemPrice': 49900.0,
           'unit': 'pcs.',
           'unitPrice': 4990.0,
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'coupon': '43763436874',
           'creative': 'product_page_promo_42',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'list': 'ProductPage',
           'positioning': '3',
           'variant': 'hardcover'
       }

       // Több termékre
       var addToCartProperties = {
           'contentType': 'Product',
           'currency': 'HUF',
           'id': 'item_42pack',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'quantity': 10.0,
           'totalItemPrice': 150000.0,
           'unit': 'pcs.',
           'unitPrice': 15000.0,
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'contents': [{
               'contentType': 'Product',
               'currency': 'HUF',
               'id': 'item_42',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 7500.0,
               'unit': 'pcs',
               'unitPrice': 2500.0,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               },
               {
               'contentType': 'Product',
               'currency': 'USD',
               'id': 'item_42en',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 25935,
               'unit': 'pcs',
               'unitPrice': 8645,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               }],
           'coupon': '43763436874',
           'creative': 'add_to_cart_promo_42',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'list': 'BasketPage',
           'positioning': '3',
           'variant': 'hardcover'
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('addtocart_button').addEventListener('click', function() {
           bp('track', 'addToCart', addToCartProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#addtocart_button").click(function() {
           bp('track', 'addToCart', addToCartProperties);
       });

Jegyértékesítésre // Egy termékre

       var addToCartProperties = {
           'contentType': 'Product',
           'currency': 'GBP',
           'id': 'metalica_12',
           'name': 'Metallica',
           'quantity': 2.0,
           'totalItemPrice': 600.0,
           'unit': 'pcs.',
           'unitPrice': 300.0,
           'category': 'Pop|Metal',
           'coupon': '43763436874',
           'creative': 'product_page_promo_metallica',
           'customerValue': 150.0,
           'list': 'ProductPage',
           'positioning': '3',
           'variant': '2019.06.08 20:00|Slane Castle'
       }

       // Több termékre
       var addToCartProperties = {
           'contentType': 'Product',
           'currency': 'GBP',
           'id': 'spring_festival_two_tickets',
           'name': "Spring Festival ticket",
           'quantity': 2.0,
           'totalItemPrice': 1800.0,
           'unit': 'pcs.',
           'unitPrice': 900.0,
           'category': 'Festival',
           'contents': [{
               'contentType': 'Product',
               'currency': 'GBP',
               'id': 'metalica_12',
               'name': 'Metallica',
               'quantity': 2.0,
               'totalItemPrice': 800.0,
               'unit': 'pcs',
               'unitPrice': 400.0,
               'category': 'Pop|Metal',
               'leírás': 'Early Bird',
               'imageUrl': "https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg",
               'variant': '2019.06.08 20:00|Slane Castle'
               },
               {
               'contentType': 'Product',
               'currency': 'GBP',
               'id': 'snoop_dog_2019',
               'name': "Snoop Dog",
               'quantity': 2.0,
               'totalItemPrice': 1000.0,
               'unit': 'pcs',
               'unitPrice': 500,
               'category': 'Rap',
               'leírás': 'Early Bird',
               'imageUrl': 'https://cdn1.thr.com/sites/default/files/2012/08/snoop-dogg-pr-08-p.jpg',
               'variant': '2019.06.08 20:00|Slane Castle'
               }],
           'coupon': '43763436874',
           'creative': 'add_to_cart_promo_42',
           'customerValue': 150.0,
           'list': 'BasketPage',
           'positioning': '3',
           'variant': '2019.06.08 20:00|Slane Castle'
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('addtocart_button').addEventListener('click', function() {
           bp('track', 'addToCart', addToCartProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#addtocart_button").click(function() {
           bp('track', 'addToCart', addToCartProperties);
       });

Vásárlási folyamat indítása (initiateCheckout)

• Kiváltó esemény: Klikkelés, amely kiváltja a fizetési folyamat indítását.
• Látogató szándéka: A kosárban lévő termékek megvásárlása.
• Miért van erre szükség: A látogatók fogékonyak, erős szándékot mutatnak a fizetési folyamatban érintett termékek iránt.

Általában egy webáruházban van egy fizetési folyamat, amely egy gomb kattintásával kezdődik, abból a célból, hogy a kosárban található termékeket megvásárolja. Ennek a gombnak a kattintása az amelyet ehhez az eseményhez kötni kell. Ezután a kattintás után kell általában a vásárlónak megadnia más adatokat, mint például a szállítási címet, fizetési módot, illetve a vásárlás véglegesítését is ezt követően kell megerősítenie.

initiateCheckout esemény kulcsai

kulcs	kötelező	típus	leírás
contents	IGEN	array	JS objektumok tömbje, melyben az egyes termékek kulcsait írjuk le. A szállítási költség és a kupon nem tartozik ebbe bele. További részletek a speciális kulcsoknál.
currency	IGEN	text (ISO 4217)	Ebben a devizában van a termék ára feltüntetve, preferáltan a 3 betűs ISO 4217 formátumban (pl.: HUF, EUR).
revenue	IGEN	float	A teljes fizetendő ár a tranzakció devizájában feltüntetve. Ez az összeg még nem tartalmaz minden, a vásárlási folyamat során felmerülő költséget, kedvezményt. Ide értve a szállítást, kupont vagy egyéb vásárlói kedvezményt.
step	IGEN	integer	Definíció szerint a legtöbb esetben ez az első lépése a fizetési folyamatnak, így ez 1.
contentType	NEM	text	Ez az érték "Product".
coupon	NEM	text	A kupon amit felhasználtak a vásárláshoz.
creative	NEM	text	A neve vagy a címe a promóciónak, pl. a promóció kép fájlneve vagy a szlogenje, ami a fizetési folyamatot indítja el.
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
list	NEM	text	Definíció szerint ennek 'Checkout'-nak kell lennie.
opt	NEM	text	További információ a vásárlásról.
orderNumber	NEM	text	A vásárlás egyedi azonosítója.
positioning	NEM	text	A termék pozíciója egy listában vagy egy termékcsoportban, ha az értelmezhető ott (pl. 2), illetve promóció esetén a promóció pozíciója az oldalon ha az értelmezhető (pl. banner_slot_1).
shipping	NEM	float	A szállítás költsége a fizetett összeg devizájában.
shippingAddress	NEM	object	Szállítási cím a shippingAdress kulcs definíció szerint megadva, lásd a részleteket a speciális kulcsoknál.
tax	NEM	float	A kifizetett összeg adóra vonatkozó része a vásárlás devizájában megadva.

(*Lehetőség van hozzáadni egyedi kulcsokat)

Vásárlás elindítására vonatkozó eseményre példák:

Fizikai termékekre // Egy termékre

       var initiateCheckoutProperties = {
           'contents': [{
               'contentType': 'Product',
               'currency': 'HUF',
               'id': 'item_42',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 7500.0,
               'unit': 'pcs',
               'unitPrice': 2500.0,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               },
               {
               'contentType': 'Product',
               'currency': 'USD',
               'id': 'item_42en',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 25935,
               'unit': 'pcs',
               'unitPrice': 8645,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               }],
           'currency': 'HUF',
           'revenue': 17500.0,
           'step': 0,
           'contentType': 'Product',
           'coupon': '43763436874',
           'creative': 'preselected_cart_01',
           'customerValue': 150.0,
           'list': 'Checkout',
           'opt': 'To postal office, no street address',
           'orderNumber': '852',
           'positioning': '1',
           'shipping': 2500.0,
           'shippingAddress': {
               'city': 'Budapest',
               'country': 'HU',
               'deliveryMethod': 'DHL',
               'fullName': 'John Doe',
               'phone': '+36 1 1111 111',
               'region': 'HU-BU',
               'street': 'Műegyetem rkpt. 3.',
               'street2': '2. porta',
               'zipCode': '1111'
           },
           'tax': 0.0
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('checkout_button').addEventListener('click', function() {
           bp('track', 'initiateCheckout', initiateCheckoutProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#checkout_button").click(function() {
           bp('track', 'initiateCheckout', initiateCheckoutProperties);
       });

For ticket sellers // Több termékre

       var initiateCheckoutProperties = {
           'contents': [{
               'contentType': 'Product',
               'currency': 'GBP',
               'id': 'metalica_12',
               'name': 'Metallica',
               'quantity': 2.0,
               'totalItemPrice': 600.0,
               'unit': 'pcs',
               'unitPrice': 300.0,
               'category': 'Pop|Metal',
               'leírás': 'Early Bird',
               'ean': '9780575115347',
               'imageUrl': 'https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg',
               'variant': '2019.06.08 20:00|Slane Castle'
               },
               {
               'contentType': 'Product',
               'currency': 'GBP',
               'id': 'snoop_dog_2019',
               'name': "Snoop Dog",
               'quantity': 3.0,
               'totalItemPrice': 1500.0,
               'unit': 'pcs',
               'unitPrice': 500,
               'category': 'Rap',
               'leírás': 'Early Bird',
               'ean': '9780575115347',
               'imageUrl': 'https://cdn1.thr.com/sites/default/files/2012/08/snoop-dogg-pr-08-p.jpg',
               'variant': '2019.04.02 23:00|Wembley'
               }],
           'currency': 'GBP',
           'revenue': 2100.0,
           'step': 0,
           'contentType': 'Product',
           'coupon': '43763436874',
           'creative': 'preselected_cart_01',
           'customerValue': 150.0,
           'list': 'Checkout',
           'opt': 'To postal office, no street address',
           'orderNumber': '852',
           'positioning': '1',
           'shipping': 2500.0,
           'shippingAddress': {
               'city': 'Budapest',
               'country': 'HU',
               'deliveryMethod': 'DHL',
               'fullName': 'John Doe',
               'phone': '+36 1 1111 111',
               'region': 'HU-BU',
               'street': 'Műegyetem rkpt. 3.',
               'street2': '2. porta',
               'zipCode': '1111'
           },
           'tax': 0.0
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('checkout_button').addEventListener('click', function() {
           bp('track', 'initiateCheckout', initiateCheckoutProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#checkout_button").click(function() {
           bp('track', 'initiateCheckout', initiateCheckoutProperties);
       });

Fizetés elindítása esemény (initiatePurchase)

• Kiváltó esemény: Klikkelés amely befejezi a fizetési folyamatot egy fizetéssel.
• Látogató szándéka: A kosárban levő terméket kifizeti.
• Miért van erre szükség: A látogatók fogékonyak, erős szándékot mutatnak a fizetési folyamatban érintett termékek iránt.

Ezt az eseményt abban az időpillanatban kell küldeni, amikor a felhasználót átirányítják például egy fizetési megoldás saját webhelyére (pl. Barion Smart Gateway). Abban az esetben is el kell küldeni ezt az eseményt, ha a felhasználó nem online fizetést választott, például átvételkor történő készpénzes fizetéssel egyenlíti majd ki a tételt, de a tranzakció ebben az esetben is teljesítettnek tekintendő. A fizetési folyamat utolsó előtti lépésének felel meg ez a klikkelés, ezt követően ideális esetben a fizetés lebonyolítása, majd végül a köszönő oldal betöltődése következik, vagy egyes esetekben rögtön a köszönő oldalra jut a vásárló (pl. készpénzes fizetés).

initiatePurchase esemény kulcsai

kulcs	kötelező	típus	leírás
contents	IGEN	array	JS objektumok tömbje, melyben az egyes termékek kulcsait írjuk le. A szállítási költség és a kupon nem tartozik ebbe bele. További részletek a speciális kulcsoknál.
currency	IGEN	text (ISO 4217)	Ebben a devizában van a termék ára feltüntetve, preferáltan a 3 betűs ISO 4217 formátumban (pl.: HUF, EUR).
revenue	IGEN	float	A teljes fizetendő ár a tranzakció devizájában feltüntetve. Ez az összeg valamennyi felmerülő költséget tartalmazza, amit a vásárló fizet, beleértve a szállítást, adót és egyéb kupont vagy vásárlói kedvezményt is.
step	IGEN	integer	A fizetési folyamat lépésének a sorszáma.
contentType	NEM	text	Általában ez az érték "Product".
coupon	NEM	text	A kupon amit felhasználtak.
creative	NEM	text	A neve vagy a címe a promóciónak, amennyiben ezt az eseményt egy promóció váltotta ki. A promóció képének fájlneve vagy a szlogenje, amely kiváltja ezt az eseményt.
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
list	NEM	text	Ez az érték definíció szerint 'Checkout'.
opt	NEM	text	További információ a vásárlásról.
orderNumber	NEM	text	A vásárlás egyedi azonosítója.
positioning	NEM	text	A termék pozíciója egy listában vagy egy termékcsoportban ha az értelmezhető ott (pl. 2), illetve promóció esetén a promóció pozíciója az oldalon ha az értelmezhető (pl. banner_slot_1).
shipping	NEM	float	A szállítás költsége a fizetett összeg devizájában.
shippingAddress	NEM	object	Szállítási cím a shippingAdress kulcs definíció szerint megadva, lásd a részleteket a speciális kulcsoknál.
tax	NEM	float	A kifizetett összeg adóra vonatkozó része a vásárlás devizájában megadva.

(*Lehetőség van hozzáadni egyedi kulcsokat)

Fizetés indítása esemény bekötésére példák:

Fizikai termékekre // Egy termékre

       var initiatePurchaseProperties = {
           'contents': [{
               'contentType': 'Product',
               'currency': 'HUF',
               'id': 'item_42',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 7500.0,
               'unit': 'pcs',
               'unitPrice': 2500.0,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               },
               {
               'contentType': 'Product',
               'currency': 'USD',
               'id': 'item_42en',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 25935,
               'unit': 'pcs',
               'unitPrice': 8645,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               }],
           'currency': 'HUF',
           'revenue': 17500.0,
           'step': 6,
           'contentType': 'Product',
           'coupon': '43763436874',
           'creative': 'preselected_cart_01',
           'customerValue': 150.0,
           'list': 'Checkout',
           'opt': 'To postal office, no street address',
           'orderNumber': '852',
           'positioning': '1',
           'shipping': 2500.0,
           'shippingAddress': {
               'city': 'Budapest',
               'country': 'HU',
               'deliveryMethod': 'DHL',
               'fullName': 'John Doe',
               'phone': '+36 1 1111 111',
               'region': 'HU-BU',
               'street': 'Műegyetem rkpt. 3.',
               'street2': '2. porta',
               'zipCode': '1111'
           },
           'tax': 0.0
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('confirm_payment').addEventListener('click', function() {
           bp('track', 'initiatePurchase', initiatePurchaseProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#confirm_payment").click(function() {
           bp('track', 'initiatePurchase', initiatePurchaseProperties);
       });

For ticket sellers // Több termékre

       var initiateCheckoutProperties = {
           'contents': [{
               'contentType': 'Product',
               'currency': 'GBP',
               'id': 'metalica_12',
               'name': 'Metallica',
               'quantity': 2.0,
               'totalItemPrice': 600.0,
               'unit': 'pcs',
               'unitPrice': 300.0,
               'category': 'Pop|Metal',
               'leírás': 'Early Bird',
               'ean': '9780575115347',
               'imageUrl': 'https://www.revolvermag.com/sites/default/files/styles/image_954_x_537/public/media/images/article/metallicapr.jpg',
               'variant': '2019.06.08 20:00|Slane Castle'
               },
               {
               'contentType': 'Product',
               'currency': 'GBP',
               'id': 'snoop_dog_2019',
               'name': "Snoop Dog",
               'quantity': 3.0,
               'totalItemPrice': 1500.0,
               'unit': 'pcs',
               'unitPrice': 500,
               'category': 'Rap',
               'leírás': 'Early Bird',
               'ean': '9780575115347',
               'imageUrl': 'https://cdn1.thr.com/sites/default/files/2012/08/snoop-dogg-pr-08-p.jpg',
               'variant': '2019.04.02 23:00|Wembley'
               }],
           'currency': 'GBP',
           'revenue': 2100.0,
           'step': 6,
           'contentType': 'Product',
           'coupon': '43763436874',
           'creative': 'preselected_cart_01',
           'customerValue': 150.0,
           'list': 'Checkout',
           'opt': 'To postal office, no street address',
           'orderNumber': '852',
           'positioning': '1',
           'shipping': 2500.0,
           'shippingAddress': {
               'city': 'Budapest',
               'country': 'HU',
               'deliveryMethod': 'DHL',
               'fullName': 'John Doe',
               'phone': '+36 1 1111 111',
               'region': 'HU-BU',
               'street': 'Műegyetem rkpt. 3.',
               'street2': '2. porta',
               'zipCode': '1111'
           },
           'tax': 0.0
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('confirm_payment').addEventListener('click', function() {
           bp('track', 'initiatePurchase', initiatePurchaseProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#confirm_payment").click(function() {
           bp('track', 'initiatePurchase', initiatePurchaseProperties);
       });

Látógatói információk (setUserProperties)

• Kiváltó esemény: Klikkelés amikor a látogató személyéhez köthető adatokat mentünk el.
• Látogató szándéka: Személyére vonatkozó részleteket ad meg.
• Miért van erre szükség: Az információ alapján a látogatóról relevánsabb ajánlat adható.

Ezt az eseményt minden olyan böngésző eseménykor küldjük, amikor a látogató adatokat ad meg magáról vagy módosítja azt. Minden ilyen jellegű adatot a GDPR-ral összhangban kezeljük, és mint ilyen, minden személyazonosításra alkalmas adatot közvetlenül az ügyfél oldalán a JS kódban - még mielőtt továbbítanánk a Barion felé - visszafejthetetlenül elkódoljuk. Ennek megfelelően fontos, hogy a személyazonosításra alkalmas adatokat az esemény hash-elt kulcsaiban adjuk át. Azok az oldalak, amelyekbe ez az esemény beilleszthető, többnyire regisztrációs vagy bejelentkező oldalak, hírlevél-feliratkozási űrlapok és minden olyan más oldal, ahol a felhasználó információkat szolgáltathat saját magáról. Ez az esemény a vásárlási folyamat során is elküldhető.

setUserProperties esemény a kulcsai

kulcs	kötelező	hashed	típus	leírás
userId	IGEN	IGEN	text	Az ID ami a látogatót azonosítja egyedi módon az oldaladon, pl. email cím vagy a látogató azonosító. (hashelt)
accountCreatedTime	NEM	NEM	UNIX timestamp	Másodperc pontos UNIX időbélyeg amikor a látogató azonosító regisztrálva lett.
age	NEM	NEM	text	A látogató kora.
city	NEM	NEM	text	A város, ahol a látogató él.
country	NEM	NEM	text	Az ország, ahol a látogató él, preferáltan az ISO 3166-1 alpha-2 formátumban, pl. HU vagy CZ.
region	NEM	NEM	text	A régió, ahol a látogató él, preferáltan az ISO 3166-2 formátumban, pl. HU-BU.
currency	NEM	NEM	text	A deviza amit a látogató preferál vagy az amiben az árak megjelenítve vannak számára, a 3 karakterből álló ISO 4217 formátum preferált (pl. HUF, EUR).
email	NEM	IGEN	text	A látogató email címe (hashelt).
gender	NEM	NEM	text	A látogató neme.
interests	NEM	NEM	text	A látogató érdeklődése elválasztva a '|' karakterrel, pl. "Arts|Games".
lang	NEM	NEM	text	A látogató által használt nyelv, preferáltan ISO 639-1 formátumban, pl. hu vagy cz.
phone	NEM	IGEN	text	A látogató telefonszáma, preferáltan E.164 formátumban, pl. +36 1 111 1111 (hashelt)
shippingAddress	NEM	NEM	object	A látogató címe a speciális kulcsok fejezetben részletezett módon.
step	NEM	NEM	text	Amennyiben a látogató adatokat a vásárlási folyamat során ad meg (pl. szállítási cím), akkor a step kulcs a vásárlási folyamat lépésének a sorszámát jelöli, ahol ezt az eseményt elküldjük.
zipCode	NEM	NEM	text	Irányítószám.

(*Lehetőség van hozzáadni egyedi kulcsokat)

setUserProperties esemény bekötési példái:

Általános példa // Vásárlási folyamtban megadott számlázási és szállítási címek

       var setUserPropertiesProperties= {
           'userId': 'user_42',
           'accountCreatedTime': 1557223622,
           'age': '12-24',
           'city': 'Budapest',
           'country': 'HU',
           'region': 'HU-BU',
           'currency': 'HUF',
           'email': '[email protected]',
           'gender': 'male',
           'interests': 'Arts|Crafts',
           'lang': 'hu',
           'phone': '+36 1 111 1111',
           'shippingAddress': {
               'city': 'Budapest',
               'country': 'HU',
               'deliveryMethod': 'DHL',
               'fullName': 'John Doe',
               'phone': '+36 1 1111 111',
               'region': 'HU-BU',
               'street': 'Műegyetem rkpt. 3.',
               'street2': '2. porta',
               'zipCode': '1111'
           },
           'step': 1,
           'zipCode': '1111'
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('next').addEventListener('click', function() {
           bp('track', 'setUserProperties', setUserPropertiesProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#next").click(function() {
           bp('track', 'setUserProperties', setUserPropertiesProperties);
       });

Kategória választás (categorySelection)

• Kiváltó esemény: Klikkelés egy kategórián a kategória választó oldalon.
• Látogató szándéka: Kategóriába tartozó termékek megtekintése.
• Miért van erre szükség: A látogató az adott kategóriába tartozó termékek iránti érdeklődését fejezi ki.

Ezt az eseményt akkor kell küldeni, ha a látogató egy termék vagy alkategóriák egy gyűjteményére kattint, pl. márka, egy közös tulajdonság, téma vagy azonos árkategóriába sorolt termékek.

categorySelection esemény kulcsai

kulcs	kötelező	típus	leírás
id	IGEN	text	Egyedi azonosítója a kategória csoportnak, amelyre klikkelt a látogató.
name	IGEN	text	Teljes neve a kategóriának. (pl. 'Nike cipők')
brand	NEM	text	A termékek márkája ebben a kategóriában (pl. 'Nike')
category	NEM	text	A kategória alkategóriája (pl. 'Téli Nike cipők') vagy az alkategória ága (pl. 'Ruhák|Téli|Cipők' vagy 'Ruhák|Nyári|Cipők', '|'-el elválasztva).
contents	NEM	array	JS objektumok egy tömbje, ahol a kategória elemeit részletezik, amennyiben ez értelmezhető. További részletekért lás a speciális kulcsokat.
contentType	NEM	text	Általában ez az érték "Product".
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
list	NEM	text	A kattintott kategória helyének a típusa a következő lehetséges értékek közül: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc.
positioning	NEM	text	A kategória pozíciója a listában vagy egy kategória csoportban, ha az értelmezhető ott (pl. 2).
step	NEM	integer	Ha a vásárlási folyamatban kattintott a kategória akkor a vásárlási lépés sorszáma.

(*Lehetőség van hozzáadni egyedi kulcsokat)

Kategória választó esemény bekötésére példák:

Fizikai termékekre // Egyszintű kategória

       var categorySelectionProperties = {
           'id': 'books_scifi',
           'name': 'Sci-Fi Books',
           'category': 'Books',
           'contentType': 'Page',
           'customerValue': 150.0,
           'list': 'SearchPage',
           'positioning': '42'
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('select_category').addEventListener('click', function() {
           bp('track', 'categorySelection', categorySelectionProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#select_category").click(function() {
           bp('track', 'categorySelection', categorySelectionProperties);
       });

Termék kattintás (clickProduct)

• Kiváltó esemény: Klikkelés egy terméken.
• Látogató szándéka: Egy termék megtekintése.
• Miért van erre szükség: A látogató érdeklődését fejezi ki a termék iránt a kattintásával.

Ezt az eseményt minden alkalommal el kell küldeni, amikor a látogató rákattint egy termékre lista oldalon vagy ajánló modulban esetleg keresési találati listában, majd a kattintást követően a termék oldala betöltődik. Az oldal típusa, amelyen a klikkelés megtörténik a 'list' kulcsban kerül definiálásra. Termék csomagok esetén a 'contents' kulcsot használhatjuk az egyes termékek leírására, míg a termék csomagok leírására a közvetlen kulcsokat használhatjuk.

clickProduct esemény kulcsai

kulcs	kötelező	típus	leírás
contentType	IGEN	text	Az oldal típusa, ahol a termékre kattintás történt. A lehetséges értékei (csak ezek az elfogadottak) a kulcsnak: Page/Product/Article/Promotion/Banner/Misc.
currency	IGEN	text (ISO 4217)	Deviza, amiben a termék ára megjelent, preferáltan a 3 karakter hosszú ISO 4217 formátum (pl. HUF, EUR).
id	IGEN	text	Egyedi azonosítója a terméknek.
name	IGEN	text	A teljes neve a kattintott terméknek.
quantity	IGEN	float	A mennyisége a terméknek, amit kattintottak. (pl. 1).
unit	IGEN	text	A mértékegysége a terméknek, amit kattintottak (pl. db, kg).
unitPrice	IGEN	float	A klikkelt termék egy egységnyi mértékegységének az ára.
brand	NEM	text	Klikkelt termék márkája
category	NEM	text	A kattintott termék alkategóriája (pl. 'Téli Nike cipők') vagy az alkategória ága (pl. 'Ruhák|Téli|Cipők' vagy 'Ruhák|Nyári|Cipők', '|'-el elválasztva).
contents	NEM	array	JS objektumok tömbje, amelyben több terméket részletezünk ki. Részleteket lásd a speciális kulcsok alatt.
creative	NEM	text	A neve vagy a leírása egy promóciónak, ami a termékre vonatkozik. Pl. a promóció képének fájlneve vagy szlogenje amennyiben promócióban kattintottunk.
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
ean	NEM	text	Amennyiben elérhető a termék nemzetközi cikkszáma (EAN).
list	NEM	text	Az oldal fajtája, ahol a terméket kattintottuk, válasszunk a következő lehetséges értékek közül: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc.
positioning	NEM	text	A termék pozíciója egy listában vagy egy termékcsoportban, ha az értelmezhető ott (pl. 2), illetve promóció esetén a promóció pozíciója az oldalon ha az értelmezhető (pl. banner_slot_1).
step	NEM	integer	A vásárlási folyamat lépésének a sorszáma amennyiben ott kattintották a terméket.
variant	NEM	text	A kattintott termék variánsa (pl. 'fekete|XS')

(*Lehetőség van hozzáadni egyedi kulcsokat)

Termék kattintás esemény bekötési példái:

Fizikai termékekre a vásárlási folyamatban // Egy termékre

       var clickProductProperties = {
           'contentType': 'Product',
           'currency': 'HUF',
           'id': 'item_42',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'quantity': 1.0,
           'unit': 'pcs',
           'unitPrice': 2500.0,
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'creative': 'book_42',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'list': 'Checkout',
           'positioning': '1',
           'step': 2,
           'variant': 'hardcover'
       }

       // Több termékre
       var clickProductProperties = {
           'contentType': 'Product',
           'currency': 'HUF',
           'id': 'item_42pack',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'quantity': 1.0,
           'unit': 'pcs',
           'unitPrice': 15000.0,
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'contents': [{
               'contentType': 'Product',
               'currency': 'HUF',
               'id': 'item_42',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 7500.0,
               'unit': 'pcs',
               'unitPrice': 2500.0,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               },
               {
               'contentType': 'Product',
               'currency': 'USD',
               'id': 'item_42en',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 25935,
               'unit': 'pcs',
               'unitPrice': 8645,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               }],
           'creative': 'bundle_offer_01',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'list': 'Checkout',
           'positioning': '1',
           'step': 2,
           'variant': 'hardcover'
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('book_42').addEventListener('click', function() {
           bp('track', 'clickProduct', clickProductProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#book_42").click(function() {
           bp('track', 'clickProduct', clickProductProperties);
       });

Termék részletek (clickProductDetail)

• Kiváltó esemény: Klikkelés, hogy további részleteket tudjunk meg a termékről.
• Látogató szándéka: Mélyebben megismerni az adott terméket.
• Miért van erre szükség: A látogató magasabb érdeklődését fejezi az adott termék iránt, hogy további részleteket olvas, néz meg róla.

Az eseménynek gombnyomásra kell elküldeni, amely lehet egy aloldal vagy aszinkron kérés további részletekért a termékről. Ezt valamennyi gombra rá kell kötni, amellyel további részletek jelenítünk meg a termékről.

clickProductDetail esemény kulcsai

kulcs	kötelező	típus	leírás
contentType	IGEN	text	A típusa az oldalnak, ahol ez az esemény elküldésre kerül. A következő lehetséges értékekkel tölthető csak: Page/Product/Article/Promotion/Banner/Misc.
currency	IGEN	text (ISO 4217)	Deviza, amiben a termék ára megjelent, preferáltan a 3 karakter hosszú ISO 4217 formátum (pl. HUF, EUR).
id	IGEN	text	Egyedi azonosítója a terméknek.
name	IGEN	text	A teljes neve a terméknek.
unit	IGEN	text	A mértékegysége a terméknek, amit kattintottak (pl. db, kg).
unitPrice	IGEN	float	A klikkelt termék egy egységnyi mértékegységének az ára.
brand	NEM	text	A termék márkája
category	NEM	text	A klikkelt termék alkategóriája (pl. 'Téli Nike cipők') vagy az alkategória ága (pl. 'Ruhák|Téli|Cipők' vagy 'Ruhák|Nyári|Cipők', '|'-el elválasztva).
contents	NEM	array	JS objektumok tömbje, amelyben több terméket részletezünk ki. Részleteket lásd a speciális kulcsok alatt.
creative	NEM	text	A neve vagy a leírása egy promóciónak, ami a termékre vonatkozik. Pl. a promóció képének fájlneve vagy szlogenje amennyiben promócióban kattintottuk.
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
ean	NEM	text	Amennyiben elérhető a termék nemzetközi cikkszáma (EAN).
list	NEM	text	Az oldal típusa, ahol a terméket kattintották, választhatók a következő lehetséges értékek : HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc.
positioning	NEM	text	A termék pozíciója egy listában vagy egy termékcsoportban, ha az értelmezhető ott (pl. 2), illetve promóció esetén a promóció pozíciója az oldalon, ha az értelmezhető (pl. banner_slot_1).
step	NEM	integer	A vásárlási folyamat lépésének a sorszáma amennyiben a vásárlási folyamat során klikkeltünk a termék részletekre.
quantity	NEM	float	A kattintott termék mennyisége. (pl. 1)
variant	NEM	text	A kattintott termék variánsa (pl. 'fekete|XS')

(*Lehetőség van hozzáadni egyedi kulcsokat)

Termék részletek esemény bekötésére példák:

Fizikai termékekre a fizetési folyamatban // Egy termékre

       var clickProductDetailProperties = {
           'contentType': 'Product',
           'currency': 'HUF',
           'id': 'item_42',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'unit': 'pcs',
           'unitPrice': 2500.0,
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'creative': 'book_42',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'list': 'Checkout',
           'positioning': '1',
           'step': 2,
           'quantity': 1.0,
           'variant': 'hardcover'
       }

       // Több termékre
       var clickProductDetailProperties = {
           'contentType': 'Product',
           'currency': 'HUF',
           'id': 'item_42pack',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'unit': 'pcs',
           'unitPrice': 15000.0,
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'contents': [{
               'contentType': 'Product',
               'currency': 'HUF',
               'id': 'item_42',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 7500.0,
               'unit': 'pcs',
               'unitPrice': 2500.0,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               },
               {
               'contentType': 'Product',
               'currency': 'USD',
               'id': 'item_42en',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 25935,
               'unit': 'pcs',
               'unitPrice': 8645,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               }],
           'creative': 'bundle_offer_01',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'list': 'Checkout',
           'positioning': '1',
           'step': 2,
           'quantity': 1.0,
           'variant': 'hardcover'
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('more_details').addEventListener('click', function() {
           bp('track', 'clickProductDetail', clickProductDetailProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#more_details").click(function() {
           bp('track', 'clickProductDetail', clickProductDetailProperties);
       });

Termék variáns beállítás (customizeProduct)

• Kiváltó esemény: Klikkelés amellyel specifikáljuk a terméket.
• Látogató szándéka: Kiválasztani a pontos terméket annak specifikálhatósága alapján.
• Miért van erre szükség: A látogató mélyebb érdeklődését fejezi ki azzal, hogy személyére szabja annak paramétereit.

Az eseményt gombnyomásra kell küldeni, amikor a látogató a termék tulajdonságait állítja be, hogy kosárba tehesse a számára megfelelő terméket. Ezt minden olyan gombnál implementálni kell, ahol a fentieknek megfelelően termék variánsait specifikáljuk.

Termék variáns kezelési esemény bekötésére példák:

kulcs	kötelező	típus	leírás
contentType	IGEN	text	A típusa az oldalnak, ahol ez az esemény elküldésre kerül. A következő lehetséges értékekkel tölthető csak: Page/Product/Article/Promotion/Banner/Misc.
currency	IGEN	text (ISO 4217)	Deviza, amiben a termék ára megjelent, preferáltan a 3 karakter hosszú ISO 4217 formátum (pl. HUF, EUR).
id	IGEN	text	Egyedi azonosítója a terméknek.
name	IGEN	text	A teljes neve a terméknek.
unit	IGEN	text	A mértékegysége a terméknek, amit kattintottak (pl. db, kg).
unitPrice	IGEN	float	A klikkelt termék egy egységnyi mértékegységének az ára.
variant	IGEN	text	A kattintott termék variánsa (pl. 'fekete|XS')
brand	NEM	text	A termék márkája
category	NEM	text	A termék alkategóriája (pl. 'Téli Nike cipők') vagy az alkategória ága (pl. 'Ruhák|Téli|Cipők' vagy 'Ruhák|Nyári|Cipők', '|'-el elválasztva).
contents	NEM	array	JS objektumok tömbje, amelyben több terméket részletezünk ki. Részleteket lásd a speciális kulcsok alatt.
creative	NEM	text	A neve vagy a leírása egy promóciónak, ami a termékre vonatkozik. Pl. a promóció képének fájlneve vagy szlogenje amennyiben promócióban kattintottuk.
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
ean	NEM	text	Amennyiben elérhető a termék nemzetközi cikkszáma (EAN).
list	NEM	text	Az oldal típusa, ahol a terméket kattintották, választhatók a következő lehetséges értékek: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc.
positioning	NEM	text	A termék pozíciója a listában vagy egy termékcsoportban, ha az értelmezhető ott (pl. 2), illetve promóció esetén a promóció pozíciója az oldalon, ha az értelmezhető (pl. banner_slot_1).
quantity	NEM	float	A kattintott termék mennyisége. (pl. 1)
step	NEM	integer	A vásárlási folyamat lépésének a sorszáma amennyiben az esemény a vásárlási folyamat során kerül küldésre.

(*Lehetőség van hozzáadni egyedi kulcsokat)

Termék variánskezelési esemény bekötésére példák:

Fizikai termékekre in checkout process // Egy termékre

       var customizeProductProperties = {
           'contentType': 'Product',
           'currency': 'HUF',
           'id': 'item_42',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'unit': 'pcs',
           'unitPrice': 2500.0,
           'variant': 'hardcover',
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'creative': 'book_42',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'list': 'Checkout',
           'positioning': '1',
           'step': 2,
           'quantity': 1.0,
       }

       // Több termékre
       var customizeProductProperties = {
           'contentType': 'Product',
           'currency': 'HUF',
           'id': 'item_42pack',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'unit': 'pcs',
           'unitPrice': 15000.0,
           'variant': 'hardcover',
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'contents': [{
               'contentType': 'Product',
               'currency': 'HUF',
               'id': 'item_42',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 7500.0,
               'unit': 'pcs',
               'unitPrice': 2500.0,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               },
               {
               'contentType': 'Product',
               'currency': 'USD',
               'id': 'item_42en',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 25935,
               'unit': 'pcs',
               'unitPrice': 8645,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               }],
           'creative': 'bundle_offer_01',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'list': 'Checkout',
           'positioning': '1',
           'step': 2,
           'quantity': 1.0,
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('customize').addEventListener('click', function() {
           bp('track', 'customizeProduct', customizeProductProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#customize").click(function() {
           bp('track', 'customizeProduct', customizeProductProperties);
       });

Vásárlás (purchase)

• Kiváltó esemény: Oldalbetöltődés váltja ki a fizetési folyamat után. Ez a köszönő oldalnak felel meg.
• Látogató szándéka: Megerősítve legyen a vásárló a vásárlásnak sikerességéről vagy sikertelenségéről.
• Miért van erre szükség: A látogatók fogékonyak, erős szándékot mutatnak a fizetési folyamatban érintett termékek iránt. Illetve elkerüljük az irreleváns hirdetéseket.

Ezt az eseményt annak az oldalnak a betöltésekor kell küldeni, ahol a vásárlót értesítik tranzakciójuk befejezéséről, amelyet a fizetési kísérlet fejez be. Ha a vásárló fizetési módként készpénzt választ, akkor ezt az eseményt kell küldeni a „köszönő” oldal betöltésekor, ha online fizetést választanak, akkor azt a „sikeres fizetés” vagy "köszönő" oldal betöltésekor kell küldeni. Ha a fizetés nem volt sikeres, akkor is ki kell küldeni ezt az eseményt úgy, hogy a „step” kulcsot „-1” értékre kell állítani.

purchase esemény kulcsai

kulcs	kötelező	típus	leírás
contents	IGEN	array	JS objektumok tömbje, melyben az egyes termékek kulcsait írjuk le. A szállítási költség és a kupon nem tartozik ebbe bele. További részletek a speciális kulcsoknál.
currency	IGEN	text (ISO 4217)	Ebben a devizában van a vásárlás ára feltüntetve, preferáltan a 3 betűs ISO 4217 formátumban (pl.: HUF, EUR).
revenue	IGEN	float	A teljes fizetendő ár a tranzakció devizájában feltüntetve. Ez az összeg valamennyi felmerülő költséget tartalmazza, amit a vásárló fizet, beleértve a szállítást és az adót is.
step	IGEN	integer	A legtöbb esetben ez a lépés az utolsó a vásárlási folyamat során ("Köszönő" oldal), ez a maximális érték, amit a step kulcsban használunk. Amennyiben a tranzakció sikertelen fizetéssel zárult ezt a kulcsot állítsuk -1-re.
contentType	NEM	text	Ez az érték "Product".
coupon	NEM	text	A kupon, amit felhasználtak.
creative	NEM	text	A neve vagy a címe a promóciónak, amennyiben ezt az eseményt egy promóció váltotta ki. A promóció képének fájlneve vagy a szlogenje, amely kiváltja ezt az eseményt.
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
list	NEM	text	Ez az érték definíció szerint 'Checkout'.
opt	NEM	text	További információ a vásárlásról.
orderNumber	NEM	text	A vásárlás egyedi azonosítója.
positioning	NEM	text	A termék pozíciója egy listában vagy egy termékcsoportban, ha az értelmezhető ott (pl. 2), illetve promóció esetén a promóció pozíciója az oldalon ha az értelmezhető (pl. banner_slot_1).
shipping	NEM	float	A szállítás költsége a fizetett összeg devizájában.
shippingAddress	NEM	object	Szállítási cím a shippingAdress kulcs definíció szerint megadva, lásd a részleteket a speciális kulcsoknál.
tax	NEM	float	A kifizetett összeg adóra vonatkozó része a vásárlás devizájában megadva.

(*Lehetőség van hozzáadni egyedi kulcsokat)

Vásárlási esemény bekötésére példák:

Sikeres vásárlás fizikai termékekre var purchaseProperties = {

           'contents': [{
               'contentType': 'Product',
               'currency': 'HUF',
               'id': 'item_42',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 7500.0,
               'unit': 'pcs',
               'unitPrice': 2500.0,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               },
               {
               'contentType': 'Product',
               'currency': 'USD',
               'id': 'item_42en',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 25935,
               'unit': 'pcs',
               'unitPrice': 8645,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               }],
           'currency': 'HUF',
           'revenue': 17500.0,
           'step': 7,
           'contentType': 'Product',
           'coupon': '43763436874',
           'creative': 'preselected_cart_01',
           'customerValue': 150.0,
           'list': 'Checkout',
           'opt': 'To postal office, no street address',
           'orderNumber': '852',
           'positioning': '1',
           'shipping': 2500.0,
           'shippingAddress': {
               'city': 'Budapest',
               'country': 'HU',
               'deliveryMethod': 'DHL',
               'fullName': 'John Doe',
               'phone': '+36 1 1111 111',
               'region': 'HU-BU',
               'street': 'Műegyetem rkpt. 3.',
               'street2': '2. porta',
               'zipCode': '1111'
           },
           'tax': 0.0
       }

       bp('track', 'purchase', purchaseProperties);

Kosárból törlés (removeFromCart)

• Kiváltó esemény: Klikkelés amely azt eredményezi, hogy kitöröljük a kosárból az abba korábban vásárlási szándékkal helyezett termékeket.
• Látogató szándéka: Kitörölni a terméket a kosarából.
• Miért van erre szükség: A látogató a kosárba helyezett termékek iránt affinis, annak kitörlésével jelzi, hogy irreleváns már a termék számára.

A kosárból való törlés esemény nagyon hasonlít a kosárba helyezés eseményére csak a látogatónak pont fordított szándékát tükrözi. A kosárból való törlés azt jelenti, hogy a vásárlási szándék, amelyet korábban mutatott a potenciális vásárló, megszakad.

removeFromCart esemény kulcsai

kulcs	kötelező	típus	leírás
contentType	IGEN	text	Ennek az értéknek jellemzően "Product"-nak kell lennie.
currency	IGEN	text (ISO 4217)	Ebben a devizában van a termék ára feltüntetve, preferáltan a 3 betűs ISO 4217 formátumban (pl.: HUF, EUR).
id	IGEN	text	Egyedi azonosítója a terméknek a webshopban (pl. SKU).
name	IGEN	text	A teljes neve a terméknek, amit a kosárból kiveszel (pl. 24 db-os Red Bull karton).
quantity	IGEN	float	A kosárból kivett termék mennyisége.
totalItemPrice	IGEN	float	A teljes ára a kosárból kivett termék(ek)nek.
unit	IGEN	text	A termékek mértékegysége (pl. darab, kg, óra).
unitPrice	IGEN	float	Egy egységnyi termék ára a megadott devizában.
brand	NEM	text	A termék márkája.
category	NEM	text	Többszintű kategorizálása (preferáltan pl. 'téli|ruhák|cipők', elválasztva '|'-al) vagy egyszíntű kategóriája (pl. 'téli cipők' or 'nyári cipők') a terméknek.
contents	NEM	array	Egy JS objektumok tömbje, amiben termékenként definiáljuk a kulcsokat. További részleteket lásd a speciális kulcsoknál.
coupon	NEM	text	A kuponkód, amit felhasználtunk a kosárból törölt termékhez.
creative	NEM	text	Ritkán használt, például egy olyan promóció, amiben kicseréled a kosaradban lévő adott terméket egy jobbra, drágábbra vagy népszerűbbre.
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint akkor ez az ügyfélérték a customerValue.
ean	NEM	text	Amennyiben elérhető a termék nemzetközi cikkszáma (EAN).
list	NEM	text	A betöltött oldal funkciója szerinti besorolása a lehetséges értékkészletből: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc.
positioning	NEM	text	A termék pozíciója egy listában vagy egy termékcsoportban, ha az értelmezhető ott (pl. 2), illetve promóció esetén a promóció pozíciója az oldalon ha az értelmezhető (pl. banner_slot_1).
step	NEM	integer	Ha az esemény a fizetési folyamat során jelenik meg akkor a folyamat lépésének a sorszáma ez.
variant	NEM	text	A termék variánsainak lehetséges értékei (pl. egy mobiltelefon színe vagy egy koncert esemény helyszíne és ideje).

(*Lehetőség van hozzáadni egyedi kulcsokat)

Kosárból törlés mint esemény bekötési példái:

Fizikai termékekre a kosárban // Egy termékre

       var removeFromCartProperties = {
           'contentType': 'Product',
           'currency': 'HUF',
           'id': 'item_42',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'quantity': 10.0,
           'totalItemPrice': 49900.0,
           'unit': 'pcs.',
           'unitPrice': 4990.0,
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'coupon': '43763436874',
           'creative': 'upsell_promo_42',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'list': 'BasketPage',
           'positioning': '3',
           'variant': 'hardcover'
       }

       // Több termékre
       var removeFromCartProperties = {
           'contentType': 'Product',
           'currency': 'HUF',
           'id': 'item_42pack',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'quantity': 10.0,
           'totalItemPrice': 150000.0,
           'unit': 'pcs.',
           'unitPrice': 15000.0,
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'contents': [{
               'contentType': 'Product',
               'currency': 'HUF',
               'id': 'item_42',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 7500.0,
               'unit': 'pcs',
               'unitPrice': 2500.0,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               },
               {
               'contentType': 'Product',
               'currency': 'USD',
               'id': 'item_42en',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 25935,
               'unit': 'pcs',
               'unitPrice': 8645,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               }],
           'coupon': '43763436874',
           'creative': 'upsell_promo_42',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'list': 'BasketPage',
           'positioning': '3',
           'variant': 'hardcover'
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('remove_button').addEventListener('click', function() {
           bp('track', 'removeFromCart', removeFromCartProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#remove_button").click(function() {
           bp('track', 'removeFromCart', removeFromCartProperties);
       });

Fizetési mód kiválasztása (addPaymentInfo)

• Kiváltó esemény: Klikkelés ahol a fizetési módot állítjuk be, általában a vásárlási folyamat során.
• Látogató szándéka: Kiválasztja hogyan szeretne fizetni.
• Miért van erre szükség: Segít megismerni a vásárló fizetési szokásait.

Ezt az eseményt akkor kell küldeni, amikor a vásárló a fizetési módját már beállította. Akkor is küldjük, ha explicit módon adja meg a fizetési módot, illetve akkor is amikor ez implicit módon történik, például csak egyfajta fizetési megoldás létezik vagy egy korábban mentett módot használ automatikusan a vásárlási folyamat során.

addPaymentInfo esemény kulcsai

kulcs	kötelező	típus	leírás
contents	IGEN	array	JS objektumok tömbje, melyben az egyes termékek kulcsait írjuk le. A szállítási költség és a kupon nem tartozik ebbe bele. További részletek a speciális kulcsoknál.
paymentMethod	IGEN	text	A fizetési mód neve, amit a vásárló kiválasztott, pl. Bankkártyás fizetés - Barion, Banki utalás, Készpénz stb.
step	IGEN	integer	A vásárlási folyamat lépésének a sorszáma, ahol a fizetési módot beállítja.
contentType	NEM	text	Általában ez az érték "Product".
coupon	NEM	text	A kupon, amit felhasználtak.
creative	NEM	text	A neve vagy a címe a promóciónak, amennyiben ezt az eseményt egy promóció váltotta ki. A promóció képének fájlneve vagy a szlogenje, amely kiváltja ezt az eseményt.
currency	NEM	text (ISO 4217)	Ebben a devizában van a termék ára feltüntetve, preferáltan a 3 betűs ISO 4217 formátumban (pl.: HUF, EUR).
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
list	NEM	text	Ez az érték definíció szerint 'Checkout'.
opt	NEM	text	További információ a vásárlásról.
orderNumber	NEM	text	A vásárlás egyedi azonosítója.
positioning	NEM	text	A termék pozíciója egy listában vagy egy termékcsoportban, ha az értelmezhető ott (pl. 2), illetve promóció esetén a promóció pozíciója az oldalon ha az értelmezhető (pl. banner_slot_1).
revenue	NEM	float	A teljes fizetendő ár a tranzakció devizájában feltüntetve. Ez az összeg valamennyi felmerülő költséget tartalmazza, amit a vásárló fizet, beleértve a szállítást és az adót is.
shipping	NEM	float	A szállítás költsége a fizetett összeg devizájában.
shippingAddress	NEM	object	Szállítási cím a shippingAdress kulcs definíció szerint megadva, lásd a részleteket a speciális kulcsoknál.
tax	NEM	float	A kifizetett összeg adóra vonatkozó része a vásárlás devizájában megadva.

(*Lehetőség van hozzáadni egyedi kulcsokat)

Fizetési mód esemény bekötésére példák:

Fizikai termékekre // Több termékre

       var addPaymentInfoProperties = {
           'contents': [{
               'contentType': 'Product',
               'currency': 'HUF',
               'id': 'item_42',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 7500.0,
               'unit': 'pcs',
               'unitPrice': 2500.0,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               },
               {
               'contentType': 'Product',
               'currency': 'USD',
               'id': 'item_42en',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 25935,
               'unit': 'pcs',
               'unitPrice': 8645,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               }],
           'paymentMethod': 'Barion',
           'step': 0,
           'contentType': 'Product',
           'coupon': '43763436874',
           'creative': 'preselected_cart_01',
           'currency': 'HUF',
           'customerValue': 150.0,
           'list': 'Checkout',
           'opt': 'To postal office, no street address',
           'orderNumber': '852',
           'positioning': '1',
           'revenue': 17500.0,
           'shipping': 2500.0,
           'shippingAddress': {
               'city': 'Budapest',
               'country': 'HU',
               'deliveryMethod': 'DHL',
               'fullName': 'John Doe',
               'phone': '+36 1 1111 111',
               'region': 'HU-BU',
               'street': 'Műegyetem rkpt. 3.',
               'street2': '2. porta',
               'zipCode': '1111'
           },
           'tax': 0.0
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('checkout_next').addEventListener('click', function() {
           bp('track', 'addPaymentInfo', addPaymentInfoProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#checkout_next").click(function() {
           bp('track', 'addPaymentInfo', addPaymentInfoProperties);
       });

Promóció kattintása (clickPromo)

• Kiváltó esemény: Klikkelés egy promóciós dobozra, bannerre az oldaladon.
• Látogató szándéka: Egy promóció megtekintése.
• Miért van erre szükség: A látogató érdeklődését fejezi ki egy promótált termék, téma iránt a klikkelésével.

Ezt az eseményt akkor kell küldeni, amikor a látogató kattint egy promóciót a weboldalon. A promóciókat általában a kezdőlapon, terméklista oldalon, a fizetési folyamatban és még sok egyéb helyen szokás elhelyezni. A promóció lehet egy termék, ajánlat, márka vagy bármilyen egyéb egyedi ajánlat vagy téma. Ezt az eseményt csak azokon a promóciókon kell végrehajtani, amelyek a weboldalon jelennek meg, külső szolgáltatók, mint például a Google Ads, Facebook promócióira ez az esemény nem alkalmazandó.

clickPromo esemény kulcsai

kulcs	kötelező	típus	leírás
contentType	IGEN	text	Az oldal típusa, ahol a kattintott promóciót elhelyezték a lehetséges értékei (és csak ezek az elfogadottak): Page/Product/Article/Promotion/Banner/Misc.
creative	IGEN	text	A promóció neve vagy leírása, például a promóció képének fájlneve vagy a szlogenje
id	IGEN	text	A promóció egyedi azonosítója, amit kattintott a látogató.
name	IGEN	text	A promóció teljes neve.
brand	NEM	text	A promóció, ha márkához köthető akkor a márka neve.
category	NEM	text	| A promócióban szereplő termék alkategóriája (pl. 'Téli Nike cipők') vagy az alkategória ága (pl. 'Ruhák|Téli|Cipők' vagy 'Ruhák|Nyári|Cipők', '|'-el elválasztva) amennyiben ez egyértelműen értelmezhető.
contents	NEM	array	JS objektumok tömbje, amelyben a termékeket részletezzük, amelyeket lekattintottak a promócióban. További részleteket lásd a speciális kulcsoknál.
currency	NEM	text (ISO 4217)	Deviza, amiben a promótált termék ára megjelent. Preferáltan a 3 karakter hosszú ISO 4217 formátumban (pl. HUF, EUR).
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
ean	NEM	text	Amennyiben elérhető a termék nemzetközi cikkszáma (EAN).
list	NEM	text	A kattintott promóció helye a weboldalon. Értékei a következő lehetséges értékek közül: HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc.
positioning	NEM	text	A promóció pozíciója egy listában, ha az értelmezhető ott (pl. 2).
quantity	NEM	float	A termék mennyisége a promócióban (pl. 2).
step	NEM	integer	A vásárlási folyamat lépésének a sorszáma amennyiben az esemény a vásárlási folyamat során kerül küldésre.
unit	NEM	text	A promótált termék mértékegysége a promócióban (pl. db, kg).
unitPrice	NEM	float	A promótált termék egy egységének az ára a megadott devizában.
variant	NEM	text	XS').

(*Lehetőség van hozzáadni egyedi kulcsokat)

Promócióra kattintás, mint esemény bekötési példái:

Vásárlási folyamat egyik lépésében kattintott promóció // Egy termékre

       var clickPromoProperties = {
           'contentType': 'Product',
           'creative': 'book_42',
           'id': 'item_42',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'currency': 'HUF',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'list': 'Checkout',
           'positioning': '1',
           'quantity': 1.0,
           'step': 2,
           'unit': 'pcs',
           'unitPrice': 2500.0,
           'variant': 'hardcover'
       }

       // Több termékre
       var clickPromoProperties = {
           'contentType': 'Product',
           'creative': 'bundle_offer_01',
           'id': 'item_42pack',
           'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'contents': [{
               'contentType': 'Product',
               'currency': 'HUF',
               'id': 'item_42',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 7500.0,
               'unit': 'pcs',
               'unitPrice': 2500.0,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               },
               {
               'contentType': 'Product',
               'currency': 'USD',
               'id': 'item_42en',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 25935,
               'unit': 'pcs',
               'unitPrice': 8645,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               }],
           'currency': 'HUF',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'list': 'Checkout',
           'positioning': '1',
           'quantity': 1.0,
           'step': 2,
           'unit': 'pcs',
           'unitPrice': 15000.0,
           'variant': 'hardcover'
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('book_42_promo').addEventListener('click', function() {
           bp('track', 'clickPromo', clickPromoProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#book_42_promo").click(function() {
           bp('track', 'clickPromo', clickPromoProperties);
       });

Sign Up (signUp)

• Kiváltó esemény: Klikkelés amely véglegesít egy regisztrációt, bejelentkezést, hírlevélre feliratkozást, vagy bármi egyéb interakciót véglegesít.
• Látogató szándéka: Regisztrál vagy belép esetleg hírlevélre iratkozik fel marketing célból.
• Miért van erre szükség: A látogató egy személyes fiók használatával vagy hírlevélre feliratkozásával a webshop piaca iránti nagyobb érdeklődést reprezentál.

Ezt az eseményt általában a setUserproperties eseménnyel együtt kell elküldeni a fiók regisztráció során, ez az esemény csak a regisztrációt rögzíti, magát a felhasználót nem. Az eseményt akkor is küldeni kell, ha a felhasználó belép vagy feliratkozik valamire. A sikertelen bejelentkezési vagy regisztrációs kísérletek nem generálnak signUp eseményeket, ezeket egy error eseményben küldhetjük el például. Ammenyiben állandó bejelentkezéssel jön vissza az oldalra ha lehetséges mindig küldjünk egyszer egy (implicit) belépésről szóló signUp eseményt, hogy az adott munkamenetet egy belépett felhasználó kezdte el.

signUp esemény kulcsai

kulcs	kötelező	típus	leírás
contentType	IGEN	text	Amennyiben a látogató egy konkrét termékre iratkozott fel, akkor legyen 'Product', amennyiben egy regisztráció, belépés vagy egyéb aktivitása volt akkor 'Page'.
id	IGEN	text	Az egyedi azonosítója az aktivitás űrlapjának.
name	IGEN	text	A látogató aktivitás neve, pl. 'Regisztráció', 'Hírlevél feliratkozás', 'Belépés', stb.
brand	NEM	text	A márkája a terméknek amire feliratkozott.
category	NEM	text	A termék többszintű kategorizálása (preferáltan pl. 'téli|ruhák|cipők', elválasztva '|'-al) vagy egyszíntű kategóriája (pl. 'téli cipők' or 'nyári cipők')
contents	NEM	array	Egy JS objektumok tömbje, amiben termékenként definiáljuk a kulcsokat. További részleteket lásd a speciális kulcsoknál.
currency	NEM	text (ISO 4217)	Ebben a devizában van a termék ára feltüntetve, preferáltan a 3 betűs ISO 4217 formátumban (pl.: HUF, EUR).
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
ean	NEM	text	A termék cikkszáma amennyiben az elérhető.
unit	NEM	text	A mértékegysége a terméknek, amelyre feliratkozott (pl. darab, kg, óra).
unitPrice	NEM	float	Egy egységnyi termék ára a megadott devizában.
variant	NEM	text	A termék variánsa, amelyre feliratkozott (pl. a telefon színe vagy az ideje és helye egy koncertesemények vagy mozinak)

(*Lehetőség van hozzáadni egyedi kulcsokat)

Sign up esemény bekötési példái:

Newsletter for a given item // Egy termékre hírlevelére való feliratkozás

       var signUpProperties = {
           'contentType': 'Product',
           'id': 'item_42',
           'name': "Hitchhikers' Guide to the Galaxy, newsletter",
           'brand': 'Gollancz',
           'category': 'books|hardcover|scifi, books|hardcover|comedy',
           'currency': 'HUF',
           'customerValue': 150.0,
           'ean': '9780575115347',
           'unit': 'pcs.',
           'unitPrice': 4990.0,
           'variant': 'hardcover'
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('signup_button').addEventListener('click', function() {
           bp('track', 'signUp', signUpProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#signup_button").click(function() {
           bp('track', 'signUp', signUpProperties);
       });

Regisztráció // sample subscription data

       var signUpProperties = {
           'contentType': 'Page',
           'id': 'registration_form_1',
           'name': 'Registration'
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('signup_button').addEventListener('click', function() {
           bp('track', 'signUp', signUpProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#signup_button").click(function() {
           bp('track', 'signUp', signUpProperties);
       });

Keresés (search)

• Kiváltó esemény: Klikkelés amivel egy keresést indít el a látogató.
• Látogató szándéka: Termék keresése az oldalon.
• Miért van erre szükség: Látogató explicit érdeklődését fejezi ki a kereséssel az adott termék iránt.

Ezt az eseményt akkor kell elküldeni amikor rákattintunk egy keresőgombra. Ha a keresésnek nincsen keresés gombja, hanem találatokat ad vissza akkor az egyik találatra való rákattintás küldheti el ezt az eseményt. Ha van olyan funkcionalitása az oldalnak, amellyel a termékeket szűrhetjük pl. márka vagy ár szerint, akkor ugyanúgy alkalmazandó az esemény, ebben az esetben a böngésző címsorában a HTTP tulajdonságaiból kiolvasható a keresett szöveg (pl. „goats” ebben: „https://www.google.com/search?ei=A3rRXNHmJY-nrgSJs5HgDQ&q=goats”).

search esemény kulcsai

kulcs	kötelező	típus	leírás
searchString	IGEN	text	A keresett kifejezés, amit a látogató begépelt vagy a HTTP paraméter, ami tartalmazza a keresett kifejezést.
contents	NEM	array	JS objektumok tömbje, amely tartalmazza az első 10 találatot a keresett kifejezésre.
contentType	NEM	text	Definíció szerint 'Product'
currency	NEM	text (ISO 4217)	Amennyiben a szűrésed ár szerinti szűrés volt akkor annak a devizája itt adható meg.
customerValue	NEM	float	Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
id	NEM	float	A keresés funkciót biztosító html elem egyedi azonosítója.
name	NEM	text	A keresés funkciót biztosító html elem neve.
totalResults	NEM	integer	A keresett kifejezésre a találatok száma.

(*Lehetőség van hozzáadni egyedi kulcsokat)

Keresési eseményre bekötési példák:

Általános példa // egyszerű keresés

       var searchProperties = {
           'searchString': 'big GOATS',
           'contents': [{
               'contentType': 'Product',
               'currency': 'HUF',
               'id': 'item_42',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 7500.0,
               'unit': 'pcs',
               'unitPrice': 2500.0,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               },
               {
               'contentType': 'Product',
               'currency': 'USD',
               'id': 'item_42en',
               'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
               'quantity': 3.0,
               'totalItemPrice': 25935,
               'unit': 'pcs',
               'unitPrice': 8645,
               'brand': 'Gollancz',
               'category': 'books|hardcover|scifi, books|hardcover|comedy',
               'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
               'ean': '9780575115347',
               'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
               'variant': 'hardcover'
               }],
           'contentType': 'Product',
           'customerValue': 150.0,
           'id': 'search_01',
           'name': 'Book Search',
           'totalResults': 2
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('search_button').addEventListener('click', function() {
           bp('track', 'search', searchProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#search_button").click(function() {
           bp('track', 'search', searchProperties);
       });

Hiba esemény (error)

• Kiváltó esemény: Bármilyen esemény, amely hibás működést okoz.
• Látogató szándéka: Bármi.
• Miért van erre szükség: Információ a hibás működésekről.

Ezt az eseményt akkor kell küldeni, ha bármilyen kérést nem tud teljesíteni a weboldal, pl. a 40X vagy 50x típusú oldalak.

Error esemény kulcsai

kulcs	kötelező	típus	leírás
leírás	IGEN	text	A hiba leírása, preferáltan a teljes hibaüzenet.
code	NEM	int	Hiba kód

Error esemény bekötésére példák:

404-es hibára // on a static 404 page

       var errorProperties = {
           'leírás': 'I find your lack of navigation disturbing.',
           'code': 404
       }

       bp('track', 'error', errorProperties);

Egyéni esemény (customEvent)

• Kiváltó esemény: Bármilyen esemény amelyet az eddigiek nem definiálnak.
• Látogató szándéka: Egyéb amelyet az eddigiek nem fednek le.
• Miért van erre szükség: Egyéb fontos információk.

Ezt az eseményt azért hoztuk létre, hogy lehetőség legyen egyedi események beküldésére a sztenderd eseményeken kívül is.

Egyéni esemény kulcsai

kulcs	kötelező	típus	leírás
_eventAction	NEM	text	Ami kiváltja ezt az eseményt, pl. klikk vagy oldalbetöltődés.
_eventCategory	NEM	text	Az esemény általad definiált kategóriája, amelybe az egyedi esemény besorolható pl. 'látogatói_beállítások'.
_eventLabel	NEM	text	A címke, ami az eseményre utal, pl. 'nyelvi_beállítások'.
_eventProperty	NEM	text	A kulcs, ami az eseményre utal, pl. 'mértékegység formátuma'.
_eventValue	NEM	text	A kulcs értéke, ami az eseményre utal, pl. 'Inch'.

Egyéni esemény implementálásra példa:

Mértékegység kiválasztása // Mértékegység kiválasztása 'Inch'-ben

       var customEventProperties = {
           '_eventAction': 'click',
           '_eventCategory': 'user_settings',
           '_eventLabel': 'language_selection',
           '_eventProperty': 'unit_format',
           '_eventValue': 'Inch'
       }

       // Use one of these to add the event listener to the button click (use only one):

       // vanilla JS (if you don't use jQuery, if in your console "$" is not defined on your site)
       document.getElementById('set_language').addEventListener('click', function() {
           bp('track', 'customEvent', customEventProperties);
       });

       // jQuery (if you use jQuery, if in your console "$" is defined on your site)
       $("#set_language").click(function() {
           bp('track', 'customEvent', customEventProperties);
       });

Speciális kulcsok

Contents kulcs típusa - objektum tömb

kulcs	kötelező	típus	leírás
contentType	IGEN	text	Amennyiben termék oldalról van szó - mint minimális követelmény a contentView eseménynél - ott ez "Product". Egyébként pedig válaszd a következő értékek közül, azt amelyek a leginkább illik rá: Page/Product/Article/Promotion/Banner/Misc.
currency	IGEN	text (ISO 4217)	Deviza, amiben a termék ára látható volt a látogató számára, preferáltan a 3 karakteres ISO 4217 formátum (pl. HUF, EUR).
id	IGEN	text	Egyedi azonosító a termékre, ez lehet webshopban definiált ID vagy SKU.
name	IGEN	text	A teljes neve a terméknek, pl. Red Bull 24 db-os karton.
quantity	IGEN	float	A termék mennyisége.
totalItemPrice	IGEN	float	A teljes ára a kosárba tett terméknek az adott devizában.
unit	IGEN	text	A termék mértékegysége, amelyben a látogató látta azt (pl. db, kg, L).
unitPrice	IGEN	float	A termék egy egységnyi mennyiségének az ára.
brand	NEM	text	A termék márkája.
category	NEM	text	A termék többszintű kategorizálása (preferáltan pl. 'téli|ruhák|cipők', elválasztva '|'-al) vagy egyszíntű kategóriája (pl. 'téli cipők' or 'nyári cipők').
description	NEM	text	A termék leírása.
ean	NEM	text	A termék cikkszáma amennyiben az elérhető.
imageUrl	NEM	text	A megtekintett termék képének URL-je.
variant	NEM	text	A termék variánsainak beállított értékei (pl. egy mobiltelefon színe vagy egy koncert esemény helyszíne és ideje).

Address kulcs típusa - objektum tömb

kulcs	kötelező	típus	leírás
city	NEM	text	A város teljes neve, amit a látogató megad.
country	NEM	text (ISO-3166-1 alpha-2)	A látogató által megadott országkódja ISO-3166-1 alpha-2 formátumban.
deliveryMethod	NEM	text	Kézbesítési mód amennyiben az értelmezhető.
fullName	NEM	text	A látogató neve.
phone	NEM	text	A telefonszáma a látogatónak (hashelt).
region	NEM	text (ISO-3166-2)	A régió kódja a látogatónak ISO-3166-2 formátumban.
street	NEM	text	A látogató utcája, melyben megadható a házszáma és egyéb részletek is.
street2	NEM	text	A cím folytatása, ha fentiben nem férne el.
zipCode	NEM	text	A látogató irányítószáma.

Egyedi kulcs

name	Value típus	leírás
_custom	any típus	Amennyiben az előre definiált kulcsok egyike sem megfelelő neked, úgy lehetőséged van egyedi kulcsot is definiálni egy már meglévő eseménybe. Az egyedi kulcs nevének alul vonással kell kezdődnie.

Egyedi kulcsra bekötési példa:

Egy vásárlási eseményben a '_myCustomProperty' kulcs elküldése //_custome_event_test

       var purchaseProperties = {
               'contents': [{
                   'contentType': 'Product',
                   'currency': 'HUF',
                   'id': 'item_42',
                   'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
                   'quantity': 3.0,
                   'totalItemPrice': 7500.0,
                   'unit': 'pcs',
                   'unitPrice': 2500.0,
                   'brand': 'Gollancz',
                   'category': 'books|hardcover|scifi, books|hardcover|comedy',
                   'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
                   'ean': '9780575115347',
                   'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
                   'variant': 'hardcover'
                   },
                   {
                   'contentType': 'Product',
                   'currency': 'USD',
                   'id': 'item_42en',
                   'name': "Hitchhikers' Guide to the Galaxy, hardcover, ISBN: 9780575115347",
                   'quantity': 3.0,
                   'totalItemPrice': 25935,
                   'unit': 'pcs',
                   'unitPrice': 8645,
                   'brand': 'Gollancz',
                   'category': 'books|hardcover|scifi, books|hardcover|comedy',
                   'leírás': 'The Hitchhikers Guide to the Galaxy is a comedy science fiction series created by Douglas Adams.',
                   'ean': '9780575115347',
                   'imageUrl': 'https://images-na.ssl-images-amazon.com/images/I/51MzUz8rQcL._SX305_BO1,204,203,200_.jpg',
                   'variant': 'hardcover'
                   }],
               'currency': 'HUF',
               'revenue': 17500.0,
               'step': 7,
               'contentType': 'Product',
               'coupon': '43763436874',
               'creative': 'preselected_cart_01',
               'customerValue': 150.0,
               'list': 'Checkout',
               'opt': 'To postal office, no street address',
               'orderNumber': '852',
               'positioning': '1',
               'shipping': 2500.0,
               'shippingAddress': {
                   'city': 'Budapest',
                   'country': 'HU',
                   'deliveryMethod': 'DHL',
                   'fullName': 'John Doe',
                   'phone': '+36 1 1111 111',
                   'region': 'HU-BU',
                   'street': 'Műegyetem rkpt. 3.',
                   'street2': '2. porta',
                   'zipCode': '1111'
               },
               'tax': 0.0,
               '_myCustomProperty' : 'This is my first custom property'
           }

           bp('track', 'purchase', purchaseProperties);