콘텐츠로 건너뛰기

Google Search Console의 대량 데이터 내보내기(Bulk Data Export)란?

실적 보고서 및 데이터

대량 데이터 내보내기는 속성의 실적 데이터를 하루에 한 번 사용자의 Google Cloud 프로젝트에 있는 BigQuery 데이터세트로 전송하는 Search Console 설정입니다. Search Console이 보유한 모든 행이 담기며, 드물게 검색되는 쿼리도 텍스트 없는 행으로 포함됩니다. 16개월로 제한되지 않고 삭제하기 전까지 계속 쌓입니다. 기능을 켠 날부터만 데이터가 쌓이기 시작하며, BigQuery 무료 사용량을 넘는 저장 및 쿼리 비용은 사용자에게 청구됩니다.

성능 보고서와 API로는 할 수 없는 것

성능 보고서Search Analytics API대량 데이터 내보내기
행 수표 또는 내보내기당 1,000개검색 유형별 하루 최대 50,000개모든 행
기간16개월16개월설정한 날부터, 삭제하기 전까지 보관
드문(익명화된) 쿼리표에서는 제외되고 합계에만 반영동일쿼리가 비어 있는 행으로 포함
비용무료Cloud 청구는 없지만 할당량 적용BigQuery 저장 및 쿼리 요금
필요한 작업없음코드와 OAuthCloud 프로젝트와 SQL

시작하기 전에

  • Search Console 속성에 대한 소유자 권한이 필요합니다.
  • 결제가 사용 설정된 Google Cloud 프로젝트가 필요합니다.
  • 해당 프로젝트의 API 및 서비스 > 사용 설정된 API 및 서비스에서 BigQuery API와 BigQuery Storage API를 사용 설정하세요.

대량 데이터 내보내기 설정 방법

  1. Cloud 콘솔에서 IAM 및 관리자를 열고 액세스 권한 부여를 선택합니다.
  2. 주 구성원 search-console-data-export@system.gserviceaccount.com을 추가하고 BigQuery Job User와 BigQuery Data Editor 두 가지 역할을 부여한 뒤 저장합니다.
  3. Search Console에서 설정 > 대량 데이터 내보내기를 엽니다.
  4. Cloud 프로젝트 ID(프로젝트 번호가 아닙니다)를 입력합니다.
  5. 데이터세트 이름을 정합니다. 기본값은 searchconsole이며, 모든 이름은 이 값으로 시작해야 합니다. 같은 프로젝트로 내보내는 속성마다 별도의 데이터세트가 필요합니다.
  6. 데이터세트 위치는 신중하게 선택하세요. 내보내기가 시작된 후에는 Google에서 위치 변경을 지원하지 않습니다.
  7. 계속을 선택합니다. 첫 내보내기는 48시간 이내에 도착하며, 내보내기가 실행된 날의 데이터를 포함합니다.

테이블이 생성된 뒤에는 파티션 만료 기간(14일 이상)을 설정해 저장 용량을 제한할 수 있습니다. 열을 추가하거나 변경하지 마세요. 스키마를 변경하면 내보내기가 실패합니다.

BigQuery에 저장되는 데이터

  • searchdata_site_impression: Search Console의 차트 합계처럼 속성 단위로 집계된 실적 데이터입니다. URL 열은 없습니다.
  • searchdata_url_impression: URL 단위로 집계되며, 검색 노출 유형별 열(예: is_job_listing)과 is_anonymized_discover 플래그가 있습니다.
  • ExportLog: 테이블별로 내보내기에 성공할 때마다 한 행씩 기록됩니다. Google이 보정된 데이터로 특정 날짜를 다시 쓸 때마다 epoch_version이 올라갑니다.

날짜는 태평양 표준시 기준입니다. 행은 미리 집계되어 있지 않으므로 항상 SUM()으로 지표를 합산하세요. 순위는 0부터 시작하는 값이 합산되어 저장되므로, 평균 게재순위는 사이트 테이블에서는 SUM(sum_top_position) / SUM(impressions) + 1, URL 테이블에서는 sum_position을 사용해 같은 방식으로 계산합니다.

지난달 웹 검색 상위 쿼리를 구하는 기본 쿼리 예시입니다.

SELECT
  query,
  SUM(clicks) AS clicks,
  SUM(impressions) AS impressions,
  SUM(sum_top_position) / SUM(impressions) + 1 AS avg_position
FROM `your-project.searchconsole.searchdata_site_impression`
WHERE data_date BETWEEN '2026-09-01' AND '2026-09-30'
  AND search_type = 'WEB'
  AND query != ''
GROUP BY query
ORDER BY clicks DESC
LIMIT 100

항상 data_date로 필터링하세요. 테이블은 날짜별로 파티션되어 있으므로, 날짜 필터가 있어야 쿼리 때마다 전체 기록을 스캔하고 그만큼 비용이 청구되는 일을 막을 수 있습니다.

제한 사항과 실패 사례

  • 소급 적용되지 않습니다. 설정 이전의 데이터는 API나 보고서에서 가져와야 합니다.
  • 실패하면 중단됩니다. 오류가 발생하면 Search Console은 다음 날 다시 시도하며, 내보내지 못한 데이터는 약 일주일간 보관합니다. 약 한 달 동안 시도가 계속 실패하면 내보내기가 완전히 중단됩니다. 내보내기가 실패하거나 복구되면 소유자와 전체 권한 사용자에게 이메일이 발송됩니다.
  • 누락이 영구적일 수 있습니다. Google의 데이터 이상 현상 페이지에 따르면 2026년 2월 28일과 3월 1일 데이터는 일부 속성의 내보내기에서 누락되었으며 복구되지 않습니다. ExportLog를 달력과 주기적으로 대조해 보세요.
  • 중지. 설정 페이지에서 내보내기 비활성화를 선택하면 24시간 이내에 내보내기가 종료됩니다. 기존 테이블은 BigQuery에 그대로 남습니다.

꼭 필요한 기능일까요?

모든 롱테일 쿼리, URL별 검색 노출 유형 플래그, 다른 사내 데이터와의 SQL 조인이 필요하다면 필요합니다. 일반적인 보고용으로 16개월 이상의 기록을 보관하는 것이 주된 목적이라면, Cloud 프로젝트 없이 AutoPSEO의 저장된 속성으로 충분합니다. 전체 저장을 켜면 16개월 치를 백필하고, 이후 웹 검색의 쿼리, 페이지, 쿼리+페이지 행을 하루 최대 25,000개까지 최대 10년간 저장합니다. 모든 행보다는 적지만 대부분의 사이트에는 충분합니다. 관리, Search Console의 데이터 보관 기간, Search Console API를 참고하세요.

출처: Google의 대량 데이터 내보내기 개요, 설정, 모니터링, 테이블 참조, 샘플 쿼리.

SEO 콘텐츠를 자동 운영으로

Search Console과 사이트를 연결하세요. AutoPSEO가 사이트를 스캔하고 첫 주제를 바로 기획합니다. 신용카드는 필요 없습니다.