Jede Tracking-Website hat eigene API-Schlüssel. Ein Schlüssel gilt für genau eine Website — er kann nur Ereignisse für die site_id dieser Website senden.
Schritte
- Melden Sie sich im Scanova-Dashboard an
- Gehen Sie zu Analysen → Konversionsverfolgung
- Klicken Sie auf Ihre Tracking-Website, um die Website-Details zu öffnen
- Wählen Sie bei Ihrer Website Tracking-Einrichtung und dann den Tab Über API verfolgen
- Klicken Sie auf Generate API Key
- Geben Sie einen sprechenden Namen ein (z. B.
Production Backend, Checkout Service)
- Klicken Sie auf Generate
- Kopieren Sie den Schlüssel sofort — er wird nur einmal angezeigt
Der API-Schlüssel im Klartext wird nur ein einziges Mal angezeigt. Schließen Sie den Dialog, ohne ihn zu kopieren, müssen Sie den Schlüssel widerrufen und einen neuen erzeugen.
Den Schlüssel sicher aufbewahren
Speichern Sie den Schlüssel als Umgebungsvariable in Ihrem Backend. Schreiben Sie ihn niemals fest in den Quellcode.
Grenzen und Verwaltung von Schlüsseln
- Eine Website kann gleichzeitig bis zu 2 aktive API-Schlüssel haben. Nehmen Sie einen alten Schlüssel aus dem Verkehr, wenn Sie einen neuen erzeugen
- Widerrufen Sie ungenutzte oder kompromittierte Schlüssel sofort im Tab Über API verfolgen
- Bei maximal zwei Schlüsseln belegt eine Trennung von Produktiv- und Staging-Umgebung bereits beide Plätze — planen Sie den Wechsel entsprechend
So verwenden Sie den Schlüssel
Senden Sie ihn bei jeder Anfrage für ein Server-Ereignis als Header mit:
Der Schlüssel muss zu der site_id passen, die Sie im Anfragetext mitschicken. Stimmen sie nicht überein, kommt 403 zurück.
Nächster Schritt
Ihr erstes Server-Ereignis senden →