Server-side tracking voor Squarespace Commerce
ROASaurus leest elke 5 minuten betaalde bestellingen uit de Squarespace Commerce API en stuurt ze vanaf de server naar je advertentieplatforms. Een snippet op de orderstatuspagina koppelt elke bestelling aan de advertentieklik.
| Squarespace in één oogopslag | |
|---|---|
| Bestellingen komen binnen via | Commerce API-polling elke 5 minuten |
| Inloggegevens | Developer API-sleutel met Orders: read |
| Abonnement | Voor API-sleutels is het abonnement Commerce Advanced nodig |
| Betaalde bestellingen | Betalingsstatus PAID |
| Snippet voor de bedankpagina | Code injection op de Order Status Page, met {orderId} en {orderGrandTotal} |
Zo koppelt Squarespace
- Settings › Advanced › Code Injection › Header: plak de ROASaurus-scripttag.
- Plak op dezelfde pagina onder Order Status Page (en Order Confirmation Page voor digitale producten) het snippet voor de bedankpagina.
- Settings › Advanced › Developer API Keys › Generate Key met Orders: read en voer die in bij ROASaurus.
Waarom polling en geen webhooks
Squarespace stuurt webhooks alleen naar OAuth-apps, niet naar integraties die een merchant met een API-sleutel instelt. Daarom haalt ROASaurus elke 5 minuten bestellingen op die sinds de vorige run zijn gewijzigd, met een overlap van 30 minuten. Bestellingen met betalingsstatus PAID worden verstuurd; duplicaten worden genegeerd.
Bestellingen koppelen aan advertentieklikken
Het snippet gebruikt de eigen variabelen van Squarespace, {orderId}, {orderGrandTotal} en {customerEmailAddress}, om de ROASaurus-aankoop met hetzelfde bestel-id te laten afgaan. Het is verpakt in {.if firstPageView}, zodat een shopper die de orderstatuspagina herlaadt het niet twee keer laat afgaan. Zonder het snippet valt ROASaurus terug op een e-mailadres dat de bezoeker eerder op je site heeft opgegeven, bijvoorbeeld in een popup.
Wat ROASaurus uit elke bestelling leest
Het bestelnummer, het eindtotaal en de valuta, het e-mailadres en het id van de klant, de naam, telefoon en het adres van de factuur, en van elke orderregel het product, de variant, het aantal, de betaalde prijs en de SKU.
Beperkingen
- Voor API-sleutels is het abonnement Commerce Advanced nodig.
- Bestellingen komen tot 5 minuten na betaling binnen. "Fetch orders now" synchroniseert op verzoek.
- Squarespace-bestellingen bevatten het IP-adres van de shopper niet, dus de IP-terugval is niet beschikbaar. Voeg het snippet toe.
- 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
Welk Squarespace-abonnement heb ik nodig?
Voor developer API-sleutels voor bestellingen is het abonnement Commerce Advanced nodig. Het trackingscript en het snippet werken via Code Injection.
Waarom kan Squarespace bestellingen niet direct versturen?
Squarespace stuurt webhooks alleen naar OAuth-apps, niet naar API-sleutels van merchants. ROASaurus pollt daarom elke 5 minuten de Commerce API.
Telt het herladen van de orderpagina dubbel?
Nee. Het snippet draait alleen bij de eerste weergave van de orderstatuspagina en ROASaurus negeert een tweede aankoop met hetzelfde bestel-id.
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 →