Installer le suivi du trafic IA
Capturez les visites issues de l'IA avec l'extrait navigateur, Tag Manager, WordPress ou Cloudflare, et connectez GA4 et Search Console.
Cette page couvre tout ce qui alimente Trafic IA : les installations de capture et les connexions Google optionnelles. Si vous avez déjà installé le suivi des robots côté serveur, cette installation rapporte aussi les visites issues des réponses IA, et vous pouvez passer directement aux événements de conversion ou à Connecter Google Analytics 4.
Ce qui est suivi
Deux types de visiteurs différents demandent deux techniques de capture différentes :
| Visiteur | Exécute JavaScript | Capturé par |
|---|---|---|
| Robots IA (GPTBot, ClaudeBot, ...) | Non | Installations côté serveur uniquement |
| Humains venus des réponses IA | Oui | Installations côté serveur ou extrait navigateur |
Les installations côté serveur (Cloudflare, WordPress, serveur personnalisé) capturent les deux. L'extrait navigateur et Tag Manager ne capturent que les referrals humains, ce qui en fait le bon choix quand vous ne pouvez pas exécuter de code côté serveur, et un complément, pas un remplacement, partout ailleurs.
Choisir un parcours d'installation
| Votre situation | À utiliser |
|---|---|
| Installation côté serveur déjà en place | Rien à ajouter ; les visites remontent déjà |
| Site derrière Cloudflare | Worker Cloudflare (capture les deux types) |
| WordPress | Extension WordPress (capture les deux types) |
| Vous gérez vos balises dans Google Tag Manager | Tag Manager |
| Tout site où vous pouvez ajouter une balise script | Extrait navigateur |
Extrait navigateur
L'extrait navigateur est un petit script servi depuis l'application. Il ne rapporte une visite que lorsque la session provient d'une surface IA reconnue, et il identifie votre site avec un jeton navigateur, public et lié au domaine de votre clé de site, donc sans risque dans le code source de la page.
- Dans l'application, allez dans Robots d'IA → Installer le suivi et ouvrez l'onglet Navigateur / GTM.
- Les jetons navigateur nécessitent une clé de site avec un domaine enregistré. Si l'onglet l'indique, ajoutez d'abord un domaine à votre clé de site, puis cliquez sur Générer un jeton navigateur.
- Copiez l'extrait de deux lignes et collez-le dans le
<head>de votre site (ou avant</body>), sur chaque page :
<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>La première ligne est un stub qui met en file d'attente les appels faits avant le chargement du script, pour que les appels de conversion ne lèvent jamais d'erreur.
Google Tag Manager
Utilisez Tag Manager quand c'est là que vivent les balises de votre site. Deux options :
- Balise HTML personnalisée : créez une nouvelle balise HTML personnalisée, collez le même extrait de deux lignes depuis l'onglet Navigateur / GTM, définissez le déclencheur sur All Pages et publiez le conteneur.
- Modèle communautaire : Citlyze fournit un modèle Tag Manager importable. Dans Tag Manager, allez dans Templates → New → Import, chargez le modèle Citlyze, créez une balise à partir de celui-ci et saisissez votre jeton navigateur.
Les deux font la même chose ; le modèle évite simplement les permissions HTML brut dans les conteneurs qui les restreignent.
Événements de conversion
Une fois une installation de capture en place, votre site peut rapporter des conversions en un appel, avec des noms d'événements que vous autorisez d'abord :
- Sur Robots d'IA → Trafic IA, ajoutez les noms d'événements à accepter sous Paramètres de capture → Événements de conversion (jusqu'à 10 noms en minuscules). Les événements hors liste sont rejetés.
- Déclenchez l'événement depuis votre site à l'endroit où la conversion a lieu :
window.citlyze("event", "signup");Les conversions sont limitées à la même session : elles sont attribuées à la source IA qui a amené le visiteur converti. Pendant que vous êtes dans les paramètres de capture, ajoutez aussi vos IP ignorées (plages IP du bureau, staging) pour garder le trafic interne hors du rapport.
Connecter Google Analytics 4
La connexion Google remplit le rapport Trafic IA à partir des données de session propres à GA4, qui couvrent les visiteurs que votre extrait ne peut pas voir, et elle fonctionne avant même toute installation.
- Sur Robots d'IA → Trafic IA, repérez la carte Google Analytics et Search Console et cliquez sur Connecter le compte Google.
- Connectez-vous avec un compte Google qui peut consulter la propriété GA4, et approuvez l'accès en lecture seule affiché sur l'écran de consentement de Google.
- De retour dans l'application, choisissez la propriété GA4 à synchroniser et enregistrez.
La connexion est en lecture seule : Citlyze lit les données de rapport agrégées quotidiennes de la propriété sélectionnée (sessions, utilisateurs et conversions des sources de type assistant IA, par page d'atterrissage et par date) et n'écrit rien dans votre compte Google. Les données se synchronisent chaque jour.
Connecter Search Console
La même connexion Google peut synchroniser un site Search Console : choisissez le site dans la carte après la connexion. La synchronisation Search Console apporte les clics et les impressions quotidiens par page et par date, ce qui couvre la performance de vos pages dans les fonctionnalités IA de la recherche Google, en plus des données de referral.
Déconnecter et révoquer
- Dans l'application, le bouton Déconnecter de la carte supprime la connexion enregistrée et les données Google synchronisées pour ce fournisseur.
- Vous pouvez aussi révoquer l'accès de Citlyze depuis les paramètres de sécurité de votre compte Google à tout moment ; plus aucune donnée Google ne pourra ensuite être récupérée.
- Passer à une autre propriété ou à un autre site remplace les données synchronisées précédemment.
Notes de confidentialité
- L'accès Google est limité aux portées de reporting en lecture seule approuvées sur l'écran de consentement ; il n'y a pas d'accès en écriture.
- Le jeton navigateur est public par conception ; l'ingestion vérifie le domaine de la page qui rapporte face au domaine enregistré de la clé de site.
- Les événements de referral enregistrent le chemin d'atterrissage, le referrer et un contexte grossier d'appareil et de pays, pas l'identité des visiteurs.
- L'historique des referrals est conservé selon votre forfait (30, 90 ou 400 jours) ; voir Forfaits et limites.
Vérifier
Le tableau des clés de site sur Installer le suivi a une colonne Dernier événement qui se met à jour quand votre installation livre son premier rapport accepté ; les clics de referral IA comptent. Les visites issues de l'IA apparaissent sur la page Trafic IA dès que de vraies sessions arrivent ; sur les sites à faible trafic, cela peut prendre un jour ou deux. La carte Google affiche le nombre de sessions synchronisées une fois la première synchronisation quotidienne terminée.