네이버 검색광고 API 다루기 (1)

이번 포스팅에는 네이버 광고 API를 다뤄보겠습니다. 현업에서 광고를 진행하는 포지션이라면 매체 API를 다뤄서 업무 자동화를 실현하고 싶은 니즈를 가지신 분들이 많을 텐데요, 이번 파이썬 강의를 통해 네이버 API를 파이썬으로 어떻게 다룰 수 있는지 살펴보도록 하겠습니다.

네이버 광고 API 서비스 신청하기

네이버 광고 API를 사용하기 위해서는 아래와 같은 과정을 거칩니다.

네이버 광고 시스템에 로그인한 후, 네이버 광고 API에서 상단의 도구 - API사용관리에 들어갑니다.

처음 네이버 광고 API를 진행한다면 위와 같은 화면이 출력될 것입니다. 중앙의 "네이버 검색광고 API 서비스 신청"버튼을 누릅니다.

신청 버튼을 누르면 곧 위와 같은 API 사용관리 화면으로 전환됩니다. 위 화면에서 빨간색 사각형으로 표시된 CUSTOMER_ID, 액세스라이선스, 비밀키를 체크해둡니다. 세 가지 데이터는 네이버 광고 API를 다루기 위해 필요합니다.

네이버 광고 API document 살펴보기

http://naver.github.io/searchad-apidoc

API를 사용하기 위해서는 API 사용전에 현재 어떤 서비스가 제공되고 있는지, 각 서비스는 어떻게 사용할 수 있는지 문서를 읽어봐야 합니다. 위의 화면 및 링크는 네이버 검색광고 API의 document입니다. 영어버전만 제공하고 있으며(2020년 현재) API에서 제공되는 서비스 리스트는 아래와 같습니다.

종류내용
AdExtension확장소재
Adgroup광고그룹
Ad광고
Campagin캠페인
BusinessChannel비즈니스채널
AdKeyword광고키워드
LabelRef라벨참조
Label라벨
MangedKeyword관리 키워드
Target광고 타겟
IpExclusion차단된 IP
Bizmoney비즈머니
ManagedCustomerLink클라이언트, 매니저 데이터
StatReport대용량보고서
Stat광고 데이터
masterReport메타 데이터
RelKwdStat연관키워드(키워드도구)
Estimate평가

위 서비스에서 특기할 만한 점은 네이버 광고를 집행한 후 광고 성과를 측정하기 위해 자주 사용하는 기능인 다차원 보고서가 없다는 점입니다. 네이버 광고 API에서는 직접적으로 다차원 보고서 서비스를 제공하지 않으며, 다차원 보고서처럼 데이터를 살펴보고 싶다면 네이버 API의 서비스로 데이터를 전달받은 후 사용자가 직접 데이터를 merge나 join 등의 방법으로 가공해야 합니다.

위 서비스들 중에서 광고성과 데이터를 호출하고 싶다면 Stat 서비스를 사용해서 살펴볼 수 있으며, Stat 서비스에서 제공하지 않는 광고데이터는 StatReport(2019.08.08 버전)에서 확인할 수 있습니다.

Stat 서비스 살펴보기

여러 서비스들 중, 사용 빈도가 높은 Stat 서비스를 살펴보도록 하겠습니다.

Stat서비스의 Overview 항목에는 각 Methods에 대한 개략적인 설명을 나타내 줍니다.

Stat서비스의 get (by id) Method를 살펴보면 페이지 상단에 서버요청 방법을 설명하고 있습니다. 내용을 살펴보면 GET 방식으로 요청하며, URI로 /stats가 사용됩니다. 중괄호는 파라미터 목록을 나열하고 있습니다.

Parameters항목에서는 id, fields, timeRange, datePreset, timeIncrement, breakdown의 총 6가지 파라미터를 정의하고 있습니다.

Response항목에서는 요청의 결과 서버에서 응답받는 response를 설명하고 있습니다.

네이버 광고 API 깃헙(Github) 페이지에서 코드 샘플 다운받기

파이썬 프로그래밍으로 네이버 광고 API를 사용하기 위해 document의 내용을 참고하여 우리가 직접 코딩을 할 수도 있지만, 네이버에서는 친절하게 Python 코드 샘플을 제공해주고 있습니다.

https://github.com/naver/searchad-apidoc

위의 페이지는 네이버 광고 API의 깃헙(github)페이지입니다. 위의 페이지에서 Python 샘플을 제공하기 때문에 요청 코드를 더욱 편리하게 작성할 수 있습니다.

Clone or download 버튼을 누른뒤, 그 아래에 생성되는 Download ZIP 버튼을 누릅니다. 그러면 searchad-apidoc-master.zip파일이 다운로드 됩니다. 압축파일을 연 뒤 searchad-apidoc-master -> python-sample -> examples의 경로를 열어보면 ad_management_sample.pysignaturehelper.py라는 파이썬 파일이 있습니다. 다음 포스팅에서는 두 개의 파일을 사용하여 네이버 검색광고 API를 다뤄보도록 하겠습니다.

Leave a Comment