Barion-Pixel-API-referencia: Difference between revisions

From Barion Documentation
Jump to navigation Jump to search
(Created page with "{{PageTitle|title=Barion Pixel API referencia}} {| style="margin-left:2em;" align="right" | __TOC__ |} == Hozzájárulás (grantConsent, rejectConsent) == * Látogató szá...")
 
 
(9 intermediate revisions by 2 users not shown)
Line 8: Line 8:


* 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.
* 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áráulás-kezelőjében.
* Hol kell implementálni: A weboldal saját hozzájárulás-kezelőjében.
* Miért van erre szüskég: A weboldal látogatói adatainak a felhasználása a GDPR-nak megfelelően hozzájárulásukhoz kötött.
* 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
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éreli ("Elfogadom", "OK", "Egyetértek", stb. gombok), annak helyes implementációja kizárólag a weboldal felelőssége.
é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
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é.
é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.
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 ájánlásunkról részletesen [https://docs.barion.com/Barion_Pixel_Consent_Management_requirements itt] tájékozódhatsz.
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 [https://docs.barion.com/Barion_Pixel_Consent_Management_requirements itt] tájékozódhatsz.




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 29: Line 56:


* Kiváltó esemény: Minimum a termék oldalak ''oldalbetöltődései'', preferáltan minden oldal oldalbetöltődése.
* 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 nézett oldalról.
* 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.
* 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.).
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.
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.


Line 56: Line 83:
| IGEN
| IGEN
| text
| 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.
| 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
! name
| IGEN
| IGEN
| text
| 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!
| 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
! quantity
Line 91: Line 118:
| NEM
| NEM
| array
| array
| Egy JS objektumok tömbje amelyben egyesével részletezzük az egyes termékeket. További részleteket lásd alább.
| Egy JS objektumok tömbje, amelyben egyesével részletezzük az egyes termékeket. További részleteket lásd alább.
|-
|-
! creative
! creative
| NEM
| NEM
| text
| 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.
| 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
! customerValue
Line 272: Line 299:
* Kiváltó esemény: ''Kattintás'' ami azt eredményezi, hogy a termék valóban kosárba kerül.
* 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.
* 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ásra.
* 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,  
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
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, van egy pont a látogató munkamenetében, ahol úgy dönt, hogy tervezi megvásárolni az általa kiválasztott terméket.  
é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.
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.
Például a „Vásárlás”, "Kosárba" vagy a „Lefoglal” felirattal ellátott gombok.
Line 307: Line 334:
| IGEN
| IGEN
| text
| text
| A teljes neve a terméknek amit a kosárhoz adsz (pl. 24 db-os Red Bull karton).
| A teljes neve a terméknek, amit a kosárhoz adsz (pl. 24 db-os Red Bull karton).
|-
|-
! quantity
! quantity
Line 342: Line 369:
| NEM
| NEM
| array
| 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.
| 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
! coupon
| NEM
| NEM
| text
| text
| A kuponkód amit felhasználtunk amikor a kosárba tettük a terméket.
| A kuponkód, amit felhasználtunk amikor a kosárba tettük a terméket.
|-
|-
! creative
! creative
| NEM
| NEM
| text
| text
| A neve vagy a címe adott termék(ek)et hirdető promóciónak. Például a a promóció kép fájlneve vagy a szlogenje, ami a terméket automatkusan kosárba teszi.
| 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
! customerValue
Line 568: Line 595:
* Kiváltó esemény: ''Klikkelés'', amely kiváltja a fizetési folyamat indítását.
* 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.
* 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 folyamtban érintett termékek iránt.
* 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
Á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árolónak megadnia más
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.
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.


Line 585: Line 612:
| IGEN
| IGEN
| array
| 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.  
| 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
! currency
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 640: Line 667:
| NEM
| NEM
| text
| 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 értelmzhető (pl. banner_slot_1).
| 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
! shipping
Line 813: Line 840:


|}
|}


== Fizetés elindítása esemény (initiatePurchase) ==
== Fizetés elindítása esemény (initiatePurchase) ==
Line 819: Line 845:
* Kiváltó esemény: ''Klikkelés'' amely befejezi a fizetési folyamatot egy fizetéssel.
* 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.
* 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 folyamtban érintett termékek iránt.
* 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őpillantban 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,  
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
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ó.
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).




Line 837: Line 863:
| IGEN
| IGEN
| array
| 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.
| 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
! currency
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 892: Line 918:
| NEM
| NEM
| text
| 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 oldaln ha az értelmzhető (pl. banner_slot_1).
| 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
! shipping
Line 912: Line 938:




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


{| role="presentation" class="wikitable mw-collapsible mw-collapsed"
{| role="presentation" class="wikitable mw-collapsible mw-collapsed"
Line 1,066: Line 1,092:
|}
|}


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


* Kiváltó esemény: ''Klikkelés'' amikor a látogató személyéhez köthető adatokat mentünk el.
* Kiváltó esemény: ''Klikkelés'' amikor a látogató személyéhez köthető adatokat mentünk el.
Line 1,073: Line 1,098:
* Miért van erre szükség: Az információ alapján a látogatóról relevánsabb ajánlat adható.
* 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
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-al ö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.
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.
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.
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.
Line 1,093: Line 1,118:
| IGEN
| IGEN
| text
| 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)
| 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
! accountCreatedTime
Line 1,111: Line 1,136:
| NEM
| NEM
| text
| text
| A város ahol a látogató él.
| A város, ahol a látogató él.
|-
|-
! country
! country
Line 1,117: Line 1,142:
| NEM
| NEM
| text
| text
| Az ország ahol a látogató él, preferáltan az ISO 3166-1 alpha-2 formátumban, pl. HU vagy CZ.
| Az ország, ahol a látogató él, preferáltan az ISO 3166-1 alpha-2 formátumban, pl. HU vagy CZ.
|-
|-
! region
! region
Line 1,123: Line 1,148:
| NEM
| NEM
| text
| text
| A régió ahol a látogató él, preferáltan az ISO 3166-2 formátumban, pl. HU-BU.
| A régió, ahol a látogató él, preferáltan az ISO 3166-2 formátumban, pl. HU-BU.
|-
|-
! currency
! currency
Line 1,129: Line 1,154:
| NEM
| NEM
| text
| text
| A deviza amit a user 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).
| 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
! email
Line 1,159: Line 1,184:
| IGEN
| IGEN
| text
| text
| A látogató telefonszáma, preferáltan E.164 formátumban, pl. +36 1 111 1111 (hashelt)
| A látogató telefonszáma, preferáltan E.164 formátumban, pl. +36 1 111 1111 (hashelt)
|-
|-
! shippingAddress
! shippingAddress
Line 1,171: Line 1,196:
| NEM
| NEM
| text
| text
| Amennyiben a látogató adatokat a vásárlási folyamt 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.
| 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
! zipCode
Line 1,236: Line 1,261:


* Kiváltó esemény: ''Klikkelés'' egy kategórián a kategória választó oldalon.
* Kiváltó esemény: ''Klikkelés'' egy kategórián a kategória választó oldalon.
* Látogató szándéka: Kategóriaba tartozó termékek megtekintése.
* 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.
* 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.
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.




Line 1,269: Line 1,294:
| NEM
| NEM
| text
| text
| | A kategória alkkategó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).
| | 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).
|-
|-
! [[#Speciális_kulcsok|contents]]
! [[#Speciális_kulcsok|contents]]
| NEM
| NEM
| array
| 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.
| 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
! contentType
Line 1,289: Line 1,314:
| NEM
| NEM
| text
| text
| A kattinott 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.
| 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
! positioning
| NEM
| NEM
| text
| text
| A kategória pozíciója a listában vagy egy kategória csoportban ha az értelmezhető ott (pl. 2).
| A kategória pozíciója a listában vagy egy kategória csoportban, ha az értelmezhető ott (pl. 2).
|-
|-
! step
! step
Line 1,343: Line 1,368:


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.
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.
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.




Line 1,358: Line 1,383:
| IGEN
| IGEN
| text
| 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.
| 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
! currency
| IGEN
| IGEN
| text (ISO 4217)
| text (ISO 4217)
| Deviza amiben a termék ára megjelent, preferáltan a 3 karakter hosszú ISO 4217 formátum (pl. HUF, EUR).
| Deviza, amiben a termék ára megjelent, preferáltan a 3 karakter hosszú ISO 4217 formátum (pl. HUF, EUR).
|-
|-
! id
! id
Line 1,378: Line 1,403:
| IGEN
| IGEN
| float
| float
| A mennyisége a terméknek amit kattintottak. (pl. 1).
| A mennyisége a terméknek, amit kattintottak. (pl. 1).
|-
|-
! unit
! unit
| IGEN
| IGEN
| text
| text
| A mértékegysége a terméknek amit kattintottak (pl. db, kg).
| A mértékegysége a terméknek, amit kattintottak (pl. db, kg).
|-
|-
! unitPrice
! unitPrice
Line 1,398: Line 1,423:
| NEM
| NEM
| text
| text
| | A kattintott termék alkkategó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).
| | 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).
|-
|-
! [[#Speciális_kulcsok|contents]]
! [[#Speciális_kulcsok|contents]]
| NEM
| NEM
| array
| array
| JS objektumok tömbje amelyben több terméket részletezünk ki. Részleteket lásd a speciális kulcsok alatt.
| JS objektumok tömbje, amelyben több terméket részletezünk ki. Részleteket lásd a speciális kulcsok alatt.
|-
|-
! creative
! creative
Line 1,428: Line 1,453:
| NEM
| NEM
| text
| 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 értelmzhető (pl. banner_slot_1).
| 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
! step
| NEM
| NEM
| integer
| integer
| A vásárlási folyamat lépésének a sorszáma, amennyiben ott kattintották a terméket.
| A vásárlási folyamat lépésének a sorszáma amennyiben ott kattintották a terméket.
|-
|-
! variant
! variant
Line 1,539: Line 1,564:


* Kiváltó esemény: ''Klikkelés'', hogy további részleteket tudjunk meg a termékről.
* Kiváltó esemény: ''Klikkelés'', hogy további részleteket tudjunk meg a termékről.
* Látogató szándéka: Mélyebben megsimerni az adott terméket.
* 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.
* 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.


Line 1,558: Line 1,583:
| IGEN
| IGEN
| text
| 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.  
| 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
! currency
| IGEN
| IGEN
| text (ISO 4217)
| text (ISO 4217)
| Deviza amiben a termék ára megjelent, preferáltan a 3 karakter hosszú ISO 4217 formátum (pl. HUF, EUR).
| Deviza, amiben a termék ára megjelent, preferáltan a 3 karakter hosszú ISO 4217 formátum (pl. HUF, EUR).
|-
|-
! id
! id
Line 1,578: Line 1,603:
| IGEN
| IGEN
| text
| text
| A mértékegysége a terméknek amit kattintottak (pl. db, kg).
| A mértékegysége a terméknek, amit kattintottak (pl. db, kg).
|-
|-
! unitPrice
! unitPrice
Line 1,593: Line 1,618:
| NEM
| NEM
| text
| text
| | A klikkelt termék alkkategó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).
| | 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).
|-
|-
! [[#Speciális_kulcsok|contents]]
! [[#Speciális_kulcsok|contents]]
| NEM
| NEM
| array
| array
| JS objektumok tömbje amelyben több terméket részletezünk ki. Részleteket lásd a speciális kulcsok alatt.
| JS objektumok tömbje, amelyben több terméket részletezünk ki. Részleteket lásd a speciális kulcsok alatt.
|-
|-
! creative
! creative
Line 1,618: Line 1,643:
| NEM
| NEM
| text
| text
| Az oldal típusa, ahol a terméket kattintották, választhatóak a következő lehetséges értékek : HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc.
| 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
! positioning
| NEM
| NEM
| text
| 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 értelmzhető (pl. banner_slot_1).
| 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
! step
Line 1,758: Line 1,783:
| IGEN
| IGEN
| text
| 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.  
| 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
! currency
| IGEN
| IGEN
| text (ISO 4217)
| text (ISO 4217)
| Deviza amiben a termék ára megjelent, preferáltan a 3 karakter hosszú ISO 4217 formátum (pl. HUF, EUR).
| Deviza, amiben a termék ára megjelent, preferáltan a 3 karakter hosszú ISO 4217 formátum (pl. HUF, EUR).
|-
|-
! id
! id
Line 1,778: Line 1,803:
| IGEN
| IGEN
| text
| text
| A mértékegysége a terméknek amit kattintottak (pl. db, kg).
| A mértékegysége a terméknek, amit kattintottak (pl. db, kg).
|-
|-
! unitPrice
! unitPrice
Line 1,798: Line 1,823:
| NEM
| NEM
| text
| text
| | A termék alkkategó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).
| | 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).
|-
|-
! [[#Speciális_kulcsok|contents]]
! [[#Speciális_kulcsok|contents]]
| NEM
| NEM
| array
| array
| JS objektumok tömbje amelyben több terméket részletezünk ki. Részleteket lásd a speciális kulcsok alatt.
| JS objektumok tömbje, amelyben több terméket részletezünk ki. Részleteket lásd a speciális kulcsok alatt.
|-
|-
! creative
! creative
Line 1,823: Line 1,848:
| NEM
| NEM
| text
| text
| Az oldal típusa, ahol a terméket kattintották, választhatóak a következő lehetséges értékek : HomePage/SearchPage/ProductPage/Recommendation/ComparisonPage/BasketPage/Checkout/Misc
| 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
! positioning
| NEM
| NEM
| text
| 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 értelmzhető (pl. banner_slot_1).
| 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
! quantity
Line 1,941: Line 1,966:
* 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.
* 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.
* 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 folyamtban érintett termékek iránt. Illetve elkerüljük az irreleváns hirdetéseket.
* 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.
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 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.
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.


Line 1,959: Line 1,984:
| IGEN
| IGEN
| array
| 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.
| 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
! currency
Line 1,974: Line 1,999:
| IGEN
| IGEN
| integer
| 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.
| 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
! contentType
Line 1,984: Line 2,009:
| NEM
| NEM
| text
| text
| A kupon amit felhasználtak.
| A kupon, amit felhasználtak.
|-
|-
! creative
! creative
Line 2,014: Line 2,039:
| NEM
| NEM
| text
| 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 oldaln ha az értelmzhető (pl. banner_slot_1).
| 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
! shipping
Line 2,108: Line 2,133:
* 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.
* 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.
* 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 irrelkeváns a termék számára.
* 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 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.
Line 2,140: Line 2,165:
| IGEN
| IGEN
| text
| text
| A teljes neve a terméknek amit a kosárból kiveszel (pl. 24 db-os Red Bull karton).
| A teljes neve a terméknek, amit a kosárból kiveszel (pl. 24 db-os Red Bull karton).
|-
|-
! quantity
! quantity
Line 2,175: Line 2,200:
| NEM
| NEM
| array
| 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.
| 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
! coupon
| NEM
| NEM
| text
| text
| A kuponkód amit felhasználtunk a kosárból törölt termékhez.
| A kuponkód, amit felhasználtunk a kosárból törölt termékhez.
|-
|-
! creative
! creative
| NEM
| NEM
| text
| text
| Ritkán használt, például egy olyan promócia amiben kicseréled a kosaradban lévő adott terméket egy jobbra, drágábbra vagy népszerűbbre.
| 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
! customerValue
| NEM
| NEM
| float
| float
| Amennyiben felskáláztad az ügyfeleidet értékük szerint, akkor ez az ügyfélérték a customerValue.
| Amennyiben felskáláztad az ügyfeleidet értékük szerint akkor ez az ügyfélérték a customerValue.
|-
|-
! ean
! ean
Line 2,205: Line 2,230:
| NEM
| NEM
| text
| 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 oldaln ha az értelmzhető (pl. banner_slot_1).
| 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
! step
Line 2,220: Line 2,245:




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


{| role="presentation" class="wikitable mw-collapsible mw-collapsed"
{| role="presentation" class="wikitable mw-collapsible mw-collapsed"
Line 2,316: Line 2,341:
== Fizetési mód kiválasztása (addPaymentInfo) ==
== 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.
* 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.
* 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.
* 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
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
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.
a vásárlási folyamat során.


Line 2,336: Line 2,361:
| IGEN
| IGEN
| array
| 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.
| 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
! paymentMethod
Line 2,356: Line 2,381:
| NEM
| NEM
| text
| text
| A kupon amit felhasználtak.
| A kupon, amit felhasználtak.
|-
|-
! creative
! creative
Line 2,391: Line 2,416:
| NEM
| NEM
| text
| 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 oldaln ha az értelmzhető (pl. banner_slot_1).
| 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
! revenue
Line 2,505: Line 2,530:
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
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,
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ó.
külső szolgáltatók, mint például a Google Ads, Facebook promócióira ez az esemény nem alkalmazandó.




Line 2,540: Line 2,565:
| NEM
| NEM
| text
| text
| A promóció ha márkához köthető, akkor a márka neve.
| A promóció, ha márkához köthető akkor a márka neve.
|-
|-
! category
! category
| NEM
| NEM
| text
| text
| | | A promócióban szereplő termék alkkategó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értelmen értelmezhető.
| | | 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ő.
|-
|-
! [[#Speciális_kulcsok|contents]]
! [[#Speciális_kulcsok|contents]]
| NEM
| NEM
| array
| array
| JS objektumok tömbje amelyben a termékeket részletezzük amelyeket lekattintottak a promócióban. További részletekt lásd a speciális kulcsoknál.
| 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
! currency
| NEM
| NEM
| text (ISO 4217)
| text (ISO 4217)
| Daviza amiben a promótált termék ára megjelent. Preferáltan a 3 karakter hosszú ISO 4217 formátumban (pl. HUF, EUR).
| Deviza, amiben a promótált termék ára megjelent. Preferáltan a 3 karakter hosszú ISO 4217 formátumban (pl. HUF, EUR).
|-
|-
! customerValue
! customerValue
Line 2,575: Line 2,600:
| NEM
| NEM
| text
| text
| A promóció pozíciója egy listában ha az értelmezhető ott (pl. 2).
| A promóció pozíciója egy listában, ha az értelmezhető ott (pl. 2).
|-
|-
! quantity
! quantity
| NEM
| NEM
| float
| float
| A termék mennyisége a promócióban(pl. 2).
| A termék mennyisége a promócióban (pl. 2).
|-
|-
! step
! step
Line 2,605: Line 2,630:




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


{| role="presentation" class="wikitable mw-collapsible mw-collapsed"
{| role="presentation" class="wikitable mw-collapsible mw-collapsed"
Line 2,705: Line 2,730:
* 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.
* 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.
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.
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.
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.




Line 2,731: Line 2,756:
| IGEN
| IGEN
| text
| text
| A user aktivitás neve, pl 'Regisztráció', 'Hírlevél feliratkozás', 'Belépés', stb.
| A látogató aktivitás neve, pl'Regisztráció', 'Hírlevél feliratkozás', 'Belépés', stb.
|-
|-
! brand
! brand
Line 2,746: Line 2,771:
| NEM
| NEM
| array
| 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.
| 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
! currency
Line 2,766: Line 2,791:
| NEM
| NEM
| text
| text
| A métékegysége a terméknek amelyre feliratkozott (pl. darab, kg, óra).
| A mértékegysége a terméknek, amelyre feliratkozott (pl. darab, kg, óra).
|-
|-
! unitPrice
! unitPrice
Line 2,776: Line 2,801:
| NEM
| NEM
| text
| text
| A termék variánsa amelyre feliratkozott (pl. a telefon színe vagy az ideje és helye egy koncertesemények vagy mozinak)
| A termék variánsa, amelyre feliratkozott (pl. a telefon színe vagy az ideje és helye egy koncertesemények vagy mozinak)
|}
|}
<span style="font-size:80%; line-height: 1.31em;">(*Lehetőség van hozzáadni [[#Speciális_kulcsok|egyedi kulcsokat]])</span>
<span style="font-size:80%; line-height: 1.31em;">(*Lehetőség van hozzáadni [[#Speciális_kulcsok|egyedi kulcsokat]])</span>
Line 2,849: Line 2,874:
* 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.
* 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
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
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”).
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”).




Line 2,865: Line 2,890:
| IGEN
| IGEN
| text
| text
| A keresett kifejezés amit a látogató begépelt vagy a HTTP paraméter ami tartalmazza a keresett kifejezést.
| A keresett kifejezés, amit a látogató begépelt vagy a HTTP paraméter, ami tartalmazza a keresett kifejezést.
|-
|-
! [[#Speciális_kulcsok|contents]]
! [[#Speciális_kulcsok|contents]]
| NEM
| NEM
| array
| array
| JS objektumok tömbje amely tartalmazza az első 10 találatot a keresett kifejezésre.
| JS objektumok tömbje, amely tartalmazza az első 10 találatot a keresett kifejezésre.
|-
|-
! contentType
! contentType
Line 2,971: Line 2,996:
== Hiba esemény (error) ==
== Hiba esemény (error) ==


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




Line 3,018: Line 3,043:
== Egyéni esemény (customEvent) ==
== Egyéni esemény (customEvent) ==


* Kiváltó esemény: Bármilyen esemény, amelyet az eddigiek nem definiálnak.
* 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.
* 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.
* Miért van erre szükség: Egyéb fontos információk.


Ezt az eseményt azért hotuk létre, hogy lehetőség legyen egyedi események beküldésére a sztenderd eseményeken kívül is.
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.




Line 3,046: Line 3,071:
| NEM
| NEM
| text
| text
| A címke ami az eseményre utal, pl. 'nyelvi_beállítások'.
| A címke, ami az eseményre utal, pl. 'nyelvi_beállítások'.
|-
|-
! _eventProperty
! _eventProperty
| NEM
| NEM
| text
| text
| A kulcs ami az eseményre utal, pl. 'unit_format'.
| A kulcs, ami az eseményre utal, pl. 'mértékegység formátuma'.
|-
|-
! _eventValue
! _eventValue
| NEM
| NEM
| text
| text
| A kulcs értéke ami az eseményre utal, pl. 'Inch'.
| A kulcs értéke, ami az eseményre utal, pl. 'Inch'.
|}
|}


Line 3,102: Line 3,127:
| IGEN
| IGEN
| text
| 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álasszd a következő értékek közül, azt amelyek a leginkább illik rá: Page/Product/Article/Promotion/Banner/Misc.
| 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
! currency
| IGEN
| IGEN
| text (ISO 4217)
| 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).
| 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
! id
Line 3,117: Line 3,142:
| IGEN
| IGEN
| text
| text
| A teljes neve a terméknek, pl. Red Bull 24 db-os carton.
| A teljes neve a terméknek, pl. Red Bull 24 db-os karton.
|-
|-
! quantity
! quantity
Line 3,132: Line 3,157:
| IGEN
| IGEN
| text
| text
| A termék mértékegysége amelyben a látogató látta.(pl. db, kg, L).
| A termék mértékegysége, amelyben a látogató látta azt (pl. db, kg, L).
|-
|-
! unitPrice
! unitPrice
Line 3,182: Line 3,207:
| NEM
| NEM
| text
| text
| A város teljes neve amit a látogató megad.
| A város teljes neve, amit a látogató megad.
|-
|-
! country
! country
Line 3,212: Line 3,237:
| NEM
| NEM
| text
| text
| A látogató utcája melyben megadható a házszáma és egyéb részletek is.
| A látogató utcája, melyben megadható a házszáma és egyéb részletek is.
|-
|-
! street2
! street2
| NEM
| NEM
| text
| text
| A cím folytatása ha fentiben nem férne el.
| A cím folytatása, ha fentiben nem férne el.
|-
|-
! zipCode
! zipCode
Line 3,235: Line 3,260:
| _custom
| _custom
| any típus
| any típus
| Amennyiben az előredefiniá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 alulvonással kell kezdődnie.
| 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.
|}
|}



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: