Allgemeines
Brauche ich Browser- und Server-Ereignisse gleichzeitig?
Nein — jedes funktioniert auch für sich. Browser-Ereignisse brauchen kein Backend und sind der schnellste Einstieg. Server-Ereignisse setzen einen API-Schlüssel und Code im Backend voraus, sind dafür zuverlässiger (Werbeblocker greifen nicht) und erlauben es, Umsätze und serverseitige Konversionen zu melden. Die meisten nutzen beides: das Browser-SDK für die Interaktionsdaten und Server-Ereignisse für bestätigte Konversionen.Kann ich Konversionen ohne QR-Code-Scan erfassen?
Nein. Das Browser-SDK braucht für jedes Ereignis einescan_session_id — kommt jemand ohne QR-Code-Scan auf Ihre Website, erkennt das SDK die fehlende Sitzung und sendet nichts. Auch die API für Server-Ereignisse verlangt scan_session_id als Pflichtfeld.
Die Konversionsverfolgung von Scanova ist eigens für die Messung von QR-Code-Zugriffen gebaut. Als allgemeines Web-Analyse-Werkzeug ist sie nicht gedacht.
Browser-SDK
Welche Browser unterstützt das SDK?
Das SDK unterstützt alle modernen Browser: Chrome, Firefox, Safari, Edge und ihre mobilen Ausgaben. ÜberXMLHttpRequest oder fetch und localStorage hinaus braucht es keine besonderen Browser-Funktionen.
Können Werbeblocker das SDK ausbremsen?
Ja — Browser-Ereignisse ant.scanova.io können von datenschutzorientierten Werbeblockern und Erweiterungen blockiert werden. Nutzen Sie für wichtige Konversionen (Käufe, Registrierungen) serverseitige Ereignisse, die sich nicht blockieren lassen.
Bremst das SDK meine Seite aus?
Das SDK lädt asynchron (Attributasync) und hält den Seitenaufbau nicht auf. Minifiziert und gzip-komprimiert ist das Skript rund 10 KB groß. Ereignisse gehen nach dem Laden der Seite im Hintergrund raus.
Kann ich das SDK auf mehreren Seiten einsetzen?
Ja — binden Sie das Snippet in die globale<head>-Vorlage Ihrer Website ein, dann läuft es auf jeder Seite. Die scan_session_id bleibt über den localStorage seitenübergreifend erhalten, sodass die gesamte Nutzerreise dem ursprünglichen Scan zugeordnet wird.
Was passiert, wenn jemand ohne QR-Code-Scan vorbeikommt?
Es werden keine Ereignisse gesendet. Das Browser-SDK prüft vor jedem Ereignis, ob einescan_session_id vorliegt. Fehlt sie (die Person kam direkt und nicht über einen Scan), überspringt das SDK das Ereignis vollständig. Für diesen Besuch wird nichts gespeichert.
Wie lange hält die Zuordnung zu einem Scan?
60 Tage. Kehrt jemand nach einem QR-Code-Scan innerhalb von 60 Tagen zurück, werden die Besuche weiterhin diesem Scan zugeordnet. Nach 60 Tagen läuft der Eintrag_scnv im localStorage ab und die Zuordnung entfällt.
Server-Ereignisse
Wie bekomme ich die scan_session_id auf meinen Server?
Übergeben Sie sie vom Browser an Ihren Server. Üblich sind:- als verstecktes Formularfeld mitschicken
- im Anfragetext mitsenden, wenn Ihr Frontend Ihre API aufruft
- beim Laden der Seite aus dem URL-Parameter lesen und serverseitig in der Sitzung ablegen
Kann ich Ereignisse im Stapel senden?
Ja. Nutzen SiePOST /server-events/batch mit bis zu 100 Ereignissen je Anfrage. Für Backends mit hohem Aufkommen und warteschlangenbasierte Architekturen ist das der empfohlene Weg.
Was passiert, wenn ich eine fehlgeschlagene Anfrage wiederhole?
Senden Sie dieselbeevent_id erneut, wird die Dublette als solche markiert und nicht in die Konversionszahlen aufgenommen. Verwenden Sie bei Wiederholungen immer dieselbe event_id. Siehe Idempotenz & Wiederholungen.
Kann ich Ereignisse mit zurückliegendem Zeitstempel senden?
Ja — mit dem Feldevent_time legen Sie fest, wann das Ereignis stattfand. Das hilft, wenn Sie Ereignisse asynchron aus einer Warteschlange senden. Das Feld erwartet das Format ISO 8601 in UTC.
Datenschutz & Daten
Soll ich E-Mail-Adressen im Klartext senden?
Nein. Schreiben Sie niemals E-Mail-Adressen im Klartext inmetadata oder properties. Nutzen Sie user_identifiers.email_hash mit einem SHA-256-Hash der kleingeschriebenen Adresse.
Wofür ist das Feld consent da?
Das Feld consent übermittelt der Verarbeitung die DSGVO-Einwilligung der Person:
granted— alle Felder werden normal gespeichertdeniedoderpending— personenbezogene Felder (page_url,referrer,city,metadata) werden vor dem Speichern entfernt
consent selbst wird als Nachweis immer gespeichert.
Wie lange werden die Daten aufbewahrt?
Ereignisse werden standardmäßig zwei Jahre aufbewahrt. Verwaiste Datensätze — Ereignisse, deren Scan-Sitzung sich nicht auflösen lässt — werden nach 24 Stunden automatisch gelöscht.Dashboard & Berichte
Wie lange dauert es, bis Ereignisse in den Berichten stehen?
Bei normaler Last meist 10 bis 30 Sekunden. Bei Lastspitzen sind Verzögerungen von einigen Minuten möglich.Wie pausiere ich das Tracking für eine Website?
Öffnen Sie Analysen → Konversionsverfolgung → Konversionsverfolgung einrichten, wählen Sie bei der Website Tracking-Einrichtung und nutzen Sie im Tab Skript einbetten den Schalter Site Status. Bei pausierter Website liefern Ereignisse von dort400.
Was ist ein verwaistes Ereignis und wann wird es gelöscht?
Bei einem verwaisten Ereignis liegt diescan_session_id zwar vor, lässt sich aber noch keinem QR-Code zuordnen — das passiert, wenn ein Ereignis eintrifft, bevor die Verarbeitung die Sitzung mit einem QR-Code-Datensatz verknüpft hat. Bleiben die Sitzungsdaten aus, wird das verwaiste Ereignis nach 24 Stunden automatisch entfernt. Treffen sie rechtzeitig ein, wird es nachträglich ergänzt und wie üblich zwei Jahre aufbewahrt.