Webshopintegratie

Server-side tracking voor BigCommerce

Geef ROASaurus een alleen-lezen API-account op winkelniveau en klik op Create webhook. Betaalde BigCommerce-bestellingen gaan dan vanaf de server naar je advertentieplatforms zodra ze binnenkomen.

BigCommerce in één oogopslag
Bestellingen komen binnen viaWebhooks (order created, status updated) plus polling elke 5 minuten
Webhook instellenAutomatisch, met de knop Create webhook
InloggegevensStore hash en een toegangstoken met Orders: read-only
Betaalde bestellingenAwaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped, Completed
Snippet voor de bedankpaginaScript op de Order confirmation-pagina met {{checkout.order.id}}

Zo koppelt BigCommerce

  1. Storefront › Script Manager › Create a Script: locatie Footer, pagina's All pages, type Script, met de scripttag van ROASaurus.
  2. Maak een tweede script voor de Order confirmation-pagina met het snippet voor de bedankpagina.
  3. Settings › API › Store-level API accounts › Create API account met Orders: read-only. Voer de store hash (het deel na /stores/ in je API-pad) en het toegangstoken in bij ROASaurus.
  4. Sla op en klik daarna op Create webhook.

Wat Create webhook doet

ROASaurus registreert twee BigCommerce-webhooks, voor order created en order status updated. Elke levering bevat een geheime header die uniek is voor je webshop en die ROASaurus controleert. De webhook meldt alleen welke bestelling is gewijzigd, dus ROASaurus haalt de bestelling en de bijbehorende producten op uit de API. Het controleert ook elke 5 minuten op gewijzigde bestellingen, voor het geval een levering verloren gaat.

Welke bestellingen meetellen

Bestellingen met een status die betekent dat de betaling is gelukt: Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped en Completed. Bestellingen die in afwachting zijn of zijn geweigerd, worden niet verstuurd. ROASaurus leest het totaal inclusief belasting, het e-mailadres, de telefoon, naam en het adres van de factuur, het klant-id, het IP-adres en elk product met zijn prijs inclusief belasting.

Bestellingen koppelen aan advertentieklikken

Het snippet op de orderbevestigingspagina laat de ROASaurus-aankoop afgaan met {{checkout.order.id}}, waarmee de bestelling aan de bezoeker wordt gekoppeld. Zonder dat snippet probeert ROASaurus een e-mailadres dat de bezoeker eerder op je site heeft opgegeven, bijvoorbeeld in een popup, en daarna het IP-adres van de bestelling, maar alleen als van 3 uur vóór tot 15 minuten na de bestelling precies één bezoeker op dat IP is gezien.

Beperkingen

  • BigCommerce-bestellingen geven ROASaurus geen user agent, dus bij gedeelde IP's (kantoren, mobiele netwerken) kan de IP-terugval vaak niet beslissen. Het snippet voorkomt dat.
  • 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

FAQ

Vragen, beantwoord

Welke API-toegang heeft ROASaurus nodig?

Een API-account op winkelniveau met Orders op alleen-lezen. ROASaurus gebruikt het om bestellingen te lezen en om zijn twee bestelwebhooks aan te maken.

Wat als een webhook mislukt?

ROASaurus pollt BigCommerce ook elke 5 minuten, met een overlap van 30 minuten. Bestellingen die het al heeft, worden genegeerd, dus er wordt niets twee keer verstuurd.

Welke BigCommerce-statussen tellen als betaald?

Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped en Completed. Andere statussen blijven buiten beschouwing tot de bestelling naar een van deze overgaat.

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 →