Vercel
Vercel Log Drains senden HTTP-Anfrage-Logs aus deinem Vercel-Projekt automatisch an Ahrefs. Die Verbindung wird über die Ahrefs-Integration für Vercel hergestellt.
Voraussetzungen
- Einen Vercel-Pro- oder Enterprise-Plan für das Team, das dein Projekt hostet. Log Drains sind im Hobby-Plan nicht verfügbar.
- Berechtigung, Integrationen für dieses Vercel-Team zu installieren.
- Die Domain deines Ahrefs-Projekts muss einem Projekt in diesem Team zugewiesen sein. Ahrefs findet das Vercel-Projekt über dessen Domains.
Wie es funktioniert
Das Einrichten von Vercel besteht aus zwei Teilen: einmalig ein Vercel-Team mit deinem Ahrefs-Workspace verbinden und dann Bot Analytics für jedes Projekt aktivieren, das du überwachen möchtest.
Schritt 1 — Vercel mit deinem Workspace verbinden
- Gehe in Ahrefs zu Kontoeinstellungen → Integrationen und klicke auf Vercel-Konto verbinden. Du kannst auch beim Projekt starten, das du überwachen möchtest: Wähle in Projekteinstellungen → Bot Analytics Vercel aus und klicke auf Mit Vercel verbinden.
- Ein Vercel-Fenster wird geöffnet. Wähle das Vercel-Team (oder dein persönliches Konto) sowie die Projekte aus, auf die Ahrefs zugreifen darf, und bestätige dann.
- Du wirst zu Ahrefs zurückgeleitet. Das Team erscheint jetzt unter Kontoeinstellungen → Integrationen → Vercel.
Jedes Vercel-Team wird einmal verbunden und von jedem Projekt in deinem Ahrefs-Workspace gemeinsam genutzt. Stelle auf dieselbe Weise erneut eine Verbindung her, um ein weiteres Team hinzuzufügen.
info
Stelle sicher, dass das Vercel-Projekt, das du überwachen möchtest, in den Zugriffsrechten enthalten ist, die du Ahrefs gewährst. Ahrefs kann Log Drains nur für Projekte erstellen, die es sehen kann.
Schritt 2 — Bot Analytics für ein Projekt aktivieren
- Gehe für dein Ahrefs-Projekt zu Projekteinstellungen → Bot Analytics.
- Wähle Vercel aus und klicke auf Vercel aktivieren.
Ahrefs wird Folgendes tun:
- Das Vercel-Projekt in deinen verbundenen Teams finden, dessen Domains die Domain deines Ahrefs-Projekts enthalten.
- Einen Log Drain in diesem Projekt mit dem Namen
ahrefs-web-analytics-\<project id>erstellen, der Anfrage-Logs an Ahrefs liefert.
Wenn kein verbundenes Team ein Projekt hat, das diese Domain ausliefert, schlägt die Aktivierung mit einer entsprechenden Meldung fehl. Prüfe die Domain-Zuweisung in Vercel oder verbinde zuerst das richtige Team.
Schritt 3 — Verbindung überprüfen
Zurück in Projekteinstellungen → Bot Analytics wird die Vercel-Methode als verbunden angezeigt. Daten erscheinen im Bot Analytics-Report, nachdem die ersten Anfragen deine Website erreicht haben. Du kannst den Drain auch in deinem Vercel-Dashboard in den Log Drains-Einstellungen des Teams sehen.
Was Ahrefs mit dem Zugriff macht
- Liest die Liste der Projekte und ihrer Domains, um das Projekt zu finden, das zu deiner Website passt.
- Erstellt, aktualisiert und löscht Log Drains in diesen Projekten. Ahrefs verwaltet nur Drains, die es selbst erstellt hat.
- Entfernt die Integration aus deinem Team, wenn du sie in Ahrefs trennst.
Deaktivieren und trennen
- Ein Projekt deaktivieren: Deaktiviere in Projekteinstellungen → Bot Analytics Vercel. Der Log Drain wird aus deinem Vercel-Team gelöscht.
- Ein Team trennen: Entferne in Kontoeinstellungen → Integrationen → Vercel die Verbindung. Ahrefs löscht die Log Drains, die es für dieses Team erstellt hat, deinstalliert die Integration in Vercel und verwirft seine Zugriffsberechtigung.
info
Für Vercel gibt es keine manuelle Einrichtung. Log Drains, die außerhalb der Ahrefs-Integration erstellt wurden, können sich nicht bei Ahrefs authentifizieren. Aktiviere Vercel deshalb immer in deinen Projekteinstellungen.