> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/fr/insights/onsite/traffic/vercel-agent-analytics.md). # Vercel Connectez votre projet Vercel à AirOps pour suivre le trafic des bots IA via Vercel Log Drains. Connectez votre projet Vercel à AirOps pour suivre le trafic des bots d’IA. AirOps provisionne automatiquement un **Drain de journaux Vercel** lorsque vous installez l’intégration, classe les visites des bots d’IA (ChatGPT, Claude, Perplexity, Google, et bien d’autres), et affiche des informations dans votre tableau de bord Agent Analytics. *** ### Prérequis * Un **AirOps** compte actif avec Agent Analytics activé * Un **Vercel Pro ou Enterprise** compte (les Log Drains ne sont pas disponibles sur les forfaits Hobby) * Un **projet Vercel** qui diffuse votre site web sur un domaine personnalisé * Un **Brand Kit** dans AirOps dont le domaine correspond à votre domaine de déploiement Vercel (configurable sous Context > Brand Kits > Brand URL) Si vous n’êtes pas sûr que votre brand kit est configuré correctement, vérifiez auprès de votre contact AirOps Customer Success avant l’installation. *** ### Étape 1 : Installez AirOps depuis le Marketplace Vercel 1. Ouvrez l’URL d’installation : [`https://vercel.com/integrations/airops-agent-analytics/new`](https://vercel.com/integrations/airops-agent-analytics/new) 2. Vercel affiche un sélecteur d’équipe. Sélectionnez l’ **équipe Vercel** qui possède le projet que vous souhaitez suivre. 3. Vercel affiche l’ **Installer AirOps Agent Analytics** écran. Sous « Sélectionnez les projets auxquels l’intégration aura accès », choisissez **Projets spécifiques** et sélectionnez uniquement le ou les projets qui diffusent votre site de marque suivi. 4. Cliquez sur **Installer**. {% hint style="info" %} Nous recommandons vivement **Projets spécifiques** plutôt que **Tous les projets**. « Tous les projets » donne à l’intégration accès à tous les projets de votre équipe Vercel, y compris ceux qui n’ont rien à voir (sites marketing, outils internes, déploiements de prévisualisation). AirOps filtre les journaux qui ne correspondent pas au domaine de votre brand kit avant de les stocker, mais ils génèrent quand même des coûts de trafic sortant du drain Vercel (environ 0,50 $/Go) sur votre facture. Ne sélectionner que le projet du site de marque permet de garder des coûts Vercel prévisibles et d’éviter de diffuser un trafic qui sera rejeté. {% endhint %} *** ### Étape 2 : Connectez-vous à votre espace de travail AirOps Après autorisation dans Vercel, vous serez redirigé vers AirOps. * Si votre compte AirOps a accès à **un seul espace de travail**, l’intégration se connecte automatiquement. * Si vous avez accès à **plusieurs espaces de travail**, un sélecteur apparaît. Sélectionnez l’espace de travail auquel vous souhaitez rattacher cette intégration Vercel. AirOps provisionne automatiquement un Vercel Log Drain pour l’équipe sélectionnée. Aucune configuration manuelle des URL de point de terminaison, des secrets de signature ou des en-têtes Bearer n’est requise. Vous serez redirigé vers la page d’intégration AirOps Agent Analytics sur Vercel, confirmant que l’installation est terminée. *** ### Étape 3 : Vérifier la connexion Dans AirOps, accédez à **Insights > Paramètres > Général** pour n’importe quel brand kit et faites défiler jusqu’à la **Intégrations connectées** section. Vous devriez voir une **Vercel** ligne avec : * Vert **Connecté** badge * Le nom de votre équipe Vercel connectée * Une **Désinstaller dans Vercel** action Les données commencent à circuler dès que votre site reçoit du trafic d’un bot d’IA. À faible volume de trafic, Vercel regroupe les enregistrements et les livre toutes les **30 à 60 secondes**. {% hint style="warning" %} de Vercel **Test** bouton (dans les paramètres des Drains côté Vercel) n’envoie que des journaux synthétiques sans données de requête. Un Test réussi ne **pas** signifie pas que le trafic réel apparaîtra dans AirOps ; cela confirme seulement que le point de terminaison est accessible. Le trafic réel des agents arrive lorsqu’un bot d’IA effectue une requête vers votre site correspondant aux projets configurés. {% endhint %} *** ### Dépannage | Symptôme | Cause probable | Correctif | | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | La ligne Vercel affiche **Connecté** mais aucune donnée n’apparaît dans Insights Traffic | Le domaine de votre brand kit ne correspond pas à votre domaine de déploiement Vercel | Dans AirOps, ouvrez les paramètres Brand Kit et confirmez que l’URL de marque correspond au domaine effectivement servi par votre projet Vercel (par exemple, `acme.com` pas `www.acme.com` si votre site est servi à `acme.com`). | | Vercel vous envoie un e-mail « drain en erreur » | Le point de terminaison AirOps a renvoyé des 4xx/5xx pour plus de 50 livraisons en une heure, ou pour plus de 80 % des livraisons en une heure | Contactez AirOps Customer Success. Nous pouvons diagnostiquer à partir des journaux du serveur. | | Le drain s’affiche comme « actif », mais aucune ligne n’apparaît après 5 minutes | Vous avez testé avec l’URL de déploiement générée automatiquement par Vercel (par exemple, `-.vercel.app`) | La protection de déploiement de Vercel sur les forfaits Pro renvoie 401 aux bots sur ces URL. Utilisez plutôt l’alias public de votre projet ou un domaine personnalisé. | | Le bouton Test réussit, mais aucune donnée réelle n’apparaît jamais | Vous avez atteint des chemins qui renvoient 404 sur un déploiement statique | Les 404 sur les déploiements statiques uniquement sont servis depuis le cache de périphérie de Vercel sans déclencher le drain. Visitez un chemin valide connu qui existe réellement dans votre déploiement. | | La colonne Bytes affiche 0 pour certaines requêtes | Les accès statiques mis en cache n’incluent pas `responseByteSize` | C’est attendu pour les ressources statiques mises en cache par Vercel. Les autres métriques (statut, user-agent, timing) ne sont pas affectées. | | Vous avez supprimé l’intégration dans Vercel, mais AirOps affiche toujours **Connecté** | La page affiche un état obsolète | Effectuez un rechargement forcé de la page AirOps (Cmd+Shift+R sur Mac, Ctrl+Shift+R sur Windows). Le webhook de désinstallation de Vercel est asynchrone et prend quelques secondes à arriver. | *** ### Exigences du forfait Les Vercel Log Drains sont disponibles sur **Vercel Pro et Enterprise** uniquement. Les forfaits Hobby ne peuvent pas créer de drains ; si votre équipe est sur Hobby, vous devrez effectuer une mise à niveau avant l’installation. Vercel facture le trafic sortant du drain à environ 0,50 $ par Go transmis, facturé sur votre facture Vercel. Pour les sites à faible trafic, cela représente généralement moins de 1 $ par mois. Pour les sites à fort trafic, réduisez le coût de deux façons : limitez l’installation à **Projets spécifiques** au seul projet du site de marque (voir l’étape 1), et dans les paramètres par environnement de Vercel, commencez avec Production uniquement et excluez les déploiements de prévisualisation. *** ### Configuration de sécurité et de moindre privilège #### Autorisations requises pour l’installation **Dans Vercel :** tout utilisateur disposant du **Membre** rôle dans votre équipe Vercel peut installer l’intégration. Le rôle Owner n’est pas requis. La configuration des intégrations fait partie des responsabilités standard du rôle Member ([rôles d’accès Vercel](https://vercel.com/docs/rbac/access-roles)). **Dans AirOps :** l’utilisateur qui effectue l’installation doit être connecté à AirOps et être membre de l’espace de travail cible, et n’importe quel rôle AirOps convient. #### Utilisateur dédié de type service AirOps ne dispose pas d’une primitive d’identité machine distincte d’un utilisateur, mais l’intégration est conçue de sorte que l’utilisateur qui installe n’intervient qu’au moment de l’installation et n’est pas le principal d’exécution. Vous pouvez satisfaire aux exigences de moindre privilège en traitant un compte utilisateur dédié comme un proxy de compte de service : 1. Invitez un utilisateur nommé et dédié (par exemple, `vercel-airops@yourcompany.com`) dans votre espace de travail AirOps. Utilisez le rôle le plus restreint proposé par votre espace de travail. 2. Connectez-vous une fois en tant que cet utilisateur et terminez l’installation OAuth. 3. Une fois l’installation terminée, cet utilisateur n’a aucune autorité d’exécution. L’intégration continue de s’authentifier via le jeton API de l’espace de travail décrit ci-dessous. Vous pouvez ensuite supprimer l’utilisateur de l’espace de travail si votre politique de sécurité l’exige ; l’intégration continue de fonctionner. Le même schéma s’applique côté Vercel : un utilisateur Vercel dédié avec le rôle Member peut effectuer l’installation puis rester comme membre inactif de l’équipe. #### Authentification à l’exécution Après l’installation, aucune session utilisateur n’est impliquée dans une livraison du drain. L’authentification de chaque livraison se fait en deux couches : * **signature HMAC-SHA1** du corps de la requête, indexée par un secret de drain propre à l’installation généré par AirOps au moment de l’installation. Vercel envoie la signature dans l’ `x-vercel-signature` en-tête à chaque livraison. * **jeton Bearer** dans l’ `Authorization` en-tête. Le jeton est la **clé API AirOps de votre espace de travail**, écrite dans la configuration du drain lors de l’installation. Les deux facteurs sont au niveau de l’espace de travail, pas au niveau de l’utilisateur. L’utilisateur qui installe est enregistré uniquement dans les métadonnées d’audit d’AirOps. #### Rotation du jeton La clé API de l’espace de travail peut être renouvelée dans l’application sous **Compte > Espace de travail > Clé API** (nécessite le rôle d’administrateur de l’espace de travail AirOps). Deux choses à comprendre avant la rotation : * Le drain Vercel contient l’ancien jeton intégré dans son en-tête sortant `Authorization` en-tête. Après la rotation, le drain commencera à échouer à l’authentification jusqu’à ce que l’intégration soit réinstallée depuis Vercel (ce qui inscrit le nouveau jeton dans un nouveau drain). * La même clé API d’espace de travail authentifie d’autres API AirOps (Public API, serveur MCP, SDK). Sa rotation les affecte toutes, pas seulement Vercel. Si la fréquence de rotation fait partie de votre politique de conformité, la séquence sûre est la suivante : faites tourner le jeton AirOps, puis réinstallez immédiatement l’intégration Vercel depuis la fiche Marketplace de Vercel. #### Ce que cette intégration ne fait pas * Elle ne demande pas de scopes sur votre compte Vercel au-delà de ce qui est nécessaire pour créer et gérer un log drain sur l’équipe sélectionnée. Elle ne peut pas lire le code source du projet, les variables d’environnement ou les journaux de déploiement en dehors du flux de requêtes du drain. * Elle n’écrit pas continuellement dans votre compte Vercel. Après le provisionnement initial du drain, AirOps ne reçoit que des données de Vercel ; il ne rappelle pas l’API de Vercel sauf si vous réinstallez ou déconnectez. Si votre revue de sécurité nécessite davantage de détails, contactez AirOps Customer Success et nous pourrons expliquer à votre équipe le flux de données au niveau de l’implémentation. *** ### Déconnexion Pour supprimer l’intégration Vercel : 1. Dans AirOps, ouvrez **Insights > Paramètres > Général > Intégrations connectées**. 2. Cliquez sur **Désinstaller dans Vercel** dans la ligne Vercel. Cela vous amène à la page des intégrations de votre équipe Vercel. 3. Trouvez l’intégration AirOps et cliquez sur **Supprimer**. Confirmez. 4. AirOps marque l’intégration comme **Déconnectée** lors du prochain rafraîchissement de la page. Vos données Vercel historiques restent dans AirOps après la déconnexion. Pour reprendre le suivi, cliquez sur **Réinstaller dans Vercel** dans la même ligne. *** ### Ce qu’AirOps suit Une fois connecté, AirOps : * **Ingeste toutes les requêtes servies par Vercel :** pages vues, ressources, appels API * **Classe le trafic des bots d’IA :** identifie les visites provenant de ChatGPT, Claude, Google, Perplexity, Meta, Apple, Bing, Bytedance, Common Crawl, et d’autres * **Catégorise le comportement de crawl :** distingue les crawlers d’entraînement de l’IA (GPTBot, ClaudeBot, etc.), les récupérations de recherche IA (PerplexityBot, OAI-SearchBot, etc.) et la navigation IA initiée par l’utilisateur (ChatGPT-User, Claude-User, etc.) * **Affiche des analyses :** des répartitions du trafic, des ratios bots/humains et des tendances de crawl dans votre tableau de bord --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.airops.com/docs/fr/insights/onsite/traffic/vercel-agent-analytics.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.