Das datakant Tracking-Snippet installieren

Überblick

Standardmäßig liefert datakant ein kleines JavaScript-Snippet, das jedes getrackte Event an den geteilten datakant Ingest-Endpoint unter https://datakant.ai sendet. Das ist das Third-party-Snippet, und es funktioniert auf jeder Website out-of-the-box — keine DNS-Records zu konfigurieren, keine Custom-Subdomains, kein Server-side Setup. Einbinden und live.

Das Server-side Tracking Add-on bietet eine zweite Option: ein First-party-Snippet, das auf eine Tracking-Subdomain auf deiner eigenen Domain zeigt (z.B. track.your-domain.com). Events fließen über deine Domain statt datakant.ai — das umgeht Third-party Ad Blocker und hält den Request-Origin first-party. Der Trade-off: ein CNAME-Record in deinem DNS plus diese Docs-Seite in deinen Bookmarks.

Wähle eine Variante, nicht beide

Nur eines der beiden Snippets sollte gleichzeitig auf einer Seite live sein. Beide parallel zu betreiben verdoppelt jedes Event und korrumpiert deine Zahlen.

Das Standard-Third-party-Snippet installieren

Füge das Snippet unten in den <head> jeder Seite ein, die du tracken willst. Du kannst es über die Head-Injection-Einstellung deines CMS einbinden, über einen Tag Manager (Google Tag Manager, Segment, Tealium) oder direkt im HTML / Template deiner Site.

HTML

<!-- datakant Analytics -->
<script>
  window.dataLayer = window.dataLayer || [];
  window.DATAKANT_TRACKING_ID = 'YOUR_TRACKING_ID';
</script>
<script src="https://datakant.ai/datakant-tracker.js" async></script>
<!-- End datakant Analytics -->

YOUR_TRACKING_ID ersetzen

Ersetze {placeholder} durch die Property Tracking-ID, die in deinem datakant Dashboard unter YOUR_TRACKING_ID Tracking-Code angezeigt wird. Sie beginnt mit dk_.

Events-Eingang prüfen

Nachdem das Snippet live ist, öffne den Realtime View in deinem datakant Dashboard. Eine Live-Session sollte innerhalb weniger Sekunden erscheinen, sobald du eine Seite deiner Site lädst. Wenn nichts erscheint, prüfe den Network Tab in den DevTools deines Browsers und filtere nach ingest — du solltest POST-Requests an /api/events/ingest mit Status 200 sehen.

Wenn du das Server-side / First-party Tracking Add-on aktivierst

Das Abonnieren des Server-side Tracking Add-ons ändert allein nichts an deiner Site. Es schaltet eine zweite Snippet-Variante frei — das First-party-Snippet — die du nach Abschluss des DNS-Setups aus Dashboard › Tracking-Code kopierst.

Der Switchover ist ein dreistufiger Prozess:

Tracking-Subdomain einrichten
Folge im Dashboard dem Server-side Setup-Wizard. Du wählst eine Subdomain (z.B. track.your-domain.com) und fügst bei deinem DNS-Provider einen einzigen CNAME-Record hinzu, der auf den datakant Ingest-Endpoint zeigt. Der Wizard verifiziert den Record, sobald die Propagation abgeschlossen ist — meist innerhalb von Minuten.
First-party-Snippet kopieren
Sobald die Subdomain verifiziert ist, zeigt der Tracking-Code Tab die First-party-Variante des Snippets. Der einzige Unterschied zum Third-party-Snippet ist das src-Attribut, das jetzt auf deine Subdomain zeigt statt auf datakant.ai.
Snippet auf deiner Site ersetzen
Entferne das Third-party-Snippet von deiner Site und füge das First-party-Snippet an seine Stelle. Deploye. Sobald das neue Snippet auf jeder Seite live ist, fließt der Ingest über deine eigene Subdomain.

HTML — first-party

<!-- datakant Analytics (first-party) -->
<script>
  window.dataLayer = window.dataLayer || [];
  window.DATAKANT_TRACKING_ID = 'YOUR_TRACKING_ID';
</script>
<script src="https://track.your-domain.com/datakant-tracker.js" async></script>
<!-- End datakant Analytics -->

Installiere das First-party-Snippet nicht, bevor DNS verifiziert ist

Solange deine Tracking-Subdomain nicht auflöst und der Wizard sie nicht bestätigt, akzeptiert der First-party-Endpoint keinen Ingest. Lass das Third-party-Snippet live, bis das Dashboard die Subdomain als verifiziert markiert — dann wechsle. Lass nicht beide Snippets gleichzeitig laufen — das verdoppelt jedes Event.

Wenn du das Server-side / First-party Tracking Add-on kündigst

Wenn du das Server-side Tracking Add-on kündigst, akzeptiert der First-party-Endpoint Events bis zum Ende deines aktuellen Abrechnungszeitraums und hört dann auf. Um Datenverlust zu vermeiden, wenn das passiert, wechsle deine Site zurück zum Standard-Third-party-Snippet, bevor der Zeitraum endet.

Der Switch zurück ist das Spiegelbild des Switchovers:

Third-party-Snippet kopieren
Hole dir das Third-party-Snippet aus Dashboard › Tracking-Code, oder kopiere das Beispiel im Abschnitt Third-party-Snippet installieren oben. Die Tracking-ID bleibt gleich — nur die src-URL wechselt zurück auf https://datakant.ai.
First-party-Snippet von deiner Site entfernen
Lösche den <script>-Block, der auf deine Tracking-Subdomain zeigt. Füge das Third-party-Snippet an seine Stelle und deploye.
Prüfen, dass das neue Snippet live ist
Öffne Realtime im Dashboard und bestätige, dass weiterhin Events ankommen. In den DevTools sollten die Ingest-Requests jetzt wieder an https://datakant.ai/api/events/ingest gehen.

Beide Snippets nicht gleichzeitig betreiben

Dieselbe Regel wie vorher: nur ein Snippet sollte gleichzeitig auf einer Seite live sein. Wenn du das First-party-Snippet während des Übergangs neben dem Third-party-Snippet lässt, wird jedes Event doppelt gesendet und deine Zahlen verdoppeln sich, bis du eines entfernst.

Was ist mit dem CNAME-Record?

Du kannst den CNAME-Record stehen lassen. Er löst nach Ablauf des Add-ons zwar auf nichts Nützliches mehr auf, schadet aber nicht — wenn du später wieder abonnierst, ist die Subdomain ohne neue DNS-Runde startklar.