- Shopifyon a szerveroldali követés minden vásárlást abból a kifizetett rendelésből küld el, amelyet a Shopify webhookon jelent, így nem függ attól, hogy a köszönőoldal betöltődik-e.
- A látogatóazonosítót és a hirdetési kattintásazonosítókat kosárattribútumként mentjük el, így a Shopify átmásolja őket a rendelésre, és a rendelés párosítható a kattintással.
- A böngészős és a szerveroldali esemény egy, a rendelésazonosítóból épített eseményazonosítót használ, így a Meta, a TikTok, a Snapchat, a Pinterest és a Reddit minden vásárlást egyszer számol.
- Ha a Respect visitor consent be van kapcsolva, az a látogató, aki elutasítja a marketingsütiket, nem kap látogatóazonosítót, és a böngészős eseményeit nem küldjük el a hirdetési platformoknak, de a kifizetett rendelést ettől még elküldjük a rendelés hashelt ügyféladataival.
- A beállítás a ROASaurusban négy fő lépésből áll: telepítsd az alkalmazást, kapcsold be a theme app embedet, add hozzá a pénztári pixelt, és csatlakoztasd a hirdetési platformjaidat.
A szerveroldali követés Shopifyon azt jelenti, hogy minden vásárlás a webáruházad rendelési adataiból jut el a Metához, a TikTokhoz és más hirdetési platformokhoz, egy szerver küldi, és nem csak a vásárló böngészőjében futó pixel. A Shopify webhookon jelent minden kifizetett rendelést a követőalkalmazásnak, az alkalmazás pedig elküldi azt az egyes platformok conversions API-jának, párosítva a vásárlót odavezető hirdetési kattintással.
Ez az útmutató a folyamat Shopify-specifikus részeit tárgyalja: a theme app embedet és az app proxyt, a pénztári pixeleket, az orders/paid webhookot, a rendelések párosítását, a deduplikációt, a hozzájárulást és a beállítást a ROASaurusban. Az alapötlethez előbb olvasd el ezt: mi a szerveroldali követés.
Hogyan működik a szerveroldali követés Shopifyon
A kattintás és a vásárlás különböző pillanatokban és különböző helyeken történik. A kattintás csak a böngészőben látszik, a landing oldalon. A kifizetett rendelés csak a Shopify oldalán biztos, amikor a fizetés beszedésre kerül. A szerveroldali követés rögzíti az elsőt, megvárja a másodikat, és összekapcsolja őket.
A Shopify elemei: app embed, app proxy, pixelek és webhookok
Egy Shopify webáruház négy helyet kínál egy követőalkalmazásnak a működéshez. Mindegyiknek más a feladata, és egy teljes beállítás mind a négyet használja.
| Elem | Hol fut | Mit csinál |
|---|---|---|
| Theme app embed | Minden webáruházi oldal | Betölti a követőscriptet, beolvassa a hirdetési kattintásazonosítókat, és elmenti a látogatóazonosítót a kosáron |
| App proxy | Egy útvonal a saját webáruház-domainen | First-party kérésekként fogadja a webáruház eseményeit |
| Customer events (pixelek) | Pénztár és köszönőoldal | Jelenti a pénztári lépéseket és a befejezett pénztárat egy sandboxból |
| Rendelés-webhookok | A Shopify szerverei | A rendelést az alkalmazásnak küldi, amikor létrejön, és amikor kifizetik |
A theme app embed és az app proxy
A theme app embed egy blokk, amelyet egy alkalmazás ad a sablonodhoz. A sablonszerkesztőben kapcsolod be, így nem kell kódot beillesztened. A ROASaurus embed minden oldalon betölt egy scriptet. A landing oldalon beolvassa a kattintásazonosítókat, például az fbclid-et, a ttclid-et és a gclid-et, valamint az UTM-paramétereket, és egy first-party látogatóazonosítóval együtt tárolja őket.
A script az eseményeit a Shopify app proxyján keresztül küldi. Az app proxy a saját domainedén lévő útvonalról, például a yourstore.com/apps/roasaurus címről érkező kéréseket továbbítja az alkalmazás szerverére. A böngésző számára ez a saját oldaladnak küldött kérés, ami segíthet az ismert követési domaineket blokkoló reklámblokkolók ellen. A Shopify eltávolítja a Cookie fejlécet az app proxy kéréseiből és a Set-Cookie fejlécet a válaszokból, ezért a látogatóazonosító magában az eseményben utazik, nem sütiben.
Customer events és pixelek a pénztárban
A Shopify pénztárában a követőscriptek pixelként futnak egy sandboxban, nem magában az oldalban. A Settings › Customer events alatt kezeled őket. Kétféle van. Az app pixelek egy alkalmazással érkeznek, és szigorú sandboxban futnak. A custom pixeleket a kereskedő adja hozzá, és kevésbé szigorú sandboxban futnak, amely harmadik féltől származó scripteket, például a Meta pixelt is betöltheti.
A ROASaurus mindkettőt használja. Az app pixele az alkalmazás telepítésekor bekapcsol. Jelenti a pénztár megkezdését, az elérhetőségi lépést és a befejezett pénztárat a ROASaurusnak. Az opcionális custom pixel hozzáadja a pénztárhoz a Meta, a TikTok, a Snapchat, a Pinterest és a Reddit böngészőpixeleit, és Google Ads konverziókat küld.
Rendelés-webhookok
A webhook egy üzenet, amelyet a Shopify egy alkalmazásnak küld, amikor valami történik a webáruházban. A ROASaurus többek között az orders/paid és az orders/create eseményekre iratkozik fel. A webhookban lévő rendelés tartalmazza a rendelésazonosítót, az értéket, a tételeket, a vásárlói adatokat, a kosár- és pénztártokeneket, a kosárattribútumokat, valamint azt az IP-címet és böngészőt, amelyről a rendelést leadták. A Shopify szervereiről érkezik, ezért egy reklámblokkoló vagy egy bezárt lap nem állíthatja meg.
Hogyan párosítjuk a rendeléseket a hirdetési kattintásokkal
A webhook azt jelzi a ROASaurusnak, hogy egy rendelést kifizettek. Hogy hasznos konverziót küldhessen, a ROASaurusnak azt is tudnia kell, melyik látogató adta le a rendelést, mert a látogatói rekord tartalmazza a kattintásazonosítókat. Ezeket a kapcsolatokat sorrendben próbálja ki, a legközvetlenebbtől a legkevésbé közvetlenig:
| Módszer | Hogyan működik | Mikor használja |
|---|---|---|
| Kosárattribútum | A script a látogatóazonosítót és az fbc, fbp, ttp, gclid és ttclid értékeket kosárattribútumként írja. A Shopify átmásolja őket a rendelésre. | Első választás |
| Kosár- és pénztártokenek | A script a kosártokent a látogatóhoz köti, a pénztári pixel pedig a pénztártokent. A webhook mindkét tokent hordozza. | Ha a kosárattribútum hiányzik |
| Pénztári esemény | A pénztári pixel a befejezett pénztárat a rendelésazonosítóval és a látogatóazonosítóval jelenti. | Ha egyik token sem egyezik |
| E-mail-cím | Egy olyan látogató hashelt e-mail-címe, aki korábban megadta, például a pénztár elérhetőségi lépésénél. | Ha nincs pénztári esemény |
| IP-cím és böngésző | Egy látogató, akit ugyanazzal az IP-címmel és böngészővel láttak röviddel a rendelés előtt. | Csak akkor, ha pontosan egy látogató illik rá |
A kosárattribútumok az oka annak, hogy a párosítás Shopifyon közvetlen. Kulcs-érték párok, amelyeket a kosáron tárolnak, és a Shopify átmásolja őket a rendelésre. A termékoldalon beírt érték még akkor is ott van, amikor a webhook megérkezik, ha a vásárló korán bezárta a köszönőoldalt.
Egy kivétel: a gyorsított fizetési gombok, például a Buy it now, kihagyják a kosarat. A ROASaurus azt javasolja, hogy kapcsold ki őket, hogy az Add to cart mindig követve legyen. Az ezeken keresztül leadott rendelések a pénztártokenen keresztül még így is párosíthatók.
Egy rendelés, elejétől a végéig
Íme, mi történik egyetlen, egy Meta-hirdetésből érkező rendelésnél, telepített custom pixellel:
page_view ?fbclid=IwAR2x…Egy vásárló Meta-hirdetésből érkezik. A kattintásazonosítót a 3f2a látogatóhoz tárolja a rendszer.cart _tl=3f2a _tl_fbc=fb.1.…A látogatóazonosító és a Meta kattintási értéke kosárattribútumként elmentődik.checkout_started ic-c1a9…A pénztártoken ugyanahhoz a látogatóhoz kapcsolódik.checkout_completed order-6123456789012A pénztári pixel jelenti a rendelést, a Meta pixel pedig ezzel az eseményazonosítóval küldi a Purchase-t.orders/paid #1042 id 6123456789012 $86.00A Shopify webhookon elküldi a kifizetett rendelést.Meta CAPI Purchase order-6123456789012Egy rövid várakozás után a szerveroldali esemény elmegy a kattintásazonosítókkal, az IP-címmel és a user agenttel.Mikor megy el a vásárlás: orders/paid vagy orders/create
Hogy melyik webhook váltja ki a vásárlást, attól függ, hogyan fizetnek a vásárlóid. Ezt a Store settings oldalon a pénztár típusaként választod ki.
| Pénztár típusa | Webhook | Mikor megy el a vásárlás |
|---|---|---|
| Shopify checkout | orders/paid | Amikor a rendelést kifizetik. A soha ki nem fizetett rendeléseket nem küldjük el. |
| External / COD checkout | orders/create | Amikor a rendelés létrejön. Utánvétnél, valamint az olyan pénztáraknál, mint a Checkify és a CheckoutChamp, amelyek Shopify-rendeléseket hoznak létre. |
A ROASaurus minden vásárlást rövid ideig visszatart a webhook megérkezése után. Ez alatt a böngészőből érkező befejezett pénztári esemény általában szintén megérkezik. Az oldal URL-je, IP-címe és user agentje ekkor hozzáadódik a szerveroldali eseményhez, a látogatói rekord kattintásazonosítói mellett. A Shopify által tesztrendelésként megjelölt rendeléseket rögzítjük, de nem küldjük el a hirdetési platformoknak.
Hogyan működik a deduplikáció a böngészőpixelekkel
Amikor a böngészőpixelek a szerveroldali események mellett futnak, a platform minden vásárlást kétszer kap, és csak egyet szabad megtartania. Ezt az eseményazonosítóval teszi. A ROASaurus egy vásárlás mindkét példányának ugyanazt az azonosítót adja, amelyet a Shopify rendelésazonosítójából épít: order-6123456789012 a 6123456789012 azonosítójú rendeléshez. Ez a hosszú szám a rendelés admin URL-jében szerepel, nem a rendelés neve, például #1042. A pénztári pixel ezt használja a böngészős Purchase-höz, a szerver pedig a conversions API eseményhez. A Meta például egy példányt tart meg, ha az eseménynév és az eseményazonosító egyezik, és mindkettő 48 órán belül megérkezik.
| Platform | A ROASaurus böngészőpixele | Deduplikálva a szerveroldali eseménnyel |
|---|---|---|
| Meta, TikTok, Snapchat, Pinterest, Reddit | Webáruház és pénztár | Igen |
| X, Microsoft Advertising, Taboola | Egyik sem, csak szerveroldali események | Nincs mit egyesíteni |
| Google Ads | Csak a pénztár, a custom pixelen keresztül | Egyszer megy el, a pénztárból |
Az eseményazonosító csak az azt hordozó események között működik. Ha egy másik alkalmazás ugyanazt a pixelt küldi, annak eseményeinek saját azonosítóik vannak, és a platform a rendelést újra beszámolja. Shopifyon a szokásos okok: ugyanahhoz a pixelhez csatlakoztatott Facebook & Instagram csatorna, a TikTok alkalmazás, és a theme.liquid fájlba beillesztett pixelkód. A duplikált vásárlási eseményekről szóló útmutatónk megmutatja, hogyan találhatod meg őket, a dupla számolás megelőzése pedig felsorolja a javításokat.
Hozzájárulás a Shopify Customer Privacy API-ján keresztül
A Shopify Customer Privacy API-ja tárolja az egyes látogatók sütibeállítását. A cookie-bannered tölti ki, akár a Shopify saját bannerét használod, akár egy, az API-hoz csatlakoztatott hozzájárulás-kezelő alkalmazást. A scriptek és pixelek ezután megkérdezhetik tőle, hogy engedélyezett-e a marketing az adott látogatónál.
Ha a Respect visitor consent be van kapcsolva, ami a Store settings alapértelmezett értéke, a ROASaurus webáruházi scriptje és pénztári pixelei lekérdezik az API-t, mielőtt követnének.
- Eltárolódik egy látogatóazonosító, a kattintásazonosítók és a böngészési események
- A böngészőpixelek betöltődnek, és eseményeket küldenek
- A kifizetett rendelés szerveroldalon elmegy, és párosítva van a hirdetési kattintással
- Nem kap látogatóazonosítót, így a látogatásai és a hirdetési kattintásai nem kapcsolódnak hozzá
- A böngészős eseményeket látogatóazonosító, IP-cím és böngészőadatok nélkül tároljuk, és nem küldjük el a hirdetési platformoknak
- A kifizetett rendelést ettől még szerveroldalon elküldjük a rendelés hashelt ügyféladataival, valamint a rendelés IP-címével és user agentjével
- A hirdetési platformhoz eljutó esemény nem hordoz kattintásazonosítót
Az e-mail-címeket, telefonszámokat, neveket és címeket SHA-256-tal hasheljük, mielőtt elküldjük őket egy hirdetési platformnak. Még három részlet számít:
- A bannered dönt. A ROASaurus azt követi, amit az API jelent. Ha az API nem érhető el az oldalon, a ROASaurus úgy kezeli a látogatót, mintha hozzájárult volna, ezért ellenőrizd, hogy a bannered csatlakozik-e hozzá.
- A landing oldal a rendelésen marad. A Shopify minden rendelésnél eltárolja a landing oldal címét, és ez tartalmazhat kampánycímkéket és kattintásazonosítókat. A ROASaurus a saját attribúciós riportjaiban használja, az elutasító látogatóknál is, és nem küldi el a hirdetési platformoknak.
- A rendelés elküldése jogi döntés. Az, hogy egy elutasító látogató kifizetett rendelését egyáltalán el szabad-e küldeni, jogi kérdés a webáruházad számára.
A Consent Mode v2 és a GDPR útmutatónk magas szinten elmagyarázza a szabályokat, a hozzájárulás és adatvédelem oldal pedig a részleteket tartalmazza.
Hogyan állítsd be a szerveroldali követést Shopifyon a ROASaurusban
A beállítási lépéseket ebben a sorrendben végezd el:
- Telepítsd az alkalmazást
Nyisd meg az Add a store oldalt, válaszd a Shopifyt, add meg a
.myshopify.comdomaint, és kattints az Install app gombra. Hagyd jóvá az alkalmazást a Shopifyban. A ROASaurus regisztrálja a rendelés-webhookokat, és bekapcsolja az app pixelét. - Kapcsold be a theme app embedet
A Tracking & platforms oldalon kattints az Open theme editor gombra, kapcsold be a ROASaurus app embedet, és mentsd el.
- Add hozzá a pénztári pixelt
A Shopify adminban lépj a Settings › Customer events oldalra, és adj hozzá egy ROASaurus nevű custom pixelt. Állítsd az engedélyét Not required értékre, mert a ROASaurus script maga ellenőrzi a látogató marketingválasztását. Illeszd be a Tracking & platforms oldalról a snippetet. Erre a pixelre a pénztári böngészőpixelekhez és a Google Adshez van szükséged.
- Csatlakoztasd a hirdetési platformjaidat
A Tracking & platforms oldalon kattints az Add pixel gombra minden platformnál, vagy a Connect with Facebook gombra a Metához. Hagyd bekapcsolva azt az opciót, amely a böngészőpixelt is betölti, ha deduplikált böngészős eseményeket szeretnél.
- Ellenőrizd a webáruház beállításait
A Store settings oldalon válaszd ki a pénztár típusát, és tartsd bekapcsolva a Respect visitor consent beállítást, ha olyan helyen értékesítesz, ahol hozzájárulás szükséges.
- Távolítsd el a többi küldőt
A Facebook & Instagram csatornában távolítsd el ezt a pixelt az adatmegosztási beállításokból. Az adatmegosztási szint csökkentése nem elég, mert minden szint, a Standardot is beleértve, elküldi a Meta pixelt a böngészőből. Ha a TikTok alkalmazás ugyanazt a pixelt küldi, ott is állítsd le, és távolítsd el a pixelkódot a sablonodból.
A custom pixel snippet így néz ki. Másold ki a Tracking & platforms oldalról, ahol a webáruházkulcsod már ki van töltve. A Shopify beállítási útmutatóban ugyanezek a lépések szerepelnek.
self.tl = this; document.head.appendChild(document.createElement('script')).src = 'https://app.roasaurus.com/c.js?k=YOUR_STORE_KEY';Hogyan ellenőrizd, hogy működik
Teszteld egyetlen valódi rendeléssel, mielőtt a számokra hagyatkozol:
- Nyisd meg a webáruházadat úgy, hogy az URL végén szerepel a
?roasaurus=connected. Egy üzenet megerősíti, hogy a script él. - A Metához illeszd be az Events Manager › Test events alatti kódot a pixel Test event code mezőjébe.
- Adj le egy valódi, alacsony árú rendelést, és utána térítsd vissza. A Shopify tesztrendelések nem kerülnek elküldésre.
- Az Event log oldalon a rendelés szerveroldali kézbesítése minden platformnál sent állapotban jelenik meg, a platform válaszával.
- A platform tesztnézetében ellenőrizd, hogy a böngészős és a szerveres Purchase ugyanazt az eseményazonosítót használja: az
order-előtagot és a Shopify rendelésazonosítóját. - Utána töröld a teszteseménykódot.
Amit a szerveroldali követés Shopifyon nem javít meg
- Elutasított hozzájárulás. Azoknak a látogatóknak a rendelései, akik elutasították a marketingsütiket, elmennek, de kattintásazonosító nélkül, ezért a hirdetési platformok rosszabbul párosítják őket.
- A Safari sütikorlátai. Az a vásárló, aki 7 napnál később tér vissza, új látogatónak tűnhet. A first-party követési aldomain a gyűjtést a saját domaineden tartja, de a Safari ezeket a sütiket is 7 napra korlátozhatja.
- Attribúciós különbségek. Minden hirdetési platform a saját attribúciós ablakai és modelljei szerint írja jóvá az eladásokat. Ha a csatornákat egyetlen szabályrendszerrel akarod összehasonlítani, használd a saját attribúciódat.
- Más alkalmazások ugyanazon a pixelen. Az eseményazonosítók csak azokat az eseményeket vonják össze, amelyek ugyanazt az azonosítót használják.
Azt javítja meg, amikor a vásárlás megtörtént, de nem jutott el a hirdetési platformhoz, mert a böngészős esemény elveszett. Hogy a ROASaurus mit küld az egyes platformoknak, azt a szerveroldali követés és a Shopify-integráció oldalán láthatod.
Források
- Shopify: Customer Privacy API
- Shopify: Authenticate app proxies
- Shopify Help Center: Manage your custom pixels
- Shopify Help Center: Facebook data sharing
- Meta: Handling Duplicate Pixel and Conversions API Events
A ROASaurusban
- Súgó: a ROASaurus beállítása Shopifyon
- Shopify integráció
- Szerveroldali követés a ROASaurusban
- Súgó: hozzájárulás és adatvédelem