Docs
搜索文档...⌘K

Vercel

Vercel Log Drains 会自动将 Vercel 项目的 HTTP 请求日志发送到 Ahrefs。 该连接通过适用于 Vercel 的 Ahrefs 集成来建立。

前提条件

  • 托管你项目的团队需使用 Vercel Pro企业版方案。 Hobby 方案不提供 Log Drains。
  • 拥有在该 Vercel 团队中安装集成的权限。
  • 你的 Ahrefs 项目的域名必须分配到该团队中的某个项目。 Ahrefs 会通过域名来查找对应的 Vercel 项目。

工作原理

设置 Vercel 分为两部分:先将一个 Vercel 团队一次性连接到你的 Ahrefs 工作区,然后在你要监控的每个项目上启用 Bot Analytics。

第 1 步 — 将 Vercel 连接到你的工作区

  1. 在 Ahrefs 中,前往 账户设置 → 集成,然后点击 连接 Vercel 账户。 你也可以从要监控的项目开始:在 项目设置 → Bot Analytics 中,选择 Vercel 并点击 使用 Vercel 连接
  2. 会打开一个 Vercel 窗口。 选择 Vercel 团队(或你的个人账号)以及允许 Ahrefs 访问的项目,然后确认。
  3. 随后会返回到 Ahrefs。 该团队现在会显示在 账户设置 → 集成 → Vercel 下。

每个 Vercel 团队只需连接一次,并由你的 Ahrefs 工作区中的所有项目共享。 若要添加另一个团队,请按相同方式再次连接。

info

请确保你要监控的 Vercel 项目包含在你授予 Ahrefs 的访问权限范围内。 Ahrefs 只能在它可见的项目上创建 Log Drains。

第 2 步 — 在项目上启用 Bot Analytics

  1. 进入你的 Ahrefs 项目的 项目设置 → Bot Analytics
  2. 选择 Vercel 并点击 启用 Vercel

Ahrefs 将会:

  1. 在你已连接的团队中,查找其域名包含你的 Ahrefs 项目域名的 Vercel 项目。
  2. 在该项目上创建一个名为 ahrefs-web-analytics-\<project id> 的 Log Drain,将请求日志传送到 Ahrefs。

如果所有已连接的团队中都没有为该域名提供服务的项目,启用将失败,并显示相应提示信息。 请在 Vercel 中检查域名分配,或先连接正确的团队。

第 3 步 — 验证连接

回到 项目设置 → Bot Analytics 后,Vercel 方法会显示为已连接。 当第一批请求到达你的网站后,数据会出现在 Bot Analytics 报告中。 你也可以在 Vercel Dashboard 中该团队的 Log Drains 设置下看到该 Log Drain。

Ahrefs 会如何使用这些访问权限

  • 读取项目列表及其域名,以找到与你网站匹配的项目。
  • 在这些项目上创建、更新和删除 Log Drains。 Ahrefs 仅管理由其创建的 Log Drains。
  • 当你在 Ahrefs 中断开连接时,会从你的团队中移除该集成。

禁用与断开连接

  • 禁用项目:在 项目设置 → Bot Analytics 中禁用 Vercel。 Log Drain 会从你的 Vercel 团队中删除。
  • 断开团队连接:在 账户设置 → 集成 → Vercel 中移除连接。 Ahrefs 会删除它为该团队创建的 Log Drains,从 Vercel 中卸载该集成,并撤销其访问权限。

info

Vercel 无需手动设置。 在 Ahrefs 集成之外创建的 Log Drains 无法通过 Ahrefs 的身份验证,因此请始终从你的项目设置中启用 Vercel。