CCV Shop konverziókövetés: beállítási útmutató

A CCV Shop konverziókövetése azt jelenti, hogy a CCV Shop webáruházad minden kifizetett rendelését jelented a hirdetési platformoknak, például a Metának és a TikToknak, hogy a megfelelő hirdetéseknek tulajdonítsák az eladásokat, és valódi eladásokra optimalizáljanak. A legteljesebb módszer, ha minden vásárlást a CCV rendelési adataiból, a szerveren keresztül küldesz el, és a rendelés-visszaigazoló oldalra felteszel egy rövid kódrészletet, amely a rendelést a hirdetési kattintáshoz köti.

A CCV Shop a holland CCV cég hosztolt webáruház-platformja, amely szerint 17,000 webáruházat működtet. Ez az útmutató elmagyarázza, hogyan kapcsolódik hozzá a ROASaurus, hogyan kötődnek a rendelések a hirdetési kattintásokhoz, mi jut el a Metához és a TikTokhoz, a beállítást, a tesztelést, és hogyan működnek a késői fizetések. Az általános elképzelésért olvasd el a mi a szerveroldali követés című útmutatót.

Hogyan kapcsolódik a ROASaurus a CCV Shophoz?

A ROASaurus a CCV Shop három részét használja, mindegyik le van írva a CCV API-dokumentációjában:

Miért nem látják a böngészőpixelek a CCV Shop vásárlásait?

A böngészőpixel csak akkor jelent vásárlást, ha a vásárló böngészője betölti a rendelés-visszaigazoló oldalt, és a pixelszkript lefut. Ezt több gyakori helyzet megszakítja:

• A vásárló átirányítással fizet, például iDEAL-lal, és bezárja a lapot, mielőtt a visszaigazoló oldal betöltődne.
• Egy reklámblokkoló vagy a böngésző adatvédelmi beállítása blokkolja a pixelszkriptet.
• A látogató elutasítja a marketingsütiket, ezért a pixel nem töltődhet be.
• A rendelést később fizetik ki, átutalással vagy átvételkor, amikor nincs bevonva böngésző.

Mindegyik esetben a CCV Shop kifizetettnek jelöli a rendelést. A ROASaurus a szerverről küldi el ezt a rendelést, így a vásárlás attól függetlenül jelentésre kerül, hogy mi történt a böngészőben. A visszaigazoló oldalon lévő kódrészletnek más a feladata: megmondja a ROASaurusnak, melyik látogatóhoz, és így melyik hirdetési kattintáshoz tartozik a rendelés.

A rendelés kifizetése webhook és az 5 perces ellenőrzés

Mit csinál a Create webhook

Amikor megnyomod a Create webhook gombot, a ROASaurus regisztrál egy CCV webhookot az orders.updated.ispaid eseményre, amelyet a CCV akkor vált ki, amikor egy rendelés kifizetett tulajdonsága megváltozik. A cím a webáruházad webhook URL-je a ROASaurusban, amely tartalmazza a store key-t és egy privát tokent. A CCV semmit sem ad a webhookhoz, ami azonosítaná a webáruházat, a dokumentációja pedig azt javasolja, hogy a címbe kerüljön egy azonosító. Ezt a feladatot a store key látja el.

A CCV minden webhookhoz külön 32 karakteres titkos kulcsot ad. Amikor a CCV visszaadja ezt a kulcsot, a ROASaurus elmenti, és attól kezdve minden kézbesítésnek érvényes x-hash fejlécet kell hordoznia. Minden kézbesítésnek a webáruházad tokenjét is tartalmaznia kell. Amikor a ROASaurus megkap egy kézbesítést, figyelmen kívül hagyja a ki nem fizetett rendeléseket, az API-ból beolvassa a teljes rendelést és a rendelési sorokat, és csak akkor küldi el a rendelést, ha a CCV szerint kifizetett.

Aláírt API-hívások

A CCV minden API-hívás aláírását megköveteli. A ROASaurus három fejlécet küld: az x-public a nyilvános kulcsoddal, az x-date az aktuális idővel, és az x-hash. A CCV elutasítja azt az időbélyeget, amely több mint 5 perccel tér el a szerver idejétől. A titkos kulcsodat magát sosem küldjük el.

API call (ROASaurus → CCV)
x-hash = HMAC-SHA512( public_key|METHOD|uri|body|timestamp , secret_key )

Webhook (CCV → ROASaurus)
x-hash = HMAC-SHA512( address|payload , webhook_key )

Az 5 perces ellenőrzés

A ROASaurus 5 percenként a CCV-től is lekéri az utolsó ellenőrzés óta létrehozott, kifizetett rendeléseket, 30 perc átfedéssel, és rögzíti azokat, amelyek még nincsenek meg. A CCV a rendeléseket csak a létrehozás dátuma szerint szűri. Így az ellenőrzés azokat a rendeléseket találja meg, amelyeket a leadás után hamar kifizetnek, a napokkal később kifizetett rendelés pedig csak a webhookon keresztül jut el a ROASaurushoz.

A CCV a 200, 201, 202 vagy 204 választ sikernek tekinti. A kézbesítést nyitva tartja, és 307, 408, 503 vagy 504 válasz után a következő előfordulásnál újra megpróbálja, minden más választ pedig sikertelennek jelöl. A kapcsolatra 2 másodpercet, a válaszra 5 másodpercet vár.

Hogyan kapcsolódik egy CCV Shop-rendelés a hirdetési kattintáshoz?

Ahhoz, hogy a platform egy hirdetésnek tulajdoníthasson egy rendelést, szüksége van a rendelő látogató kattintásazonosítóira, például a Meta kattintásazonosítójára (fbc) és a TikTok kattintásazonosítójára (ttclid). A ROASaurus szkriptje minden látogatónál eltárolja ezeket, amikor hirdetésből érkezik. A ROASaurus nem a CCV-rendelésből kapja ezt a látogatóazonosítót, ezért más módokon köti a rendeléseket a látogatókhoz:

A ROASaurus röviden vár, mielőtt elküld egy vásárlást, hogy a visszaigazoló oldal eseménye érkezhessen előbb, és küldéskor újra megpróbálja a párosítást. Az Orders oldal rendelésenként mutatja az eredményt a Matched by oszlopban: thank_you, email vagy not matched.

Egy nem párosított rendelés is elmegy a hirdetési platformokhoz a rendelésből származó hashelt ügyféladatokkal. Nincsenek kattintásazonosítói, és mivel a CCV-rendelések nem hordoznak IP-címet vagy böngészőt, ezek sincsenek meg. Ez csökkenti azoknak az eseményeknek az arányát, amelyeket a Meta személyhez tud párosítani; az Event Match Quality elmagyarázza, hogyan pontozza ezt a Meta. A ROASaurus attribúciójában egy nem párosított rendelés közvetlenként vagy ismeretlenként jelenik meg.

Mi jut el a Metához és a TikTokhoz egy CCV-rendelésből?

A Meta a Conversions API-ján keresztül egy Purchase eseményt kap, a TikTok pedig az Events API-ján keresztül egy CompletePayment eseményt, mindkettőt order-58213 eseményazonosítóval. A TikTok a riportjaiban ma már Purchase-ként mutatja a CompletePayment eseményt. Ha bejelölöd a böngészős pixel betöltésének opcióját is, a visszaigazoló oldal kódrészlete ugyanezeket az eseményeket a böngészőben is elküldi, ugyanazzal az eseményazonosítóval, és a Meta és a TikTok egyetlen példányt tart meg. Ugyanezek a rendelések a Snapchathez, a Pinteresthez, a Reddithez, az X-hez, a Microsoft Adshez, a Taboolához, a LinkedInhez és a többi hirdetési platformhoz is eljutnak, ha csatlakoztatod őket. A Google Ads vásárlási konverziói csak a Shopify pénztárából mennek el, ezért a ROASaurus a CCV Shopból nem küldi őket.

Hogyan állítsd be a CCV Shop konverziókövetést

1. Add hozzá a webáruházat a ROASaurusban

   Nyisd meg az Add a store oldalt, válaszd a CCV Shopot, és add meg a webáruházad címét. A Connection fül ezután megmutatja a szkriptcímkédet és a visszaigazoló oldal kódrészletét.

2. Keresd meg az API-kulcsaidat

   A CCV Shopban nyisd meg a My webshop › Settings › General › API settings menüt, és kattints a New API key gombra. Ha nem látod, előbb telepítsd az API appot a CCV App Store-ból.

3. Add hozzá a szkriptet minden oldalhoz

   Illeszd be a szkriptcímkét a webáruházad Header HTML mezőjébe. A CCV súgóközpontja ezt a Mijn webshop › Instellingen › Lay-out › Layout alatt helyezi el, az oldal alján. Egy app kódblokkja a fejlécben szintén működik.

4. Add hozzá a kódrészletet a visszaigazoló oldalhoz

   Menj ide: Mijn webshop › Instellingen › Algemeen › Teksten, nyisd meg a rendelés leadása után megjelenő szöveget, váltsd át Source nézetre, és illeszd be oda a kódrészletet. A CCV Shop ezután a rendelés-visszaigazoló oldalon futtatja.

5. Csatlakoztasd az API-t

   A Connection fülön add meg a nyilvános kulcsot és a titkos kulcsot. A Shop URL mezőt csak akkor töltsd ki, ha az API-d a webáruházadtól eltérő domainen fut. Mentsd, nyomd meg a Test connection gombot, majd a Create webhook gombot.

6. Csatlakoztasd a hirdetési platformjaidat

   A Tracking & platforms oldalon használd a Connect with Facebook vagy az Add pixel opciót a Metához, a TikTokhoz pedig az Add pixel opciót. Jelöld be a böngészőpixel egyidejű betöltésének opcióját.

Hozzájárulás

A Shopifyon kívül a ROASaurus script a látogató döntését a gyakori hozzájárulás-kezelő eszközökből olvassa ki: Cookiebot, OneTrust, IAB TCF bannerek és Google consent mode. Más sütibanner esetén hívd meg a tlq('consent', true) függvényt, amikor a látogató elfogadja a marketingsütiket, és a tlq('consent', false) függvényt, amikor elutasítja. Amíg a látogató nem fogadja el, nincs látogatóazonosítója vagy kattintásazonosítója, és nem fut böngészőpixel. A kifizetett rendelést ettől még elküldi a szerver a rendelés hashelt ügyféladataival. A részleteket a hozzájárulásról szóló súgóoldal tartalmazza.

Hogyan teszteled a CCV Shop konverziókövetést?

• Nyisd meg a webáruházadat úgy, hogy a címhez hozzáadod a ?roasaurus=connected paramétert. Egy felugró üzenet megerősíti, hogy a szkript fut. A ?roasaurus=debug a böngészőkonzolba naplózza, mit küld el.
• Az Event log Collected events részében az oldalmegtekintéseknél látnod kell egy látogatóazonosítót.
• Adj le egy rendelést és fizesd ki, vagy jelöld kifizetettnek. A Collected events alatt az Event lognak egy Purchase eseményt kell mutatnia a CCV rendelésazonosítóval az adataiban. Ha hiányzik, a visszaigazoló oldal kódrészlete nem futott le.
• A Connection fülön a Last order received mutatja a rendelést, a Last sync pedig az utolsó 5 perces ellenőrzést, a CCV esetleges hibájával együtt.
• Az Event log Server deliveries részében minden csatlakoztatott platform kap egy sort a sent státusszal és a platform válaszával.

Hogy lásd az eseményt a Metában, illeszd be az Events Manager › Test events alatt található kódot a Meta pixeled Test event code mezőjébe a ROASaurusban, és távolítsd el, ha végeztél.

Késői fizetések és egyéb korlátok

Az átutalással és utánvéttel fizetett rendeléseket a leadás után fizetik ki. Íme, mi történik egy példa átutalásos rendeléssel a leadás napjától:

• Utánvét. A ROASaurus akkor küldi el ezeket a rendeléseket, amikor a CCV kifizetettnek jelöli őket, általában a kézbesítés után. Az utánvétes követésnél olvashatsz arról, hogy mikor számítsd be az ilyen rendeléseket.
• Böngészős vásárlások a fizetés előtt. A visszaigazoló oldal kódrészlete a rendelés leadásakor fut le, így a böngészőpixelek már a kifizetés előtt jelentik az átutalásos rendelést. Ha a fizetés több mint 48 órával később érkezik, a Meta és a TikTok nem tudja összevonni a böngészős és a szerveroldali példányt.
• Nincs IP-alapú tartalékmegoldás. Add hozzá a visszaigazoló oldal kódrészletét, és ahol tudod, gyűjts e-mail-címeket az oldaladon korábban.
• A lemondásokat és visszatérítéseket nem küldjük el. Ha egy vásárlást egyszer elküldtek, az a hirdetési platformon marad.
• Kód nélkül csak oldalmegtekintések. A termékmegtekintéseket és a kosárba tételeket csak Shopifyon észleljük automatikusan. A CCV Shopon egy fejlesztő küldheti el őket egy tlq track hívással.

A CCV Shop-integráció oldala egy helyen sorolja fel a kapcsolat tudnivalóit, a más webáruházakról szóló súgóoldal pedig összeveti a CCV Shopot a többi platformmal, amelyekhez a ROASaurus csatlakozik, például a Lightspeeddel.

Források

1. CCV Shop: API Documentatie
2. CCV: Webshop API
3. Meta for Developers: Server Event Parameters
4. Meta for Developers: Handling Duplicate Pixel and Conversions API Events
5. TikTok Ads Manager: About Event Deduplication

A ROASaurusban

• CCV Shop-integráció
• Súgó: Wix, Lightspeed és más webáruházak
• Szerveroldali követés
• Meta integráció

Olvass tovább