Webshop-Integration

Server-Side-Tracking für CCV Shop

Verbinde deine CCV-Shop-API-Keys und klicke auf Create webhook. CCV meldet dann jede bezahlte Bestellung an ROASaurus, das sie vom Server an deine Werbeplattformen sendet.

CCV Shop auf einen Blick
Bestellungen kommen an perWebhook (Bestellung bezahlt) plus Abfrage alle 5 Minuten
Webhook-EinrichtungAutomatisch, mit der Schaltfläche Create webhook
ZugangsdatenPublic Key und Secret Key aus API gegevens
Anfrage-SignierungHMAC-SHA512 bei jedem API-Aufruf
Snippet für die DankeseiteErfolgsseite der Bestellung, mit Vertoshop.getOrder().getId()

So verbindet sich CCV Shop

  1. Füge das ROASaurus-Skript auf allen Seiten hinzu: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML oder ein App-Codeblock im Header.
  2. Füge das Snippet für die Dankeseite zur Erfolgsseite der Bestellung hinzu.
  3. Mijn webshop › Instellingen › Algemeen › API gegevens: Kopiere den Public Key und den Secret Key. Wenn du API gegevens nicht siehst, installiere zuerst die API-App.
  4. Gib beide Keys in ROASaurus ein, speichere und klicke dann auf Create webhook.

Was „Create webhook“ bewirkt

ROASaurus registriert einen CCV-Webhook für das Event order paid. CCV meldet dann jede bezahlte Bestellung sofort. Liefert CCV ein Webhook-Secret zurück, prüft ROASaurus die HMAC-SHA512-Signatur jeder Zustellung; jede Zustellung muss außerdem das für deinen Shop einzigartige Token tragen. ROASaurus ruft dann die vollständige Bestellung und ihre Bestellzeilen aus der API ab.

Jeder API-Aufruf von ROASaurus wird so signiert, wie CCV es verlangt: mit einem HMAC-SHA512-Hash aus deinem Public Key, der Methode, der Adresse, dem Body und einem Zeitstempel.

Die 5-Minuten-Prüfung

ROASaurus fragt CCV außerdem alle 5 Minuten nach bezahlten Bestellungen. CCV filtert nur nach Erstellungsdatum, daher wird eine Bestellung, die Tage nach der Aufgabe als bezahlt markiert wird, vom Webhook erfasst, nicht von der Prüfung.

Was ROASaurus aus jeder Bestellung liest

Die vollständige Bestellnummer, Summe, Währung, E-Mail des Kunden, Mobil- oder Telefonnummer, Name, Rechnungsstadt, PLZ und Land, die Kunden-ID und jede Bestellzeile mit Produktnummer, Menge und Preis.

Einschränkungen

  • CCV-Bestellungen enthalten nicht die IP-Adresse des Kunden, daher ist der IP-Fallback nicht verfügbar. Füge das Snippet für die Dankeseite hinzu.
  • Lass den Webhook aktiv: Verspätete Zahlungen sind darauf angewiesen.
  • Der Konnektor basiert auf der offiziellen API-Dokumentation der Plattform. Klicke nach dem Speichern deiner Zugangsdaten auf Test connection, gib dann eine Testbestellung auf und prüfe das Event log.

Verwandt

FAQ

Antworten auf deine Fragen

Wo finde ich meine CCV-Shop-API-Keys?

Unter Mijn webshop › Instellingen › Algemeen › API gegevens. Fehlt dieses Menü, installiere zuerst die API-App von CCV.

Was macht das Snippet für die Erfolgsseite der Bestellung?

Es liest die Bestell-ID mit Vertoshop.getOrder().getId() und löst damit den ROASaurus-Kauf aus, was die Bestellung mit dem Besucher und seinem Anzeigenklick verknüpft.

Werden später bezahlte Bestellungen trotzdem gesendet?

Ja, über den Webhook für bezahlte Bestellungen. Die 5-Minuten-Prüfung betrachtet nur kürzlich erstellte Bestellungen, lass den Webhook also aktiv.

Jeder Verkauf, zurückverfolgt zur Anzeige, die ihn gebracht hat

Server-Side-Tracking, Gewinn und Customer Lifetime Value in einer App. 14 Tage kostenlos testen, ohne Kreditkarte.

Starte deine kostenlose Testphase →