Webshop-Integration

Server-Side-Tracking für Squarespace Commerce

ROASaurus liest bezahlte Bestellungen alle 5 Minuten aus der Squarespace Commerce API und sendet sie vom Server an deine Werbeplattformen. Ein Snippet auf der Bestellstatusseite verknüpft jede Bestellung mit dem Anzeigenklick.

Squarespace auf einen Blick
Bestellungen kommen an perCommerce-API-Abfrage alle 5 Minuten
ZugangsdatenDeveloper-API-Key mit Orders: read
TarifAPI-Keys erfordern den Tarif Commerce Advanced
Bezahlte BestellungenZahlungsstatus PAID
Snippet für die DankeseiteCode Injection auf der Order Status Page, mit {orderId} und {orderGrandTotal}

So verbindet sich Squarespace

  1. Settings › Advanced › Code Injection › Header: Füge das ROASaurus-Script-Tag ein.
  2. Füge auf derselben Seite unter Order Status Page (und Order Confirmation Page für digitale Produkte) das Snippet für die Dankeseite ein.
  3. Settings › Advanced › Developer API Keys › Generate Key mit Orders: read und gib ihn in ROASaurus ein.

Warum Abfrage statt Webhooks

Squarespace sendet Webhooks nur an OAuth-Apps, nicht an Integrationen, die ein Händler mit einem API-Key einrichtet. Deshalb ruft ROASaurus alle 5 Minuten Bestellungen ab, die seit dem letzten Lauf geändert wurden, mit 30 Minuten Überlappung. Bestellungen mit dem Zahlungsstatus PAID werden gesendet; Duplikate werden ignoriert.

Bestellungen mit Anzeigenklicks verknüpfen

Das Snippet nutzt die eigenen Variablen von Squarespace, {orderId}, {orderGrandTotal} und {customerEmailAddress}, um den ROASaurus-Kauf mit derselben Bestell-ID auszulösen. Es ist in {.if firstPageView} eingebettet, sodass ein Kunde, der die Bestellstatusseite neu lädt, es nicht doppelt auslöst. Ohne das Snippet greift ROASaurus auf eine E-Mail-Adresse zurück, die der Besucher zuvor auf deiner Website angegeben hat, etwa in einem Popup.

Was ROASaurus aus jeder Bestellung liest

Die Bestellnummer, Gesamtsumme und Währung, E-Mail und ID des Kunden, Rechnungsname, Telefonnummer und Adresse sowie Produkt, Variante, Menge, gezahlter Preis und SKU jeder Position.

Einschränkungen

  • API-Keys erfordern den Tarif Commerce Advanced.
  • Bestellungen kommen bis zu 5 Minuten nach der Zahlung an. „Fetch orders now“ synchronisiert bei Bedarf.
  • Squarespace-Bestellungen enthalten nicht die IP-Adresse des Kunden, daher ist der IP-Fallback nicht verfügbar. Füge das Snippet hinzu.
  • Der Konnektor basiert auf der offiziellen API-Dokumentation der Plattform. Klicke nach dem Speichern deiner Zugangsdaten auf Test connection, gib dann eine Testbestellung auf und prüfe das Event log.

Verwandt

FAQ

Antworten auf deine Fragen

Welchen Squarespace-Tarif brauche ich?

Developer-API-Keys für Bestellungen erfordern den Tarif Commerce Advanced. Das Tracking-Skript und das Snippet funktionieren über Code Injection.

Warum kann Squarespace keine Bestellungen sofort senden?

Squarespace sendet Webhooks nur an OAuth-Apps, nicht an API-Keys von Händlern. ROASaurus fragt stattdessen alle 5 Minuten die Commerce API ab.

Zählt ein Neuladen der Bestellseite doppelt?

Nein. Das Snippet läuft nur beim ersten Aufruf der Bestellstatusseite, und ROASaurus ignoriert einen zweiten Kauf mit derselben Bestell-ID.

Jeder Verkauf, zurückverfolgt zur Anzeige, die ihn gebracht hat

Server-Side-Tracking, Gewinn und Customer Lifetime Value in einer App. 14 Tage kostenlos testen, ohne Kreditkarte.

Starte deine kostenlose Testphase →