Skip to main content

​
Der Weg vom Scan zum Bericht

So läuft es ab — vom Moment des Scans bis zu dem Moment, in dem das Ereignis in Ihren Berichten auftaucht.

​
Die Scan-Sitzung

Der Abfrageparameter scnv ist der Schlüssel zur Zuordnung. Er enthält eine Scan-Sitzungs-ID — eine UUID, die genau einen Scan eines bestimmten QR-Codes durch eine bestimmte Person zu einem bestimmten Zeitpunkt kennzeichnet.
Lädt das Browser-SDK auf einer Seite mit diesem Parameter, tut es Folgendes:
  1. Es liest den Wert scnv aus der URL
  2. Es speichert ihn mit 60 Tagen Gültigkeit im localStorage
  3. Es hängt ihn als scan_session_id an jedes Ereignis an, das dieser Browser sendet
Kehrt die Person also innerhalb von 60 Tagen zurück, werden ihre weiteren Aktionen weiterhin dem ursprünglichen Scan zugeordnet.

​
Zuordnung über Seiten und Sitzungen hinweg

Die Scan-Sitzungs-ID bleibt beim Wechsel zwischen Seiten derselben Domain erhalten. Wenn jemand:
  1. einen QR-Code scannt → auf /landing landet
  2. weiter zu /pricing klickt
  3. sich auf /signup registriert
werden alle drei Seitenaufrufe demselben QR-Code-Scan zugeordnet, sofern das SDK auf allen Seiten eingebunden ist.

​
Browser-Ereignisse und Server-Ereignisse

Es gibt zwei Arten von Ereignissen: Beide Arten nehmen eine scan_session_id entgegen, die sie mit dem QR-Code-Scan verknüpft. Für Server-Ereignisse muss Ihr Backend die scan_session_id aus dem Browser erhalten — üblicherweise über ein Formularfeld, ein Sitzungs-Cookie oder einen API-Aufruf.

​
Wie Ereignisse verarbeitet werden

Sobald die Tracking-API ein Ereignis erhält, durchläuft es mehrere Verarbeitungsschritte:
  1. Prüfung — kontrolliert Pflichtfelder, Größe der Nutzdaten und die Berechtigung von Website und Domain
  2. Dublettenerkennung — markiert wiederholte Werte von event_id als Dubletten (sie werden weiterhin gespeichert, nicht verworfen)
  3. Geräteangaben — liest aus dem User-Agent Gerätetyp, Browser und Betriebssystem aus
  4. Standortangaben — ermittelt per GeoIP Land und Stadt aus der IP-Adresse
  5. Verknüpfung der Identität — löst die scan_session_id anhand der Scanova-Datenbank zu QR-Code-ID und Nutzer-ID auf
  6. Betrugserkennung — bewertet nach Heuristiken und markiert bot-artiges Verhalten
  7. Datenschutz / DSGVO — entfernt personenbezogene Felder, wenn consent auf denied oder pending steht
Verarbeitete Ereignisse erscheinen mit kurzer Verzögerung in den Berichten Ihres Dashboards (in der Regel unter 10 Sekunden).

​
Identität und Sitzungen

Jedes Ereignis, das das SDK sendet, trägt drei getrennte Identitätswerte. Wer den Unterschied kennt, liest Berichte leichter: Ein Besucher kann viele Website-Sitzungen haben, eine Sitzung viele Ereignisse. Alle Ereignisse innerhalb von 60 Tagen nach einem Scan teilen sich dieselbe scan_session_id.

​
Verfügbarkeit der Daten

  • Ereignisse werden sofort bei Eingang aufgenommen und eingereiht
  • Bei normaler Last erscheinen verarbeitete Ereignisse innerhalb von Sekunden in den Berichten
  • Bei Lastspitzen sind kurze Verzögerungen von bis zu einigen Minuten möglich