Webshop-Integration

Server-Side-Tracking für Shopware 6

Füge eine Shopware-Integration mit Lesezugriff auf Bestellungen hinzu, und ROASaurus synchronisiert bezahlte Bestellungen über die Admin API. Ein Flow-Builder-Webhook sorgt dafür, dass sie im Moment der Zahlung ankommen.

Shopware auf einen Blick
Bestellungen kommen an perAdmin-API-Abfrage alle 5 Minuten; sofort mit einem Flow-Builder-Webhook
ZugangsdatenIntegrations-Zugriffsschlüssel-ID und geheimer Zugriffsschlüssel
Bezahlte BestellungenEine Transaktion im Status paid
Bestell-IDDie Shopware-Bestellnummer
Snippet für die DankeseiteTemplate checkout/finish, mit page.order.orderNumber

So verbindet sich Shopware

  1. Füge das ROASaurus-Skript zu deinem Theme hinzu (base.html.twig, Block base_script_tracking) oder über ein Tag-Manager-Plugin.
  2. Einstellungen › System › Integrationen › Integration hinzufügen, mit Lesezugriff auf Bestellungen. Gib die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel in ROASaurus ein.
  3. Für eine exakte Zuordnung füge das Snippet für die Dankeseite zu storefront/page/checkout/finish/index.html.twig hinzu.

ROASaurus tauscht die Integrationsschlüssel gegen ein kurzlebiges Admin-API-Token und sucht alle 5 Minuten nach Bestellungen, die seit dem letzten Lauf aktualisiert wurden. Eine Bestellung gilt als bezahlt, wenn eine ihrer Transaktionen im Status paid ist. Als ID dient die Bestellnummer, die auch das Snippet für die Dankeseite sendet.

Sofortige Bestellungen mit dem Flow Builder

Lege bei Shopware Evolve und höher einen Flow mit dem Auslöser State Enter / Order Transaction / State / Paid und der Aktion Call URL (Webhook) an, POST an deine ROASaurus-Webhook-URL. Der Aufruf ist nur ein Signal: ROASaurus vertraut seinem Inhalt nicht und ruft stattdessen die Bestellungen der letzten zwei Stunden über die authentifizierte API ab. Bestellungen, die es schon hat, werden ignoriert.

Was ROASaurus aus jeder Bestellung liest

Die Summe, Währung, das Bestelldatum, E-Mail und Name des Kunden, Rechnungstelefonnummer, Stadt, PLZ und Land, die Kunden-ID und die Produktpositionen mit Menge, Stückpreis und Produktnummer.

Bestellungen mit Anzeigenklicks verknüpfen

Das Snippet für die Dankeseite löst den ROASaurus-Kauf mit Bestellnummer und Summe aus, was die Bestellung mit dem Besucher verknüpft. Ohne es nutzt ROASaurus eine E-Mail-Adresse, die der Besucher zuvor auf deiner Website angegeben hat, etwa in einem Popup.

Einschränkungen

  • Shopware anonymisiert die IP-Adresse des Kunden standardmäßig, daher hilft der IP-Fallback selten. Füge das Snippet für die Dankeseite hinzu.
  • Flow-Builder-Webhooks brauchen Shopware Evolve oder höher. Ohne sie dauern Bestellungen bis zu 5 Minuten.
  • 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

Brauche ich den Flow Builder?

Nein. Ohne ihn ruft ROASaurus bezahlte Bestellungen alle 5 Minuten ab. Der Flow-Builder-Webhook, verfügbar ab Shopware Evolve, sorgt nur dafür, dass sie sofort ankommen.

Ist der Flow-Builder-Webhook sicher?

ROASaurus behandelt ihn nur als Signal. Es übernimmt nie Bestelldaten aus dem Aufruf, sondern ruft aktuelle Bestellungen mit deinen Integrationsschlüsseln über die Admin API ab.

Welchen Zugriff braucht die Integration?

Lesezugriff auf Bestellungen. ROASaurus nutzt die Zugriffsschlüssel-ID und das Secret der Integration, um ein kurzlebiges Admin-API-Token zu erhalten.

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 →