Webshop-integration

Server-side tracking til Squarespace Commerce

ROASaurus læser betalte ordrer fra Squarespace Commerce API'et hvert 5. minut og sender dem til dine annonceplatforme fra serveren. Et snippet på ordrestatussiden knytter hver ordre til annonceklikket.

Squarespace i overblik
Ordrer ankommer viaCommerce API-hentning hvert 5. minut
LegitimationsoplysningerDeveloper API-nøgle med Orders: read
AbonnementAPI-nøgler kræver abonnementet Commerce Advanced
Betalte ordrerBetalingsstatus PAID
Snippet på tak-sidenCode injection på Order Status Page med {orderId} og {orderGrandTotal}

Sådan forbindes Squarespace

  1. Settings › Advanced › Code Injection › Header: Indsæt ROASaurus-script-tagget.
  2. På den samme side skal du under Order Status Page (og Order Confirmation Page for digitale produkter) indsætte snippet til tak-siden.
  3. Settings › Advanced › Developer API Keys › Generate Key med Orders: read, og indtast den i ROASaurus.

Hvorfor hentning og ikke webhooks

Squarespace sender kun webhooks til OAuth-apps, ikke til integrationer, som en shopejer opsætter med en API-nøgle. Derfor henter ROASaurus hvert 5. minut ordrer, der er ændret siden sidste kørsel, med 30 minutters overlap. Ordrer med betalingsstatus PAID sendes; dubletter ignoreres.

Sådan knyttes ordrer til annonceklik

Snippet bruger Squarespaces egne variabler, {orderId}, {orderGrandTotal} og {customerEmailAddress}, til at udløse ROASaurus-købet med det samme ordre-id. Det er pakket ind i {.if firstPageView}, så en shopper, der genindlæser ordrestatussiden, ikke udløser det to gange. Uden snippet falder ROASaurus tilbage på en e-mail, den besøgende tidligere har oplyst på dit website, for eksempel i en popup.

Hvad ROASaurus læser fra hver ordre

Ordrenummeret, totalbeløbet og valutaen, kundens e-mail og id, navn, telefon og adresse fra faktureringen samt hver ordrelinjes produkt, variant, antal, betalt pris og SKU.

Begrænsninger

  • API-nøgler kræver abonnementet Commerce Advanced.
  • Ordrer ankommer op til 5 minutter efter betalingen. "Fetch orders now" synkroniserer efter behov.
  • Squarespace-ordrer indeholder ikke shopperens IP-adresse, så IP-fallbacken er ikke tilgængelig. Tilføj snippet.
  • Connectoren er bygget ud fra platformens officielle API-dokumentation. Tryk på Test connection, når du har gemt dine legitimationsoplysninger, læg derefter en testordre, og tjek Event log.

Relateret

FAQ

Spørgsmål, besvaret

Hvilket Squarespace-abonnement skal jeg have?

Developer API-nøgler til ordrer kræver abonnementet Commerce Advanced. Tracking-scriptet og snippet virker via Code Injection.

Hvorfor kan Squarespace ikke sende ordrer med det samme?

Squarespace sender kun webhooks til OAuth-apps, ikke til shopejeres API-nøgler. I stedet henter ROASaurus fra Commerce API'et hvert 5. minut.

Tæller en genindlæsning af ordresiden dobbelt?

Nej. Snippet kører kun ved første visning af ordrestatussiden, og ROASaurus ignorerer et andet køb med det samme ordre-id.

Hvert salg, sporet til annoncen, der skabte det

Server-side tracking, overskud og livstidsværdi i én app. 14 dages gratis prøve, uden kreditkort.

Start din gratis prøve →