BigQuery 도움말 가이드
마지막 업데이트 2025년 1월 9일 목요일
다음 단계에 따라 AccuRanker 데이터를 Google BigQuery와 연결하세요.
전제 조건
BigQuery를 AccuRanker에 연결하려면 다음이 필요합니다:
- 20,000개 이상의 키워드 AccuRanker 구독.
- 빅쿼리 활성화 요청을 위해 AccuRanker 고객 지원팀에 연락.
- 구글 빅쿼리 인스턴스가 있는 구글 클라우드 계정.
- 구글 빅쿼리에서 청구 활성화.
- 구글 서비스 계정에 특정 역할을 할당할 수 있는 권한.
BigQuery 액세스 설정에 대한 단계별 가이드
1. 서비스 계정 만들기
Google의 서비스 계정 키 만들기 설명서를 따라 서비스 계정 키 인증을 설정합니다.
2. 서비스 계정 권한 설정
Google은 서비스 계정에 필요한 권한을 부여하기 위해 세 가지 권한 시나리오를 지원합니다. 이전에 권한을 설정하지 않은 경우 Google의 서비스 계정 액세스 관리 문서를 읽어보세요.
프로젝트 또는 단일 데이터 집합에 대한 액세스 권한을 부여할 수 있습니다.
| 권한 유형 | 역할 | 리소스 | ------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------| | BigQuery 관리자 역할 | BigQuery 관리자 | 이미 만든 프로젝트 또는 데이터 집합 | BigQuery 데이터 소유자 및 BigQuery 작업 사용자 | BigQuery 데이터 소유자
BigQuery 작업 사용자 | 이미 만든 프로젝트 또는 데이터 집합 | | 사용자 지정 IAM 역할 | bigquery.tables.create
bigquery.tables.get
bigquery.tables.update
bigquery.tables.updateData
bigquery.tables.delete
bigquery.jobs.create | 이미 만들어진 프로젝트 또는 데이터 집합 |
서비스 계정 키 만들기
서비스 계정 플로우를 사용하려면 서비스 계정에 대한 JSON 파일을 제공해야 합니다.
- JSON 형식을 선택하여 새 키를 만듭니다.
- 만들기를 클릭합니다.
- 이 파일은 BigQuery에 연결하는 데 필수적이므로 안전한 위치에 JSON 파일을 다운로드합니다.
BigQuery 구성 완료
- BigQuery에 연결하려는 도메인으로 이동합니다.
- 개요에서 "통합"을 클릭하면 BigQuery 통합을 찾을 수 있습니다.
- 연결에 이름을 지정하고 데이터 집합의 위치를 지정합니다.
- 위치가 확실하지 않은 경우 여기에서 다양한 위치에 대해 읽어볼 수 있습니다.
- 서비스 계정 JSON 키를 업로드하고 "연결"을 클릭합니다 .
- 이미 데이터 집합을 만든 경우, 데이터 집합 위치가 이미 만든 데이터 집합과 일치하는지 확인하세요.그런 다음 연결을 테스트하고 연결이 성공적으로 테스트되면 메시지가 표시됩니다.
(선택 사항) 기록 데이터 다시 채우기
이제 도메인 설정으로 이동하여 기록 데이터가 필요한 경우 AccuRanker 데이터의 백필을 시작할 수 있습니다.
빅쿼리 업데이트 및 데이터 백필 방법
당사는 가장 최근의 변경 사항을 반영하기 위해 매일 BigQuery 데이터를 업데이트합니다. 매일 전날의 새로운 데이터를 추가합니다. 이러한 접근 방식은 분석을 위해 과거 기록을 보존하면서 모든 중요한 데이터 집합을 최신 상태로 유지하도록 보장합니다.
일일 업데이트 프로세스
업데이트 프로세스는 다음 데이터 세트에 중점을 둡니다:
모든* 랭크 및 자체* 랭크
- 이러한 데이터 세트는 매일 새로운 데이터를 추가하여 업데이트됩니다.
- 종합적이고 최신의 순위 기록을 유지합니다.
키워드메타데이터* 및 경쟁사*메타데이터
- 이러한 데이터 세트는 필요에 따라 보강됩니다.
- 메타데이터의 정확성과 완전성을 유지하기 위해 새로운 기록이 통합되거나 기존 기록이 새로 고쳐집니다.
월간 업데이트 주기
검색볼륨* 및 AI*search_volume 데이터 세트는 일일 업데이트 외에도 월 단위로 관리됩니다.
- 업데이트 일정: 매월 15일에 이러한 표는 Google 키워드 플래너(GKP)의 최신 데이터와 업데이트된 검색량 측정지표로 잘려서 대체됩니다.
- 목적: 이 프로세스는 가장 정확한 최신 인사이트를 제공하기 위한 것입니다.
- 과거 데이터: 이러한 데이터 세트에는 지난 4년간의 백필 데이터가 포함되어 있어 트렌드 분석을 위한 강력한 과거 관점을 제공합니다.
백필 데이터
연결에 성공한 후에는 데이터를 다시 채우도록 선택할 수 있습니다. 작동 방식은 다음과 같습니다:
- 범위: 데이터를 얼마나 뒤로 채울지 결정합니다. 첫 번째 순위 날짜까지 데이터를 다시 채울 수 있습니다.
- 제한 사항: 악의적인 동작을 방지하기 위해 백필은 한 번만 할 수 있습니다. 다시 채우려면 고객 지원을 통해 요청해야 합니다.
BigQuery 스키마 가이드
테이블의 명명 규칙은 다음과 같습니다.
정확랭커{스케마네임}{우리내부 도메인 플러그}
스키마 이름은 아래에 나열되어 있으며 각 스키마는 JSON 형식으로 다운로드할 수 있습니다.
테이블 설명
| 테이블 이름 | 설명 | -------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | all_ranks
| 이 테이블에는 동적 순위 및 경쟁사를 포함한 키워드 순위에 대한 모든 정보가 포함되어 있습니다. | own_ranks
| 이 테이블에는 추적하는 키워드 순위에 대한 모든 정보가 포함되어 있습니다. | 키워드_메타데이터
| 이 테이블에는 태그 및 도메인별 설정을 포함하여 현재 추적 중인 키워드에 대한 세부 정보가 포함되어 있습니다. | 경쟁사_메타데이터
| 이 테이블에는 경쟁사 설정을 포함하여 현재 추적 중인 경쟁사에 대한 세부 정보가 포함되어 있습니다. | 검색량
| 이 테이블에는 각 키워드의 월간 검색량이 포함되어 있습니다. 키워드에 위치가 있는 경우 위치별 검색량과 국가별 검색량이 모두 표시됩니다. 위치를 지정하지 않으면 검색량은 둘 다 동일합니다. | ai_search_volume
| 이 표에는 각 키워드에 대한 월별 AI 검색량이 포함되어 있습니다. 여기에는 특정 검색 유형에 대한 검색볼륨과* 두 검색 유형을 합친 검색*volume_total이 포함됩니다. |