Server-side tracking for Squarespace Commerce
ROASaurus leser betalte bestillinger fra Squarespace Commerce API hvert 5. minutt og sender dem til annonseplattformene dine fra serveren. En kodesnutt på siden for ordrestatus kobler hver bestilling til annonseklikket.
| Squarespace i et overblikk | |
|---|---|
| Bestillinger kommer inn via | Polling av Commerce API hvert 5. minutt |
| Tilgangsdata | Developer API key med Orders: read |
| Abonnement | API-nøkler krever abonnementet Commerce Advanced |
| Betalte bestillinger | Betalingstilstand PAID |
| Kodesnutt på takkesiden | Code injection på Order Status Page, med {orderId} og {orderGrandTotal} |
Slik kobles Squarespace til
- Settings › Advanced › Code Injection › Header: lim inn script-taggen fra ROASaurus.
- På den samme siden limer du inn kodesnutten for takkesiden under Order Status Page (og Order Confirmation Page for digitale produkter).
- Settings › Advanced › Developer API Keys › Generate Key med Orders: read, og skriv den inn i ROASaurus.
Hvorfor polling og ikke webhooks
Squarespace sender bare webhooks til OAuth-apper, ikke til integrasjoner en butikkeier setter opp med en API-nøkkel. Derfor henter ROASaurus bestillinger som er endret siden forrige kjøring, hvert 5. minutt, med 30 minutters overlapping. Bestillinger med betalingstilstanden PAID sendes; duplikater ignoreres.
Koble bestillinger til annonseklikk
Kodesnutten bruker Squarespaces egne variabler, {orderId}, {orderGrandTotal} og {customerEmailAddress}, til å utløse ROASaurus-kjøpet med den samme bestillings-ID-en. Den er pakket inn i {.if firstPageView}, slik at en kunde som laster siden for ordrestatus på nytt, ikke utløser den to ganger. Uten kodesnutten faller ROASaurus tilbake på en e-postadresse den besøkende oppga tidligere på nettstedet ditt, for eksempel i en popup.
Hva ROASaurus leser fra hver bestilling
Bestillingsnummeret, totalsummen og valutaen, kundens e-post og ID, navnet, telefonnummeret og adressen for fakturering, og for hver varelinje produktet, varianten, antallet, betalt pris og SKU-en.
Begrensninger
- API-nøkler krever abonnementet Commerce Advanced.
- Bestillinger kommer inn opptil 5 minutter etter betaling. «Fetch orders now» synkroniserer på forespørsel.
- Squarespace-bestillinger inneholder ikke kundens IP-adresse, så IP-reserven er ikke tilgjengelig. Legg til kodesnutten.
- Connectoren er bygget etter plattformens offisielle API-dokumentasjon. Trykk på Test connection etter at du har lagret legitimasjonen din, legg deretter inn en testbestilling og sjekk Event log.
Relatert
Spørsmål, besvart
Hvilket Squarespace-abonnement trenger jeg?
Developer API keys for bestillinger krever abonnementet Commerce Advanced. Tracking-scriptet og kodesnutten fungerer gjennom Code Injection.
Hvorfor kan ikke Squarespace sende bestillinger umiddelbart?
Squarespace sender bare webhooks til OAuth-apper, ikke til API-nøkler som butikkeiere oppretter. I stedet poller ROASaurus Commerce API hvert 5. minutt.
Teller en omlasting av bestillingssiden to ganger?
Nei. Kodesnutten kjører bare ved første visning av siden for ordrestatus, og ROASaurus ignorerer et nytt kjøp med samme bestillings-ID.
Hvert salg, sporet til annonsen som tjente det inn
Server-side tracking, fortjeneste og livstidsverdi i én app. 14 dagers gratis prøveperiode, uten kredittkort.
Start den gratis prøveperioden din →