네이버 검색광고(파워링크) API, 이것 모르고 쓰면 분석이 틀어집니다

네이버 검색광고 API, 그러니까 파워링크 API를 쓰시는 분들이 정말 많이 겪는 문제가 몇 가지 있습니다. 실제 계정 데이터로 하나씩 보여 드리겠습니다.

시간대·기기별 성과는 API로 7일까지만 나옵니다

광고 성과를 시간대와 기기별로 쪼개서 보고 싶을 때, 바로 조회하는 API(/stats)로는 최대 7일까지만 볼 수 있습니다. 그보다 긴 기간은 대용량 보고서를 따로 받아야 해서, 조금만 고도화된 분석을 하려 해도 막히게 됩니다.

검색어·전환 유형은 하루치 보고서로만 받을 수 있습니다

검색어, 시간대, 전환 유형 같은 상세 내용은 하루 단위 대용량 보고서로만 제공됩니다. 보고서를 요청하고, 다 만들어질 때까지 기다렸다가, TSV 파일을 내려받아 우리가 분석하려는 형식에 맞게 다시 정리해야 합니다.

내려받은 파일은 이렇게 생겼습니다. 저희 계정의 10월 15일 파워링크 검색어 보고서인데요, 첫 줄에 열 이름도 없습니다.

20261015  3809033  cmp-a001-…  grp-a001-…  웍스              27758   P  …  160  0  0  …
20261015  3809033  cmp-a001-…  grp-a001-…  디자이너프리랜서  69559   M  …   57  0  0  …
20261015  3809033  cmp-a001-…  grp-a001-…  웍스              335738  P  …   53  0  0  …

(ID 일부와 몇 칸은 줄였습니다)

날짜, 고객번호, 캠페인, 광고그룹, 검색어, 매체 번호, 기기, 노출, 클릭, 비용 순서인데, 이건 네이버 문서를 따로 찾아봐야 압니다. 27758 이 "네이버 통합검색 PC", 69559 가 "사람인 모바일"이라는 것도 매체 목록을 한 번 더 받아서 붙여야 알 수 있고요. 이런 줄이 하루에만 272개였습니다.

그래서 90일치를 보려면 보고서 유형마다 이 과정을 90번씩 되풀이해야 합니다. AI로 API를 호출한다고 해도 전체 데이터를 한눈에 보기가 정말 어렵습니다.

네이버는 오래된 데이터를 지웁니다

네이버의 고질적인 문제는 오래된 데이터를 지운다는 점인데, 보관 기간도 보고서마다 다릅니다.

실제로 10월 20일에 지난 6개월 시간대별 전환을 물어보면, 네이버는 9월 4일부터의 전환만 줍니다. 그 앞 넉 달 치 전환 상세는 이미 지워져서 보고 싶어도 확인할 방법이 없습니다. 그래서 꼼꼼하게 분석하려면 데이터를 지워지기 전에 받아 두는 게 정말 중요합니다.

파워링크는 검색어별 전환을 볼 수 없습니다

파워링크 검색어 보고서를 볼 때 아주 불편한 부분이 있는데요. 어떤 검색어에 광고비를 많이 썼는지는 바로 보이지만, 그 검색어로 전환과 매출이 났는지는 나오지 않습니다.

파워링크 검색어 보고서에는 노출·클릭·비용만 있고, 검색어별 전환은 쇼핑 검색 광고에서만 확인할 수 있습니다. 그래서 파워링크는 등록한 키워드 단위로만 전환을 볼 수 있다는 걸 알고 분석해야 합니다.

전환수는 어떻게 세느냐에 따라 달라집니다

네이버 검색광고 API를 쓸 때 아주 중요한 부분이 전환수를 정의하는 겁니다.

• 직접 전환: 광고를 누르고 30분 안에 일어난 전환
• 간접 전환: 30분이 지난 뒤, 전환 추적 기간 안에 다시 돌아와 일어난 전환

또 전환에는 구매 완료 말고도 회원 가입, 장바구니 담기 같은 전환이 함께 들어 있습니다. 예를 들어 광고비 100만 원에 전환 매출이 500만 원으로 잡혔는데, 그중 구매 완료가 300만 원이고 나머지 200만 원이 장바구니 담기에 붙은 전환값이라면 이렇게 됩니다.

같은 광고인데도 ROAS가 200%p 차이 나니 전환값을 무엇으로 놓느냐에 따라 분석 결과가 완전히 바뀔 수 있습니다.

AI에게 물어봐도 한 번에 답이 안 나오는 이유

이런 문제들 때문에, 조금 긴 기간을 분석하고 싶을 때는 보통 이렇게 묻게 됩니다.

그런데 AI가 네이버 API를 직접 호출하면, 보고서를 수십 개 받아서 합치고 가공해야 하기 때문에 한 번에 답을 받기가 정말 어렵습니다.

웹에서 ChatGPT나 Claude를 쓰시는 분들은 네이버 API를 직접 부를 수 없어서, 파일을 하나하나 내려받아 올려야 합니다. Claude Code나 Codex처럼 내 컴퓨터에서 API를 호출하고 파일을 정리할 수 있는 도구를 쓰면 결과를 받을 수는 있지만, 시간이 아주 오래 걸리고 토큰도 많이 듭니다.

Docca는 이 문제를 이렇게 풉니다

Docca는 네이버 API의 이런 한계를 풀려고, 네이버가 주는 보고서를 받아서 분석하기 좋은 형태로 쌓아 둡니다. 그래서 웹에서 ChatGPT나 Claude를 쓰시는 분들도 Docca만 연결하면 위와 같은 질문에 바로 답을 받을 수 있습니다.

실제로 웹 Claude에 이렇게 물어봤습니다.

보고서 90개를 내려받는 대신 질문 한 번으로 끝났습니다. 이어서 "지난 6개월을 시간대별로 나눠서 클릭, 비용, 전환을 보여줘"라고 물으니, 표와 함께 이런 해석까지 붙여 줬습니다.

새벽 0~3시 클릭당 비용이 낮 시간의 세 배가 넘는다는 것, 전환이 0건이라 전환 추적부터 확인해야 한다는 것까지 바로 보입니다.

그리고 연결한 뒤부터 받은 데이터는 Docca에 계속 남아 있어서, 네이버가 보관 기간이 지나 지운 데이터도 Docca에서는 볼 수 있습니다. 전환 상세는 45일만 남으니, 하루라도 빨리 연결해 두시는 게 좋습니다.

연결하는 방법

처음 한 번만 하면 되고 세 단계면 끝납니다.

처음이면 이용 신청을 누르면 되는데, 심사 없이 액세스라이선스와 비밀키가 바로 나오고, 같은 화면 위에 CUSTOMER_ID(고객번호)도 있습니다. 세 값을 복사해 두세요.

키는 계정마다 다르니 광고 계정이 여럿이면 화면 위 계정 이름을 눌러 분석할 계정부터 고르세요.

새로 연결을 누르고, 1단계에서 복사한 고객번호·액세스 라이선스·비밀키를 붙여 넣은 뒤 확인하고 저장을 누릅니다.

저장하기 전에 그 키로 네이버에 실제로 한 번 접속해 보고, 키가 맞지 않으면 저장하지 않습니다. 키는 암호화해서 보관하고 저장한 뒤에는 화면에도 다시 보여 주지 않습니다.

이름에 Docca, MCP 서버 URL에 https://api.usedocca.com/v1/mcp 를 넣고 계속을 누릅니다. Docca 로그인 창이 뜨면 로그인하고 허용을 누르면 끝입니다.

ChatGPT도 같은 주소로 연결할 수 있습니다. 설정에서 개발자 모드를 켜고 플러그인 → 새 플러그인에 이름 Docca, 서버 URL https://api.usedocca.com/v1/mcp 를 넣고 만들기를 누른 뒤 Docca에 로그인하면 됩니다.