Server-side tracking for CCV Shop
Koble til CCV Shop API-nøklene dine og trykk på Create webhook. CCV rapporterer da hver betalte bestilling til ROASaurus, som sender den til annonseplattformene dine fra serveren.
| CCV Shop i et overblikk | |
|---|---|
| Bestillinger kommer inn via | Webhook (bestilling betalt) pluss polling hvert 5. minutt |
| Oppsett av webhook | Automatisk, med knappen Create webhook |
| Tilgangsdata | Public key og secret key fra API gegevens |
| Signering av forespørsler | HMAC-SHA512 på hvert API-kall |
| Kodesnutt på takkesiden | Success-siden for bestilling, med Vertoshop.getOrder().getId() |
Slik kobles CCV Shop til
- Legg til ROASaurus-scriptet på alle sider: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML, eller en kodeblokk fra en app i headeren.
- Legg til kodesnutten for takkesiden på success-siden for bestillinger.
- Mijn webshop › Instellingen › Algemeen › API gegevens: kopier public key og secret key. Hvis du ikke ser API gegevens, installerer du API-appen først.
- Skriv inn begge nøklene i ROASaurus, lagre, og trykk deretter på Create webhook.
Hva Create webhook gjør
ROASaurus registrerer en CCV-webhook for eventet order paid. CCV rapporterer da hver betalte bestilling med en gang. Når CCV returnerer en webhook secret, kontrollerer ROASaurus HMAC-SHA512-signaturen til hver levering; hver levering må også ha med tokenet som er unikt for butikken din. ROASaurus henter deretter hele bestillingen og ordrelinjene fra API-et.
Hvert API-kall ROASaurus gjør, signeres slik CCV krever: en HMAC-SHA512-hash av public key, metoden, adressen, request body og et tidsstempel.
5-minuttersjekken
ROASaurus ber også CCV om betalte bestillinger hvert 5. minutt. CCV filtrerer bare på opprettelsesdato, så en bestilling som markeres som betalt dager etter at den ble lagt inn, fanges opp av webhooken, ikke av sjekken.
Hva ROASaurus leser fra hver bestilling
Hele bestillingsnummeret, totalsummen, valutaen, kundens e-post, mobil- eller telefonnummer, navn, by, postnummer og land for fakturering, kunde-ID-en og hver ordrelinje med produktnummer, antall og pris.
Begrensninger
- CCV-bestillinger inneholder ikke kundens IP-adresse, så IP-reserven er ikke tilgjengelig. Legg til kodesnutten for takkesiden.
- Hold webhooken aktiv: sene betalinger er avhengige av den.
- Connectoren er bygget etter plattformens offisielle API-dokumentasjon. Trykk på Test connection etter at du har lagret legitimasjonen din, legg deretter inn en testbestilling og sjekk Event log.
Relatert
Spørsmål, besvart
Hvor finner jeg CCV Shop API-nøklene mine?
I Mijn webshop › Instellingen › Algemeen › API gegevens. Hvis den menyen mangler, installerer du CCVs API-app først.
Hva gjør kodesnutten på success-siden for bestillinger?
Den leser bestillings-ID-en med Vertoshop.getOrder().getId() og utløser ROASaurus-kjøpet med den, som kobler bestillingen til den besøkende og annonseklikket deres.
Sendes bestillinger som betales senere, fortsatt?
Ja, via webhooken for betalt bestilling. 5-minuttersjekken ser bare på nylig opprettede bestillinger, så hold webhooken aktiv.
Hvert salg, sporet til annonsen som tjente det inn
Server-side tracking, fortjeneste og livstidsverdi i én app. 14 dagers gratis prøveperiode, uten kredittkort.
Start den gratis prøveperioden din →