KI-Module Funktionen Schritte Preise FAQ Blog Tutorial Videos Glossar Über uns Agenturen
Anmelden Mein kostenloses Audit starten
Tutorials
Tracking-Plugin

Das AI Labs Audit Tracking-Plugin installieren

Erkennen Sie KI-Bot-Crawls und Referrals auf Ihrer Website. 6 Installationsmethoden: WordPress, PHP, Node.js, Python, Cloudflare Worker oder JavaScript-Pixel.

Inhaltsverzeichnis

  1. Voraussetzungen
  2. WordPress-Plugin
  3. PHP Generisch
  4. Node.js
  5. Python
  6. Cloudflare Worker
  7. JavaScript-Pixel-Tag
  8. Verifizierung

Voraussetzungen

Bevor Sie das Tracking-Plugin installieren, muessen Sie im AI Labs Audit Dashboard einen Tracking-Schluessel erstellen. Damit erhalten Sie Ihre 4 Zugangsdaten:

1

Zu API & Integrations navigieren

Melden Sie sich bei Ihrem AI Labs Audit Konto an und rufen Sie die Seite API & Integrations auf.

2

Tracking-Schluessel erstellen

Klicken Sie auf Schluessel erstellen, waehlen Sie die Rolle Client, waehlen Sie den Client aus, dann den Schluesseltyp Tracking IA (trk_live_...) und bestaetigen Sie.

3

Ihre 4 Zugangsdaten kopieren

Ein Dialog zeigt Ihre Zugangsdaten an. Kopieren Sie alle sofort, das HMAC Secret wird nie wieder angezeigt:

  • API Key — Ihr eindeutiger Tracking-Schluessel (Format: trk_live_...)
  • HMAC Secret — Geheimschluessel zum Signieren der Payloads (niemals clientseitig offenlegen)
  • Client ID — Ihre Client-Kennung, die Daten mit Ihrem Konto verknuepft
  • API URL — Der Endpoint: https://ailabsaudit.com/api/v1

Wichtig

Das HMAC Secret wird nur einmal bei der Erstellung angezeigt. Falls Sie es verlieren, muessen Sie einen neuen Tracking-Schluessel erstellen.

DSGVO-konform

Der Tracker erfasst keine personenbezogenen Daten. Er erkennt ausschliesslich User-Agents von KI-Bots und KI-Referral-Domains. Keine Cookies, kein IP-Tracking, kein Fingerprinting.

WordPress-Plugin

Das WordPress-Plugin ist der einfachste Weg zum Einstieg. Es uebernimmt alles automatisch: KI-Bot-Erkennung, Event-Pufferung und zeitgesteuerter Versand.

Installation

Sie haben zwei Moeglichkeiten, das Plugin zu installieren:

1

Option A: Upload per FTP / Dateimanager

Laden Sie das Plugin von GitHub herunter und laden Sie den Ordner ailabsaudit-tracker in /wp-content/plugins/ hoch.

2

Option B: Installation ueber den WordPress-Admin

Gehen Sie zu Plugins > Installieren > Plugin hochladen, waehlen Sie die ZIP-Datei aus und klicken Sie auf Jetzt installieren.

Konfiguration

3

Plugin aktivieren

Gehen Sie in Ihrem WordPress-Admin zu Plugins, suchen Sie AI Labs Audit Tracker und klicken Sie auf Aktivieren.

4

Zugangsdaten eingeben

Navigieren Sie zu Einstellungen > AI Labs Audit und geben Sie Ihren API Key, HMAC Secret, Client ID und die API URL ein.

5

Verbindung testen

Klicken Sie auf den Button "Test Connection", um zu pruefen, ob Ihre Zugangsdaten korrekt sind und Events gesendet werden koennen.

So funktioniert es

< 1ms Erkennung

Die Bot-Erkennung fuegt weniger als 1 Millisekunde pro Seitenaufruf hinzu.

Event-Pufferung

Events werden im WP-Transient gepuffert und alle 5 Minuten via WP-Cron gesendet.

Taegliche Aktualisierung

Bot-Signaturen und Referrer-Domain-Listen werden taeglich ueber die API aktualisiert.

Object-Cache-kompatibel

Funktioniert problemlos mit Redis, Memcached und anderen Object-Caching-Loesungen.

DSGVO-konform

Das Plugin erfasst keinerlei personenbezogene Daten. Es erkennt ausschliesslich User-Agent-Zeichenfolgen von KI-Bots und KI-Referral-Domains. Keine Cookies, keine IP-Adressen, kein Tracking echter Besucher.

PHP Generisch

Fuer PHP-Websites ohne WordPress verwenden Sie den eigenstaendigen PHP-Tracker mit integrierter Auto-Erkennung. Installieren Sie ihn via Composer oder durch Kopieren der einzelnen Datei.

Installation

Composer 
composer require ailabsaudit/tracker

Alternativ koennen Sie AilabsTracker.php aus dem GitHub-Repository herunterladen und direkt einbinden.

Verwendungsbeispiel

PHP 
use AilabsAudit\Tracker\AilabsTracker;

$tracker = new AilabsTracker(
    apiKey: 'your-api-key',
    apiSecret: 'your-hmac-secret',
    clientId: 'your-client-id',
    apiUrl: 'https://ailabsaudit.com/api/v1',
    enableDetection: true,
    bufferStorage: '/tmp/ailabs_buffer.json'
);

// Am Anfang Ihres Front Controllers aufrufen
$tracker->detect();

So funktioniert es

  • Auto-Erkennung ist Opt-in (enableDetection: false standardmaessig) fuer Abwaertskompatibilitaet. Wenn aktiviert, erkennt detect() automatisch KI-Bots und Referrer aus der aktuellen Anfrage.
  • Buffer: Events werden in einer JSON-Datei gespeichert (LOCK_EX fuer Parallelitaetssicherheit) und als Batch gesendet.
  • API-Aktualisierung: Bot-Signaturen und Referrer-Domain-Listen werden automatisch ueber die API aktualisiert (TTL 24h, ETag-Unterstuetzung).

Voraussetzungen

PHP 7.4+, ext-curl, ext-json.

Node.js

Fuer Node.js-Backends (Express, Fastify, Next.js usw.) verwenden Sie das offizielle npm-Paket mit integrierter Express-Middleware und Auto-Erkennung.

Installation

npm 
npm install @ailabsaudit/tracker-node

Alternativ koennen Sie src/index.js aus dem GitHub-Repository kopieren.

Verwendungsbeispiel

JavaScript 
const { AilabsTracker, createMiddleware } = require('@ailabsaudit/tracker-node');

const tracker = new AilabsTracker({
  apiKey: 'your-api-key',
  apiSecret: 'your-hmac-secret',
  clientId: 'your-client-id',
  apiUrl: 'https://ailabsaudit.com/api/v1',
  enableDetection: true,
});

// Express-Middleware — erkennt Bots & Referrals automatisch
app.use(createMiddleware(tracker));

// Sauberes Herunterfahren — sendet den verbleibenden Buffer
process.on('SIGTERM', () => tracker.shutdown());

So funktioniert es

  • Auto-Erkennung ist Opt-in (enableDetection: false standardmaessig). Wenn aktiviert, erkennt die Middleware automatisch KI-Bots und Referrer bei jeder Anfrage.
  • Buffer: In-Memory-Buffer (max. 500 Events), wird alle 5 Min. gesendet, Debounce 30s. Retry x3 bei 5xx/429-Fehlern.
  • API-Aktualisierung: Bot-Signaturen und Referrer-Listen werden ueber die API aktualisiert (TTL 24h, ETag-Unterstuetzung).

Sauberes Herunterfahren

tracker.shutdown() sendet verbleibende gepufferte Events und stoppt alle Timer. Unverzichtbar, um beim Beenden des Prozesses keine Events zu verlieren.

Voraussetzungen

Node.js 14+. Keine externen Abhaengigkeiten.

Python

Fuer Python-Backends (Django, Flask, FastAPI usw.) verwenden Sie das pip-Paket mit WSGI/ASGI-Middleware und Auto-Erkennung.

Installation

pip 
pip install ailabsaudit-tracker

Alternativ koennen Sie tracker.py aus dem GitHub-Repository kopieren.

Verwendungsbeispiel

Python (Flask) 
from ailabsaudit_tracker import AilabsTracker, WsgiMiddleware

tracker = AilabsTracker(
    api_key="your-api-key",
    api_secret="your-hmac-secret",
    client_id="your-client-id",
    api_url="https://ailabsaudit.com/api/v1",
    enable_detection=True,
)

# WSGI-Middleware — erkennt KI-Bots und Referrals automatisch
app.wsgi_app = WsgiMiddleware(app.wsgi_app, tracker)

# Sauberes Herunterfahren — sendet den verbleibenden Buffer
import atexit
atexit.register(tracker.shutdown)

So funktioniert es

  • Auto-Erkennung ist Opt-in (enable_detection=False standardmaessig). Wenn aktiviert, erkennt die Middleware automatisch KI-Bots und Referrer bei jeder Anfrage.
  • Buffer: Thread-sicherer In-Memory-Buffer (max. 500 Events), wird alle 5 Min. via Daemon-Timer-Thread gesendet. Retry x3 bei 5xx/429-Fehlern.
  • API-Aktualisierung: Bot-Signaturen und Referrer-Listen werden ueber die API in einem Hintergrund-Thread aktualisiert (TTL 24h, ETag-Unterstuetzung).

Sauberes Herunterfahren

tracker.shutdown() sendet die verbleibenden gepufferten Events und stoppt alle Timer-Threads. Unverzichtbar, um beim Stoppen des Prozesses (Gunicorn, uWSGI usw.) keine Events zu verlieren.

Voraussetzungen

Python 3.8+. Keine externen Abhaengigkeiten. Kompatibel mit WSGI (Flask, Django) und ASGI (FastAPI, Starlette).

Cloudflare Worker

Stellen Sie den Tracker als Cloudflare Worker bereit, um Anfragen am Edge abzufangen und zu analysieren, ohne Auswirkungen auf Ihren Origin-Server.

Installation

1

Wrangler installieren

Falls Sie Wrangler noch nicht installiert haben:

Terminal 
npm install -g wrangler
2

wrangler.toml konfigurieren

Klonen Sie das GitHub-Repository und bearbeiten Sie wrangler.toml, um die Variable API_URL zu setzen.

wrangler.toml 
[vars]
API_URL = "https://ailabsaudit.com/api/v1"
3

Secrets konfigurieren

Fuegen Sie Ihre Zugangsdaten als Cloudflare Worker Secrets hinzu (sie werden niemals im Code offengelegt):

Terminal 
wrangler secret put API_KEY
wrangler secret put API_SECRET
wrangler secret put CLIENT_ID
4

Bereitstellen

Stellen Sie den Worker im Cloudflare-Edge-Netzwerk bereit:

Terminal 
wrangler deploy

So funktioniert es

Edge-Erkennung

Faengt GET-Anfragen am Cloudflare-Edge ab, bevor sie Ihren Origin-Server erreichen.

90+ Bot-Signaturen

Erkennt ueber 90 User-Agent-Signaturen von KI-Bots, darunter GPTBot, ClaudeBot, Bingbot AI usw.

30+ KI-Referrer

Identifiziert Traffic von ueber 30 KI-Referrer-Domains wie ChatGPT, Perplexity, You.com usw.

Fire-and-forget

Events werden asynchron via ctx.waitUntil() gesendet, ohne Auswirkungen auf die Latenz.

Dynamische Aktualisierung

Bot-Signaturen und KI-Referrer-Listen werden dynamisch ueber die API via die Cloudflare Cache API aktualisiert (TTL 24h). Falls die API nicht erreichbar ist, greift der Worker auf die bei der Bereitstellung eingebetteten Listen zurueck.

JavaScript-Pixel-Tag

Ein leichtgewichtiger clientseitiger Tracker (< 2 KB), den Sie als einzelnes Script-Tag einbinden. Ideal fuer statische Websites, Landing Pages oder wenn Sie keinen serverseitigen Zugriff haben.

Installation

Fuegen Sie das folgende Script-Tag in Ihr HTML ein, direkt vor dem schliessenden </body>-Tag:

HTML 
<script src="/path/to/tracker.js"
  data-tracker-id="YOUR_TRACKER_ID"
  data-api-url="https://ailabsaudit.com/api/v1/collect">
</script>

Was erfasst wird

page_view

Erfasst automatisch jeden Seitenaufruf mit URL- und Referrer-Informationen.

page_leave

Erfasst Seitenverlassen-Events mit Verweildauer und Scroll-Tiefe.

click

Verfolgt Klick-Events auf Links und interaktive Elemente.

Sicherheitshinweis

Clientseitige Payloads sind nicht signiert (HMAC Secrets koennen nicht im Browser offengelegt werden). Payloads werden serverseitig anhand der Origin-Domain validiert. Stellen Sie sicher, dass Ihre Domain in Ihren AI Labs Audit Einstellungen registriert ist.

Verifizierung

Nachdem Sie den Tracker bereitgestellt haben, ueberpruefen Sie in Ihrem AI Labs Audit Dashboard, ob alles korrekt funktioniert.

1

Dashboard oeffnen

Melden Sie sich bei Ihrem AI Labs Audit Konto an und navigieren Sie zur Tracking-Seite Ihres Clients.

2

Bot-Crawls pruefen

KI-Bot-Crawls sollten innerhalb weniger Minuten nach der Bereitstellung erscheinen. Achten Sie auf Eintraege von GPTBot, ClaudeBot, Bingbot und anderen KI-Crawlern.

3

KI-Referrals pruefen

Traffic von KI-Plattformen (ChatGPT, Perplexity, Copilot usw.) wird ebenfalls im Dashboard angezeigt, sobald er auftritt.

4

Event-Details ueberpruefen

Klicken Sie auf ein beliebiges Event, um die vollstaendigen Details zu sehen: User-Agent, gecrawlte URL, Zeitstempel, Statuscode und Antwortgroesse.

Tipp

Wenn Sie nach einigen Minuten keine Daten sehen, ueberpruefen Sie Ihre Zugangsdaten in den Plugin-Einstellungen und stellen Sie sicher, dass Ihr Server https://ailabsaudit.com/api/v1 erreichen kann. Bei WordPress ueberpruefen Sie, ob WP-Cron korrekt laeuft.

Bereit, die KI-Sichtbarkeit zu verfolgen?

Installieren Sie den Tracker in wenigen Minuten und beginnen Sie, KI-Bot-Aktivitaeten auf Ihrer Website zu ueberwachen.

Auf GitHub ansehen Zugangsdaten erhalten

Bereit, Ihre KI-Sichtbarkeit zu prüfen?

Erstellen Sie Ihr kostenloses Konto und erhalten Sie 1000 Bonus-Credits.

Kostenloses Konto erstellen