Server-Ereignisse im Überblick

Mit Server-Ereignissen meldet Ihr Backend Konversionen über einen API-Schlüssel direkt an die Scanova-Tracking-API. Anders als Browser-Ereignisse lassen sich Server-Ereignisse nicht von Werbeblockern unterdrücken, sie sind von Browser-Einschränkungen unabhängig und können sensible Zuordnungsdaten sicher übertragen.

Wann Server-Ereignisse sinnvoll sind

Browser-Ereignisse nutzen	Server-Ereignisse nutzen
Seitenaufrufe und Navigation	Kaufbestätigungen
Klicks und Scrolltiefe	Abo-Aktivierungen
Interaktionen mit Formularfeldern	Lead-Anlage in Ihrem CRM
Jede im Browser sichtbare Aktion	E-Mail-Bestätigungen bei der Registrierung
—	Jede Aktion, die serverseitig stattfindet

Am vollständigsten wird das Bild, wenn Sie beides kombinieren: Das Browser-SDK verfolgt die Nutzerreise, und Ihr Server meldet, wann eine Konversion tatsächlich stattgefunden hat.

So funktioniert die Zuordnung serverseitig

Die scan_session_id ist das Bindeglied zwischen einem QR-Code-Scan und einem Server-Ereignis. Der typische Ablauf sieht so aus:

Nutzer scannt QR-Code
    ↓
Landet auf yoursite.com/?scnv=7ad26d4f-...
    ↓
SDK speichert scan_session_id im localStorage
    ↓
Nutzer schließt ein Kaufformular ab
    ↓
Browser sendet scan_session_id an Ihre Checkout-API
    ↓
Ihr Server sendet ein purchase-Ereignis mit dieser scan_session_id
    ↓
Scanova ordnet den Kauf dem QR-Code-Scan zu

Ihre Aufgabe: die scan_session_id vom Browser an Ihren Server übergeben. Üblich sind dafür:

Als verstecktes Formularfeld mitschicken
Im API-Anfragetext aus Ihrem Frontend-JavaScript senden
Beim Laden der Seite aus dem URL-Parameter lesen und serverseitig in der Sitzung des Nutzers ablegen

// Read from SDK (browser-side)
// Note: _scnv is the SDK's internal storage key — structure may change.
// Use this pattern only if no higher-level SDK method is available.
const scanSessionId = localStorage.getItem('_scnv')
  ? JSON.parse(localStorage.getItem('_scnv')).sid
  : null;

// Include in your API call to your backend
await fetch('/api/checkout', {
  method: 'POST',
  body: JSON.stringify({ ...orderData, scan_session_id: scanSessionId })
});

Voraussetzungen

Eine Tracking-Website, angelegt unter Analysen → Konversionsverfolgung
Ein auf die Website beschränkter API-Schlüssel (erzeugt im Tab Tracking-Einrichtung → Über API verfolgen der Website)
Ihr Server kann ausgehende HTTPS-POST-Anfragen stellen
Sie haben einen Weg, die scan_session_id aus dem Browser des Nutzers entgegenzunehmen

Sicherheitsanforderungen

Geben Sie Ihren API-Schlüssel niemals in Frontend-Code oder clientseitigem JavaScript preis
Bewahren Sie den Schlüssel in einer Umgebungsvariablen oder einem Secrets-Manager auf
Tauschen Sie Schlüssel regelmäßig im Dashboard aus

Nächste Schritte

API-Schlüssel erzeugen

Erzeugen Sie im Dashboard einen auf eine Website beschränkten API-Schlüssel.

Ereignisse senden

Codebeispiele in cURL, Node.js, Python und PHP.

Idempotenz & Wiederholungen

So wiederholen Sie fehlgeschlagene Anfragen gefahrlos.

Zustellung prüfen

Prüfen Sie, ob Ihre Ereignisse ankommen.

Überblick

Browser-SDK

Serverseitig

API-Referenz

Ressourcen

Wann Server-Ereignisse sinnvoll sind

So funktioniert die Zuordnung serverseitig

Voraussetzungen

Sicherheitsanforderungen

Nächste Schritte

API-Schlüssel erzeugen

Ereignisse senden

Idempotenz & Wiederholungen

Zustellung prüfen

​Wann Server-Ereignisse sinnvoll sind

​So funktioniert die Zuordnung serverseitig

​Voraussetzungen

​Sicherheitsanforderungen

​Nächste Schritte

API-Schlüssel erzeugen

Ereignisse senden

Idempotenz & Wiederholungen

Zustellung prüfen

Wann Server-Ereignisse sinnvoll sind

So funktioniert die Zuordnung serverseitig

Voraussetzungen

Sicherheitsanforderungen

Nächste Schritte