안녕하세요. 네이버 성과형 디스플레이 광고 오픈 API 운영자입니다.
2026년 8월 네이버 성과형 디스플레이 광고 플랫폼 변경 사항 안내드립니다. 자세한 사항은 아래 내용을 참고하시기 바랍니다.
■ 변경 사항
[1] ADV쇼핑(PMAX) 캠페인 생성·관리 API 신규 지원
[2] 애셋 그룹 단위 성과 조회 API 신규 제공
■ 상세 변경 내용
[1] ADV쇼핑(PMAX) 캠페인 생성·관리 API 신규 지원
기존 캠페인 API에서 ADV쇼핑(PMAX) 캠페인의 생성·조회·수정·ON/OFF·삭제를 지원합니다.
- 캠페인 생성
- ADV쇼핑 캠페인의 예산은
performanceMax.budget필드로 입력합니다. 기존spendLimit은 ADV쇼핑 캠페인에서 사용하지 않으며, 입력해도 무시됩니다. - 캠페인 생성 시 애셋 그룹이 기본값(모든 아이템)으로 자동 생성됩니다. 아이템 필터링 등 애셋 그룹 설정 변경은 광고시스템에서 가능합니다.
- 쇼핑상품연동 및 오프사이트 광고 이용동의가 필요한 경우 자동으로 동의 처리됩니다.
- ADV쇼핑 캠페인의 예산은
- 캠페인 생성 조건
- 전환추적 설정이 필수이며, 전환 스크립트가 설치 완료 상태여야 합니다.
- 비즈채널이 승인 상태여야 합니다.
- 예산 변경
- 기존 캠페인 지출 한도 다중 변경 API를 사용합니다. ADV쇼핑 캠페인은
campaignSpendLimit값이 ADV쇼핑 예산(performanceMax.budget)으로 반영되며, 변경 결과는 캠페인 조회 응답의performanceMax.budget으로 확인할 수 있습니다. - 광고 최적화 보호를 위해 ADV쇼핑 캠페인의 예산 변경은 캠페인당 2시간에 1회로 제한됩니다.
- 기존 캠페인 지출 한도 다중 변경 API를 사용합니다. ADV쇼핑 캠페인은
- 애셋 그룹 및 하위 요소의 생성·수정 API는 제공하지 않습니다. 애셋 그룹 단위 성과 조회는 아래 [2]를 참고해 주시기 바랍니다.
세부 요청 및 응답 명세는 캠페인 API 문서를 참고해 주시기 바랍니다.
[2] 애셋 그룹 단위 성과 조회 API 신규 제공
ADV쇼핑(PMAX) 캠페인의 성과를 애셋 그룹 단위로 조회할 수 있도록 기존 GFA 성과 조회 API의 조회 범위를 확장합니다.
성과 조회는 다음 두 조회 계층으로 제공됩니다.
- 소재 계층: 광고 계정 → 캠페인 → 광고 그룹 → 소재
- 애셋 그룹 계층: 광고 계정 → 캠페인 → 애셋 그룹
애셋 그룹 단위 조회는 일반 성과와 전환 성과의 과거 및 실시간 조회를 모두 지원합니다.
- 광고 계정 또는 캠페인 성과 조회
- 과거 성과 조회 시 집계 단위(
aggregationType)에assetGroups를 사용할 수 있습니다. - 실시간 성과 조회 시 애셋 그룹 단위 전용 API를 사용할 수 있습니다.
- 과거 성과 조회 시 집계 단위(
- 개별 애셋 그룹 성과 조회
- 특정 애셋 그룹의 과거 및 실시간 성과를 조회할 수 있습니다.
- 응답 필드
- 애셋 그룹 단위 성과 응답에
assetGroupNo가 제공됩니다.
- 애셋 그룹 단위 성과 응답에
애셋 그룹 단위 일반 성과 조회 시
vplayCount는 항상0으로 제공됩니다.
세부 요청 및 응답 명세는 과거 성과 조회 API, 실시간 성과 조회 API, 전환 성과 조회 안내 문서를 참고해 주시기 바랍니다.
적용 일자
2026년 8월 26일 수요일
변경 사항
- ADV쇼핑(PMAX) 캠페인의 생성·조회·수정·ON/OFF·삭제 지원
- ADV쇼핑 캠페인 예산 필드
performanceMax.budget추가 및 예산 변경 제한(캠페인당 2시간 1회) 적용 - 일반 성과 및 전환 성과의 애셋 그룹 단위 조회 지원
- 과거 성과 조회의
assetGroups집계 단위 추가 - 실시간 성과 및 개별 애셋 그룹 성과 조회 API 추가
- 성과 응답에
assetGroupNo필드 추가 - 애셋 그룹 단위 일반 성과의
vplayCount는 항상0으로 제공
기타 궁금하신 사항은 네이버 성과형 디스플레이 광고 API 문의를 이용해 주시기 바랍니다.
감사합니다.