Logquellen verbinden

Das Tracking-Snippet meldet, was im Browser oder auf Ihrem Server läuft, doch viele KI-Bots rufen Seiten ab, ohne je JavaScript auszuführen. Logquellen schließen diese Lücke: Verbinden Sie Ihre CDN- oder Server-Logs, und jede KI-relevante Anfrage wird gezählt, mit eigenem Quellen-Label, sodass Sie log-basierte Treffer von Snippet-Treffern unterscheiden können.

Gespeichert werden nur KI-relevante Anfragen. Bekannte KI-Crawler, Bot-artige Agents und Besuche, die von KI-Assistenten verwiesen wurden, bleiben erhalten; aller übrige Traffic wird beim Eintreffen verworfen und nirgendwo geschrieben. Die Verifizierungsstufen gelten für log-basierte Treffer genauso wie für Snippet-Treffer.

Alle Logquellen authentifizieren sich mit einem Log-Ingest-Schlüssel. Er ist von Ihren Tracking-Snippet-Keys getrennt und kann ausschließlich Logs einreichen. Alles Folgende finden Sie unter KI-Crawler, dann Tracking installieren, im Bereich Logquellen.

Cloudflare (ein Klick)

Der schnellste Weg für Sites hinter dem Cloudflare-Proxy. Erstellen Sie ein API-Token mit genau drei Berechtigungen: Workers Scripts Edit, Zone Read und Workers Routes Edit. Fügen Sie Token und Domain ein, und Citlyze deployt einen kleinen Worker auf Ihrer Zone und verbindet ihn mit der Route Ihrer Domain.

Der Worker ist strikt Pass-Through: Er liest oder verändert niemals Request- oder Response-Bodys, und jeder interne Fehler schlägt offen fehl, sodass Ihre Site nie beeinträchtigt wird. Er meldet Request-Metadaten (Pfad, Status, User-Agent, IP, Referrer, Land), nachdem die Antwort ausgeliefert wurde. Das Token wird einmalig für die Einrichtung verwendet und nie gespeichert.

Zwei Hinweise:

Die Route greift nur bei DNS-Einträgen mit aktiviertem Proxy (Orange Cloud).
Im kostenlosen Workers-Tarif teilen sich Anfragen ein Tageskontingent. Mit der Vorfilter-Option meldet der Worker nur KI-User-Agents; das spart Kontingent, bedeutet aber, dass neu registrierte Crawler erst erfasst werden, wenn Sie den Worker erneut deployen.

Sie möchten lieber kein Token einfügen? Wählen Sie die manuelle Option, und Citlyze generiert denselben Worker-Code, den Sie selbst im Cloudflare-Dashboard einfügen.

Für Zonen mit sehr hohem Traffic ist Cloudflare Logpush die bessere Wahl: Erstellen Sie ein HTTP-Ziel, das auf Ihre Ingest-URL zeigt, mit dem Schlüssel als key=-URL-Parameter, und Citlyze filtert die gepushten Batches auf dieselbe Weise.

Vercel (Log-Drain)

Fügen Sie ein Vercel-Token ein, und Citlyze erstellt einen Log-Drain, der Request-Logs automatisch streamt. Beschränken Sie ihn auf ein Projekt oder lassen Sie das Projekt leer, um das gesamte Team abzudecken. Das Token wird verschlüsselt und nur für einen einzigen Zweck aufbewahrt: den Drain zu entfernen, wenn Sie die Verbindung trennen. Die Ingestion selbst authentifiziert sich über den Log-Ingest-Schlüssel, der in die Drain-URL eingebettet ist.

Generischer Webhook

Jedes System, das JSON per POST senden kann, kann Logs einspeisen. Senden Sie Batches mit bis zu 500 Einträgen an den Ingest-Endpunkt, mit Ihrem Log-Ingest-Schlüssel im X-API-Key-Header. Jeder Eintrag enthält Zeitstempel, Methode, URL, Status und User-Agent, optional außerdem Client-IP, Referrer und Land. Den vollständigen Vertrag finden Sie in der API-Referenz zur Log-Ingestion.

Datei-Upload

Für eine einmalige Nacherfassung fügen Sie einen Ausschnitt Ihrer Access-Logs direkt im Tab Upload ein. Zwei Formate werden unterstützt: CSV mit Kopfzeile (gängige CDN-Export-Header werden automatisch erkannt) und das Apache/Nginx-Combined-Format. Einträge, die älter als 30 Tage sind, werden übersprungen, und die Zusammenfassung zeigt, wie viele Zeilen geparst, gespeichert und verworfen wurden.

Weitere CDNs

CloudFront- und Akamai-Nutzer erreichen denselben Endpunkt schon heute über den generischen Webhook-Vertrag: Richten Sie eine Lambda@Edge-Funktion, ein DataStream-HTTPS-Ziel oder einen beliebigen Log-Shipper auf die Ingest-URL mit Ihrem Schlüssel. Native Ein-Klick-Anbindungen für diese Anbieter folgen je nach Nachfrage.

Ergebnisse lesen

Log-basierte Treffer erscheinen in denselben KI-Crawler- und KI-Traffic-Ansichten wie Snippet-Treffer. Die öffentliche API weist die Quelle in jeder Zeile aus, sodass Exporte trennen können, was das Snippet gesehen hat und was Ihre Logs gesehen haben.