Server-side tracking voor CCV Shop
Koppel je CCV Shop-API-sleutels en klik op Create webhook. CCV meldt dan elke betaalde bestelling aan ROASaurus, dat die vanaf de server naar je advertentieplatforms stuurt.
| CCV Shop in één oogopslag | |
|---|---|
| Bestellingen komen binnen via | Webhook (order paid) plus polling elke 5 minuten |
| Webhook instellen | Automatisch, met de knop Create webhook |
| Inloggegevens | Publieke sleutel en geheime sleutel uit API gegevens |
| Ondertekening van verzoeken | HMAC-SHA512 bij elke API-aanroep |
| Snippet voor de bedankpagina | Succespagina van de bestelling, met Vertoshop.getOrder().getId() |
Zo koppelt CCV Shop
- Voeg het ROASaurus-script toe aan alle pagina's: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML, of een app-codeblok in de header.
- Voeg het snippet voor de bedankpagina toe aan de succespagina van de bestelling.
- Mijn webshop › Instellingen › Algemeen › API gegevens: kopieer de publieke sleutel en de geheime sleutel. Zie je API gegevens niet, installeer dan eerst de API-app.
- Voer beide sleutels in bij ROASaurus, sla op en klik daarna op Create webhook.
Wat Create webhook doet
ROASaurus registreert een CCV-webhook voor het event order paid. CCV meldt dan elke betaalde bestelling meteen. Geeft CCV een webhook-secret terug, dan controleert ROASaurus bij elke levering de HMAC-SHA512-handtekening; elke levering moet ook het token bevatten dat uniek is voor je webshop. ROASaurus haalt daarna de volledige bestelling en de orderregels uit de API op.
Elke API-aanroep van ROASaurus wordt ondertekend zoals CCV vereist: een HMAC-SHA512-hash van je publieke sleutel, de methode, het adres, de body en een tijdstempel.
De controle van 5 minuten
ROASaurus vraagt CCV ook elke 5 minuten om betaalde bestellingen. CCV filtert alleen op aanmaakdatum, dus een bestelling die dagen na plaatsing als betaald wordt gemarkeerd, wordt door de webhook opgepikt en niet door de controle.
Wat ROASaurus uit elke bestelling leest
Het volledige bestelnummer, het totaal, de valuta, het e-mailadres, het mobiele of vaste telefoonnummer, de naam, de plaats, postcode en het land van de factuur, het klant-id en elke orderregel met productnummer, aantal en prijs.
Beperkingen
- CCV-bestellingen bevatten het IP-adres van de shopper niet, dus de IP-terugval is niet beschikbaar. Voeg het snippet voor de bedankpagina toe.
- Houd de webhook actief: late betalingen zijn ervan afhankelijk.
- De connector is gebouwd op basis van de officiële API-documentatie van het platform. Klik na het opslaan van je inloggegevens op Test connection, plaats daarna een testbestelling en controleer het Event log.
Gerelateerd
Vragen, beantwoord
Waar vind ik mijn CCV Shop-API-sleutels?
Onder Mijn webshop › Instellingen › Algemeen › API gegevens. Ontbreekt dat menu, installeer dan eerst de API-app van CCV.
Wat doet het snippet voor de succespagina?
Het leest het bestel-id met Vertoshop.getOrder().getId() en laat daarmee de ROASaurus-aankoop afgaan, waarmee de bestelling aan de bezoeker en zijn advertentieklik wordt gekoppeld.
Worden later betaalde bestellingen nog verstuurd?
Ja, via de webhook voor betaalde bestellingen. De controle van 5 minuten kijkt alleen naar recent aangemaakte bestellingen, dus houd de webhook actief.
Elke verkoop herleid tot de advertentie die hem opleverde
Server-side tracking, winst en lifetime value in één app. 14 dagen gratis proberen, geen creditcard.
Start je gratis proefperiode →