네이버 검색광고 데이터, 구글 시트로 자동으로 받는 법

네이버 검색광고를 운영하면 매주 광고시스템에 들어가 보고서를 내려받고, 시트에 붙여넣고, 캠페인별로 다시 합치는 일이 반복됩니다. 키워드가 많은 계정은 파일 하나만으로도 수천 행이 되고, 붙여넣는 범위가 한 줄만 어긋나도 합계가 틀립니다.

이 글은 네이버 검색광고 데이터를 구글 시트로 자동으로 받는 방법을 세 가지로 나눠 비교하고, 직접 만들 때 막히는 지점을 정리합니다.

방법 비교: 다운로드·API·연동 도구

매주 한 번, 캠페인 합계만 보면 다운로드로 충분합니다. 매일 보거나, 광고그룹·키워드·소재 단위로 보거나, 구글·메타와 한 시트에 합쳐야 한다면 API를 쓰는 쪽이 낫습니다.

방법 1. 광고시스템 보고서를 내려받아 붙여넣기

네이버 검색광고 광고시스템의 보고서 메뉴에서 기간과 단위(캠페인·광고그룹·키워드 등)를 고른 보고서를 만들고 파일로 내려받습니다. 자주 쓰는 구성은 저장해 두면 다음부터 기간만 바꿔 받을 수 있습니다.

붙여넣을 때는 다음을 지키면 실수가 줄어듭니다.

• 시트에 원본 탭과 요약 탭을 나누고, 원본 탭은 통째로 지우고 새로 붙여넣습니다.
• 요약 탭은 원본 탭 전체 열을 참조하는 SUMIFS·QUERY로 만들어 행 수가 바뀌어도 따라가게 합니다.
• 오늘 데이터는 계속 바뀌므로 어제까지만 받습니다.

방법 2. 검색광고 API + Apps Script로 직접 만들기

API 키 발급

광고시스템의 도구 → API 사용 관리에서 API 사용을 신청하면 세 가지 값이 나옵니다.

값을 복사할 때 앞뒤 공백이 따라오면 인증 오류가 납니다. 비밀키는 시트 셀이 아니라 Apps Script의 스크립트 속성에 넣어 두세요. 시트를 공유받은 사람이 키를 볼 수 있기 때문입니다.

요청 서명 만들기

네이버 검색광고 API는 OAuth가 아니라 HMAC-SHA256 서명 방식입니다. 타임스탬프.메서드.경로를 비밀키로 서명해 매 요청 헤더에 넣습니다. 경로에는 쿼리 문자열을 넣지 않습니다.

function naverHeaders(method, path) {
  const props = PropertiesService.getScriptProperties();
  const timestamp = String(Date.now());
  const signature = Utilities.base64Encode(
    Utilities.computeHmacSha256Signature(
      timestamp + '.' + method + '.' + path,
      props.getProperty('NAVER_SECRET_KEY')
    )
  );
  return {
    'X-Timestamp': timestamp,
    'X-API-KEY': props.getProperty('NAVER_API_KEY'),
    'X-Customer': props.getProperty('NAVER_CUSTOMER_ID'),
    'X-Signature': signature,
  };
}

AI에게 코드를 부탁할 때도 "HMAC-SHA256 서명 방식"이라고 명시해야 엉뚱한 OAuth 코드가 나오지 않습니다.

직접 만들 때 막히는 지점

1. 성과 데이터에 이름이 없습니다. 통계 조회는 캠페인·광고그룹 ID 기준으로 숫자를 돌려줍니다. 캠페인 목록을 따로 받아 ID로 이름을 붙여야 시트에서 읽을 수 있습니다.
2. 단위가 내려갈수록 호출이 늘어납니다. 광고그룹·소재·키워드 단위로 내려가면 대상 ID가 수백~수천 개가 되고, 호출 빈도 제한(429)에 걸리기 쉽습니다. 기간 안에 노출이나 비용이 있었던 대상만 조회하고, 큰 계정은 대용량 보고서 기능을 검토하세요.
3. 같은 날짜를 다시 받으면 행이 중복됩니다. 날짜·ID를 키로 기존 행을 지우고 다시 쓰는 방식으로 만들어야 재실행해도 안전합니다.
4. 실패가 조용히 지나갑니다. 시간 트리거가 실패하면 시트는 어제 상태로 남습니다. 마지막 성공 시각과 반영 날짜를 시트 한 칸에 남겨 두세요.

방법 3. 연동형 도구로 연결하기

API 키 세 가지를 입력하면 도구가 서명·이름 붙이기·재수집·실패 처리를 대신합니다. 고를 때는 다음을 확인하세요.

• 캠페인뿐 아니라 광고그룹·소재·키워드 단위까지 받는가
• 같은 날짜를 다시 받아도 중복 없이 교체되는가
• 수집 실패 시 기존 데이터를 지우지 않는가
• 구글 시트가 같은 파일로 갱신되는가, 매번 새 파일인가
• 구글·메타 등 다른 매체와 같은 열 구조로 합쳐지는가

수집할 때 주의할 점

• 전환 정의: 네이버 검색광고의 전환은 광고시스템에 설정한 전환 추적 기준입니다. 다른 매체 전환과 단순 합산하지 마세요. 기준 맞추는 법은 네이버 검색광고 vs 메타 광고: 성과를 한 표로 비교하는 기준을 참고하세요.
• 광고비 기준: 광고시스템 비용과 실제 청구 금액(부가세 등)이 다를 수 있습니다. 보고서 첫 줄에 어떤 기준인지 적어 두세요.
• 파생 지표: CTR·CPC·CPA는 합계를 먼저 내고 나눠야 합니다. 수식은 광고 성과 지표 계산식 총정리에 있습니다.

메디트랙으로 연결하면

메디트랙은 네이버 검색광고 API 키·비밀키·CUSTOMER_ID를 입력하면 캠페인·광고그룹·소재와 키워드 성과를 매일 새벽 수집합니다. 리포트 빌더에서 원하는 열을 고르고 시트로 저장하면 매일 아침 전날까지의 데이터로 같은 구글 시트가 갱신됩니다. 네이버 검색광고와 Google Ads 연결, 구글 시트 자동화는 카드 등록 없이 계속 무료입니다.

여러 매체를 한 시트로 묶는 전체 흐름은 광고 리포트 자동화: 여러 매체 데이터를 매일 한 시트로에서 볼 수 있습니다.

자주 묻는 질문

API 사용에 비용이 드나요?

API 사용 신청 자체는 광고시스템에서 할 수 있습니다. 다만 호출 빈도 제한이 있으므로 큰 계정을 자주 조회하면 제한에 걸릴 수 있습니다. 최신 이용 조건은 네이버 검색광고 API 공식 안내를 확인하세요.

키워드별 월간 검색수도 같은 방법으로 받을 수 있나요?

월간 검색수는 광고 성과 통계가 아니라 키워드 도구 API에서 따로 받습니다. 성과 데이터와 기준 기간이 다르므로 같은 표에 넣을 때 출처를 구분하세요.

오늘 데이터까지 시트에 넣어도 되나요?

권장하지 않습니다. 당일 데이터는 계속 바뀌고, 전환은 며칠 뒤 반영되기도 합니다. 매일 어제까지를 받고, 최근 며칠은 다시 받아 덮어쓰는 방식이 안전합니다.