본문 바로가기
C++ 200제/코딩 IT 정보

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

by vicddory 2018. 6. 26.

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 예제, 사용관리 도구

댓글