Vercel

Vercel 로그 드레인은 Vercel 프로젝트의 HTTP 요청 로그를 Ahrefs로 자동 전송합니다. 연결은 Vercel용 Ahrefs 통합을 통해 이루어집니다.

사전 준비 사항

• 프로젝트를 호스팅하는 팀에 Vercel 프로 또는 엔터프라이즈 플랜이 있어야 합니다. Hobby 플랜에서는 로그 드레인을 사용할 수 없습니다.
• 해당 Vercel 팀에 통합을 설치할 수 있는 권한이 필요합니다.
• Ahrefs 프로젝트의 도메인이 해당 팀의 프로젝트에 할당되어 있어야 합니다. Ahrefs는 도메인을 기준으로 Vercel 프로젝트를 찾습니다.

작동 방식

Vercel 설정은 두 단계로 이루어집니다. 먼저 Vercel 팀을 Ahrefs 워크스페이스에 한 번 연결한 다음, 모니터링하려는 각 프로젝트에서 봇 애널리틱스를 활성화합니다.

1단계 — Vercel을 워크스페이스에 연결

1. Ahrefs에서 계정 설정 → 통합으로 이동한 다음 Vercel 계정 연결을 클릭합니다. 모니터링하려는 프로젝트에서 시작할 수도 있습니다. 프로젝트 설정 → 봇 애널리틱스에서 Vercel을 선택하고 Vercel에 연결을 클릭합니다.
2. Vercel 창이 열립니다. Vercel 팀(또는 개인 계정)과 Ahrefs가 액세스할 수 있는 프로젝트를 선택한 다음 확인합니다.
3. Ahrefs로 돌아갑니다. 이제 해당 팀이 계정 설정 → 통합 → Vercel 아래에 표시됩니다.

각 Vercel 팀은 한 번만 연결되며, Ahrefs 워크스페이스의 모든 프로젝트에서 공유됩니다. 다른 팀을 추가하려면 같은 방법으로 다시 연결하세요.

2단계 — 프로젝트에서 봇 애널리틱스 활성화

1. Ahrefs 프로젝트의 프로젝트 설정 → 봇 애널리틱스로 이동합니다.
2. Vercel을 선택하고 Vercel 활성화를 클릭합니다.

Ahrefs는 다음을 수행합니다:

1. 연결된 팀 전체에서 도메인에 Ahrefs 프로젝트의 도메인이 포함된 Vercel 프로젝트를 찾습니다.
2. 해당 프로젝트에 ahrefs-web-analytics-\<project id>라는 이름의 로그 드레인을 생성하고, 요청 로그를 Ahrefs로 전송합니다.

연결된 팀 중 해당 도메인을 제공하는 프로젝트가 없으면, 활성화가 실패하며 그 사실을 알리는 메시지가 표시됩니다. Vercel에서 도메인 할당을 확인하거나 먼저 올바른 팀을 연결하세요.

3단계 — 연결 확인

프로젝트 설정 → 봇 애널리틱스로 돌아가면 Vercel 방식이 연결된 것으로 표시됩니다. 첫 요청이 사이트에 도달한 후 봇 애널리틱스 보고서에 데이터가 표시됩니다. Vercel 대시보드의 팀 로그 드레인 설정에서도 해당 로그 드레인을 확인할 수 있습니다.

Ahrefs가 액세스 권한으로 수행하는 작업

• 프로젝트 및 해당 도메인 목록을 읽어 사이트와 일치하는 프로젝트를 찾습니다.
• 해당 프로젝트에서 로그 드레인을 생성, 업데이트 및 삭제합니다. Ahrefs는 자신이 생성한 로그 드레인만 관리합니다.
• Ahrefs에서 연결을 해제하면 팀에서 통합을 제거합니다.

비활성화 및 연결 해제

• 프로젝트 비활성화: 프로젝트 설정 → 봇 애널리틱스에서 Vercel을 비활성화합니다. 로그 드레인이 Vercel 팀에서 삭제됩니다.
• 팀 연결 해제: 계정 설정 → 통합 → Vercel에서 연결을 제거합니다. Ahrefs는 해당 팀에 대해 생성했던 로그 드레인을 삭제하고, Vercel에서 통합을 제거하며, 액세스 권한을 폐기합니다.