Barion-Pixel-API-referencia: Difference between revisions

From Barion Documentation
Jump to navigation Jump to search
VisualWikitext
 
(7 intermediate revisions by 2 users not shown)
Line 24: Line 24:
         bp('consent', 'grantConsent');
         bp('consent', 'grantConsent');
         bp('consent', 'rejectConsent');
         bp('consent', 'rejectConsent');
    </nowiki>
== Ü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'''
    <nowiki>
        bp('identity','setEncryptedEmail', '[email protected]');
        bp('identity','setEncryptedPhone', '+36301234567');
    </nowiki>
VAGY
    <nowiki>
        var hashedEmailAddress = sha1('[email protected]');
        bp('identity','setEncryptedEmail', hashedEmailAddress);
        var hashedPhone = sha1('+36301234567');
        bp('identity','setEncryptedPhone', hashedPhone);
     </nowiki>
     </nowiki>


Line 595: Line 622:
| IGEN
| IGEN
| float
| 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.
| 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
! step
Line 813: Line 840:


|}
|}


== Fizetés elindítása esemény (initiatePurchase) ==
== Fizetés elindítása esemény (initiatePurchase) ==
Line 847: Line 873:
| IGEN
| IGEN
| float
| 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.
| 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
! step
Line 1,065: Line 1,091:


|}
|}


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

Latest revision as of 10:33, 6 March 2024

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:


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:


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:

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:

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:


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:


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:


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:


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:


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:


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:


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:

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:


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:


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:


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:


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:

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:

Retrieved from "https://docs.barion.com/index.php?title=Barion-Pixel-API-referencia&oldid=4261"