Docs
Pesquisar na documentação...⌘K

Vercel

Os Log Drains da Vercel enviam automaticamente logs de requisições HTTP do seu projeto da Vercel para a Ahrefs. A conexão é feita por meio da integração da Ahrefs para a Vercel.

Pré-requisitos

  • Um plano Pro ou Enterprise da Vercel na equipe que hospeda seu projeto. Os Log Drains não estão disponíveis no plano Hobby.
  • Permissão para instalar integrações nessa equipe da Vercel.
  • O domínio do seu projeto da Ahrefs precisa estar atribuído a um projeto nessa equipe. A Ahrefs encontra o projeto da Vercel pelos domínios dele.

Como funciona

A configuração da Vercel tem duas partes: conectar uma equipe da Vercel à sua área de trabalho da Ahrefs uma vez e, depois, ativar o Bot Analytics em cada projeto que você quiser monitorar.

Etapa 1 — Conecte a Vercel à sua área de trabalho

  1. Na Ahrefs, acesse Configurações da conta → Integrações e clique em Conectar conta da Vercel. Você também pode começar pelo projeto que quer monitorar: em Configurações do projeto → Bot Analytics, selecione Vercel e clique em Conectar com a Vercel.
  2. Uma janela da Vercel é aberta. Escolha a equipe da Vercel (ou sua conta pessoal) e quais projetos a Ahrefs pode acessar e, em seguida, confirme.
  3. Você será redirecionado de volta para a Ahrefs. A equipe agora aparece em Configurações da conta → Integrações → Vercel.

Cada equipe da Vercel é conectada uma única vez e compartilhada por todos os projetos na sua área de trabalho da Ahrefs. Conecte novamente da mesma forma para adicionar outra equipe.

info

Certifique-se de que o projeto da Vercel que você quer monitorar esteja incluído no acesso que você concede à Ahrefs. A Ahrefs só pode criar Log Drains em projetos que ela consegue ver.

Etapa 2 — Ative o Bot Analytics em um projeto

  1. Acesse Configurações do projeto → Bot Analytics no seu projeto da Ahrefs.
  2. Selecione Vercel e clique em Ativar Vercel.

A Ahrefs vai:

  1. Encontrar o projeto da Vercel cujos domínios incluem o domínio do seu projeto da Ahrefs, em todas as suas equipes conectadas.
  2. Criar um Log Drain nesse projeto com o nome ahrefs-web-analytics-\<project id>, enviando logs de requisições para a Ahrefs.

Se nenhuma equipe conectada tiver um projeto que sirva esse domínio, a ativação falhará com uma mensagem informando isso. Verifique a atribuição do domínio na Vercel ou conecte primeiro a equipe correta.

Etapa 3 — Verificar a conexão

De volta em Configurações do projeto → Bot Analytics, o método Vercel aparece como conectado. Os dados aparecem no relatório do Bot Analytics depois que as primeiras requisições chegam ao seu site. Você também pode ver o Log Drain no seu dashboard da Vercel, nas configurações de Log Drains da equipe.

O que a Ahrefs faz com o acesso

  • Lê a lista de projetos e seus domínios para encontrar o projeto que corresponde ao seu site.
  • Cria, atualiza e exclui Log Drains nesses projetos. A Ahrefs gerencia apenas os Log Drains que ela criou.
  • Remove a integração da sua equipe quando você a desconecta na Ahrefs.

Desativação e desconexão

  • Desativar um projeto: em Configurações do projeto → Bot Analytics, desative a Vercel. O Log Drain é excluído da sua equipe da Vercel.
  • Desconectar uma equipe: em Configurações da conta → Integrações → Vercel, remova a conexão. A Ahrefs exclui os Log Drains que criou para essa equipe, desinstala a integração da Vercel e revoga o acesso.

info

Não há configuração manual para a Vercel. Os Log Drains criados fora da integração da Ahrefs não conseguem se autenticar na Ahrefs; por isso, sempre ative a Vercel nas configurações do seu projeto.