Naver search 키워드 검색광고 C# API 예제, 사용관리 도구

Naver search 키워드 검색광고 C# API 예제, 사용관리 도구


1. 네이버 검색광고 회원 가입


API를 사용하려면 검색광고 회원 가입이 필요합니다. 해당 과정은 네이버 광고 페이지에서 제공하니 아래 링크를 참조해 주세요.



위에서 간단히 검색광고 회원 가입을 끝내세요. 그리고 해당 아이디로 로그인하면 아래처럼 첫 화면을 볼 수 있습니다.


Naver search 키워드 검색, 검색광고 API 예제 (C#)[Naver search] C# 예제 및 사용법


우리는 네이버 검색광고 API를 사용해야 하니 상단의 도구 - API 사용 관리를 선택합니다.


검색광고 api c# 네이버[Naver search] C# 예제 및 사용법

이곳에서 소스 코드에 필요한 3가지를 확인할 수 있습니다. CUSTOMER_ID, 엑세스라이선스, 비밀키입니다. 여기까지 확인되었다면, 이제 다음 단계입니다.


네이버 검색광고 api 예제 사용법[Naver search] C# 예제 및 사용법


2. searchad-apidoc


네이버에선 C#, Java, PHP 세 가지로 소스 코드를 제공합니다. 링크는 아래.



저는 C# 예제를 다운로드 받았습니다. 주요 소스 코드는 2개입니다.


- SearchAdApi.cs : Execute 함수로 접속 정보와 검색 결과를 리턴합니다.

- Main : 이건 함수만 있어도 됩니다.


예제에서 분리하여 다른 프로그램에 이식할 때 위의 2가지 사항만 존재하면 된다는 뜻이죠.

SearchAdApi.cs는 건드릴 부분이 전혀 없으니 생략하고 메인 함수에서 필요한 부분만 언급하면 이렇습니다.


1
2
3
4
5
6
7
8
var rest = new SearchAdApi(base_url_, naver_api_key_, naver_secret_key_);
 
var request = new RestRequest("/keywordstool", Method.GET);
request.AddQueryParameter("hintKeywords", keyword_);
request.AddQueryParameter("includeHintKeywords""1");
request.AddQueryParameter("showDetail""1");
 
rest.Execute<List<CustomerLink>>(request, naver_manager_customer_id_);
cs


1. base url : 기본값으로 https://api.naver.com입니다.

2. NAVER API : API 사용관리에서 확인

3. NAVER SECRET : API 사용관리에서 확인

4. CUSTOMER ID : API 사용관리에서 확인


base url은 고정이라 바뀔 것이 없으며, 쿼리 파라미터를 추가하는데 이건 정리된 정보가 없어서 저도 확실하게 알려드리긴 힘드네요. 자, 어쨌든 다음 단계로 넘어갑니다.

3. 예제 작성하고 결과 비교/확인하기


네이버 광고에서 도구 - 키워드 도구로 이동합니다.


네이버 검색광고 searchad-apidoc[Naver search] C# 예제 및 사용법


그리고 키워드로 "주식투자"를 입력하고 조회하기를 누릅니다.


searchad-apiodc 예제 c#[Naver search] C# 예제 및 사용법


결과를 확인하니 월간검색수는 PC 6,030 모바일 14,700으로 나오네요. 그리고 위에 적은 SearchAdApi.cs를 포함하는 프로젝트를 생성한 뒤, 메인 함수에 필요한 소스 코드를 삽입합니다. 그리고 프로그램 결과를 확인해 보죠.


정상적인 Request 메시지


GET /keywordstool?hintKeywords=주식투자&includeHintKeywords=1&showDetail=1

X-API-KEY=xxxxxxxx

X-Customer=1xxxxxxx

X-Timestamp=1530176313218

X-Signature=xxxxxxxx


정상적인 Response 메시지


============ Response ============

200 OK

Connection=close

X-Transaction-ID=xxxxxxxx

Strict-Transport-Security=max-age=Xxxxxx

Cache-Control=no-store, must-revalidate

Content-Type=application/json;charset=UTF-8


SearchAdApi.cs의 Execute 함수를 보면 var response = client.Execute<T>(request); 란 코드가 있습니다. response에 결과가 저장됩니다. 그리고 위의 정상적인 Response 메시지는 response 객체에 담겨있던 결과가 됩니다.


결과 중 일부를 살펴보죠.


{"keywordList":[{"relKeyword":"주식투자","monthlyPcQcCnt":6030,"monthlyMobileQcCnt":14700,"monthlyAvePcClkCnt":28.0,"monthlyAveMobileClkCnt":127.0,"monthlyAvePcCtr":0.5,"monthlyAveMobileCtr":0.93,"plAvgDepth":15,"compIdx":"높음"},


결과는 위와 같은데 알아보기 쉽게 분리해 보면 이렇습니다.


keywordList : 네이버 검색광고 API 결과로 추출한 키워드 리스트

relKeyword : 실제 키워드, 주식투자


monthlyPcQcCnt:6030 : 월간검색수 PC

monthlyMobileQcCnt:14700 : 월간검색수 모바일


monthlyAvePcClkCnt:28.0 : 월평균클릭수 PC

monthlyAveMobileClkCnt:127.0 : 월평균클릭수 모바일


monthlyAvePcCtr:0.5 : 월평균클릭률 PC

monthlyAveMobileCtr:0.93 : 월평균클릭률 모바일


plAvgDepth:15 : 월평균 노출 광고수

compIdx:높음 : 경쟁 정도


이렇게 키워드 결과를 추출해 응용할 수 있습니다.


Naver search 키워드 검색광고 C# API 예제, 사용관리 도구

댓글(6)

  • 김태훈
    2018.06.26 22:25 신고

    좋은 예제 공개해 주셔서 감사합니다.
    한가지 문의 드리고 싶어서 글 남겨요.
    같은 방식으로 테스트를 해보았는데 결과가 아래와 같이 나오네요.
    혹시 무슨 문제인지 알 수 있을까요?
    감사합니다.

    ============ Response ============
    200 OK
    Connection=close
    X-Transaction-ID=B47H14V599ID8
    Strict-Transport-Security=max-age=15768000
    Cache-Control=no-store, must-revalidate
    Content-Type=application/json;charset=UTF-8
    Date=Tue, 26 Jun 2018 13:22:15 GMT

    {"keywordList":[]}

    • 2018.06.26 22:46 신고

      Connection이 close로 리턴되네요? 음.... 클라이언트 아이디나 뭐 기본 입력 사항이 잘못된 것 아닐까요?

  • 김태훈
    2018.06.28 11:40 신고

    답변 감사합니다.
    제가 hintkeywords => K를 소문자로 적었네요. ^^

  • 김훈
    2018.07.24 21:54 신고

    혹시 php로 웹페이지에서 출력되게 어떻게 구현하는지 너무 궁금합니다. pc 모바일 조회수랑 문서량 이렇게 출력을 하려면 어떻게 하는지 너무 궁금합니다.
    프로그램 개발을 처음부터 배워야 할까요?

    • 2018.08.01 09:54 신고

      순서는 포스트에 나와있고요. php 같은 웹쪽으론 제가 몰라요. ㅎㅎㅎ

      프로그래밍 기초가 아예 없다면 공부부터 해보세요.

Designed by JB FACTORY