Server-side tracking för Squarespace Commerce
ROASaurus läser betalda ordrar från Squarespace Commerce API var 5:e minut och skickar dem till dina annonsplattformar från servern. Ett snippet på orderstatussidan kopplar varje order till annonsklicket.
| Squarespace i korthet | |
|---|---|
| Ordrar kommer in via | Commerce API-polling var 5:e minut |
| Åtkomstuppgifter | Developer API-nyckel med Orders: read |
| Plan | API-nycklar kräver planen Commerce Advanced |
| Betalda ordrar | Betalningsstatus PAID |
| Tacksides-snippet | Code Injection på Order Status Page, med {orderId} och {orderGrandTotal} |
Så ansluter Squarespace
- Settings › Advanced › Code Injection › Header: klistra in ROASaurus scripttagg.
- På samma sida, under Order Status Page (och Order Confirmation Page för digitala produkter), klistrar du in tacksides-snippetet.
- Settings › Advanced › Developer API Keys › Generate Key med Orders: read, och ange den i ROASaurus.
Varför polling och inte webhooks
Squarespace skickar bara webhooks till OAuth-appar, inte till integrationer som en handlare sätter upp med en API-nyckel. Därför hämtar ROASaurus ordrar som ändrats sedan senaste körningen, var 5:e minut, med 30 minuters överlappning. Ordrar med betalningsstatus PAID skickas; dubbletter ignoreras.
Koppla ordrar till annonsklick
Snippetet använder Squarespaces egna variabler, {orderId}, {orderGrandTotal} och {customerEmailAddress}, för att skicka ROASaurus-köpet med samma order-id. Det är omslutet av {.if firstPageView}, så en köpare som laddar om orderstatussidan inte skickar det två gånger. Utan snippetet faller ROASaurus tillbaka på en e-postadress som besökaren angav tidigare på din sajt, till exempel i en popup.
Vad ROASaurus läser från varje order
Ordernumret, slutsumman och valutan, kundens e-postadress och id, faktureringsnamn, telefonnummer och adress, samt varje orderrads produkt, variant, antal, betalt pris och SKU.
Begränsningar
- API-nycklar kräver planen Commerce Advanced.
- Ordrar kommer in upp till 5 minuter efter betalning. "Fetch orders now" synkroniserar på begäran.
- Squarespace-ordrar innehåller inte köparens IP-adress, så IP-reserven är inte tillgänglig. Lägg till snippetet.
- Kopplingen är byggd utifrån plattformens officiella API-dokumentation. Klicka på Test connection när du har sparat dina åtkomstuppgifter, lägg sedan en testorder och kolla i Event log.
Relaterat
Frågor, besvarade
Vilken Squarespace-plan behöver jag?
Developer API-nycklar för ordrar kräver planen Commerce Advanced. Trackingskriptet och snippetet fungerar via Code Injection.
Varför kan inte Squarespace skicka ordrar direkt?
Squarespace skickar bara webhooks till OAuth-appar, inte till handlares API-nycklar. I stället kontrollerar ROASaurus Commerce API var 5:e minut.
Räknas det två gånger om orderstatussidan laddas om?
Nej. Snippetet körs bara vid första visningen av orderstatussidan, och ROASaurus ignorerar ett andra köp med samma order-id.
Varje försäljning, spårad till annonsen som genererade den
Server-side tracking, vinst och livstidsvärde i en app. 14 dagars gratis provperiod, inget kreditkort.
Starta din gratis provperiod →