Konverteringstracking med CCV Shop: en opsætningsguide

Konverteringstracking i CCV Shop betyder, at hver betalt ordre i din CCV Shop-webshop meldes til annonceplatforme som Meta og TikTok, så de krediterer de rigtige annoncer og optimerer på reelle salg. Den mest komplette måde er at sende hvert køb fra CCV's ordredata på serveren og tilføje et kort snippet til ordrebekræftelsessiden, der knytter ordren til annonceklikket.

CCV Shop er en hosted webshopplatform fra det nederlandske firma CCV, som oplyser, at det driver 17,000 webshops. Denne guide forklarer, hvordan ROASaurus forbinder til den, hvordan ordrer knyttes til annonceklik, hvad der når frem til Meta og TikTok, opsætningen, test, og hvordan sene betalinger fungerer. For den generelle idé kan du læse hvad server-side tracking er.

Hvordan forbinder ROASaurus til CCV Shop?

ROASaurus bruger tre dele af CCV Shop, som alle er beskrevet i CCV's API-dokumentation:

Hvorfor overser browserpixels køb i CCV Shop?

En browserpixel rapporterer kun et køb, når shopperens browser indlæser ordrebekræftelsessiden, og pixel-scriptet kører. Flere almindelige situationer bryder det:

• Shopperen betaler via omdirigering, for eksempel med iDEAL, og lukker fanen, før bekræftelsessiden indlæses.
• En adblocker eller en privatlivsindstilling i browseren blokerer pixel-scriptet.
• Den besøgende afviser marketingcookies, så pixelen ikke må indlæses.
• Ordren betales senere, via bankoverførsel eller ved levering, når der ikke er nogen browser involveret.

I hvert tilfælde markerer CCV Shop stadig ordren som betalt. ROASaurus sender den ordre fra serveren, så købet bliver rapporteret, uanset hvad der skete i browseren. Snippetten på bekræftelsessiden har et andet job: Den fortæller ROASaurus, hvilken besøgende og dermed hvilket annonceklik ordren hører til.

Webhooken for betalt ordre og 5-minutterstjekket

Hvad Create webhook gør

Når du trykker på Create webhook, registrerer ROASaurus en CCV-webhook til eventet orders.updated.ispaid, som CCV udløser, når en ordres betalt-egenskab ændres. Adressen er din shops webhook-URL i ROASaurus, som indeholder din shopnøgle og en privat token. CCV tilføjer intet til en webhook, der identificerer shoppen, og dets dokumentation anbefaler at lægge en identifikator i adressen. Det gør shopnøglen.

CCV giver hver webhook sin egen hemmelige nøgle på 32 tegn. Når CCV returnerer nøglen, gemmer ROASaurus den, og derefter skal hver levering have en gyldig header x-hash. Hver levering skal også bære din shops token. Når ROASaurus modtager en levering, ignorerer den ordrer, der ikke er betalt, læser hele ordren og dens ordrelinjer fra API'et og sender kun ordren, når CCV siger, at den er betalt.

Signerede API-kald

CCV kræver, at hvert API-kald er signeret. ROASaurus sender tre headers: x-public med din offentlige nøgle, x-date med det aktuelle tidspunkt og x-hash. CCV afviser et tidsstempel, der afviger mere end 5 minutter fra dets servertid. Din hemmelige nøgle sendes aldrig selv.

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 )

Kontrollen hvert 5. minut

Hvert 5. minut spørger ROASaurus også CCV om betalte ordrer, der er oprettet siden sidste tjek, med 30 minutters overlap, og registrerer dem, den ikke har endnu. CCV filtrerer kun ordrer efter oprettelsesdato. Tjekket finder derfor ordrer, der betales kort efter, de er afgivet, og en ordre, der betales dage senere, når kun ROASaurus via webhooken.

CCV regner et svar med 200, 201, 202 eller 204 som en succes. Det holder en levering åben og prøver den igen ved næste forekomst efter et svar med 307, 408, 503 eller 504, og markerer ethvert andet svar som mislykket. Det venter 2 sekunder på en forbindelse og 5 sekunder på svaret.

Hvordan knyttes en CCV Shop-ordre til annonceklikket?

For at kreditere en annonce har platformen brug for klik-id'erne fra den besøgende, der bestilte, f.eks. Metas klik-id (fbc) og TikToks klik-id (ttclid). ROASaurus-scriptet gemmer dem for hver besøgende, når vedkommende lander fra en annonce. ROASaurus får ikke det besøgs-id fra CCV-ordren, så den knytter ordrer til besøgende på andre måder:

ROASaurus venter kort, før den sender hvert køb, så eventet fra bekræftelsessiden kan nå frem først, og den prøver matchingen igen på afsendelsestidspunktet. Siden Orders viser resultatet pr. ordre i kolonnen Matched by: thank_you, email eller not matched.

En ordre, der ikke er matchet, går stadig til dine annonceplatforme med hashede kundedata fra ordren. Den har ingen klik-id'er, og fordi CCV-ordrer ikke har nogen IP-adresse eller browser, har den heller ingen af dem. Det sænker andelen af events, Meta kan matche med en person; Event Match Quality forklarer, hvordan Meta vurderer det. I ROASaurus' attribution vises en ikke-matchet ordre som direkte eller ukendt.

Hvad når frem til Meta og TikTok fra en CCV-ordre?

Meta modtager et Purchase via sin Conversions API og TikTok et CompletePayment via sin Events API, begge med event-id'et order-58213. TikTok viser nu CompletePayment som Purchase i sine rapporter. Når du sætter flueben ved indstillingen om også at indlæse browserpixelen, udløser snippetten på bekræftelsessiden de samme events i browseren med samme event-id, og Meta og TikTok beholder én kopi. De samme ordrer går til Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboola, LinkedIn og de andre annonceplatforme, når du forbinder dem. Google Ads-købskonverteringer sendes kun fra Shopify checkout, så ROASaurus sender dem ikke fra CCV Shop.

Sådan sætter du konverteringstracking op i CCV Shop

1. Tilføj shoppen i ROASaurus

   Gå til Add a store, vælg CCV Shop, og indtast din shopadresse. Fanen Connection viser derefter dit script-tag og snippetten til bekræftelsessiden.

2. Find dine API-nøgler

   Gå til My webshop › Settings › General › API settings i CCV Shop, og klik på New API key. Hvis du ikke kan se den, skal du først installere API-appen fra CCV App Store.

3. Tilføj scriptet til alle sider

   Indsæt script-tagget i Header HTML i din shop. CCV's hjælpecenter placerer det under Mijn webshop › Instellingen › Lay-out › Layout, nederst på siden. En app-kodeblok i headeren virker også.

4. Tilføj snippetten til bekræftelsessiden

   Gå til Mijn webshop › Instellingen › Algemeen › Teksten, åbn den tekst, der vises, når en ordre er afgivet, skift til Source, og indsæt snippeten dér. CCV Shop kører den derefter på ordrebekræftelsessiden.

5. Forbind API'et

   Indtast den offentlige nøgle og den hemmelige nøgle på fanen Connection. Udfyld kun Shop URL, hvis dit API kører på et andet domæne end din shop. Gem, tryk på Test connection, og derefter Create webhook.

6. Forbind dine annonceplatforme

   Under Tracking & platforms skal du bruge Connect with Facebook eller Add pixel til Meta og Add pixel til TikTok. Sæt flueben ved indstillingen om også at indlæse browserpixelen.

Samtykke

Uden for Shopify læser ROASaurus-scriptet den besøgendes valg fra almindelige samtykkeværktøjer: Cookiebot, OneTrust, IAB TCF-bannere og Google consent mode. Med et andet cookiebanner kalder du tlq('consent', true), når den besøgende accepterer marketingcookies, og tlq('consent', false), når vedkommende afviser. Indtil den besøgende accepterer, har vedkommende intet besøgs-id eller klik-id'er, og ingen browserpixels udløses. Den betalte ordre sendes stadig fra serveren med hashede kundedata fra ordren. Hjælpesiden om samtykke forklarer detaljerne.

Hvordan tester du konverteringstracking i CCV Shop?

• Åbn din shop med ?roasaurus=connected i adressen. En meddelelse bekræfter, at scriptet kører. ?roasaurus=debug logger det, det sender, i browserkonsollen.
• I Event log skal sidevisninger under Collected events vise et besøgs-id.
• Afgiv en ordre og betal den, eller markér den som betalt. Under Collected events skal Event log vise et Purchase med CCV-ordre-id'et i sine data. Hvis det mangler, kørte snippetten på bekræftelsessiden ikke.
• På fanen Connection viser Last order received ordren og Last sync det seneste 5-minutterstjek med eventuelle fejl fra CCV.
• Under Server deliveries i Event log får hver forbundet platform en linje med status sent og platformens svar.

For at se eventet i Meta skal du indsætte koden fra Events Manager › Test events i feltet Test event code på din Meta-pixel i ROASaurus og fjerne den, når du er færdig.

Sene betalinger og andre begrænsninger

Bankoverførsler og efterkrav betales, efter ordren er afgivet. Her er, hvad der sker med en eksempelordre betalt med bankoverførsel, fra den dag, den afgives:

• Efterkrav. ROASaurus sender disse ordrer, når CCV markerer dem som betalt, som regel efter levering. Se tracking ved efterkrav for, hvornår du skal tælle sådanne ordrer med.
• Browserkøb før betaling. Snippetten på bekræftelsessiden kører, når ordren afgives, så browserpixels rapporterer en bankoverførselsordre, før den er betalt. Hvis betalingen kommer mere end 48 timer senere, kan Meta og TikTok ikke samle browser- og serverkopien.
• Ingen IP-fallback. Tilføj snippetten på bekræftelsessiden, og indsaml e-mails tidligere på dit site, hvor du kan.
• Annulleringer og refunderinger sendes ikke. Når et køb først er sendt, bliver det stående i annonceplatformen.
• Kun sidevisninger uden kode. Produktvisninger og tilføjelser til kurven registreres kun automatisk på Shopify. På CCV Shop kan en udvikler sende dem med et tlq-track-kald.

Siden om CCV Shop-integrationen samler fakta om forbindelsen ét sted, og hjælpesiden om andre webshops sammenligner CCV Shop med de andre platforme, ROASaurus forbinder til, f.eks. Lightspeed.

Kilder

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

I ROASaurus

• CCV Shop-integration
• Hjælp: Wix, Lightspeed og andre webshops
• Server-side tracking
• Meta-integration

Læs videre