Vercel

Vercel Log Drains は、Vercel プロジェクトの HTTP リクエストログを Ahrefs に自動的に送信します。 接続は、Vercel 用 Ahrefs 連携機能を通じて行われます。

前提条件

• プロジェクトをホストしているチームで、Vercel の プロ または エンタープライズ プランを利用していること。 Log Drains は Hobby プランでは利用できません。
• その Vercel チームに連携機能をインストールする権限があること。
• Ahrefs プロジェクトのドメインが、そのチームのプロジェクトに割り当てられている必要があります。 Ahrefs はドメインに基づいて Vercel プロジェクトを特定します。

仕組み

Vercel の設定は 2 つの手順から成ります。まず 1 回だけ Vercel チームを Ahrefs ワークスペースに接続し、その後、監視したい各プロジェクトでボット解析を有効化します。

手順 1 — Vercel をワークスペースに接続する

1. Ahrefs で アカウント設定 → 連携機能 に移動し、Vercel アカウントを接続 をクリックします。 監視したいプロジェクトから開始することもできます。プロジェクト設定 → ボット解析 で Vercel を選択し、Vercel と接続 をクリックします。
2. Vercel のウィンドウが開きます。 Vercel チーム（または個人アカウント）と、Ahrefs がアクセスできるプロジェクトを選択し、確認します。
3. Ahrefs に戻ります。 チームが アカウント設定 → 連携機能 → Vercel に表示されます。

各 Vercel チームは 1 回だけ接続され、Ahrefs ワークスペース内のすべてのプロジェクトで共有されます。 別のチームを追加するには、同じ手順で再度接続します。

手順 2 — プロジェクトでボット解析を有効にする

1. Ahrefs プロジェクトの プロジェクト設定 → ボット解析 に移動します。
2. Vercel を選択し、Vercel を有効化 をクリックします。

Ahrefs は次の処理を行います。

1. 接続済みチーム全体から、ドメインに Ahrefs プロジェクトのドメインが含まれる Vercel プロジェクトを探します。
2. ahrefs-web-analytics-\<project id> という名前の Log Drain をそのプロジェクトに作成し、リクエストログを Ahrefs に送信します。

接続済みのどのチームにも、そのドメインを配信しているプロジェクトがない場合、有効化は失敗し、その旨を示すメッセージが表示されます。 Vercel でドメインの割り当てを確認するか、先に正しいチームを接続してください。

ステップ 3 — 接続を確認

プロジェクト設定 → ボット解析 に戻ると、Vercel 方式が接続済みとして表示されます。 最初のリクエストがサイトに到達すると、ボット解析レポートにデータが表示されます。 チームの Log Drains 設定で、Vercel ダッシュボードからも Log Drain を確認できます。

Ahrefs がアクセス権で行うこと

• プロジェクトとそのドメインの一覧を読み取り、サイトに一致するプロジェクトを見つけます。
• それらのプロジェクト上の Log Drain を作成・更新・削除します。 Ahrefs が管理するのは、自身が作成した Log Drain のみです。
• Ahrefs で切断すると、チームから連携機能を削除します。

無効化と切断

• プロジェクトを無効化：プロジェクト設定 → ボット解析 で、Vercel を無効にします。 Log Drain は Vercel チームから削除されます。
• チームを切断：アカウント設定 → 連携機能 → Vercel で、接続を解除します。 Ahrefs は、そのチーム向けに作成した Log Drain を削除し、Vercel から連携機能をアンインストールして、アクセス権を破棄します。