Webshop-Integration

Server-Side-Tracking für BigCommerce

Gib ROASaurus ein schreibgeschütztes API-Konto auf Shop-Ebene und klicke auf Create webhook. Bezahlte BigCommerce-Bestellungen gehen dann vom Server an deine Werbeplattformen, sobald sie eingehen.

BigCommerce auf einen Blick
Bestellungen kommen an perWebhooks (Bestellung erstellt, Status aktualisiert) plus Abfrage alle 5 Minuten
Webhook-EinrichtungAutomatisch, mit der Schaltfläche Create webhook
ZugangsdatenStore-Hash und ein Zugriffstoken mit Orders: read-only
Bezahlte BestellungenAwaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped, Completed
Snippet für die DankeseiteSkript auf der Bestellbestätigungsseite mit {{checkout.order.id}}

So verbindet sich BigCommerce

  1. Storefront › Script Manager › Create a Script: Ort Footer, Seiten All pages, Typ Script, mit dem ROASaurus-Script-Tag.
  2. Erstelle ein zweites Skript für die Seite Order confirmation mit dem Snippet für die Dankeseite.
  3. Settings › API › Store-level API accounts › Create API account mit Orders: read-only. Gib den Store-Hash (den Teil nach /stores/ in deinem API-Pfad) und das Zugriffstoken in ROASaurus ein.
  4. Speichere und klicke dann auf Create webhook.

Was „Create webhook“ bewirkt

ROASaurus registriert zwei BigCommerce-Webhooks, für erstellte Bestellungen und aktualisierte Bestellstatus. Jede Zustellung enthält einen für deinen Shop einzigartigen geheimen Header, den ROASaurus prüft. Der Webhook sagt nur, welche Bestellung sich geändert hat, deshalb ruft ROASaurus die Bestellung und ihre Produkte aus der API ab. Außerdem prüft es alle 5 Minuten auf geänderte Bestellungen, falls eine Zustellung verloren geht.

Welche Bestellungen zählen

Bestellungen in einem Status, der bedeutet, dass die Zahlung durchgegangen ist: Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped und Completed. Ausstehende oder abgelehnte Bestellungen werden nicht gesendet. ROASaurus liest die Summe inklusive Steuern, die Rechnungs-E-Mail, Telefonnummer, Name und Adresse, die Kunden-ID, die IP-Adresse und jedes Produkt mit seinem Preis inklusive Steuern.

Bestellungen mit Anzeigenklicks verknüpfen

Das Snippet auf der Bestellbestätigungsseite löst den ROASaurus-Kauf mit {{checkout.order.id}} aus, was die Bestellung mit dem Besucher verknüpft. Ohne es probiert ROASaurus eine E-Mail-Adresse, die der Besucher zuvor auf deiner Website angegeben hat, etwa in einem Popup, und dann die IP-Adresse der Bestellung, aber nur, wenn von 3 Stunden vor bis 15 Minuten nach der Bestellung genau ein Besucher mit dieser IP gesehen wurde.

Einschränkungen

  • BigCommerce-Bestellungen liefern ROASaurus keinen User-Agent, daher kann der IP-Fallback bei geteilten IPs (Büros, Mobilfunknetze) oft nicht entscheiden. Das Snippet vermeidet das.
  • 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 API-Zugriff braucht ROASaurus?

Ein API-Konto auf Shop-Ebene mit Orders auf schreibgeschützt. ROASaurus nutzt es, um Bestellungen zu lesen und seine beiden Bestell-Webhooks anzulegen.

Was passiert, wenn ein Webhook fehlschlägt?

ROASaurus fragt BigCommerce außerdem alle 5 Minuten mit 30 Minuten Überlappung ab. Bestellungen, die es schon hat, werden ignoriert, sodass nichts doppelt gesendet wird.

Welche BigCommerce-Status gelten als bezahlt?

Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped und Completed. Andere Status bleiben außen vor, bis die Bestellung in einen davon wechselt.

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 →