Vercel

Les drains de journaux de Vercel envoient automatiquement les journaux de requêtes HTTP de votre projet Vercel à Ahrefs. La connexion s’effectue via l’intégration Ahrefs pour Vercel.

Prérequis

• Un forfait Vercel Pro ou Entreprise pour l’équipe qui héberge votre projet. Les drains de journaux ne sont pas disponibles avec le forfait Hobby.
• L’autorisation d’installer des intégrations pour cette équipe Vercel.
• Le domaine de votre projet Ahrefs doit être attribué à un projet de cette équipe. Ahrefs trouve le projet Vercel grâce à ses domaines.

Comment ça fonctionne

La configuration de Vercel se fait en deux parties : connecter une équipe Vercel à votre espace de travail Ahrefs une seule fois, puis activer Bot Analytics sur chaque projet que vous souhaitez surveiller.

Étape 1 — Connecter Vercel à votre espace de travail

1. Dans Ahrefs, accédez à Paramètres du compte → Intégrations et cliquez sur Connecter un compte Vercel. Vous pouvez aussi partir du projet que vous souhaitez surveiller : dans Paramètres du projet → Bot Analytics, sélectionnez Vercel et cliquez sur Se connecter avec Vercel.
2. Une fenêtre Vercel s’ouvre. Choisissez l’équipe Vercel (ou votre compte personnel) ainsi que les projets auxquels Ahrefs peut accéder, puis confirmez.
3. Vous êtes redirigé vers Ahrefs. L’équipe apparaît désormais sous Paramètres du compte → Intégrations → Vercel.

Chaque équipe Vercel n’est connectée qu’une seule fois et est partagée par tous les projets de votre espace de travail Ahrefs. Répétez la même procédure pour ajouter une autre équipe.

Étape 2 — Activer Bot Analytics sur un projet

1. Accédez à Paramètres du projet → Bot Analytics pour votre projet Ahrefs.
2. Sélectionnez Vercel et cliquez sur Activer Vercel.

Ahrefs va effectuer les actions suivantes :

1. Trouver le projet Vercel dont les domaines incluent le domaine de votre projet Ahrefs, parmi toutes vos équipes connectées.
2. Créer sur ce projet un drain de journaux nommé ahrefs-web-analytics-\<project id>, qui transmet les journaux de requêtes à Ahrefs.

Si aucune équipe connectée n’a de projet desservant ce domaine, l’activation échoue avec un message l’indiquant. Vérifiez l’attribution du domaine dans Vercel ou connectez d’abord la bonne équipe.

Étape 3 — Vérifier la connexion

De retour dans Paramètres du projet → Bot Analytics, la méthode Vercel apparaît comme connectée. Les données apparaissent dans le rapport Bot Analytics après que les premières requêtes ont atteint votre site. Vous pouvez également voir le drain de journaux dans votre dashboard Vercel, dans les paramètres Drains de journaux de l’équipe.

Ce qu’Ahrefs fait avec l’accès

• Lit la liste des projets et de leurs domaines afin de trouver le projet correspondant à votre site.
• Crée, met à jour et supprime des drains de journaux sur ces projets. Ahrefs ne gère que les drains de journaux qu’il a créés.
• Supprime l’intégration de votre équipe lorsque vous la déconnectez dans Ahrefs.

Désactivation et déconnexion

• Désactiver un projet : dans Paramètres du projet → Bot Analytics, désactivez Vercel. Le drain de journaux est supprimé de votre équipe Vercel.
• Déconnecter une équipe : dans Paramètres du compte → Intégrations → Vercel, supprimez la connexion. Ahrefs supprime les drains de journaux qu’il a créés pour cette équipe, désinstalle l’intégration de Vercel et révoque son accès.