Webshop-Integration

Server-Side-Tracking für jede Website

Füge deiner Website ein Script-Tag hinzu und sende bezahlte Bestellungen als JSON aus deinem Backend oder einem No-Code-Tool. ROASaurus ordnet jede Bestellung ihrem Anzeigenklick zu und leitet sie an deine Werbeplattformen weiter.

Eigene Website auf einen Blick
SkriptEin Script-Tag auf jeder Seite: Seitenaufrufe, Click-IDs, das Besucher-Cookie _tl
Orders APIPOST /api/v1/orders mit Shop-Key und API-Key
JSON-WebhookPOST an deine Webhook-URL aus deinem Backend, Zapier, Make oder n8n
Offline-EventsPOST /api/v1/events für Leads, Demos und Abo-Folgezahlungen
Bestellzuordnungvisitor_id (das Cookie _tl), Dankeseiten-Event, eine zuvor vom Besucher angegebene E-Mail oder IP und Browser

1. Das Skript hinzufügen

Füge das Script-Tag von deiner Tracking & platforms-Seite auf jeder Seite ein, meist unter „Custom Code“, „Code Injection“ oder „Header Scripts“. Es erfasst Seitenaufrufe, Click-IDs und UTMs und setzt das Besucher-Cookie _tl. Sende weitere Events mit tlq('track', 'AddToCart', {...}).

2. Bezahlte Bestellungen senden

Orders API. Erstelle unter Settings › Orders API einen API-Key und sende jede bezahlte Bestellung per POST an /api/v1/orders. Das Anfrageformat steht auf dieser Seite. Übergib das Cookie _tl als visitor_id, damit die Bestellung dem Anzeigenklick zugeordnet wird.

JSON-Webhook. Wähle beim Hinzufügen des Shops „Other / custom webhook“ und sende Bestellungen per POST an deine Webhook-URL. Felder: order_id, total, currency, email, phone, first_name, last_name, country, zip, client_ip, user_agent, items (variant_id, quantity, price) und, wenn möglich, visitor_id. Du kannst auch click_ids, landing_url und is_first_order übergeben und Testbestellungen mit "test": true markieren, damit sie gespeichert, aber nicht gesendet werden.

3. Das Dankeseiten-Event auslösen

Löse auf der Bestätigungsseite tlq('track', 'Purchase', ...) aus, mit event_id gesetzt auf order- plus deine Bestell-ID. Das verknüpft die Bestellung mit dem Besucher, auch wenn du das Cookie nicht übergeben kannst. Sobald dein Server Bestellungen sendet, verknüpfen Browser-Käufe nur noch Besucher; sie erzeugen keine Bestellungen mehr.

Leads und Abonnements

Die Offline-Events-API (POST /api/v1/events) nimmt Leads, Demos, MQLs und Abo-Folgezahlungen entgegen und ordnet sie über die gehashte E-Mail einem Besucher zu. Sie akzeptiert bis zu 1.000 Events pro Minute und Shop, je 3 KB.

Funnels und First-Party-Cookies

Trage deine Funnel- und Shop-Domains unter Settings › Linked domains ein, und Links zwischen ihnen tragen die Besucher-ID und die Click-IDs weiter. Wenn du das Skript von deiner eigenen Subdomain auslieferst (ein CNAME), bleibt die Erfassung auf deiner Domain, und _tl wird als HTTP-Cookie neu ausgestellt. Safari kann dieses Cookie trotzdem auf 7 Tage begrenzen.

Verwandt

FAQ

Antworten auf deine Fragen

Brauche ich einen Entwickler?

Nicht immer. Zapier, Make oder n8n können bezahlte Bestellungen aus deinem Shop oder Zahlungstool an die Webhook-URL von ROASaurus senden. Die Besucher-ID aus dem Cookie _tl zu übergeben, erfordert meist eine kleine Änderung auf deiner Website.

Wie sende ich Testbestellungen?

Füge der Bestellung "test": true hinzu. ROASaurus speichert sie, damit du das Format prüfen kannst, sendet aber nichts an Werbeplattformen.

Was, wenn meine Website gar kein Backend hat?

Löse den Browser-Kauf auf der Bestätigungsseite aus. Hat ein Shop keine serverseitige Bestellquelle, erzeugt dieses Event die Bestellung und wird an die Werbeplattformen weitergeleitet. Eine Server-Quelle ist zuverlässiger.

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 →