Modules IA Fonctionnalités Étapes Tarifs FAQ Blog Tutoriel Vidéos Glossaire À propos Agences
Connexion Lancer mon audit gratuit
Tutoriels
Plugin de Tracking

Installer le Plugin de Tracking AI Labs Audit

Detectez les crawls de bots IA et les referrals sur votre site. 6 methodes d'installation : WordPress, PHP, Node.js, Python, Cloudflare Worker ou pixel JavaScript.

Sommaire

  1. Prerequis
  2. Plugin WordPress
  3. PHP Generique
  4. Node.js
  5. Python
  6. Cloudflare Worker
  7. Pixel JavaScript
  8. Verification

Prerequis

Avant d'installer le plugin de tracking, vous devez creer une cle Tracking depuis le dashboard AI Labs Audit. Cela vous donnera vos 4 identifiants :

1

Allez sur API & Integrations

Connectez-vous a votre compte AI Labs Audit et rendez-vous sur la page API & Integrations.

2

Creez une cle Tracking

Cliquez sur Creer une cle, selectionnez le role Client, choisissez le client, puis selectionnez le type de cle Tracking IA (trk_live_...) et confirmez.

3

Copiez vos 4 identifiants

Une fenetre affichera vos identifiants. Copiez-les tous immediatement, le HMAC Secret ne sera plus jamais affiche :

  • API Key — votre cle de tracking unique (format : trk_live_...)
  • HMAC Secret — cle secrete pour signer les payloads (ne jamais exposer cote client)
  • Client ID — votre identifiant client qui relie les donnees a votre compte
  • API URL — l'endpoint : https://ailabsaudit.com/api/v1

Important

Le HMAC Secret n'est affiche qu'une seule fois a la creation. Si vous le perdez, vous devrez creer une nouvelle cle Tracking.

Conforme RGPD

Le tracker ne collecte aucune donnee personnelle. Il detecte uniquement les user-agents de bots IA et les domaines de referrals IA. Pas de cookies, pas de suivi d'IP, pas de fingerprinting.

Plugin WordPress

Le plugin WordPress est la methode la plus simple pour demarrer. Il gere tout automatiquement : detection des bots IA, mise en tampon des evenements et envoi programme.

Installation

Vous avez deux options pour installer le plugin :

1

Option A : Upload via FTP / Gestionnaire de fichiers

Telechargez le plugin depuis GitHub et uploadez le dossier ailabsaudit-tracker dans /wp-content/plugins/.

2

Option B : Installer depuis l'admin WordPress

Allez dans Extensions > Ajouter > Televerser une extension, selectionnez le fichier ZIP et cliquez sur Installer maintenant.

Configuration

3

Activer le plugin

Rendez-vous dans Extensions de votre admin WordPress, trouvez AI Labs Audit Tracker et cliquez sur Activer.

4

Saisir vos identifiants

Naviguez vers Reglages > AI Labs Audit et renseignez votre API Key, HMAC Secret, Client ID et API URL.

5

Tester la connexion

Cliquez sur le bouton "Test Connection" pour verifier que vos identifiants sont corrects et que les evenements peuvent etre envoyes.

Comment ca fonctionne

< 1ms detection

La detection des bots ajoute moins d'1 milliseconde par chargement de page.

Mise en tampon

Les evenements sont stockes en WP transient et envoyes via WP-Cron toutes les 5 minutes.

Rafraichissement quotidien

Les signatures de bots et les listes de domaines referrers sont rafraichies quotidiennement depuis l'API.

Compatible cache objet

Fonctionne parfaitement avec Redis, Memcached et autres solutions de cache objet.

Conforme RGPD

Le plugin ne collecte aucune donnee personnelle. Il detecte uniquement les chaines user-agent de bots IA et les domaines de referrals IA. Pas de cookies, pas d'adresses IP, pas de suivi des visiteurs reels.

PHP Generique

Pour les sites PHP hors WordPress, utilisez le tracker PHP autonome avec auto-detection integree. Installez-le via Composer ou en copiant le fichier unique.

Installation

Composer 
composer require ailabsaudit/tracker

Alternativement, telechargez AilabsTracker.php depuis le depot GitHub et incluez-le directement.

Exemple d'utilisation

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'
);

// Appeler en haut de votre front controller
$tracker->detect();

Comment ca fonctionne

  • Auto-detection est opt-in (enableDetection: false par defaut) pour la retrocompatibilite. Une fois active, detect() identifie automatiquement les bots IA et les referrers de la requete courante.
  • Buffer : les evenements sont persistes dans un fichier JSON (LOCK_EX pour la concurrence) et envoyes en batch.
  • Refresh API : les signatures de bots et listes de domaines referrers se rafraichissent automatiquement depuis l'API (TTL 24h, support ETag).

Prerequis

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

Node.js

Pour les backends Node.js (Express, Fastify, Next.js, etc.), utilisez le package npm officiel avec middleware Express integre et auto-detection.

Installation

npm 
npm install @ailabsaudit/tracker-node

Alternativement, copiez src/index.js depuis le depot GitHub.

Exemple d'utilisation

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,
});

// Middleware Express — detecte bots et referrals automatiquement
app.use(createMiddleware(tracker));

// Arret propre — flush le buffer restant
process.on('SIGTERM', () => tracker.shutdown());

Comment ca fonctionne

  • Auto-detection est opt-in (enableDetection: false par defaut) pour la retrocompatibilite. Une fois active, le middleware detecte automatiquement les bots IA et referrers sur chaque requete.
  • Buffer : en memoire (max 500 evenements), flush toutes les 5 min, debounce 30s. Retry x3 sur erreurs 5xx/429.
  • Refresh API : les signatures de bots et listes de referrers se rafraichissent depuis l'API (TTL 24h, support ETag).

Arret propre

tracker.shutdown() envoie les evenements bufferises restants et stoppe tous les timers. Indispensable pour ne pas perdre d'evenements a l'arret du process.

Prerequis

Node.js 14+. Aucune dependance externe.

Python

Pour les backends Python (Django, Flask, FastAPI, etc.), utilisez le package pip avec middleware WSGI/ASGI et auto-detection.

Installation

pip 
pip install ailabsaudit-tracker

Alternativement, copiez tracker.py depuis le depot GitHub.

Exemple d'utilisation

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,
)

# Middleware WSGI — detecte bots et referrals automatiquement
app.wsgi_app = WsgiMiddleware(app.wsgi_app, tracker)

# Arret propre — flush le buffer restant
import atexit
atexit.register(tracker.shutdown)

Comment ca fonctionne

  • Auto-detection est opt-in (enable_detection=False par defaut) pour la retrocompatibilite. Une fois active, le middleware detecte automatiquement les bots IA et referrers sur chaque requete.
  • Buffer : thread-safe en memoire (max 500 evenements), flush toutes les 5 min via un thread daemon timer. Retry x3 sur erreurs 5xx/429.
  • Refresh API : les signatures de bots et listes de referrers se rafraichissent depuis l'API dans un thread background (TTL 24h, support ETag).

Arret propre

tracker.shutdown() envoie les evenements bufferises restants et stoppe tous les threads timer. Indispensable pour ne pas perdre d'evenements a l'arret du process (Gunicorn, uWSGI, etc.).

Prerequis

Python 3.8+. Aucune dependance externe. Compatible WSGI (Flask, Django) et ASGI (FastAPI, Starlette).

Cloudflare Worker

Deployez le tracker en tant que Cloudflare Worker pour intercepter et analyser les requetes en edge, sans aucun impact sur votre serveur d'origine.

Installation

1

Installer Wrangler

Si vous n'avez pas encore Wrangler installe :

Terminal 
npm install -g wrangler
2

Configurer wrangler.toml

Clonez le depot GitHub et editez wrangler.toml pour definir la variable API_URL.

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

Configurer les secrets

Ajoutez vos identifiants en tant que secrets du Cloudflare Worker (ils ne sont jamais exposes dans le code) :

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

Deployer

Deployez le Worker sur le reseau edge de Cloudflare :

Terminal 
wrangler deploy

Comment ca fonctionne

Detection en edge

Intercepte les requetes GET sur le edge Cloudflare, avant qu'elles n'atteignent votre serveur d'origine.

90+ signatures de bots

Detecte plus de 90 signatures de user-agent de bots IA dont GPTBot, ClaudeBot, Bingbot AI, etc.

30+ referrers IA

Identifie le trafic provenant de plus de 30 domaines de referrers IA comme ChatGPT, Perplexity, You.com, etc.

Fire-and-forget

Les evenements sont envoyes de maniere asynchrone via ctx.waitUntil() sans impact sur la latence.

Refresh dynamique

Les signatures de bots et listes de referrers IA sont rafraichies dynamiquement depuis l'API via la Cloudflare Cache API (TTL 24h). Si l'API est injoignable, le Worker retombe sur ses listes codees en dur incluses au deploiement.

Pixel JavaScript

Un tracker client leger (< 2 Ko) que vous ajoutez comme une simple balise script. Ideal pour les sites statiques, les landing pages ou quand vous n'avez pas d'acces serveur.

Installation

Ajoutez la balise script suivante a votre HTML, juste avant la balise fermante </body> :

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

Ce qu'il suit

page_view

Suit automatiquement chaque vue de page avec l'URL et les informations de referrer.

page_leave

Capture les evenements de sortie de page avec le temps passe et la profondeur de scroll.

click

Suit les evenements de clic sur les liens et elements interactifs.

Note de securite

Les payloads cote client sont non signes (les secrets HMAC ne peuvent pas etre exposes dans le navigateur). Les payloads sont valides cote serveur par domaine d'origine. Assurez-vous que votre domaine est enregistre dans vos parametres AI Labs Audit.

Verification

Une fois le tracker deploye, verifiez que tout fonctionne correctement depuis votre dashboard AI Labs Audit.

1

Ouvrir votre dashboard

Connectez-vous a votre compte AI Labs Audit et naviguez vers la page Tracking de votre client.

2

Verifier les crawls de bots

Les crawls de bots IA devraient commencer a apparaitre quelques minutes apres le deploiement. Recherchez les entrees de GPTBot, ClaudeBot, Bingbot et autres crawlers IA.

3

Verifier les referrals IA

Le trafic provenant des plateformes IA (ChatGPT, Perplexity, Copilot, etc.) apparaitra egalement dans le dashboard au fur et a mesure.

4

Examiner les details des evenements

Cliquez sur n'importe quel evenement pour voir les details complets : user-agent, URL crawlee, timestamp, code de statut et taille de reponse.

Astuce

Si vous ne voyez pas de donnees apres quelques minutes, verifiez vos identifiants dans les parametres du plugin et assurez-vous que votre serveur peut atteindre https://ailabsaudit.com/api/v1. Pour WordPress, verifiez que WP-Cron fonctionne correctement.

Pret a suivre la visibilite IA ?

Installez le tracker en quelques minutes et commencez a surveiller l'activite des bots IA sur votre site.

Voir sur GitHub Obtenir vos identifiants

Prêt à auditer votre visibilité IA ?

Créez votre compte gratuitement et recevez 1000 crédits bonus.

Créer un compte gratuit