CCV Shop -konversioseuranta: käyttöönoto-opas

CCV Shop -konversioseuranta tarkoittaa, että jokainen CCV Shop -verkkokauppasi maksettu tilaus raportoidaan mainosalustoille, kuten Metalle ja TikTokille, jotta ne lukevat ansion oikeille mainoksille ja optimoivat todellisten myyntien mukaan. Kattavin tapa on lähettää jokainen osto CCV:n tilausdatasta palvelimella ja lisätä tilausvahvistussivulle lyhyt koodinpätkä, joka yhdistää tilauksen mainosklikkaukseen.

CCV Shop on hollantilaisen CCV-yhtiön ohjelmistopalveluna toimiva verkkokauppa-alusta, jonka mukaan se pyörittää 17,000 verkkokauppaa. Tämä opas selittää, miten ROASaurus yhdistyy siihen, miten tilaukset yhdistetään mainosklikkauksiin, mitä Metalle ja TikTokille päätyy, miten käyttöönotto ja testaus tehdään ja miten myöhässä tulevat maksut toimivat. Yleisen idean saat lukemalla tekstin mitä on palvelinpuolen seuranta.

Miten ROASaurus yhdistyy CCV Shopiin?

ROASaurus käyttää kolmea CCV Shopin osaa, jotka kaikki on kuvattu CCV:n API-dokumentaatiossa:

Miksi selainpikselit eivät näe CCV Shop -ostoja?

Selainpikseli raportoi oston vain, kun ostajan selain lataa tilausvahvistussivun ja pikseliskripti suoritetaan. Useat yleiset tilanteet rikkovat tämän:

• Ostaja maksaa uudelleenohjauksella, esimerkiksi iDEALilla, ja sulkee välilehden ennen kuin vahvistussivu latautuu.
• Mainosesto tai selaimen tietosuoja-asetus estää pikseliskriptin.
• Kävijä kieltäytyy markkinointievästeistä, joten pikseli ei saa latautua.
• Tilaus maksetaan myöhemmin tilisiirrolla tai toimituksen yhteydessä, jolloin selain ei ole mukana.

Jokaisessa tapauksessa CCV Shop merkitsee tilauksen silti maksetuksi. ROASaurus lähettää tämän tilauksen palvelimelta, joten osto raportoidaan riippumatta siitä, mitä selaimessa tapahtui. Vahvistussivun koodinpätkällä on eri tehtävä: se kertoo ROASaurukselle, mille kävijälle ja siten mille mainosklikkaukselle tilaus kuuluu.

Tilauksen maksettu -webhook ja 5 minuutin tarkistus

Mitä Create webhook tekee

Kun painat Create webhook, ROASaurus rekisteröi CCV-webhookin tapahtumalle orders.updated.ispaid, jonka CCV laukaisee, kun tilauksen paid-ominaisuus muuttuu. Osoite on kauppasi webhook-URL ROASaurusissa, ja se sisältää kauppa-avaimesi ja yksityisen tokenin. CCV ei lisää webhookiin mitään, mikä tunnistaisi kaupan, ja sen dokumentaatio neuvoo laittamaan tunnisteen osoitteeseen. Kauppa-avain tekee sen.

CCV antaa jokaiselle webhookille oman 32-merkkisen salaisen avaimen. Kun CCV palauttaa tämän avaimen, ROASaurus tallentaa sen, ja siitä lähtien jokaisessa lähetyksessä on oltava kelvollinen x-hash-otsikko. Jokaisen lähetyksen on myös sisällettävä kauppasi token. Kun ROASaurus vastaanottaa lähetyksen, se ohittaa tilaukset, joita ei ole maksettu, lukee koko tilauksen ja sen tilausrivit API:sta ja lähettää tilauksen vain, kun CCV ilmoittaa sen maksetuksi.

Allekirjoitetut API-kutsut

CCV vaatii jokaisen API-kutsun allekirjoittamista. ROASaurus lähettää kolme otsikkoa: x-public julkisella avaimellasi, x-date nykyisellä ajalla ja x-hash. CCV hylkää aikaleiman, joka poikkeaa yli 5 minuuttia sen palvelinajasta. Salaista avaintasi itsessään ei koskaan lähetetä.

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 )

5 minuutin tarkistus

ROASaurus kysyy CCV:ltä myös 5 minuutin välein maksetut tilaukset, jotka on luotu edellisen tarkistuksen jälkeen, 30 minuutin päällekkäisyydellä, ja tallentaa ne, joita sillä ei vielä ole. CCV suodattaa tilaukset vain luontipäivän mukaan. Tarkistus löytää siis tilaukset, jotka maksetaan pian tilauksen jälkeen, ja päiviä myöhemmin maksettu tilaus saavuttaa ROASaurusin vain webhookin kautta.

CCV pitää vastausta 200, 201, 202 tai 204 onnistuneena. Se pitää lähetyksen auki ja yrittää sitä uudelleen seuraavalla kerralla vastauksen 307, 408, 503 tai 504 jälkeen ja merkitsee kaikki muut vastaukset epäonnistuneiksi. Se odottaa yhteyttä 2 sekuntia ja vastausta 5 sekuntia.

Miten CCV Shop -tilaus yhdistetään mainosklikkaukseen?

Jotta alusta voi lukea ansion mainokselle, se tarvitsee tilanneen kävijän klikkaustunnisteet, kuten Metan klikkaus-ID:n (fbc) ja TikTokin klikkaus-ID:n (ttclid). ROASaurus-skripti tallentaa ne jokaiselle kävijälle, kun hän saapuu mainoksesta. ROASaurus ei saa kyseistä kävijätunnusta CCV-tilauksesta, joten se yhdistää tilaukset kävijöihin muilla tavoilla:

ROASaurus odottaa hetken ennen kunkin oston lähettämistä, jotta vahvistussivun tapahtuma ehtii saapua ensin, ja yrittää yhdistämistä uudelleen lähetyshetkellä. Orders-sivu näyttää tuloksen tilauskohtaisesti sarakkeessa Matched by: thank_you, email tai not matched.

Yhdistämätön tilaus lähtee silti mainosalustoillesi tilauksen hashatun asiakasdatan kanssa. Siinä ei ole klikkaustunnisteita, ja koska CCV-tilauksissa ei ole IP-osoitetta tai selainta, ei niitäkään. Tämä pienentää niiden tapahtumien osuutta, jotka Meta voi yhdistää henkilöön; Event Match Quality selittää, miten Meta pisteyttää tämän. ROASaurusin attribuutiossa yhdistämätön tilaus näkyy suorana tai tuntemattomana.

Mitä CCV-tilauksesta päätyy Metalle ja TikTokille?

Meta vastaanottaa Purchase-tapahtuman Conversions API:n kautta ja TikTok CompletePayment-tapahtuman Events API:n kautta, molemmat tapahtuma-ID:llä order-58213. TikTok näyttää nykyään CompletePaymentin raporteissaan Purchasena. Kun rastitat vaihtoehdon ladata myös selainpikselin, vahvistussivun koodinpätkä laukaisee samat tapahtumat selaimessa samalla tapahtuma-ID:llä, ja Meta ja TikTok säilyttävät yhden kopion. Samat tilaukset menevät Snapchatille, Pinterestille, Redditille, X:lle, Microsoft Adsille, Taboolalle, LinkedInille ja muille mainosalustoille, kun yhdistät ne. Google Adsin ostokonversiot lähetetään vain Shopifyn kassalta, joten ROASaurus ei lähetä niitä CCV Shopista.

Miten CCV Shop -konversioseuranta otetaan käyttöön

1. Lisää kauppa ROASaurukseen

   Siirry kohtaan Add a store, valitse CCV Shop ja syötä kauppasi osoite. Connection-välilehti näyttää sitten skriptitunnisteesi ja vahvistussivun koodinpätkän.

2. Etsi API-avaimesi

   Siirry CCV Shopissa kohtaan My webshop › Settings › General › API settings ja klikkaa New API key. Jos et näe sitä, asenna ensin API-sovellus CCV App Storesta.

3. Lisää skripti jokaiselle sivulle

   Liitä skriptitunniste kauppasi Header HTML -kenttään. CCV:n ohjekeskus sijoittaa sen kohtaan Mijn webshop › Instellingen › Lay-out › Layout, sivun alaosaan. Myös sovelluksen koodilohko headerissa toimii.

4. Lisää koodinpätkä vahvistussivulle

   Siirry kohtaan Mijn webshop › Instellingen › Algemeen › Teksten, avaa teksti, joka näytetään tilauksen tekemisen jälkeen, vaihda näkymään Source ja liitä koodinpätkä sinne. CCV Shop ajaa sen sitten tilausvahvistussivulla.

5. Yhdistä API

   Syötä Connection-välilehdellä julkinen avain ja salainen avain. Täytä Shop URL vain, jos API:si toimii eri domainissa kuin kauppasi. Tallenna, paina Test connection ja sitten Create webhook.

6. Yhdistä mainosalustasi

   Käytä kohdassa Tracking & platforms Metalle vaihtoehtoa Connect with Facebook tai Add pixel ja TikTokille vaihtoehtoa Add pixel. Rastita vaihtoehto ladata myös selainpikseli.

Suostumus

Shopifyn ulkopuolella ROASaurus-skripti lukee kävijän valinnan yleisistä suostumustyökaluista: Cookiebot, OneTrust, IAB TCF -bannerit ja Google consent mode. Jos käytössä on jokin muu evästebanneri, kutsu tlq('consent', true), kun kävijä hyväksyy markkinointievästeet, ja tlq('consent', false), kun hän kieltäytyy. Kunnes kävijä hyväksyy, hänellä ei ole kävijätunnusta eikä klikkaus-ID:itä, eikä selainpikseleitä laukea. Maksettu tilaus lähetetään silti palvelimelta tilauksen hashatun asiakasdatan kanssa. Suostumusta käsittelevä ohjesivu kertoo yksityiskohdat.

Miten CCV Shop -konversioseuranta testataan?

• Avaa kauppasi lisäämällä osoitteeseen ?roasaurus=connected. Ilmoitus vahvistaa, että skripti toimii. ?roasaurus=debug kirjaa selaimen konsoliin sen, mitä skripti lähettää.
• Kohdassa Collected events (Event log) sivunäytöillä pitäisi näkyä kävijätunnus.
• Tee tilaus ja maksa se tai merkitse se maksetuksi. Event logissa pitäisi näkyä kohdassa Collected events Purchase, jonka datassa on CCV-tilaus-ID. Jos se puuttuu, vahvistussivun koodinpätkä ei suorittunut.
• Connection-välilehdellä Last order received näyttää tilauksen ja Last sync viimeisimmän 5 minuutin tarkistuksen sekä mahdollisen CCV:n virheen.
• Kohdassa Server deliveries (Event log) jokaiselle yhdistetylle alustalle tulee rivi, jonka tila on sent, sekä alustan vastaus.

Jos haluat nähdä tapahtuman Metassa, liitä Events Manager › Test events -kohdan koodi ROASaurusissa Meta-pikselisi Test event code -kenttään ja poista se, kun olet valmis.

Myöhässä tulevat maksut ja muut rajoitukset

Tilisiirrot ja postiennakko maksetaan tilauksen tekemisen jälkeen. Näin esimerkkinä oleva tilisiirtotilaus etenee tilauspäivästä alkaen:

• Postiennakko. ROASaurus lähettää nämä tilaukset, kun CCV merkitsee ne maksetuiksi, yleensä toimituksen jälkeen. Katso postiennakkoseuranta siitä, milloin tällaiset tilaukset kannattaa laskea.
• Selainostot ennen maksua. Vahvistussivun koodinpätkä suoritetaan, kun tilaus tehdään, joten selainpikselit raportoivat tilisiirtotilauksen ennen kuin se on maksettu. Jos maksu tulee yli 48 tuntia myöhemmin, Meta ja TikTok eivät voi yhdistää selaimen ja palvelimen kopioita.
• Ei IP-varamenetelmää. Lisää vahvistussivun koodinpätkä ja kerää sähköpostiosoitteita sivustollasi aiemmin, missä voit.
• Peruutuksia ja hyvityksiä ei lähetetä. Kun osto on lähetetty, se pysyy mainosalustalla.
• Vain sivunäytöt ilman koodia. Tuotenäytöt ja ostoskoriin lisäykset tunnistetaan automaattisesti vain Shopifyssa. CCV Shopissa kehittäjä voi lähettää ne tlq-track-kutsulla.

CCV Shop -integraatiosivu listaa yhteyden tiedot yhdessä paikassa, ja muiden verkkokauppojen ohjesivu vertaa CCV Shopia muihin alustoihin, joihin ROASaurus yhdistyy, kuten Lightspeediin.

Lähteet

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

ROASaurusissa

• CCV Shop -integraatio
• Ohje: Wix, Lightspeed ja muut verkkokaupat
• Palvelinpuolen seuranta
• Meta-integraatio

Lue lisää