Server-side tracking voor Ecwid-webshops
ROASaurus leest betaalde Ecwid-bestellingen via een custom app-token en stuurt ze vanaf de server naar je advertentieplatforms. Vraag Ecwid support om webhooks en bestellingen komen direct binnen.
| Ecwid in één oogopslag | |
|---|---|
| Bestellingen komen binnen via | API-polling elke 5 minuten; webhooks zodra Ecwid support ze inschakelt |
| Inloggegevens | Store-ID, het secret token van de custom app en het client secret voor webhooks |
| Webhook-controle | HMAC-handtekening met het client secret |
| Betaalde bestellingen | Betalingsstatus PAID |
| Snippet voor de bedankpagina | Ecwid.OnOrderPlaced, na het trackingscript |
Zo koppelt Ecwid
- Voeg het ROASaurus-script toe aan de site die je Ecwid-webshop insluit, of aan de custom code van je Instant Site.
- Voeg daarna het snippet voor de bedankpagina toe. Het luistert naar het event
OnOrderPlacedvan Ecwid en laat de ROASaurus-aankoop afgaan met het bestelnummer, het totaal en het e-mailadres. - Maak op my.ecwid.com/#develop-apps een custom app met leestoegang tot bestellingen. Voer je store-ID (te zien in de URL van je admin en onder Account › Summary) en het
secret_…-token van de app in bij ROASaurus.
ROASaurus haalt daarna elke 5 minuten bestellingen op die sinds de vorige run zijn bijgewerkt en verstuurt die met betalingsstatus PAID.
Directe bestellingen met webhooks
Ecwid stelt webhook-URL's voor custom apps in via het API-supportteam. Vraag hen de webhook-URL van je app in te stellen op die in je tabblad Connection van ROASaurus, met de events order.created en order.updated. Plak het client secret van de app in ROASaurus: elke webhook wordt gecontroleerd aan de hand van zijn HMAC-handtekening, waarna de bestelling uit de API wordt opgehaald.
Wat ROASaurus uit elke bestelling leest
Het totaal, de valuta, het e-mailadres, de naam, telefoon en het adres van de factuur, het klant-id en de artikelen met hun combinatie, aantal, prijs en SKU. Ecwid-bestellingen bevatten het IP-adres en de user agent van de shopper, dus ROASaurus kan ook matchen op hetzelfde IP en dezelfde browser, alleen als precies één bezoeker past.
Beperkingen
- Voor webhooks moet je Ecwid support om een instelling vragen. Tot die tijd duurt het tot 5 minuten voordat bestellingen binnenkomen.
- Ecwid levert één naamveld, dat ROASaurus splitst in voor- en achternaam.
- 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
Waarom moet ik voor webhooks contact opnemen met Ecwid?
Ecwid configureert de webhook-URL van een custom app via zijn API-support. Polling elke 5 minuten werkt ook zonder webhooks.
Waar dient het client secret voor?
Het verifieert dat een webhook echt van Ecwid komt. ROASaurus controleert daarmee de HMAC-handtekening van elke webhook voordat het de bestelling ophaalt.
Werkt het als Ecwid op een andere site is ingesloten?
Ja. Voeg het ROASaurus-script en het snippet voor de bedankpagina toe aan de site die je Ecwid-webshop insluit.
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 →