Praćenje konverzija za CCV Shop: vodič za postavljanje

Praćenje konverzija za CCV Shop znači prijavljivanje svake plaćene narudžbe u vašoj CCV Shop web-trgovini oglasnim platformama poput Mete i TikToka, kako bi pripisale prave oglase i optimizirale prema stvarnoj prodaji. Najpotpuniji način je slati svaku kupnju iz CCV-ovih podataka o narudžbi na poslužitelju te na stranicu uspješne narudžbe dodati kratak isječak koda koji povezuje narudžbu s klikom na oglas.

CCV Shop je hostirana platforma za web-trgovine nizozemske tvrtke CCV, koja navodi da pokreće 17,000 web-trgovina. Ovaj vodič objašnjava kako se ROASaurus povezuje s njom, kako se narudžbe povezuju s klikovima na oglase, što stiže na Meta i TikTok, postavljanje, testiranje i kako funkcioniraju kasna plaćanja. Za opću ideju pročitajte što je praćenje na strani poslužitelja.

Kako se ROASaurus povezuje s CCV Shopom?

ROASaurus koristi tri dijela CCV Shopa, a svi su opisani u CCV-ovoj API dokumentaciji:

Zašto pikseli preglednika propuštaju kupnje u CCV Shopu?

Piksel preglednika prijavljuje kupnju samo kada preglednik kupca učita stranicu uspješne narudžbe i pokrene se skripta piksela. Nekoliko čestih situacija to prekida:

• Kupac plaća preusmjeravanjem, na primjer putem iDEAL-a, i zatvori karticu prije nego što se učita stranica uspješne narudžbe.
• Blokator oglasa ili postavka privatnosti preglednika blokira skriptu piksela.
• Posjetitelj odbije marketinške kolačiće, pa se piksel ne smije učitati.
• Narudžba se plaća kasnije, bankovnim prijenosom ili pri isporuci, kada preglednik nije uključen.

U svakom od tih slučajeva CCV Shop narudžbu i dalje označava kao plaćenu. ROASaurus tu narudžbu šalje s poslužitelja, pa se kupnja prijavljuje bez obzira na to što se dogodilo u pregledniku. Isječak na stranici uspješne narudžbe ima drugačiji zadatak: govori ROASaurusu kojem posjetitelju, a time i kojem kliku na oglas, narudžba pripada.

Webhook za plaćenu narudžbu i petominutna provjera

Što radi Create webhook

Kada pritisnete Create webhook, ROASaurus registrira CCV webhook za događaj orders.updated.ispaid, koji CCV pokreće kada se promijeni svojstvo plaćenosti narudžbe. Adresa je URL webhooka vaše trgovine u ROASaurusu, koji sadrži ključ vaše trgovine i privatni token. CCV webhooku ne dodaje ništa što identificira trgovinu, a njegova dokumentacija savjetuje da se identifikator stavi u adresu. Ključ trgovine to radi.

CCV svakom webhooku daje vlastiti tajni ključ od 32 znaka. Kada CCV vrati taj ključ, ROASaurus ga sprema i od tada svaki poziv mora nositi valjano zaglavlje x-hash. Svaki poziv mora nositi i token vaše trgovine. Kada ROASaurus primi poziv, zanemaruje narudžbe koje nisu plaćene, iz API-ja čita cijelu narudžbu i njezine stavke te narudžbu šalje samo kada CCV kaže da je plaćena.

Potpisani API pozivi

CCV zahtijeva da se svaki API poziv potpiše. ROASaurus šalje tri zaglavlja: x-public s vašim javnim ključem, x-date s trenutnim vremenom i x-hash. CCV odbija vremensku oznaku koja se od vremena njegova poslužitelja razlikuje više od 5 minuta. Sam vaš tajni ključ nikad se ne šalje.

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 )

Provjera svakih 5 minuta

ROASaurus svakih 5 minuta također pita CCV za plaćene narudžbe stvorene od posljednje provjere, uz preklapanje od 30 minuta, i bilježi one koje još nema. CCV narudžbe filtrira samo prema datumu stvaranja. Zato provjera pronalazi narudžbe plaćene ubrzo nakon zaprimanja, a narudžba plaćena danima kasnije do ROASaurusa stiže samo putem webhooka.

CCV kao uspjeh broji odgovor 200, 201, 202 ili 204. Poziv ostavlja otvorenim i ponavlja ga pri sljedećem pojavljivanju nakon odgovora 307, 408, 503 ili 504, a svaki drugi odgovor označava kao neuspješan. Čeka 2 sekunde na vezu i 5 sekundi na odgovor.

Kako se narudžba iz CCV Shopa povezuje s klikom na oglas?

Da bi pripisala oglas, platformi trebaju identifikatori klikova posjetitelja koji je naručio, kao što su Metin ID klika (fbc) i TikTokov ID klika (ttclid). ROASaurus skripta sprema ih za svakog posjetitelja kada dođe s oglasa. ROASaurus ID posjetitelja ne dobiva iz CCV narudžbe, pa narudžbe s posjetiteljima povezuje na druge načine:

ROASaurus kratko pričeka prije slanja svake kupnje, pa događaj sa stranice uspješne narudžbe može stići prvi, a povezivanje pokušava ponovno pri slanju. Stranica Orders prikazuje rezultat po narudžbi u stupcu Matched by: thank_you, email ili not matched.

Narudžba koja nije povezana i dalje odlazi na vaše oglasne platforme s hashiranim podacima o kupcu iz narudžbe. Nema identifikatora klikova, a budući da CCV narudžbe ne nose IP adresu ni preglednik, nema ni njih. To smanjuje udio događaja koje Meta može povezati s osobom; Event Match Quality objašnjava kako Meta to ocjenjuje. U ROASaurus atribuciji nepovezana narudžba prikazuje se kao izravna ili nepoznata.

Što iz CCV narudžbe stiže na Meta i TikTok?

Meta prima Purchase putem svojeg Conversions API-ja, a TikTok CompletePayment putem svojeg Events API-ja, oba s ID-om događaja order-58213. TikTok sada u izvješćima prikazuje CompletePayment kao Purchase. Kada označite opciju da se učita i piksel u pregledniku, isječak na stranici uspješne narudžbe aktivira iste događaje u pregledniku s istim ID-om događaja, a Meta i TikTok zadržavaju jednu kopiju. Iste narudžbe idu i na Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboolu, LinkedIn i ostale oglasne platforme kada ih povežete. Konverzije kupnje za Google Ads šalju se samo iz Shopify naplate, pa ih ROASaurus ne šalje iz CCV Shopa.

Kako postaviti praćenje konverzija za CCV Shop

1. Dodajte trgovinu u ROASaurus

   Idite na Add a store, odaberite CCV Shop i unesite adresu svoje trgovine. Kartica Connection tada prikazuje vašu oznaku skripte i isječak za stranicu uspješne narudžbe.

2. Pronađite svoje API ključeve

   U CCV Shopu idite na My webshop › Settings › General › API settings i kliknite New API key. Ako ga ne vidite, najprije instalirajte aplikaciju API iz CCV App Storea.

3. Dodajte skriptu na svaku stranicu

   Zalijepite oznaku skripte u Header HTML svoje trgovine. CCV-ov centar za pomoć smješta je pod Mijn webshop › Instellingen › Lay-out › Layout, na dnu stranice. Radi i blok koda aplikacije u zaglavlju.

4. Dodajte isječak na stranicu uspješne narudžbe

   Idite na Mijn webshop › Instellingen › Algemeen › Teksten, otvorite tekst koji se prikazuje nakon što je narudžba predana, prebacite se na Source i tamo zalijepite isječak. CCV Shop ga zatim pokreće na stranici uspješne narudžbe.

5. Povežite API

   Na kartici Connection unesite javni i tajni ključ. Shop URL popunite samo kada vaš API radi na drugoj domeni od vaše trgovine. Spremite, pritisnite Test connection, a zatim Create webhook.

6. Povežite svoje oglasne platforme

   Na Tracking & platforms koristite Connect with Facebook ili Add pixel za Meta te Add pixel za TikTok. Označite opciju za učitavanje i piksela preglednika.

Privola

Izvan Shopifyja ROASaurus skripta čita izbor posjetitelja iz uobičajenih alata za privolu: Cookiebot, OneTrust, bannera IAB TCF i signala Google consent mode. S drugim bannerom za kolačiće pozovite tlq('consent', true) kada posjetitelj prihvati marketinške kolačiće i tlq('consent', false) kada ih odbije. Dok posjetitelj ne prihvati, nema ID-ja posjetitelja ni ID-ova klika i ne pokreće se nijedan piksel u pregledniku. Plaćena narudžba i dalje se s poslužitelja šalje s hashiranim podacima o kupcu iz narudžbe. Pojedinosti su na stranici pomoći o privoli.

Kako testirati praćenje konverzija za CCV Shop?

• Otvorite svoju trgovinu s ?roasaurus=connected u adresi. Upozorenje potvrđuje da skripta radi. ?roasaurus=debug bilježi u konzolu preglednika što šalje.
• U Event log, pod Collected events, prikazi stranica trebali bi prikazivati ID posjetitelja.
• Napravite narudžbu i platite je, ili je označite kao plaćenu. Pod Collected events, Event log treba prikazati događaj Purchase s CCV ID-om narudžbe u svojim podacima. Ako ga nema, isječak na stranici uspješne narudžbe nije se pokrenuo.
• Na kartici Connection, Last order received prikazuje narudžbu, a Last sync posljednju petominutnu provjeru, uz eventualnu pogrešku iz CCV-a.
• Pod Server deliveries u Event log, svaka povezana platforma dobiva redak sa statusom sent i odgovorom platforme.

Da biste vidjeli događaj u Meti, zalijepite kod iz Events Manager › Test events u polje Test event code svog Meta piksela u ROASaurusu i uklonite ga kada završite.

Kasna plaćanja i druga ograničenja

Bankovni prijenosi i plaćanje pouzećem plaćaju se nakon što se narudžba zaprimi. Evo što se događa s primjerom narudžbe bankovnim prijenosom, od dana kada je zaprimljena:

• Plaćanje pouzećem. ROASaurus šalje te narudžbe kada ih CCV označi kao plaćene, obično nakon isporuke. Pogledajte praćenje plaćanja pouzećem za informaciju kada takve narudžbe brojati.
• Kupnje iz preglednika prije plaćanja. Isječak na stranici uspješne narudžbe pokreće se kada se narudžba zaprimi, pa pikseli preglednika prijavljuju narudžbu bankovnim prijenosom prije nego što je plaćena. Ako plaćanje stigne više od 48 sati kasnije, Meta i TikTok ne mogu spojiti kopije iz preglednika i s poslužitelja.
• Nema IP rezervne metode. Dodajte isječak na stranicu uspješne narudžbe i, gdje možete, prikupljajte e-poštu ranije na svojoj stranici.
• Otkazivanja i povrati se ne šalju. Nakon što se kupnja pošalje, ostaje na oglasnoj platformi.
• Samo prikazi stranica, bez koda. Prikazi proizvoda i dodavanja u košaricu automatski se otkrivaju samo na Shopifyju. Na CCV Shopu ih programer može slati pomoću poziva tlq track.

Stranica CCV Shop integracije navodi činjenice o povezivanju na jednom mjestu, a stranica pomoći za druge web-trgovine uspoređuje CCV Shop s drugim platformama s kojima se ROASaurus povezuje, kao što je Lightspeed.

Izvori

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

U ROASaurusu

• CCV Shop integracija
• Pomoć: Wix, Lightspeed i druge web-trgovine
• Praćenje na strani poslužitelja
• Integracija s Metom

Nastavite čitati