KI-Crawler-Tracking installieren
Schritt-für-Schritt-Anleitungen für Cloudflare, Vercel, WordPress, eigene Node-Server, Webflow und Shopify.
Diese Seite führt Klick für Klick durch jeden Installationsweg. Was das Crawler-Tracking misst und wie die Verifizierung funktioniert, steht unter KI-Crawler. Dieselbe Installation meldet auch menschliche Besuche aus KI-Antworten und liefert damit zugleich die Daten für KI-Traffic; reine Browser-Optionen für diese Seite finden Sie unter KI-Traffic-Tracking installieren.
Wählen Sie die Anleitung, die zu Ihrer Website passt:
| Ihre Einrichtung | Passende Anleitung |
|---|---|
| Website läuft hinter Cloudflare (Proxy mit orangefarbener Wolke) | Cloudflare Worker |
| Next.js-App auf Vercel (oder selbst gehostetes Next.js) | Vercel / Next.js-Middleware |
| WordPress-Website | WordPress-Plugin |
| Selbst entwickelte Website auf eigenen Servern (AWS, GCP, Azure, VPS, Container) | Eigener Server / Node |
| Webflow-Website | Webflow |
| Shopify-Shop | Shopify |
Bevor Sie beginnen: einen Site-Schlüssel erzeugen
Jede Installation braucht einen Site-Schlüssel, egal welche Plattform Sie nutzen:
- Gehen Sie in der App zu Einstellungen → Verbindungen → Website-Tracking.
- Klicken Sie auf Site-Schlüssel generieren. Geben Sie dem Schlüssel einen Namen und idealerweise die Domain, für die er melden soll; die Domain stärkt zusätzlich die Verifizierung signierter Crawler für diese Website.
- Kopieren Sie beide Werte aus dem Bestätigungsdialog: die Schlüssel-ID
und das Signatur-Secret (es beginnt mit
ctk_). Das Secret wird nur einmal angezeigt; wenn Sie es verlieren, erzeugen Sie mit Erneuern am Schlüssel ein neues.
Halten Sie das Signatur-Secret geheim: Wer es kennt, kann gefälschte
Traffic-Meldungen für Ihre Website einreichen. Die Snippets für Cloudflare,
Vercel und eigene Server lesen es aus der Umgebungsvariable
CITLYZE_SIGNING_SECRET, sodass es nie in Ihrem Code steht; das
WordPress-Plugin speichert es in seinen Einstellungen. Committen Sie es nie
in ein Repository und fügen Sie es nie in clientseitigen Code ein.
Cloudflare Worker
Nutzen Sie diesen Weg, wenn Ihr DNS bei Cloudflare liegt und die Website über den Proxy läuft (der Schalter mit der orangefarbenen Wolke). Es ist die vollständigste Option: Der Worker sieht jede Anfrage an der Edge, meldet echte HTTP-Statuscodes und funktioniert unabhängig davon, was hinter Cloudflare läuft.
- Öffnen Sie unter Einstellungen → Verbindungen → Website-Tracking → Snippet installieren den Tab Cloudflare und kopieren Sie das Snippet.
- Ersetzen Sie
SITE_KEY_IDim Snippet durch Ihre Schlüssel-ID. Das Signatur-Secret gehört nicht in den Code; Sie hinterlegen es in Schritt 5 als Worker-Secret. - Gehen Sie im Cloudflare-Dashboard zu
Workers & Pages → Create → Create Worker. Geben Sie einen Namen ein
(zum Beispiel
ai-crawler-tracker) und klicken Sie auf Deploy, um den leeren Worker anzulegen. - Klicken Sie auf Edit code, ersetzen Sie das generierte Beispiel durch Ihr Snippet und klicken Sie erneut auf Deploy.
- Hinterlegen Sie das Signatur-Secret: Öffnen Sie im Worker Settings →
Variables and Secrets → Add, wählen Sie den Typ Secret, nennen Sie
es
CITLYZE_SIGNING_SECRET, fügen Sie Ihr Signatur-Secret ein und klicken Sie auf Deploy. Cloudflare speichert es verschlüsselt, und es taucht nie im Code des Workers auf. - Verbinden Sie den Worker mit Ihrer Website: Öffnen Sie in den
Einstellungen des Workers Settings → Domains & Routes → Add → Route,
wählen Sie Ihre Zone und fügen Sie die Route
example.com/*hinzu. Wird Ihre Website auch überwww.example.comausgeliefert, ergänzen Sie eine zweite Route fürwww.example.com/*. - Fertig: An Ihrer Website müssen Sie keinen Code ändern. Der Worker reicht jede Anfrage unverändert an Ihren Origin-Server weiter und meldet passende Besuche im Hintergrund.
Zwei Dinge sollten Sie prüfen:
- Die Route muss alle Pfade abdecken (
/*), sonst bleiben Crawler-Besuche auf Seiten außerhalb der Route unsichtbar. - Läuft auf diesen Routen bereits ein Worker, führt Cloudflare nur einen Worker pro Route aus; übernehmen Sie die Logik des Snippets in Ihren bestehenden Worker, statt einen zweiten hinzuzufügen.
Vercel / Next.js-Middleware
Nutzen Sie diesen Weg für eine Next.js-App auf Vercel. Dieselbe Datei funktioniert auch bei selbst gehostetem Next.js.
- Öffnen Sie unter Einstellungen → Verbindungen → Website-Tracking → Snippet installieren den Tab Vercel / Proxy und kopieren Sie das Snippet.
- Erstellen Sie in Ihrem Next.js-Repository die Datei
middleware.tsim Projektstamm (oder insrc/, falls Ihre App dort liegt) und fügen Sie das Snippet ein. - Ersetzen Sie
SITE_KEY_IDdurch Ihre Schlüssel-ID. Das Signatur-Secret gehört nicht in die Datei. - Öffnen Sie in Ihrem Vercel-Projekt Settings → Environment Variables
und legen Sie
CITLYZE_SIGNING_SECRETmit Ihrem Signatur-Secret für jede Umgebung an, die erfasst werden soll. Markieren Sie die Variable als Sensitive. Hosten Sie Next.js selbst, setzen Sie dieselbe Variable in der Umgebung Ihres Servers. - Haben Sie bereits eine
middleware.ts, legen Sie keine zweite Datei an; Next.js führt nur eine aus. Kopieren Sie den Hilfsblock des Snippets in Ihre bestehende Datei, rufen Sie seine Meldelogik am Anfang Ihrer Middleware-Funktion auf und stellen Sie sicher, dass Ihrematcher-Konfiguration weiterhin alle Pfade abdeckt. - Committen und deployen Sie die Änderung.
Hinweise:
- Middleware läuft, bevor die Antwort existiert, daher melden Ereignisse
ihren HTTP-Status als
unknown. Das ist normal. Für Statuscodes nutzen Sie statt dieser Middleware den Vercel-Log-Drain (beides zusammen zählt jeden Besuch doppelt) oder die Installation mit Cloudflare oder eigenem Server, die auch Weiterleitungen melden. - Auf Vercel stammt die Besucher-IP aus einem Header, den die Plattform setzt, und ist vertrauenswürdig. Hosten Sie Next.js selbst hinter Ihrem eigenen Proxy, stellen Sie sicher, dass der Header mit der weitergeleiteten IP, den das Snippet liest, von Ihrem Proxy gesetzt wird und nicht unverändert vom Client stammt.
WordPress-Plugin
Nutzen Sie diesen Weg für jede WordPress-Website, auf der Sie Plugins installieren können.
Dasselbe Plugin prüft außerdem kostenlos, welche KI-Crawler Ihre robots.txt durchlässt und was die übrigen blockiert; siehe WordPress-Plugin.
-
Gehen Sie in der WordPress-Verwaltung zu Plugins → Installieren, suchen Sie nach AI Crawler Control by Citlyze und klicken Sie auf Jetzt installieren und dann auf Aktivieren. Das Plugin ist im offiziellen Verzeichnis auf WordPress.org gelistet, ein Zip-Upload ist also nicht nötig.
-
Sie installieren lieber manuell? Öffnen Sie unter Einstellungen → Verbindungen → Website-Tracking → Snippet installieren den Tab WordPress, klicken Sie auf WordPress-Plugin herunterladen und laden Sie die Zip-Datei unter Plugins → Installieren → Plugin hochladen hoch.
-
Gehen Sie zu Citlyze → Connect Citlyze und füllen Sie alle drei Felder aus:
- Tracker base URL:
https://app.citlyze.com - Key ID: Ihre Schlüssel-ID
- Signing secret: Ihr
ctk_...-Secret Das Plugin meldet nichts, solange die Basis-URL leer ist.
- Tracker base URL:
-
Klicken Sie auf Send test event. Sie sollten eine „connected“-Bestätigung sehen; damit sind Zugangsdaten und Verbindung durchgehend bestätigt.
-
Hinter einem anderen Proxy oder Load Balancer als Cloudflare? Wählen Sie unter Visitor IP behind a proxy den Header, den Ihr Proxy setzt, und tragen Sie die Adressen des Proxys ein, damit Crawler anhand ihrer echten IP verifiziert werden können. Hinter Cloudflare ist nichts nötig.
Das Plugin meldet nach der Auslieferung jeder Seite, mit dem genauen Statuscode, auch bei Anfragen, die ein anderes Plugin weiterleitet, bevor die Seite gerendert wird. Ereignisse warten in Ihrer WordPress-Datenbank und werden in Batches gesendet; der Bildschirm Connect Citlyze zeigt, wie viele warten und wann sie zuletzt zugestellt wurden.
Einschränkung: Seiten aus einem Full-Page-Cache, Weiterleitungen Ihres Webservers oder CDNs und Anfragen, die eine Firewall blockiert, bevor WordPress lädt, erreichen das Plugin nie. Der Bildschirm Connect Citlyze zeigt an, wenn er einen Seiten-Cache erkennt. Ist Ihre Website stark gecacht, nutzen Sie besser den Cloudflare Worker oder laden Ihre Server-Logs hoch.
Eigener Server / Node
Nutzen Sie diesen Weg für selbst entwickelte Websites, die Sie selbst hosten: AWS, Google Cloud, Azure, ein VPS oder Container. Das Snippet ist eine Middleware im Express-Stil für Node 20 oder neuer (sie läuft auch mit Bun und Deno).
- Öffnen Sie unter Einstellungen → Verbindungen → Website-Tracking → Snippet installieren den Tab Eigener Server / Node und kopieren Sie das Snippet.
- Speichern Sie es als
aeo-tracker.mjsneben dem Einstiegspunkt Ihres Servers. - Ersetzen Sie
SITE_KEY_IDdurch Ihre Schlüssel-ID und setzen Sie auf dem Server die UmgebungsvariableCITLYZE_SIGNING_SECRETauf Ihr Signatur-Secret: in den Secret-Einstellungen Ihres Hosters oder in einer.env-Datei, die nie committet wird. Das Secret gehört nie in die Datei selbst. - Registrieren Sie die Middleware vor Ihren Routen:
import { aeoCrawlerTracker } from "./aeo-tracker.mjs"; app.use(aeoCrawlerTracker()); - Sitzt Ihr Server hinter einem Load Balancer oder Reverse Proxy (nginx,
ALB), konfigurieren Sie Express so, dass es ihm vertraut (zum Beispiel
app.set("trust proxy", 1)), damit die Middleware die echte Client-IP statt der des Proxys meldet. Die Verifizierung der Crawler-Identität prüft genau diese IP. - Deployen Sie. Die Middleware meldet erst, wenn die jeweilige Antwort abgeschlossen ist, verursacht also keine zusätzliche Latenz und liefert echte HTTP-Statuscodes.
Kein Express? Der zurückgegebene Handler nimmt einfache Argumente
(req, res, next) entgegen und lässt sich an Fastify, Koa oder den
http-Server von Node anpassen. Für ganz andere Sprachen (Python, Go, PHP,
Ruby, ...) implementieren Sie das
Protokoll für signierte Beacons;
jeder signierte HTTPS-POST enthält einen Batch mit bis zu 50 passenden Anfragen.
Webflow
Das Hosting von Webflow kann keinen serverseitigen Code ausführen, und Skripte im Browser sehen KI-Trainings-Crawler nicht. Das Tracking wird daher auf einer Proxy-Ebene vor Webflow installiert:
- Webflow unterstützt selbst verwaltete Reverse Proxies im Enterprise-Tarif; klären Sie das mit Ihrem Ansprechpartner bei Webflow und leiten Sie Ihre Domain über Ihren Proxy (Cloudflare, CloudFront, Fastly oder Ihr eigenes nginx).
- Installieren Sie den Tracker auf dieser Proxy-Ebene:
- Proxy auf Cloudflare → folgen Sie der Anleitung Cloudflare Worker.
- Eigener Node-Proxy → folgen Sie der Anleitung Eigener Server / Node.
- Alles andere → implementieren Sie das Protokoll für signierte Beacons in Ihrem Proxy.
- Prüfen Sie die Installation wie unten beschrieben.
Mit Webflow-Cloud-Apps lässt sich nicht die gesamte Website erfassen: Sie bedienen nur Anfragen unter ihrem eigenen Pfad und sehen daher nie Crawler-Besuche auf Ihren regulären Seiten.
Shopify
Standard-Storefronts von Shopify können diesen Tracker nicht ausführen: Shopify lässt Händler keinen serverseitigen Code für Storefront-Anfragen ausführen und erlaubt es nicht, einen Proxy (etwa Cloudflare) vor einen Shop zu schalten. Skripte im Browser sind kein Ausweg: KI-Trainings-Crawler führen nie JavaScript aus, und ein Browser-Skript würde Ihr Signatur-Secret offenlegen.
Was Sie tun können:
- Headless-Storefronts, die auf Hydrogen basieren und auf Oxygen gehostet werden (oder jedes selbst gehostete Setup), führen serverseitigen Code aus; binden Sie die Logik des Snippets Eigener Server / Node in den Request-Handler des Servers Ihrer Storefront ein.
- Für Standard-Shops funktionieren Ihre übrigen Citlyze-Messungen (Prompt-Tracking, Zitierungen, GEO-Audits) unabhängig davon, wo der Shop gehostet ist.
Installation verifizieren
- Unter Einstellungen → Verbindungen → Website-Tracking hat die Tabelle der Site-Schlüssel eine Spalte Letztes Ereignis. Sie aktualisiert sich, sobald Ihre Installation die erste akzeptierte Meldung übermittelt; Crawler-Besuche und Klicks aus KI-Antworten zählen beide.
- In WordPress können Sie die Zustellung sofort mit Send test event bestätigen (Testereignisse prüfen Zugangsdaten und Verbindung, aktualisieren aber nicht Letztes Ereignis).
- Haben Sie etwas Geduld: Bei Websites mit wenig Traffic kann der erste echte Crawler-Besuch Stunden oder ein paar Tage dauern. Sobald Ereignisse eintreffen, füllt sich Analysieren → KI-Crawler-Aktivität → Überblick.
- Kommt nach ein paar Tagen nichts an, prüfen Sie, ob die Schlüssel-ID in
Ihrem Snippet (oder in den Plugin-Einstellungen) zu einem aktiven, nicht
widerrufenen Schlüssel gehört, ob
CITLYZE_SIGNING_SECRETdessen aktuelles Signatur-Secret enthält und ob Ihre Route oder Middleware alle Pfade abdeckt. Ohne gültiges Secret meldet das Snippet nichts und protokolliert einmalig „Citlyze crawler tracking is off“. - Die Tabelle der Site-Schlüssel zeigt außerdem, welche Collector-Version mit jedem Schlüssel meldet, und weist darauf hin, wenn eine neuere Snippet- oder Plugin-Version verfügbar ist oder das WordPress-Plugin einen Seiten-Cache erkannt hat.