Schnellstart — in 5 Schritten live - Scanova API Documentation

Diese Anleitung beschreibt die wenigen Schritte vom Scanova-Konto bis zum laufenden Tracking. Für die Feinheiten folgen Sie den Links im jeweiligen Schritt.

Schritt 1: Eine Tracking-Website anlegen

Eine Tracking-Website steht für eine Website-Domain. Ohne sie können Sie weder das SDK einbinden noch Server-Ereignisse senden.

Melden Sie sich im Scanova-Dashboard an
Gehen Sie zu Analysen → Konversionsverfolgung
Klicken Sie auf Create Site
Geben Sie einen Namen ein und tragen Sie Ihre Allowed Domains ein (z. B. yoursite.com)
Speichern Sie

Nach dem Speichern erzeugt Scanova eine eindeutige site_id für diese Website. Sie verwenden sie im Snippet und in allen API-Aufrufen.

Tragen Sie alle Hostnamen ein, auf denen Ihr Tracking-Snippet läuft — die Variante mit www ebenso wie die ohne www, dazu alle Staging-Domains, auf denen Sie testen wollen.

Schritt 2: Das Browser-SDK einbinden

Wählen Sie unter Analysen → Konversionsverfolgung → Konversionsverfolgung einrichten bei der eben angelegten Website Tracking-Einrichtung und bleiben Sie im Tab Skript einbetten
Stellen Sie die Schalter für die automatische Erfassung (Seitenaufrufe, Klicks, Formularabsendungen) und den Debug-Modus ein
Kopieren Sie das erzeugte Snippet
Fügen Sie es in der HTML-Vorlage Ihrer Website vor </head> ein

<head>
  <!-- other tags -->
  <script>
  (function(w,d,s,o,f,js,fjs){
    w['ScanovaTrackingObject']=o;w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)};
    js=d.createElement(s),fjs=d.getElementsByTagName(s)[0];
    js.id=o;js.src=f;js.async=1;fjs.parentNode.insertBefore(js,fjs);
  })(window,document,'script','scanova','https://cdn.scanova.io/ct/js/qcg.min.js');

  scanova('init', 'YOUR_SITE_ID', {
    autoPageview: true,
    autoClicks: true,
    autoForms: true,
    autoScroll: true
  });
  </script>
</head>

Sie nutzen den Google Tag Manager? Siehe Einbindung über GTM.

Schritt 3: Ihre QR-Codes mit der Tracking-Website verknüpfen

Damit Ereignisse einem bestimmten QR-Code zugeordnet werden, muss dessen Zieldomain zu einer der Allowed Domains Ihrer Tracking-Website passen.

Öffnen Sie einen QR-Code im Scanova-Dashboard
Gehen Sie zu seinen Einstellungen unter Settings oder Redirect
Prüfen Sie, dass die Ziel-URL auf einer Domain aus Schritt 1 liegt (z. B. yoursite.com)

Führt der QR-Code auf eine Domain, die nicht in den Allowed Domains der Tracking-Website steht, werden Browser-Ereignisse von dieser Domain mit 403 abgewiesen. Die Zuordnung funktioniert nur bei passender Zieldomain.

Schritt 4: Prüfen, ob das SDK arbeitet

Öffnen Sie Ihre Website in einem Browser
Öffnen Sie die DevTools und darin den Tab Network
Filtern Sie nach /ct
Laden Sie die Seite neu — Sie sollten eine POST-Anfrage an https://t.scanova.io/ct mit der Antwort 200 sehen

Sehen Sie die Anfrage, arbeitet das SDK. Andernfalls hilft Fehlerbehebung für das Browser-SDK.

Schritt 5: (Optional) Serverseitige Konversionen senden

Für Kaufbestätigungen, Registrierungen und andere Backend-Ereignisse erzeugen Sie einen API-Schlüssel und senden die Ereignisse von Ihrem Server.

Öffnen Sie bei derselben Website Tracking-Einrichtung und dann den Tab Über API verfolgen
Wählen Sie Add New Key, vergeben Sie einen Namen, kopieren Sie den Schlüssel und bewahren Sie ihn sicher auf
Senden Sie eine POST-Anfrage an https://track.scanova.io/server-events:

curl -X POST "https://track.scanova.io/server-events" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "site_id": "YOUR_SITE_ID",
    "event_name": "purchase",
    "scan_session_id": "SCAN_SESSION_ID_FROM_BROWSER",
    "conversion_value": { "amount": 49.99, "currency": "USD" }
  }'

Geben Sie Ihren X-API-Key niemals in Code preis, der im Browser läuft. Er gehört ausschließlich auf den Server.

Ausführliche Anleitung: Server-Ereignisse senden

Schritt 6: Ihre Daten ansehen

Öffnen Sie im Dashboard Analysen → Konversionsverfolgung, wählen Sie Ihre Website und öffnen Sie den Tab Analytics. Ihre ersten Ereignisse sollten innerhalb von 30–60 Sekunden nach der Prüfung des SDK in Schritt 3 erscheinen.

Wie es weitergeht

Das Browser-SDK konfigurieren

Alle SDK-Optionen — Schalter für die automatische Erfassung, Debug-Modus und mehr.

Eigene Ereignisse

Erfassen Sie gezielt Aktionen wie Klicks auf Schaltflächen oder ausgefüllte Formulare.

Server-Ereignisse

Konversionen sicher aus dem Backend senden — mit Zuordnung.

SPAs & Frameworks

Einrichtungsschritte für React, Next.js und Vue.

Überblick

Browser-SDK

Serverseitig

API-Referenz

Ressourcen

Schnellstart — in 5 Schritten live

Schritt 1: Eine Tracking-Website anlegen

Schritt 2: Das Browser-SDK einbinden

Schritt 3: Ihre QR-Codes mit der Tracking-Website verknüpfen

Schritt 4: Prüfen, ob das SDK arbeitet

Schritt 5: (Optional) Serverseitige Konversionen senden

Schritt 6: Ihre Daten ansehen

Wie es weitergeht

Das Browser-SDK konfigurieren

Eigene Ereignisse

Server-Ereignisse

SPAs & Frameworks

​Schritt 1: Eine Tracking-Website anlegen

​Schritt 2: Das Browser-SDK einbinden

​Schritt 3: Ihre QR-Codes mit der Tracking-Website verknüpfen

​Schritt 4: Prüfen, ob das SDK arbeitet

​Schritt 5: (Optional) Serverseitige Konversionen senden

​Schritt 6: Ihre Daten ansehen

​Wie es weitergeht

Das Browser-SDK konfigurieren

Eigene Ereignisse

Server-Ereignisse

SPAs & Frameworks

Schritt 1: Eine Tracking-Website anlegen

Schritt 2: Das Browser-SDK einbinden

Schritt 3: Ihre QR-Codes mit der Tracking-Website verknüpfen

Schritt 4: Prüfen, ob das SDK arbeitet

Schritt 5: (Optional) Serverseitige Konversionen senden

Schritt 6: Ihre Daten ansehen

Wie es weitergeht