네이버 검색광고 API 사용하기

네이버 검색광고 API로 데이터를 추출할 때, 타 매체와는 데이터가 다르게 추출된다고 생각하실 수 있습니다. 데이터 보존 방식, 그리고 짧은 데이터 수집 기간이 있기 때문에, 만약 광고계에 종사하시는 개발자라면 API 데이터를 미리미리 수집하고, 가공해서 사용해야하는 어려움을 느끼실 수 있으실겁니다. 그렇다면 어떠한 차이점이 있는지 자세하게 알아보도록 하겠습니다.

네이버 검색광고 API 기본 구성

네이버 검색 광고 API를 통해 추출할 수 있는 데이터는 크게 6가지 데이터라고 보시면 되는데요.

키워드 보고서, 키워드 전환 보고서, 쇼핑 키워드 보고서, 쇼핑 키워드 전환 보고서, 브랜드형 쇼핑 검색광고 상품별 보고서, 브랜드형 쇼핑 검색광고 상품별 전환 보고서로 분류할 수 있습니다.

보통 브랜드형 쇼핑 검색광고 상품별는 사용하지 않고 키워드와 쇼핑 키워드 두 개의 데이터를 대중적으로 사용하고 있습니다.

네이버 검색광고 API 데이터 추출 전 알고 가기

사실 네이버는 조금 다른 형태로 데이터를 추출해야하는데요.

키워드 보고서, 키워드 전환 보고서, 쇼핑 키워드 보고서, 쇼핑 키워드 전환 보고서 데이터 이외에 네이버 마스터 데이터도 함께 데이터를 받아야합니다.

네이버 검색광고 API 마스터 데이터

네이버 검색광고 API에서 가장 중요한 데이터라고 보는데요.

google, kakao, criteo 등의 타 매체와는 다르게 네이버 성과 데이터는 캠페인 이름 정보, 광고그룹 이름 정보, 키워드 이름 정보 등을 성과 데이터와 따로 분류하고 있습니다. (이유는 몰라요)

그렇기 때문에 키워드 또는 소재별 데이터를 추출할 때에는 가장 처음 마스터 데이터를 추출하고 난 후에

성과 데이터를 추출하고 데이터를 저장한 후에 join으로 데이터를 보시는게 좋습니다.

네이버 검색광고 대시보드에서 보고서 탭 -> 대용량 다운로드 보고서에 들어가면 ‘광고 정보 일괄 다운로드’ 탭에서 마스터를 받을 수 있는데요.

(1) 캠페인 마스터

Customer ID, Campaign ID, Campaign Name 까지만 데이터를 추출하면 됩니다.

(2) 광고그룹마스터

Customer ID, Campaign ID, Ad Group ID, Ad Group Name 까지만 추출하면 됩니다.

(3) 파워링크등록키워드 마스터 (구 광고 키워드 마스터)

Customer ID, Ad Group ID, Ad Keyword ID 까지만 추출하면 됩니다.

파워링크등록키워드 마스터의 Ad Group ID로 광고그룹 마스터를 가지고 오고, 조합한 데이터로 Campaign ID를 기준으로 캠페인 마스터에서 데이터를 가지고 와 Campaign Name을 가지고 오면 된다.

이 데이터를 토대로 성과보고서에 맵핑해서 데이터를 비교하면 된다.

※주의할 점※

네이버의 데이터는 무기한 다운로드할 수 없어요.

보통 마스터 데이터는 최대 2년 전 데이터만 받을 수 있고, 만약 마스터 데이터를 받더라도 원하는 정보가 없다면, 좀 더 예전 기간의 데이터를 받아야 하는 불편함이 있습니다.

이유는 마스터 데이터가 결과적으로 최종 데이터를 주지만, update 된 데이터의 기록만 주는 경우가 있기 때문에 보통 네이버 검색광고 API를 통해 데이터를 받는다면 마스터 데이터 기간을 당일로부터 2년 전 데이터부터 받는걸 추천합니다.

EX) 오늘이 2024-09-11이면 2022-09-11부터 받도록합니다. 그전 데이터는 받을 수 없기 때문에 맵핑에 이상이 있다면 수기로 찾아아서 입력해야합니다.

만약 성과 데이터를 매일 API를 통해 데이터를 받는다면, 마스터 데이터를 1차적으로 받은 후 성과 데이터를 받는 걸 추천합니다.

네이버 검색광고 API 광고성과 데이터

네이버 검색광고 API로 성과 데이터를 추출하게 되면 csv파일로 네이버에서 주는데요.

이 데이터를 원하시는 각 개발 언어에 맞춰서 가공 후에 마스터 데이터와 맵핑해서 데이터를 사용하는걸 추천합니다.

네이버 검색광고 API 키워드 추출

API 데이터 기입 위치는 sample.ini 파일에서

API_KEY = “0123456789”
SECRET_KEY = “ABCDEFG”
CUSTOMER_ID = 000000

정보를 기입해서 API를 맵핑해야 합니다.

참고

네이버의 데이터 경우는 구글과 다르게 전날자 데이터가 거의 변동이 없어 데이터의 변동이 없는 편리함이 있다. 하지만 API의 사용이 생각보다 제약이 많다. GFA(광고성과 디스플레이)는 API로 데이터 추출이 어려웠지만 최근 들어 API로 추출이 가능하다고 한다.