KI-Traffic-Tracking installieren
Erfassen Sie KI-vermittelte Besuche mit Browser-Snippet, Tag Manager, WordPress oder Cloudflare, und verbinden Sie GA4 und Search Console.
Diese Seite behandelt alles, was KI-Traffic speist: die Erfassungs-Installationen und die optionalen Google-Verbindungen. Haben Sie das Crawler-Tracking bereits serverseitig installiert, meldet diese Installation auch KI-vermittelte Besuche, und Sie können direkt zu Conversion-Events oder Google Analytics 4 verbinden springen.
Was getrackt wird
Zwei verschiedene Arten von Besuchern brauchen zwei verschiedene Erfassungstechniken:
| Besucher | Führt JavaScript aus | Erfasst durch |
|---|---|---|
| KI-Crawler (GPTBot, ClaudeBot, ...) | Nein | Nur serverseitige Installationen |
| Menschen aus KI-Antworten | Ja | Serverseitige Installationen oder das Browser-Snippet |
Die serverseitigen Installationen (Cloudflare, WordPress, eigener Server) erfassen beides. Browser-Snippet und Tag Manager erfassen nur menschliche Referrals; das macht sie zur richtigen Wahl, wenn Sie keinen serverseitigen Code ausführen können, und überall sonst zur Ergänzung, nicht zum Ersatz.
Installationsweg wählen
| Ihre Situation | Nutzen Sie |
|---|---|
| Serverseitige Installation läuft bereits | Nichts zu ergänzen; Besuche werden bereits gemeldet |
| Site hinter Cloudflare | Cloudflare Worker (erfasst beide Arten) |
| WordPress | WordPress-Plugin (erfasst beide Arten) |
| Sie verwalten Tags in Google Tag Manager | Tag Manager |
| Jede Site, auf der Sie ein Script-Tag ergänzen können | Browser-Snippet |
Browser-Snippet
Das Browser-Snippet ist ein kleines Skript, das aus der App ausgeliefert wird. Es meldet einen Besuch nur, wenn die Sitzung von einer erkannten KI-Oberfläche kam, und identifiziert Ihre Site mit einem Browser-Token, das öffentlich und an die Domain Ihres Site-Keys gebunden ist; im Seitenquelltext ist es daher sicher.
- Gehen Sie in der App zu KI-Crawler → Tracking installieren und öffnen Sie den Tab Browser / GTM.
- Browser-Tokens erfordern einen Site-Key mit registrierter Domain. Wenn der Tab das meldet, fügen Sie Ihrem Site-Key zuerst eine Domain hinzu und klicken Sie dann auf Browser-Token generieren.
- Kopieren Sie das zweizeilige Snippet und fügen Sie es auf jeder Seite
in den
<head>Ihrer Site ein (oder vor</body>):
<script>window.citlyze=window.citlyze||function(){(window.citlyze.q=window.citlyze.q||[]).push(arguments)};</script>
<script async src="https://app.citlyze.com/collect.js" data-token="cbt_YOUR_BROWSER_TOKEN"></script>Die erste Zeile ist ein Stub, der Aufrufe vor dem Laden des Skripts in eine Warteschlange stellt, sodass Conversion-Aufrufe nie einen Fehler werfen.
Google Tag Manager
Nutzen Sie Tag Manager, wenn die Tags Ihrer Site dort leben. Zwei Optionen:
- Benutzerdefiniertes HTML: Erstellen Sie ein neues Tag vom Typ Benutzerdefiniertes HTML, fügen Sie dasselbe zweizeilige Snippet aus dem Tab Browser / GTM ein, setzen Sie den Trigger auf Alle Seiten und veröffentlichen Sie den Container.
- Community-Vorlage: Citlyze liefert eine importierbare Tag-Manager-Vorlage. Gehen Sie in Tag Manager zu Vorlagen → Neu → Importieren, laden Sie die Citlyze-Vorlage, erstellen Sie daraus ein Tag und tragen Sie Ihr Browser-Token ein.
Beide tun dasselbe; die Vorlage vermeidet nur Raw-HTML-Berechtigungen in Containern, die sie einschränken.
Conversion-Events
Sobald eine Erfassungs-Installation live ist, kann Ihre Site Conversions mit einem Aufruf melden, mit Event-Namen, die Sie vorher freigeben:
- Fügen Sie auf KI-Crawler → KI-Traffic unter Erfassungseinstellungen → Conversion-Events die Event-Namen hinzu, die Sie akzeptieren wollen (bis zu 10 kleingeschriebene Namen). Events, die nicht auf der Liste stehen, werden abgelehnt.
- Feuern Sie das Event auf Ihrer Site dort, wo die Conversion passiert:
window.citlyze("event", "signup");Conversions gelten je Sitzung: Sie werden der KI-Quelle zugeordnet, die den konvertierenden Besucher vermittelt hat. Wenn Sie schon in den Erfassungseinstellungen sind, ergänzen Sie auch Ignorierte IPs (Büro-Bereiche, Staging), damit interner Traffic aus dem Bericht bleibt.
Google Analytics 4 verbinden
Die Google-Verbindung füllt den KI-Traffic-Bericht aus den eigenen Sitzungsdaten von GA4, die auch Besucher abdecken, die Ihr Snippet nicht sehen kann, und sie funktioniert schon, bevor irgendeine Installation vorhanden ist.
- Suchen Sie auf KI-Crawler → KI-Traffic die Karte Google Analytics & Search Console und klicken Sie auf Google-Konto verbinden.
- Melden Sie sich mit einem Google-Konto an, das die GA4-Property sehen kann, und bestätigen Sie den auf Googles Zustimmungsbildschirm angezeigten Lesezugriff.
- Wählen Sie zurück in der App die zu synchronisierende GA4-Property und speichern Sie.
Die Verbindung ist read-only: Citlyze liest täglich aggregierte Berichtsdaten für die gewählte Property (Sitzungen, Nutzer und Conversions aus KI-Assistenten-Quellen, je Landingpage und Datum) und schreibt nichts in Ihr Google-Konto. Die Daten werden täglich synchronisiert.
Search Console verbinden
Dieselbe Google-Verbindung kann eine Search-Console-Website synchronisieren: Wählen Sie die Website nach dem Verbinden in der Karte. Die Search-Console-Synchronisierung bringt tägliche Klicks und Impressionen je Seite und Datum und deckt damit neben den Referral-Daten ab, wie Ihre Seiten in den KI-Funktionen der Google-Suche abschneiden.
Trennen und widerrufen
- In der App entfernt die Schaltfläche Trennen auf der Karte die gespeicherte Verbindung und die synchronisierten Google-Daten für diesen Anbieter.
- Sie können Citlyze den Zugriff auch jederzeit in den Sicherheitseinstellungen Ihres Google-Kontos entziehen; danach können keine weiteren Google-Daten abgerufen werden.
- Der Wechsel zu einer anderen Property oder Website ersetzt die zuvor synchronisierten Daten.
Datenschutzhinweise
- Der Google-Zugriff ist auf die auf dem Zustimmungsbildschirm bestätigten Read-only-Reporting-Scopes beschränkt; es gibt keinen Schreibzugriff.
- Das Browser-Token ist bewusst öffentlich; die Annahme prüft die Domain der meldenden Seite gegen die registrierte Domain des Site-Keys.
- Referral-Events erfassen Landing-Pfad, Referrer sowie groben Geräte- und Länderkontext, keine Besucheridentitäten.
- Der Referral-Verlauf wird gemäß Ihrem Plan aufbewahrt (30, 90 oder 400 Tage); siehe Pläne und Limits.
Verifizieren
Die Site-Key-Tabelle unter Tracking installieren zeigt eine Spalte Letztes Ereignis, die sich aktualisiert, sobald Ihre Installation die erste akzeptierte Meldung liefert; KI-Referral-Klicks zählen. KI-vermittelte Besuche erscheinen auf der KI-Traffic-Seite, sobald echte Sitzungen eintreffen; auf Sites mit wenig Traffic kann das ein bis zwei Tage dauern. Die Google-Karte zeigt die Zahl der synchronisierten Sitzungen, sobald die erste tägliche Synchronisierung abgeschlossen ist.