FAQ

Table of Contents

• FAQ
  • Q. 하나의 엑세스 라이선스/비밀키로 여러 개의 애플리케이션을 구축할 수 있나요?
  • Q. 광고주에게 엑세스 라이선스와 비밀키를 전달받아 API를 사용해도 되나요?
  • Q. API 호출 회수와 속도 제한이 있나요?
  • Q. 시간 타게팅은 어떻게 사용하나요?
  • Q. 매체 타게팅에 대해서 알고 싶습니다.
  • Q. 지역 코드
  • Q. Invalid Timestamp 에러가 발생합니다. 어떻게 해야 할까요?
  • Q. 타겟팅별 등록 가능한 대상과 캠페인은 어떻게 되나요?
  • Q. 키워드 확장 Beta는 어떻게 사용하나요?
  • Q. 캠페인 유형별 등록가능한 그룹 유형은 어떻게 되나요?
  • Q. 각 항목의 상태와 상태이유 계산 방식은 어떻게 되나요?.
  • Q. 광고 관리의 문자열 코드와 Master Report의 숫자 코드는 어떻게 매핑이 되나요?
  • Q. 확장소재 유형은 어떻게 되나요?
  • Q. 쇼핑 검색의 노출제외 키워드와 검색어 없는 경우 노출 제외 기능은 어떻게 등록하나요?
  • Q. 검색어 없는경우 광고 노출 제외 기능 사용(PUT)
  • Q. 노출 제한 키워드 추가 Request 예제 - 광고그룹(PUT)
  • Q. 노출 제한 키워드 추가 Request 예제 - 광고소재(PUT)
  • Q. 노출 제한 키워드 제거 Request 예제(PUT)
  • Q. 공유예산은 몇개까지 생성할 수 있나요?
  • Q. 광고 소재 유형별 응답 JSON의 ad, adAttr 프로퍼티는 어떻게 되나요?

---

FAQ

Q. 하나의 엑세스 라이선스/비밀키로 여러 개의 애플리케이션을 구축할 수 있나요?

여러 광고주에게 권한을 위임받은 계정의 엑세스 라이선스와 비밀키로 검색광고 API를 통해 해당 광고주들의 광고를 관리하실 수 있습니다. 이때 특정 광고주에게 제공한 애플리케이션에서는 다른 광고주의 정보가 노출되어서는 안됩니다.

Q. 광고주에게 엑세스 라이선스와 비밀키를 전달받아 API를 사용해도 되나요?

네이버 검색광고 API 이용약관에서 액세스 라이선스와 비밀키는 제3자에게 전달하는 것을 금지하고 있습니다. 따라서 권한 위임을 받은 계정을 통해 API 를 사용해야 합니다.

https://saedu.naver.com/adguide/policy/api.nhn#step5

제 5 조 (사용자 액세스 라이선스 및 비밀키 관리 의무) +
① "액세스 라이선스"와 "비밀키"에 대한 관리책임은 "사용자"에게 있습니다. +
② "액세스 라이선스"와 "비밀키"는 제 3자에게 전달 하여서는 안 되며 제 3자의 이용에 따른 모든 불이익과 분쟁에 대하여 "회사"는 책임을 지지 않습니다.

Q. API 호출 회수와 속도 제한이 있나요?

네이버 검색광고 API는 호출량에 대한 제한은 없습니다. 하지만
광고주별 호출 속도 제한은 있습니다.
단 특정숫자가 정해진것은 아니고 초 단위 이하에서 측정합니다.
횟수는 Customer id 기준이며 연관키워드의 api의 경우 ip도 포함됩니다.
속도는 저희 시스템이 현재 시스템 사용량을 판단하여 실시간으로 설정하고 있어 정확한 수를 특정하기는 어렵습니다.
호출 속도 초과 시 HTTP 429 Too Many Requests 응답을 받을 수 있으며, 이 경우 잠시 후 다시 시도하시면 됩니다.

Q. 시간 타게팅은 어떻게 사용하나요?

요일별로 매시간에 대한 타게팅 여부를 1 bit의 값으로 0(타게팅 하지 않음) 또는 1(타게팅)로 표현하도록 하고 있습니다.
0~1시간은 0 번째 bit 값을 사용하며, 1~2시간은 1번째 bit 값, …​. 22~23시간은 22번째 bit 값, 23~24시간은 23번째 bit 값을 사용합니다. (0 ~ 23의 번째의 bit를 가짐)
시간 타게팅 값의 범위는 0 (타게팅 없음) ~ 16777215(모든 시간대)입니다.
요일별로 타게팅 하고 싶은 시간대의 bit 위치를 모두 1로 설정한 다음 해당 integer 값을 타게팅 숫자 값으로 넣어주시면 됩니다.

java 코드를 참고하시기 바랍니다.

예) 00, 01시 타게팅시 3

23 22 21 20 19 18 17 16 16 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00
------------------------------------------------------------------------
 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 1| 1|
------------------------------------------------------------------------
(2^1 * 1)  + (2^0 * 1) = 3
     2     +      1    = 3
  01~02시      00~01시


예) 22, 23시  타게팅시 12582912
------------------------------------------------------------------------
 1| 1| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0| 0|
------------------------------------------------------------------------
(2^23 * 1) + (2^22 * 1) = 12582912
  8388608  +  4194304   = 12582912
  23~24시      22~23시

java로 조금 더 쉽게 설명드리면, Math.pow 메서드를 이용하셔서 타게팅 할 시간대의 값을 구하신 후, 
합산하여 요일별 시간대 타게팅 값으로 사용하면 됩니다.

0~1시 타게팅시 : Math.pow(2,0) = 1
1~2시 타게팅시 : Math.pow(2,1) = 2
2~3시 타게팅시 : Math.pow(2,2) = 4
3~4시 타게팅시 : Math.pow(2,3) = 8
4~5시 타게팅시 : Math.pow(2,4) = 16
5~6시 타게팅시 : Math.pow(2,5) = 32
6~7시 타게팅시 : Math.pow(2,6) = 64
7~8시 타게팅시 : Math.pow(2,7) = 128
8~9시 타게팅시 : Math.pow(2,8) = 256
9~10시 타게팅시 : Math.pow(2,9) = 512
10~11시 타게팅시 : Math.pow(2,10) = 1024
11~12시 타게팅시 : Math.pow(2,11) = 2048
12~13시 타게팅시 : Math.pow(2,12) = 4096
13~14시 타게팅시 : Math.pow(2,13) = 8192
14~15시 타게팅시 : Math.pow(2,14) = 16384
15~16시 타게팅시 : Math.pow(2,15) = 32768
16~17시 타게팅시 : Math.pow(2,16) = 65536
17~18시 타게팅시 : Math.pow(2,17) = 131072
18~19시 타게팅시 : Math.pow(2,18) = 262144
19~20시 타게팅시 : Math.pow(2,19) = 524288
20~21시 타게팅시 : Math.pow(2,20) = 1048576
21~22시 타게팅시 : Math.pow(2,21) = 2097152
22~23시 타게팅시 : Math.pow(2,22) = 4194304
23~24시 타게팅시 : Math.pow(2,23) = 8388608

일요일 (03, 04, 05 타게팅) => SUN : 8 + 16 + 32 = 56
월요일 (07, 08, 20 타게팅) => MON : 128 + 256 + 1048576 = 1048960
화요일 (15, 16, 20 타게팅) => TUE : 32768 + 65536 + 1048576 = 1146880

Q. 매체 타게팅에 대해서 알고 싶습니다.

매체 타게팅과 관련해서는 노출 매체 유형 중에 상위 매체로는 검색 매체와 콘텐츠 매체가 존재하며, 각 상위 매체별 하위 매체로는 네이버 매체와 파트너 매체로 구분됩니다. 타게팅 설정을 통해 원하는 매체를 선택하면, 해당 매체에만 광고가 노출됩니다.

Target JSON Sample (모든 매체)

{
	"type": 1,
	"search": [],
	"contents": [],
	"white": {
		"media": null,
		"mediaGroup": null
	},
	"black": {
		"media": null,
		"mediaGroup": null
	}
}

Target JSON Sample (네트워크 선택)

{
	"type": 2,
	"search": ["naver", "partner"],
	"contents": ["naver", "partner"],
	"black": {
		"media": [],
		"mediaGroup": []
	},
	"white": {
		"media": null,
		"mediaGroup": null
	}
}

Target JSON Sample (특정 매체 지정)

{
	"type": 3,
	"white": {
		"media": [12836, 12835, 11676],
		"mediaGroup": []
	},
	"search": [],
	"contents": [],
	"black": {
		"media": null,
		"mediaGroup": null
	}
}

매체 타게팅과 관련해서는 아래의 링크를 참고하시면 도움이 될 것 같습니다.

https://saedu.naver.com/help/faq/ncc/view.nhn?faqSeq=180

Q. 지역 코드

REGN_NO	REGN_NM
9	서울특별시
5	광주광역시
6	대구광역시
7	대전광역시
8	부산광역시
10	울산광역시
11	인천광역시
17	세종특별자치시
1	강원도
2	경기도
3	경상남도
4	경상북도
12	전라남도
13	전라북도
15	충청남도
16	충청북도
14	제주특별자치도
99	국내 - 상세 위치 확인불가
0	대한민국외
-1	알수없음

Q. Invalid Timestamp 에러가 발생합니다. 어떻게 해야 할까요?

HTTP Response Status : 403 Forbidden

Response Body

{
  "type": "urn:naver:api:problem:invalid-timestamp",
  "title": "Invalid Timestamp",
  "detail": "Request has expired."
}

해당 오류는 요청 메시지에 포함된 X-Timestamp 값이 기준 시간 이상 차이날 경우에 발생합니다.

주로 timestamp 값을 생성하고 실제 호출하기까지 오래걸리거나,
클라이언트의 시간이 표준 시간 서버와 동기화가 제대로 안되어있을 경우에 발생합니다.

우선 아래 문서에 있는 시간 서버 또는 공개된 다른 시간 서버와 NTP 시간 동기화를 하시기 바랍니다.
http://time.ewha.or.kr/domestic.html

이후에도 동일한 오류가 발생할 경우에는 X-Timestamp 를 최대한 호출 직전에 생성하도록 하거나 네트워크 지연이 있는지 확인해볼 필요가 있습니다.

Q. 타겟팅별 등록 가능한 대상과 캠페인은 어떻게 되나요?

광고주가 설정할 수 있는 타겟팅은 아래의 9가지가 있습니다.

• 요일 시간 타겟팅 (TIME_WEEKLY_TARGET)

• 지역 타겟팅 (REGIONAL_TARGET)

• 매체 타겟팅 (MEDIA_TARGET)

• PC/Mobile 타겟팅 (PC_MOBILE_TARGET)

• 노출 제한 키워드 타겟팅 (RESTRICT_KEYWORD_TARGET)

• 검색어 없는 경우 광고 노출 제외 타겟팅 (NON_SEARCH_KEYWORD_TARGET)

• 성별 타겟팅 (GENDER_TARGET)

• 기간 타겟팅 (PERIOD_TARGET)

• 광고 태그 타겟팅 (AD_TAG)

타겟팅은 기본 적으로 그룹에 적용되지만 몇몇 타겟팅은 캠페인 유형별 특정 그룹, 소재에 적용됩니다.

광고 그룹에 등록 가능한 타겟팅

타겟팅	대상 캠페인
요일 시간 타겟팅 (TIME_WEEKLY_TARGET)	파워링크, 플레이스, 파워 컨텐츠, 쇼핑 캠페인
지역 타겟팅 (REGIONAL_TARGET)	파워링크, 플레이스, 파워 컨텐츠
매체 타겟팅 (MEDIA_TARGET)	파워링크, 파워 컨텐츠, 쇼핑 캠페인
PC/Mobile 타겟팅 (PC_MOBILE_TARGET)	파워링크, 파워 컨텐츠, 쇼핑 캠페인
노출 제한 키워드 타겟팅 (RESTRICT_KEYWORD_TARGET)	쇼핑 캠페인 (제외 키워드)
검색어 없는 경우 광고 노출 제외 타겟팅 (NON_SEARCH_KEYWORD_TARGET)	쇼핑 캠페인 (제외 키워드)
성별 타겟팅 (GENDER_TARGET)	플레이스

광고 소재에 등록 가능한 타겟팅

타겟팅	대상 캠페인	등록 가능 대상
노출 제한 키워드 타겟팅 (RESTRICT_KEYWORD_TARGET)	쇼핑 캠페인	소재 (제외 키워드)
검색어 없는 경우 광고 노출 제외 타겟팅 (NON_SEARCH_KEYWORD_TARGET)	쇼핑 캠페인	소재 (제외 키워드)
광고 태그 타겟팅 (AD_TAG)	쇼핑 캠페인	소재 (태그)
요일 시간 타겟팅 (TIME_WEEKLY_TARGET)	브랜드 검색	소재
기간 타겟팅 (PERIOD_TARGET)	브랜드 검색	소재

위에 설정 가능한 타겟팅 조건 외에 다른 타겟팅을 등록 요청할 경우 등록이 되지 않습니다.

Q. 키워드 확장 Beta는 어떻게 사용하나요?

키워드 확장 Beta 는 광고그룹의 설정을 수정하여 사용과 미사용을 적용할 수 있습니다. 광고 그룹에서 키워드 확장 Beta 와 관련된 프로퍼티는 다음과 같습니다.

프로퍼티 이름	값	설명
useKeywordPlus	true 또는 false	키워드 확장 Beta 사용여부를 나타냅니다.
keywordPlusWeight	1 ~ 999999	키워드 확장 Beta의 입찰가 가중치(%) 값을 나타냅니다.

키워드 확장 Beta 기능의 수정 (사용, 미사용, 입찰가 가중치 변경)은 Adgroup update (by fields) API를 이용합니다.

키워드 확장 Beta 사용함 설정 Json 예제

{
  useKeywordPlus: true,
  keywordPlusWeight: 150
}

키워드 확장 Beta 사용안함 설정 Json 예제

{
  useKeywordPlus: false,
  keywordPlusWeight: 100
}

키워드 확장 Beta 의 기능을 사용하면서 특정 키워드의 노출을 제한하고 싶을 경우 노출 제한 키워드를 등록하셔야 합니다. 노출 제한 키워드의 등록은 create (keyword plus restricted keywords), 등록된 노출 제한 키워드 삭제는 delete (keyword plus restricted keywords) API를 이용합니다.

노출 제한 키워드 등록 Json 예제

POST /ncc/adgroups/grp-a001-01-XXXXXXXXX/restricted-keywords

[
  {
    "nccAdgroupId":"grp-a001-01-XXXXXXXXX",
    "keyword":"이어폰",
    "description":"노출 제한 키워드 추가",
    "type":"KEYWORD_PLUS_RESTRICT"
  },
  {
    "nccAdgroupId":"grp-a001-01-XXXXXXXXX",
    "keyword":"냉장고",
    "description":"노출 제한 키워드 추가",
    "type":"KEYWORD_PLUS_RESTRICT"
  }
]

노출 제한 키워드 삭제 Request 예제

DELETE /ncc/adgroups/grp-a001-01-ZZZZZZZZ/restricted-keywords?ids=rst-a001-00-XXXXXX,rst-a001-00-YYYY

Q. 캠페인 유형별 등록가능한 그룹 유형은 어떻게 되나요?

캠페인 유형별 등록 가능한 그룹의 유형은 아래와 같습니다.

캠페인 유형 코드 (Master Report Code)	그룹 유형 코드 (Master Report Code)	등록가능 사업 채널 코드 (Master Report Code)	설명
WEB_SITE(1)	WEB_SITE(1)	SITE(1)	파워링크 캠페인은 WEB_SITE 그룹 유형, 그리고 WEB_SITE 그룹 유형은 SITE 채널만 등록 가능합니다.
SHOPPING(2)	SHOPPING(2)	MALL(6)	쇼핑 캠페인에 SHOPPING 그룹 유형은 등록 가능합니다. 또한 해당 그룹 유형은 MALL 채널만 등록 가능합니다.
SHOPPING(2)	CATALOG(7)	CATALOG(9)	쇼핑 캠페인에 CATALOG 그룹 유형은 등록 가능합니다. 또한 해당 그룹 유형은 CATALOG 채널만 등록 가능합니다.
SHOPPING(2)	SHOPPING_BRAND(9)	BRAND_STORE(11)	쇼핑 캠페인에 SHOPPING_BRAND 그룹 유형은 등록 가능합니다. 또한 해당 그룹 유형은 BRAND_STORE 채널만 등록 가능합니다.
BRAND_SEARCH(4)	BRAND_SEARCH(5)	SITE(1)	브랜드 검색 캠페인은 BRAND_SEARCH 그룹 유형, 그리고 BRAND_SEARCH 그룹 유형은 SITE 채널만 등록 가능합니다.
BRAND_SEARCH(4)	BRAND_ZONE(8)	SITE(1)	브랜드 검색 캠페인은 BRAND_ZONE 그룹 유형, 그리고 BRAND_ZONE 그룹 유형은 SITE 채널만 등록 가능합니다.
PLACE(6)	PLACE(6)	PLACE(8)	플레이스 캠페인은 PLACE 그룹 유형, 그리고 PLACE 그룹 유형은 PLACE 채널만 등록 가능합니다.
PLACE(6)	LOCAL_AD(10)	PLACE(8)	플레이스 캠페인은 LOCAL_AD 그룹 유형, 그리고 PLACE 채널만 등록 가능합니다.
POWER_CONTENTS(3)	INFORMATION(3)	CONTENTS(7)	파워컨텐츠 캠페인은 INFORMATION 그룹 유형은 등록 가능합니다. 또한 INFORMATION 그룹 유형은 CONTENTS 채널만 등록 가능합니다.

Q. 각 항목의 상태와 상태이유 계산 방식은 어떻게 되나요?.

네이버 검색광고 API에서 제공해 드리는 각 항목의 status, statusReason 은 다음과 같이 계산이 됩니다. 경우에 따라 상위 항목의 상태값을 같이 확인해야 할 필요가 있습니다.

항목	상태/이유 계산 방식
캠페인	광고주의 비즈머니 상태와 캠페인 ON/OFF, 일일 허용 예산, 노출 기간 설정이 계산된 값
광고 그룹	광고주의 비즈머니 상태, 캠페인의 상태, PC 사업 채널/ Mobile 사업 채널 상태, 그룹의 ON/OFF, PC/Mobile 타겟, 그룹의 일일 허용 예산 상태가 계산된 값.
확장 소재	PC/Mobile 사업 채널 상태, 확장 소재의 노출 기간 설정, 확장 소재의 검수 상태가 계산된 값
소재	소재의 검수상태, ON/OFF가 계산된 값
키워드	키워드의 검수상태, ON/OFF가 계산된 값
사업 채널	사업 체널의 PC/Mobile 검수 상태, 외부 연동시 연동된 상태값이 계산된 값

상태이유 코드	설명
ELIGIBLE	노출 가능
CAMPAIGN_DELETED	캠페인이 삭제됨
CAMPAIGN_PAUSED	캠페인 사용자 중지
CAMPAIGN_PENDING	캠페인 기간 설정. 오늘 날짜 < 설정 시작일
CAMPAIGN_ENDED	캠페인 기간 설정. 오늘 날짜 > 설정 종료일
CAMPAIGN_LIMITED_BY_BUDGET	캠페인 예산 도달
BUSINESS_CHANNEL_PAUSED	사업 채널 중지
BUSINESS_CHANNEL_DISAPPROVED	사업채널 '보류', '반려'
BUSINESS_CHANNEL_UNDER_REVIEW	사업채널 검수 상태 '등록'
BUSINESS_CHANNEL_ABNORMAL_INTERLOCK	사업채널 외부 연동 비정상
PC_BUSINESS_CHANNEL_APPROVED	PC 사업채널 통과, 일부 노출
PC_BUSINESS_CHANNEL_DISAPPROVED	사업채널 PC 보류, 반려
PC_BUSINESS_CHANNEL_ABNORMAL_INTERLOCK	PC 사업채널 외부 연동 비정상
PC_BUSINESS_CHANNEL_UNDER_REVIEW	사업채널 등록 상태
MOBILE_BUSINESS_CHANNEL_APPROVED	모바일 사업채널 통과, 일부
MOBILE_BUSINESS_CHANNEL_DISAPPROVED	사업채널 보류, 반려
MOBILE_BUSINESS_CHANNEL_ABNORMAL_INTERLOCK "	모바일 사업채널 외부 연동 비정상
MOBILE_BUSINESS_CHANNEL_UNDER_REVIEW	사업채널 등록 상태
GROUP_DELETED	삭제된 광고 그룹
GROUP_PAUSED	광고그룹 사용자 중지
GROUP_LIMITED_BY_BUDGET	그룹 예산 도달
GROUP_PAUSED_BY_INVALID_TARGET	그룹 타겟팅 오류
KEYWORD_DELETED	삭제된 키워드
KEYWORD_PAUSED	키워드 사용자 중지
KEYWORD_DISAPPROVED	키워드 보류
KEYWORD_DENIED	키워드 반려
KEYWORD_UNDER_REVIEW	키워드 등록 상태
AD_DELETED	삭제된 소재
AD_PAUSED	소재 사용자 중지
AD_ABNORMAL_INTERLOCK	소재 연동 상태 비정상
AD_DISAPPROVED	소재 보류, 반려
AD_UNDER_REVIEW	소재 등록 상태
AD_EXTENSION_DELETED	삭제된 확장소재
AD_EXTENSION_PAUSED	확장소재 사용자 중지
AD_EXTENSION_NOT_SCHEDULED	확장소재 요일, 시간으로 인한 일시중지
AD_EXTENSION_DISAPPROVED	확장 소재 보류, 반려
AD_EXTENSION_UNDER_REVIEW	확장소재 등록 상태
AD_EXTENSION_PENDING	확장소재 기간 설정 (기간 외)
AD_EXTENSION_ABNORMAL_INTERLOCK	확장 소재 연동 상태 비정상
LACK_OF_ACCOUNT_BALANCE	계정 예산 부족
REFUND_IN_PROGRESS	환불 진행중

Q. 광고 관리의 문자열 코드와 Master Report의 숫자 코드는 어떻게 매핑이 되나요?

문자열 코드와 숫자형 코드는 아래와 같이 연결이 됩니다.

• 캠페인 유형

문자열 코드	숫자 코드	설명
WEB_SITE	1	파워링크 캠페인
SHOPPING	2	쇼핑검색 캠페인
POWER_CONTENTS	3	파워컨텐츠 캠페인
BRAND_SEARCH	4	브랜드검색 캠페인
PLACE	6	플레이스 캠페인

• 광고그룹 유형

문자열 코드	숫자 코드	설명
WEB_SITE	1	파워링크 그룹
SHOPPING	2	쇼핑몰 상품형 그룹
INFORMATION	3	파워컨텐츠 그룹
BRAND_SEARCH	5	브랜드 검색 일반 그룹
PLACE	6	지역 소상공인 그룹
CATALOG	7	제품 카탈로그 그룹
BRAND_ZONE	8	브랜드 검색 브랜드존 그룹
SHOPPING_BRAND	9	쇼핑 브랜드 그룹
LOCAL_AD	10	플레이스 검색 그룹
BRAND_NEW	11	신제품 검색 그룹

• 비즈채널 유형

문자열 코드	숫자 코드	설명
SITE	1	웹사이트
PHONE	2	전화번호
ADDRESS	3	위치정보
BOOKING	4	네이버 예약
TALK	5	네이버 톡톡
MALL	6	쇼핑몰
CONTENTS	7	콘텐츠
PLACE	8	플레이스
CATALOG	9	쇼핑 제조사
NAVER_TV	10	네이버 TV
BRAND_STORE	11	쇼핑 브랜드 스토어(브랜드검색)
SHOPPING_BRAND	12	네이버쇼핑 브랜드(쇼핑검색광고)

• 광고소재 유형

문자열 코드	숫자 코드	캠페인	설명
TEXT_45	1	파워링크	단일형 소재
SHOPPING_PRODUCT_AD	2	쇼핑 검색	상품형 소재
CONTENTS_AD_INFORMATION	3	파워컨텐츠	파워컨텐츠 소재
BRAND_SEARCH_AD	5	브랜드 검색	일반형 소재, 브랜드존 소재
PLACE_AD	6	플레이스	지역소상공인 소재
CATALOG_AD	7	쇼핑 검색	카탈로그형 소재
LOCAL_AD	10	플레이스	플레이스 검색 소재
SHOPPING_BRAND_IMAGE_THUMBNAIL_AD	11	쇼핑 검색	쇼핑 브랜드형 이미지 섬네일형 소재
SHOPPING_BRAND_IMAGE_BANNER_AD	12	쇼핑 검색	쇼핑 브랜드형 이미지 배너형 소재
BRAND_SEARCH_NEW_AD	13	브랜드 검색	신제품 검색형 소재
RSA_AD	14	파워링크	반응형 소재

Q. 확장소재 유형은 어떻게 되나요?

확장소재 코드와 숫자형 코드는 아래와 같이 연결이 되며, 캠페인별로 사용가능한 확장소재 유형도 명시하였습니다.

• 확장소재 유형

확장소재 유형	숫자형 코드	확장소재명	사용가능한 캠페인 유형
PHONE	1	전화번호	WEB_SITE
LOCATION	2	위치정보	WEB_SITE
BOOKING	3	네이버 예약	WEB_SITE
TALK	4	네이버 톡톡	WEB_SITE, SHOPPING
CALCULATION	5	계산	WEB_SITE
HEADLINE	6	추가제목	WEB_SITE
DESCRIPTION	7	홍보문구	WEB_SITE
SUB_LINKS	8	서브링크	WEB_SITE
PRICE_LINKS	9	가격링크	WEB_SITE
PROMOTION	10	추가홍보문구	SHOPPING
SHOPPING_EXTRA	11	쇼핑 상품 부가정보	SHOPPING
POWER_LINK_IMAGE	12	파워링크 이미지	WEB_SITE
IMAGE_SUB_LINKS	13	이미지형 서브링크	WEB_SITE
PLACE	14	플레이스 정보	WEB_SITE
CATALOG_RELEASE_DATE	15	카탈로그 신제품	SHOPPING
CATALOG_EXTRA	16	카탈로그 부가정보	SHOPPING
CATALOG_DETAIL	17	카탈로그 상세정보	SHOPPING
CATALOG_IMAGE	18	카톨로그 제품이미지	SHOPPING
CATALOG_PROMOTION	19	카탈로그 홍보문구	SHOPPING
CATALOG_EVENT	20	카탈로그 이벤트	SHOPPING
CATALOG_MOVIE	21	카탈로그 제품영상	SHOPPING
CATALOG_PURCHASE_CONDITION	22	카탈로그 구매조건	SHOPPING
CATALOG_BRAND_MESSAGE	23	카탈로그 브랜드메시지	SHOPPING
NAVER_TV_VIDEO	24	홍보 영상	WEB_SITE
NAVER_BLOG_REVIEW	25	블로그 리뷰	WEB_SITE
SHOPPING_BRAND_IMAGE	26	쇼핑 브랜드 이미지	SHOPPING
SHOPPING_BRAND_VIDEO	27	쇼핑 브랜드 동영상	SHOPPING
SHOPPING_BRAND_BROADCAST	28	쇼핑 브랜드 라이브	SHOPPING
SHOPPING_BRAND_EVENT	29	쇼핑 브랜드 이벤트	SHOPPING
PLACE_SMART_ORDER	30	플레이스 네이버 주문	PLACE
PLACE_BEAUTY_STYLE	31	플레이스 뷰티스타일	PLACE
DESCRIPTION_EXTRA	32	추가설명	WEB_SITE
SHOPPING_BRAND_DAY	33	쇼핑 브랜드 데이	SHOPPING
SHOPPING_WEB	34	쇼핑 정보	WEB_SITE
WEBSITE_INFO	35	웹사이트정보	WEB_SITE

Q. 쇼핑 검색의 노출제외 키워드와 검색어 없는 경우 노출 제외 기능은 어떻게 등록하나요?

• 쇼핑검색의 노출 제외 키워드는 아래링크의 Target API를 이용 합니다.

• http://naver.github.io/searchad-apidoc/#/tags/Target

• targetTp값으로 RESTRICT_KEYWORD_TARGET, NON_SEARCH_KEYWORD_TARGET 값을 입력합니다.

Q. 검색어 없는경우 광고 노출 제외 기능 사용(PUT)

{
	"nccTargetId": "tgt-a001-02-XXXXXX",
	"ownerId": "grp-a001-02-XXXXXXX",
	"targetTp": "NON_SEARCH_KEYWORD_TARGET",
	"target": {"excluded": true},
	"delFlag": false,
	"regTm": "2022-01-13T02:03:03.000Z",
	"editTm": "2022-01-13T02:03:03.000Z"
}

Q. 노출 제한 키워드 추가 Request 예제 - 광고그룹(PUT)

• ownerId에 광고그룹의 ID를 입력 합니다.

• 광고그룹은 쇼핑 캠페인에 속한 광고그룹에 유효합니다.

• type 값은 1(exact),2(phrase)을 나타냅니다.

  {
  	"ownerId": "grp-a001-02-XXXXXX",
  	"targetTp": "RESTRICT_KEYWORD_TARGET",
  	"nccTargetId": "tgt-a001-02-XXXXX",
  	"target": [{"keyword": "대출", "type": 1}, {"keyword": "꽃배달", "type": 1}],
  	"delFlag": false,
  	"regTm": "2023-01-13T02:03:03.000Z",
  	"editTm": "2023-01-13T02:03:03.000Z"
  }

Q. 노출 제한 키워드 추가 Request 예제 - 광고소재(PUT)

• ownerId에 소재의 ID를 입력 합니다.

• 소재는 쇼핑 캠페인에 속한 광고그룹의 소재입니다.

  {
  	"ownerId": "nad-a001-02-XXXXX",
  	"targetTp": "RESTRICT_KEYWORD_TARGET",
  	"nccTargetId": "tgt-a001-02-XXXXX",
  	"target": [{"keyword": "대출", "type": 2}, {"keyword": "꽃배달", "type":2}],
  	"delFlag": false,
  	"regTm": "2023-01-13T02:03:03.000Z",
  	"editTm": "2023-01-13T02:03:03.000Z"
  }

Q. 노출 제한 키워드 제거 Request 예제(PUT)

• 위의 추가 요청에서 제거하고자 하는 키워드를 빼고 요청하시면 됩니다. (이 요청에서 키워드가 빠지면 서버에서 이미 등록된 키워드가 있을 경우 제거 합니다.)

  {
  	"nccTargetId": "tgt-a001-02-XXXX",
  	"ownerId": "grp-a001-02-XXXX",
  	"targetTp": "RESTRICT_KEYWORD_TARGET",
  	"target": [{
  		"keyword": "꽃배달",
  		"date": 1682300721
  	}],
  	"delFlag": false,
  	"regTm": "2023-01-13T02:03:03.000Z",
  	"editTm": "2023-04-24T01:45:21.000Z"
  }

Q. 공유예산은 몇개까지 생성할 수 있나요?

• 광고주별 캠페인용 공유예산은 최대 20개까지 생성가능합니다.

• 광고주별 광고그룹용 공유예산은 최대 20개까지 생성가능합니다.

• 캠페인용 공유예산에 포함되는 캠페인의 개수는 최대 200개까지 입니다.

• 광고그룹용 공유예산에 포함되는 광고그룹의 개수는 최대 200개까지 입니다.

Q. 광고 소재 유형별 응답 JSON의 ad, adAttr 프로퍼티는 어떻게 되나요?

• 공통 부분

  {
      "nccAdId": "소재의 고유 번호(문자열)",
      "nccAdgroupId": "광고그룹의 고유 번호(문자열)",
      "customerId": 광고 계정 번호(숫자),
      "inspectStatus": "검수 상태 코드",
      "type": "광고소재 유형",
      "ad": {/* 광고소재 정보 */},
      "adAttr": {/* 광고소재 속성 */},
      "userLock": false, /* 광고주의 노출 중지 설정 여부 */
      "enable": true, /* 검색광고 외부 연동시 상태값 */
      "status": "소재의 계산된 상태 코드",
      "statusReason": "소재의 계산된 상태 이유 코드",
      "referenceKey": "검색광고 외부 연동시 키값(ex. 쇼핑의 경우 nvmid, 네이버 플레이스 고유번호 등)"
  }

• TEXT_45 파워링크 단일형 소재 ad 프로퍼티 JSON 예제

  {
    "description": "노출 광고소재의 설명 부분",
    "headline": "노출 광고소재의 제목 부분",
    "mobile": {
        "display": "http://www.naver.com(PC 표시 URL)",
        "final": "http://www.naver.com(PC 랜딩 페이지 URL)"
    },
    "pc": {
        "display": "http://www.naver.com(모바일 표시 URL)",
        "final": "http://www.naver.com(모바일 랜딩 페이지 URL)"
    }
  }

• TEXT_45 파워링크 단일형 소재 adAttr 프로퍼티 JSON 예제

  {}

• SHOPPING_PRODUCT_AD 쇼핑 검색 상품형 소재 ad 프로퍼티 JSON 예제

{
    "imagePath": "추가 이미지 패스",
    "productName": "상품 이름",
    "imageHeight": 이미지 높이(숫자),
    "imageWidth": 이미지 너비(숫자),
    "imageColorCode": "색상코드(숫자)"
}

- SHOPPING_PRODUCT_AD 쇼핑 검색 상품형 소재 adAttr 프로퍼티 JSON 예제

{
    "bidAmt": 입찰가(숫자, 그룹 입찰가 사용시 무시됨),
    "useGroupBidAmt": 그룹 입찰가 사용 여부(boolean)
}

• CONTENTS_AD_INFORMATION 파워컨텐츠 소재 ad 프로퍼티 JSON 예제

  {
      "companyName": "업체명",
      "contentImages": ["컨텐츠 이미지 목록"],
      "contentIssueDate": "컨텐츠 발행일",
      "description": "광고소재 설명",
      "headline": "광고소재 제목",
      "imageHeight": 노출용 이미지 높이(숫자),
      "imagePath": "노출용 이미지",
      "imageWidth": 노출용 이미지 너비(숫자),
      "mobile": {
          "display": "http://www.naver.com(PC 표시 URL)",
          "final": "http://www.naver.com(PC 랜딩 페이지 URL)"
      },
      "pc": {
          "display": "http://www.naver.com(PC 표시 URL)",
          "final": "http://www.naver.com(PC 랜딩 페이지 URL)"
      },
      "representImage": 대표이미지 인덱스(숫자),
      "useContentImage": "컨텐츠 이미지 사용여부(Y/N)",
      "profileImgUrlOrg": "프로필 이미지",
      "useProfileImage": "프로필 이미지 사용여부(Y/N)",
      "medicalNo": "의료 심의 번호",
      "assets": 반응형 소재에만 존재
  }

• CONTENTS_AD_INFORMATION 파워컨텐츠 소재 adAttr 프로퍼티 JSON 예제

  {}

• BRAND_SEARCH_AD 브랜드 검색 | 일반형 소재, 브랜드존 소재 ad 프로퍼티 JSON 예제

  {
      "dittoId": "광고소재 저장소 고유 번호",
      "thumbnail": "광고소재 썸네일"
  }

• BRAND_SEARCH_AD 파워컨텐츠 소재 adAttr 프로퍼티 JSON 예제

  {}

• PLACE_AD 지역소상공인 소재 ad 프로퍼티 JSON 예제

  {}

• PLACE_AD 지역소상공인 소재 adAttr 프로퍼티 JSON 예제

  {}

• CATALOG_AD 쇼핑 검색 카탈로그형 소재 ad 프로퍼티 JSON 예제

  {
      "imagePath": "이미지 패스",
      "catalogType": "MAKER",
      "imageHeight": "이미지 높이",
      "imageWidth": "이미지 너비",
      "imageColorCode": "컬러 코드"
  }

• CATALOG_AD 쇼핑 검색 카탈로그형 소재 adAttr 프로퍼티 JSON 예제

  {
      "bidAmt": 입찰가(숫자, 그룹 입찰가 사용시 무시됨),
      "useGroupBidAmt": 그룹 입찰가 사용 여부(boolean)
  }

• LOCAL_AD 플레이스 검색 소재 ad 프로퍼티 JSON 예제

  {
      "description": "광고소재 설명",
      "images": [이미지 목록],
      "info": {
          "address": "주소",
          "localCategoryName": "업종명",
          "name": "업체 이름",
          "openingHours": [
              "매일 11:30~22:00",
              "매일 14:30~17:30 Break time"
          ],
          "sid": "네이버 플레이스 고유번호"
      },
      "medicalNo": "의료심의 번호"
  }

• LOCAL_AD 플레이스 검색 소재 adAttr 프로퍼티 JSON 예제

  {}

• SHOPPING_BRAND_IMAGE_THUMBNAIL_AD 쇼핑 검색 이미지 섬네일형 소재 ad 프로퍼티 JSON 예제

  {
      "description": "광고소재의 설명 문구",
      "extraDescription": "광고소재의 추가 설명 문구",
      "headline": "광고소재의 제목 문구",
      "image": "이미지 패스",
      "landingUrl": "랜딩 페이지 URL",
      "logoImage": "로고 이미지 패스"
  }

• SHOPPING_BRAND_IMAGE_THUMBNAIL_AD 쇼핑 검색 이미지 섬네일형 소재 adAttr 프로퍼티 JSON 예제

  {}

• SHOPPING_BRAND_IMAGE_BANNER_AD 쇼핑 검색 이미지 배너형 소재 ad 프로퍼티 JSON 예제

  {
      "description": "광고소재의 설명 문구",
      "headline": "광고소재의 제목 문구",
      "image": "이미지 패스",
      "logoImage": "로고 이미지 패스"
  }

• SHOPPING_BRAND_IMAGE_BANNER_AD 쇼핑 검색 이미지 배너형 소재 adAttr 프로퍼티 JSON 예제

  {}

• BRAND_SEARCH_NEW_AD 브랜드 검색 신제품 검색형 소재 ad 프로퍼티 JSON 예제

  {
      "dittoId": "소재 저장소 고유 번호",
      "thumbnail": "소재 썸네일",
      "productReleaseDate": "제품 출시일"
  }

• BRAND_SEARCH_NEW_AD 브랜드 검색 신제품 검색형 소재 ad 프로퍼티 JSON 예제

  {}

• RSA_AD 파워링크 반응형 소재 ad 프로퍼티 JSON 예제

  {
    "description": "노출 광고소재의 설명 부분",
    "headline": "노출 광고소재의 제목 부분",
    "mobile": {
        "display": "http://www.naver.com(PC 표시 URL)",
        "final": "http://www.naver.com(PC 랜딩 페이지 URL)"
    },
    "pc": {
        "display": "http://www.naver.com(모바일 표시 URL)",
        "final": "http://www.naver.com(모바일 랜딩 페이지 URL)"
    }
  }

• RSA_AD 파워링크 반응형 소재 adAttr 프로퍼티 JSON 예제

  {}

• RSA_AD 파워링크 반응형 소재 assets 프로퍼티 JSON 예제

  {
      "nccAssetId": "애셋 고유 번호",
      "customerId": 광고 계정 번호,
      "assetType": "애셋 유형 코드",
      "assetData": {
          "text": "애셋 데이터"
      },
      "inspectStatus": "검수 상태 코드",
      "nccAdId": "광고소재 고유번호",
      "linkType": "링크 유형"
  }