네이버 검색광고 API 키 발급 방법 (CUSTOMER_ID·엑세스라이선스·비밀키)
네이버 검색광고 API 키는 네이버 광고주센터 > 검색 광고 > 도구 > SA API 사용관리에서 무료로 발급합니다. 처음이라면 "네이버 검색광고 API 서비스 신청"을 누르면 CUSTOMER_ID, 엑세스라이선스, 비밀키 세 가지가 바로 표시됩니다.
네이버 검색광고 API는 광고관리 화면에서 하는 일을 프로그램이 대신 할 수 있게 해 주는 공식 통로입니다. 자동입찰, 광고 보고서 같은 외부 도구를 쓰려면 이 API 키가 필요합니다. 발급은 무료이며 광고주센터에서 몇 분이면 끝납니다.
발급받는 키 세 가지
| 항목 | 무엇인가 |
|---|---|
| CUSTOMER_ID | 광고 계정 번호입니다. 어떤 광고 계정에 접근할지 정합니다. |
| 엑세스라이선스 | API를 쓰는 주체를 확인하는 공개 키입니다. |
| 비밀키 | 요청에 서명하는 비밀 값입니다. 다른 사람에게 보여 주면 안 됩니다. |
1단계. SA API 사용관리 열기
네이버 광고주센터(searchad.naver.com)에 로그인한 뒤, 왼쪽 메뉴에서 검색 광고를 고르고 도구 메뉴를 엽니다.
도구 메뉴 안에서 SA API 사용 관리를 누릅니다.
2단계. 네이버 검색광고 API 서비스 신청
API를 처음 쓰는 계정이면 "API 서비스를 이용하고 있지 않습니다"라는 안내가 나옵니다. 네이버 검색광고 API 서비스 신청을 누르고 이용 약관에 동의하면 바로 발급됩니다. 이미 신청한 계정이면 이 단계는 건너뜁니다.
3단계. CUSTOMER_ID·엑세스라이선스·비밀키 복사
신청이 끝나면 "현재 API 서비스를 이용 중입니다"라는 문구와 함께 CUSTOMER_ID, 엑세스라이선스, 비밀키가 표시됩니다. 각 값 옆의 복사 버튼으로 복사해 사용할 서비스에 붙여 넣습니다.
키를 안전하게 쓰려면
- 비밀키는 메신저나 메일로 주고받지 말고, 쓸 서비스 화면에 직접 붙여 넣으세요.
- 키가 새어 나갔다고 의심되면 SA API 사용 관리에서 키를 삭제하고 다시 발급하면 기존 키는 더는 쓸 수 없습니다.
- 대행사·직원이 바뀌면 키를 새로 발급해 접근을 정리하는 것이 좋습니다.
마피아넷 네이버 자동입찰에 연결하기
자동입찰 화면에서 네이버 광고 연동을 누르고 세 값을 붙여 넣으면, 키가 맞는지 네이버에 바로 확인한 뒤 저장합니다. 키는 서버에서 AES-256 방식으로 암호화해 저장하고, 저장한 뒤에는 화면에 다시 보여 주지 않습니다. 네이버 광고 계정의 아이디·비밀번호는 받지 않으며, 연동을 해지하면 저장된 키도 지워집니다.
연결을 마쳤다면 자동입찰 등록 조건을 확인한 뒤 키워드를 불러오세요.