페이지 이동경로
  • 문서>
  • 카카오모먼트>
  • 이해하기

카카오모먼트

이해하기

이 문서는 카카오모먼트 API를 소개합니다.

기능 소개

카카오모먼트 API

카카오모먼트 API는 카카오모먼트 플랫폼의 광고계정, 캠페인, 광고그룹, 소재와 관련된 설정 정보를 API를 통해 조회하고 이와 관련된 성과 지표를 확인할 수 있는 기능을 제공합니다. 또한, 광고계정, 캠페인, 광고그룹, 소재에 대한 ON/OFF 및 일예산, 입찰금액 등을 변경할 수 있는 기능과 일부 디스플레이 소재의 생성, 수정, 삭제 및 광고그룹, 캠페인 삭제 기능을 제공합니다.

주요 용어

용어 설명
광고계정 광고계정은 광고집행을 관리하는 단위로, 광고주가 직접 생성하거나 광고 운영을 대행하는 대행사가 직접 생성할 수 있습니다. 대행사에서 광고계정을 생성할 경우 광고주 정보를 별도로 기입할 수 있습니다. 광고계정의 사업자 정보는 세금계산서 발행정보의 기준이 됩니다. 카카오모먼트는 카카오계정으로 광고계정을 생성합니다.
캠페인 디스플레이광고의 광고목적 또는 메시지광고의 발송 방식을 선택할 수 있으며, 전략에 따라 다수의 캠페인을 운영할 수 있습니다.
광고그룹 캠페인 하위에 광고그룹을 생성할 수 있으며, 광고그룹별로 타겟, 게재설정, 입찰금액, 기간 등 상세한 전략 설정이 가능합니다.
소재 디스플레이광고는 네이티브/배너/동영상광고의 소재 등록이 가능하며, 소재 단위별로 게재빈도 설정이 가능합니다. 메시지 광고는 소재로 사용할 메시지를 선택할 수 있습니다.
디스플레이 네이티브, 배너, 동영상 등 다양한 크리에이티브를 원하는 사용자에게 노출할 수 있는 광고 유형입니다.
다이렉트 메시지 일시를 지정하여 설정한 타겟에게 한 번에 발송하는 메시지입니다. 타겟 설정 시 맞춤타겟, 데모그래픽, 상세타겟을 활용할 수 있으며 타겟 설정 여부에 따라 단가가 달라집니다. 맞춤타겟과 데모그래픽 타게팅이 가능하며, 타게팅이 적용되지 않은 경우 건당 15원, 타게팅이 적용된 경우 건당 20원입니다.

사용하는 ID 종류

이름 설명
adAccountId 광고계정 번호
campaignId 캠페인 번호
adGroupId 광고그룹 번호
creativeId 소재 번호

이용 정책

사용 권한 신청

카카오모먼트 API는 권한을 보유하고 비즈니스 인증을 도입한 카카오디벨로퍼스 애플리케이션(이하 앱)에서만 사용할 수 있습니다. 아래 순서로 사용 권한을 신청합니다.

  1. 애플리케이션 등록
  2. 비즈 앱 전환
  3. [로그인] > [카카오계정 ID] > [계정 설정] > [본인인증]에서 앱 소유자의 카카오계정 본인인증 완료
  4. [내 애플리케이션] > [앱 권한 신청]에서 사용 권한 신청
비즈니스 인증

카카오모먼트 API를 호출하려면 필요한 비즈니스 동의항목을 인가받은 비즈니스 토큰을 사용해야 합니다. 비즈니스 인증에서 자세한 내용을 확인할 수 있습니다.

카카오비즈니스

2021년 2월 1일 이후 카카오비즈니스 이용약관 동의 절차를 진행하지 않은 경우 카카오모먼트 API 사용에 제한이 있을 수 있습니다. 서비스를 계속 이용하기 위해서는 플랫폼을 통해 전환 절차를 진행해야 합니다.

API 목록

현재 제공되는 카카오모먼트 API 목록입니다.

광고 만들기: 광고계정

API 설명
광고계정 목록 보기 조회자가 소속된 광고계정 목록 조회
광고계정 보기 광고계정의 상세 내용 조회
제공하는 정보: 광고계정 번호, 이름, 소유사업자번호, 광고주 사업자 정보, 유형, 상태, 관리자 정지 여부, 잔액 부족 여부, 게재 상태
실시간 잔액 보기 광고계정의 잔액 조회
영업권 보기 광고계정에 연동된 영업권 조회
카카오톡 채널 프로필 목록 보기 조회자의 카카오계정을 기준으로 카카오모먼트에서 활용 가능한 카카오톡 채널 프로필 목록 조회
픽셀 & SDK 목록 보기 조회자의 카카오계정을 기준으로 카카오모먼트에서 활용 가능한 픽셀 & SDK 목록 조회
광고계정 생성하기 카카오비즈니스 관리자센터에 등록한 사업자 ID를 이용하여 광고계정 생성
사업자 카카오계정만 생성 가능
광고계정 상태 변경하기 광고계정의 운영 상태 ON/OFF 변경

광고 만들기: 캠페인

API 설명
캠페인 목록 보기 광고계정 하위 캠페인 목록 조회
캠페인 보기 캠페인 상세 내용 조회
제공하는 정보: 광고계정 번호, 캠페인 번호, 이름, 유형X목표, 광고 목표 설정, 일 예산, 상태, 일 예산 초과 여부, 게재 상태, 전환추적설정 번호
캠페인 생성하기 광고계정 하위에 캠페인 생성
이름, 일예산, 전환추적설정 설정 가능
캠페인 수정하기 생성된 캠페인 이름, 일 예산, 전환추적설정(목표가 방문인 경우) 수정
디스플레이 캠페인 일 예산 수정하기 생성된 캠페인의 일 예산 수정
캠페인 상태 변경하기 캠페인의 운영 상태 ON/OFF 변경
캠페인 삭제하기 캠페인 삭제
캠페인 시스템 정지 사유 보기 지정한 한 캠페인의 관리자 정지 사유 단건 조회
캠페인 시스템 정지 사유 목록 보기 지정한 한 캠페인의 관리자 정지 사유 다건 조회

광고 만들기: 광고그룹

API 설명
광고그룹 목록 보기 캠페인 하위 광고그룹 목록 조회
광고그룹 보기 광고그룹 상세 내용 조회
디스플레이 광고그룹 생성하기 캠페인 하위에 디스플레이 광고그룹 생성
디스플레이 광고그룹 수정하기 생성된 디스플레이 광고그룹 수정
디스플레이 광고그룹 일 예산 수정하기 광고그룹의 일예산 수정
디스플레이 광고그룹 최대 입찰금액 수정하기 광고그룹의 최대 입찰금액 수정
디스플레이 광고그룹 게재 방식 수정하기 광고그룹 일반게재/빠른게재 변경
메시지 광고그룹 생성하기 캠페인 하위에 메시지 광고그룹 생성
메시지 광고그룹 수정하기 생성된 메시지 광고그룹 수정
메시지 광고그룹 예상 모수 조회하기 카카오톡 채널 X 도달 캠페인 하위의 광고그룹 생성 및 수정시 필요한 구매 발송수 입력을 위한 예상 모수 조회
메시지 광고그룹 계약해지하기 카카오톡 채널 X 도달 캠페인 하위의 광고그룹에 대해 계약해지
개인화 메시지 광고그룹 생성하기 개인화 메시지 X 도달 캠페인 하위의 광고그룹 생성
개인화 메시지 광고그룹 수정하기 개인화 메시지 X 도달 캠페인 하위의 광고 그룹의 상세 정보 수정
광고그룹 상태 변경하기 광고그룹의 운영상태 ON/OFF 변경
광고그룹 삭제하기 광고그룹 삭제
광고그룹 시스템 정지 사유 보기 지정한 한 광고그룹의 관리자 정지 사유 단건 조회
광고그룹 시스템 정지 사유 목록 보기 지정한 한 광고그룹의 관리자 정지 사유 다건 조회

광고그룹 타겟 조회

API 설명
시/도 보기 시/도 코드 조회
시/군/구 보기 시/군/구 코드 조회
동/읍/면 보기 동/읍/면 코드 조회
네트워크 게재지면 하위 목록 보기 네트워크, 네트워크 하위 게재지면 코드 조회
섹션 카테고리 목록 보기 광고그룹 생성 및 수정 시 선택 가능한 섹션 카테고리 목록 조회
타게팅 가능한 광고반응타겟 보기 광고계정 하위에 생성된 광고반응타겟 번호, 이름, 광고반응 데이터 목록, 수집기간, 타겟 모수 상태, 생성일시, 마지막 수정일시 조회
타게팅 가능한 픽셀 & SDK 이벤트 보기 광고계정 하위에 생성된 픽셀 & SDK 트래커 ID, 타겟 기간 조회
타게팅 가능한 고객파일 목록 보기 광고계정 하위에 생성된 고객파일 번호, 이름, 고객파일 등록 Key, 상태, 타겟 모수, 준비 완료 여부, 생성일시, 마지막 수정일시 조회
타게팅 가능한 친구그룹 목록 보기 광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 친구그룹 목록 조회
타게팅 가능한 카카오톡 채널 정보 목록 보기 광고 그룹 생성 수정시 활용 가능한 카카오톡 채널 프로필 ID, 프로필 이름, 채널 이름 조회
타게팅 가능한 카카오 로그인 이용자 목록 보기 광고 그룹 생성 및 수정 시 활용 가능한 카카오 로그인 이용자 목록, 카카오톡 채널 프로필 ID, 프로필 이름, 채널 이름 조회

광고그룹 맞춤타겟 조회

API 설명
맞춤타겟 카테고리 타입 보기 맞춤타겟 카테고리 타입별 카테고리 코드 조회
맞춤타겟 모먼트 타게팅 보기 맞춤타겟 모먼트 지역 GH 코드 조회

광고 만들기: 소재 공통

API 설명
소재 목록 보기 광고그룹하위 광고소재 조회
소재 보기 광고소재 상세 정보 조회
디스플레이 소재 생성하기 광고그룹 하위에 디스플레이 광고소재 생성
디스플레이 소재 복사하기 기존 디스플레이 소재 복사
디스플레이 소재 수정하기 생성된 디스플레이 광고소재 수정
디스플레이 소재 의견증빙 조회하기 디스플레이 소재 의견증빙 정보 조회
메시지 소재 생성하기 광고그룹 하위에 메시지광고소재 생성
메시지 소재 수정하기 생성된 메시지광고소재 수정
메시지 소재 복사하기 기존 메시지 소재 복사
개인화 메시지 소재 템플릿 생성하기 광고그룹 하위에 개인화 메시지광고소재 템플릿 생성
개인화 메시지 소재 템플릿 수정하기 생성된 개인화 메시지광고소재 템플릿 수정
소재 상태 변경하기 광고소재의 운영상태 ON/OFF 변경
소재 삭제하기 광고소재 삭제
시스템 정지 사유 보기 지정한 한 소재의 시스템 정지 사유를 조회합니다.
시스템 정지 사유 목록 보기 지정한 한 소재의 최근 2년 동안의 시스템 정지 사유를 조회합니다.

비즈보드 랜딩 유형 조회

API 설명
비즈니스폼 랜딩 유형 목록 보기 비즈니스폼 랜딩 유형에 사용 가능한 비즈니스폼의 비즈니스폼 번호, 제목, 유형, 권한 추가일시, 비즈니스폼 시작일시, 종료일시 조회
애드뷰 랜딩 유형 목록 보기 애드뷰 랜딩 유형에 사용 가능한 애드뷰의 번호, 이름, 유형, 템플릿 유형 조회
채널 소식 랜딩 유형 목록 보기 채널 소식 랜딩 유형에 사용 가능한 애드뷰 목록 조회

보고서

API 설명
광고계정 보고서 보기 광고계정 보고서 조회
캠페인 보고서 보기 캠페인 보고서 조회
광고그룹 보고서 보기 광고그룹 보고서 조회
소재 보고서 보기 광고 소재 보고서 조회

메시지 관리

API 설명
카카오TV 채널 목록 보기 메시지 소재에서 사용할 동영상이 포함되어 있는 카카오TV 채널 목록 조회
카카오TV 채널 상세 보기 메시지 소재에서 사용할 동영상이 포함되어 있는 카카오TV 채널의 상세 정보 조회
카카오TV 채널 영상 목록 보기 메시지 소재에서 사용할 동영상 목록 조회
카카오TV 채널 영상 상세 보기 메시지 소재에서 사용할 동영상 조회
메시지 버튼 쿠폰 목록 보기 메시지 소재의 버튼으로 설정 가능한 쿠폰 목록 조회
메시지 버튼 쿠폰 상세 보기 메시지 소재의 버튼으로 설정 가능한 쿠폰을 상세 조회
메시지 버튼 애드뷰 목록 보기 메시지 소재의 버튼으로 설정 가능한 애드뷰 목록 조회
메시지 버튼 소식 목록 보기 메시지 소재의 버튼으로 설정 가능한 카카오톡 채널의 소식 목록 조회
메시지 버튼 비즈니스폼 목록 보기 메시지 소재의 버튼으로 설정 가능한 비즈니스폼 목록 조회
메시지 버튼 비즈니스폼 상세 보기 메시지 소재의 버튼으로 설정 가능한 비즈니스폼 조회

개인화 메시지 관리

API 설명
개인화 메시지 테스트 발송하기 개인화 메시지 X 도달 캠페인 하위의 소재의 테스트 발송을 요청
개인화 메시지 단건 발송 요청하기 개인화 메시지 X 도달 캠페인 하위의 소재의 발송을 요청
개인화 메시지 다건 발송 요청하기 개인화 메시지 X 도달 캠페인 하위의 소재의 발송을 요청, 한 번에 2~100건 발송 요청 가능
개인화 메시지 발송 상태 조회하기 개인화 메시지 발송 요청에 대한 결과 조회
개인화 메시지 이미지 업로드하기 개인화 메시지 X 도달 캠페인 하위 소재에 사용할 홍보 이미지를 업로드
개인화 메시지 비디오 등록하기 개인화 메시지 X 도달 캠페인 하위 소재에 사용할 홍보 동영상으로 활용하고자 하는 카카오TV URL 등록, 사전에 유효성 체크 진행

애드뷰 관리

API 설명
애드뷰 목록 보기 광고계정 하위 생성된 애드뷰 목록 조회
애드뷰 보기 광고계정 하위 애드뷰 상세 조회
애드뷰 삭제하기 광고계정 하위 애드뷰 삭제

비즈니스폼 연동 관리

API 설명
연동된 비즈니스폼 목록 보기 광고계정에 연동된 비즈니스폼 목록 조회
연동 가능한 비즈니스폼 목록 보기 광고계정에 연동할 수 있는 비즈니스폼 조회
비즈니스폼 연동하기 광고계정에 비즈니스폼 연동

픽셀 & SDK 연동 관리

API 설명
연동된 픽셀 & SDK 목록 보기 광고계정에 권한이 추가된 픽셀 & SDK 목록 조회
연동 가능한 픽셀 & SDK 목록 보기 광고계정에 권한을 추가할 수 있는 픽셀 & SDK 조회
픽셀 & SDK 연동하기 광고계정에 픽셀 & SDK 권한 추가
픽셀 & SDK 연동 해제하기 광고계정에 픽셀 & SDK 권한 삭제

오디언스 관리

API 설명
오디언스 목록 보기 오디언스 관리의 오디언스 목록 조회
오디언스 상세 보기 오디언스 관리의 오디언스 단건 조회
오디언스 생성하기 광고 그룹 생성 및 수정 시 사용할 오디언스 생성
오디언스 수정하기 오디언스 수정
오디언스 삭제하기 오디언스 삭제
오디언스 여러 개 삭제하기 오디언스 여러 개 삭제
오디언스 사용 현황 보기 오디언스 관리의 오디언스를 사용하고 있는 광고그룹 조회
오디언스 사용 해제하기 오디언스 관리의 오디언스를 사용하고 있는 광고그룹에 사용 해제

광고반응타겟 관리

API 설명
광고반응타겟 목록 보기 광고계정 하위 생성된 광고반응타겟 번호, 이름, 반응 데이터 목록, 수집 기간, 타겟 모수 상태, 타겟 모수, 생성일시, 마지막 수정일시 조회
광고반응타겟 보기 특정 광고반응타겟 번호, 이름, 광고반응 데이터 목록, 수집 기간, 타겟 모수 상태, 생성일시, 마지막 수정일시 조회
광고반응타겟 생성 가능 대상 보기 광고반응타겟 생성 가능 캠페인, 광고그룹 조회
광고반응타겟 생성하기 광고반응타겟 이름, 광고반응 데이터 설정
광고반응타겟 이름 수정하기 생성된 광고반응타겟 이름수정
광고반응타겟 데이터 수정하기 생성된 광고반응타겟 광고반응 데이터 수정
광고반응타겟 삭제하기 생성된 광고반응타겟 삭제
광고반응타겟 여러 개 삭제하기 생성된 광고반응타겟 여러 개 삭제
사용 현황 보기 광고반응타겟을 사용하고 있는 광고그룹, 캠페인 조회

고객파일 관리

API 설명
고객파일 목록 보기 광고계정에 업로드된 고객파일 번호, 이름, 등록 Key, 상태, 준비완료 여부, 생성일시, 마지막 수정일시 조회
고객파일 상세 보기 광고계정 하위에 생성된 고객파일 번호, 이름, 고객파일 등록 Key, 상태, 타겟모수, 준비완료 여부, 생성일시, 마지막 수정일시 조회
고객파일 등록하기 광고계정 하위 고객파일 업로드, 고객파일 이름, 파일 설정
고객파일 수정하기 광고주가 보유한 오디언스 광고 식별자를 이용하여 광고그룹 생성 및 수정 시 사용할 정보를 파일 형태로 업로드
고객파일 이름 수정하기 업로드된 고객파일 이름 수정
고객파일 삭제하기 업로드된 고객파일 삭제
고객파일 여러 개 삭제하기 업로드된 고객파일 여러 개 삭제
사용 현황 보기 특정 고객파일 사용 중인 광고그룹, 캠페인 조회

친구그룹 관리

API 설명
친구그룹 목록 보기 광고계정하위 생성된 친구그룹 ID, 카카오톡 채널 프로필 ID, 프로필이름, 파일유형, 친구그룹 이름, 친구수, 상태, 생성일시, 마지막 수정일시 조회
친구그룹 등록하기 광고 집행 및 운영을 통해 확보한 고객 식별자 또는 먼저 집행한 메시지 발송 대상자를 친구그룹으로 등록
친구그룹 이름 수정하기 등록된 친구그룹 이름수정
친구그룹 삭제하기 등록된 친구그룹 삭제
친구그룹 여러 개 삭제하기 등록된 친구그룹 여러 개 삭제
사용 현황 보기 특정 친구그룹을 사용하고 있는 광고그룹 조회

광고계정 관리

API 설명
사업자 정보 보기 광고계정 사업자의 사업자번호, 사업자등록번호, 사업자 이름, 대표자 이름, 주소, 업태, 종목 조회

결제 관리

API 설명
무통장입금 가상계좌 생성하기 무통장입금을 위한 가상계좌용 입금금액, 은행코드 설정하여 계좌 생성

변경 이력

변경 날짜 변경 이력
2024.7.8 * 보고서
   - ROAS 지표 보고서 추가
* 광고반응타겟 관리
   - 타겟 모수(populationScore) 응답 필드 추가
2024.6.3 * AssetGroup 업데이트
   - 가격 필드 변경
   - 할인 가격 정보 필드 추가
   - PC 및 모바일 랜딩 URL 필드 추가
2024.4.2 * 행정구역 및 카테고리 코드 업데이트
* 광고반응타겟 유형별 정책에 신규 지면 추가
* 보고서 MetricsGroup에 재생률(VTR) 지표 추가
2024.2.26 * 고객파일 관리
   - 고객파일 등록 및 수정을 URL로 요청할 수 있는 API 추가
* 광고 만들기: 광고계정
   - 광고계정 목록 보기, 광고계정 보기 API 응답에서 businessAccount 제거
2024.1.30 * 신규 API 추가
   - 광고계정 목록 보기: 페이지 형식의 응답 제공, 광고계정 개수 제한 없이 사용 가능, 기존 API 제공 종료일(2024.5.9)
* 문서 내 설명 개선
2023.12.7 * 픽셀&SDK 타겟팅 "모든 이벤트" 추가
* 나이 타겟팅 "70 이상" 반영
* 동 단위, 관심사, 업종 코드 업데이트
   - 동 단위: 경기 양주시 옥정1동(B7220A153), 경기 양주시 옥정2동(B7220A154)
   - 업종: 쇼핑몰 - 전문몰 - 아동/유아용품 - 장난감/레고(P10210802), 생활/편의서비스 - 상담서비스 - 법률/세무/회계(P151001)
   - 관심사: 음식 - 동남아식(I1614), 교육 - 어학 - 영어(I050201), 교육 - 어학 - 중국어(I050202), 교육 - 어학 - 일본어(I050203), 여행 - 해외여행 - 호주(I140209), 야외활동/레저 - 러닝/마라톤(I2309), 건강-명상/심리케어(I0209)
* 자동 입찰 안내 문구 개선
2023.11.30 * 스폰서드 보드 종료에 따른 문서 수정
* creativeId 설명 개선
2023.10.18 * 광고 만들기: 메시지 소재, 광고 만들기: 개인화 메시지 소재
- 캐러셀 타입 지원
2023.7.31 * 개인화 메시지 API 추가
2023.5.3 * 비즈보드 모션 지표 추가

* 디스플레이 광고그룹 CPC 비용 목표 입찰 방식 추가

* 픽셀 & SDK 타겟 기간 설정 변경

* 데모그래픽 지역코드(Depth3Location) 업데이트
- 추가: 경기 파주시 운정4동(B72300236), 경기 파주시 운정5동(B72300237), 경기 파주시 운정6동(B72300238), 서울 강남구 개포3동(I10000003)
- 삭제: 서울 강남구 일원2동(I10001102)

* 관심사 상세 정보 중 가상화폐 코드 변경(I320104 → I32010702)

* 업종 상세 정보 업데이트
- 추가: 쇼핑몰 - 전문몰 - 생활용품 - 욕실용품(P10210602), 쇼핑몰 - 전문몰 - 생활용품 - 침구용품(P10210603), 쇼핑몰 - 전문몰 - 생활용품 - 방향용품(P10210604), 쇼핑몰 - 전문몰 - 음/식료품 - 정육(P10210907), 쇼핑몰 - 종합몰 - 재래시장(P101714), 자동차 - 렌트카/리스(P2005)
- 삭제: 교통 - 렌트카/리스(P0509)

* 메시지 소재 조회 유형 추가: CAROUSEL_FEED_MESSAGE(캐러셀피드), PREMIUM_VIDEO_MESSAGE(프리미엄동영상)
2023.3.27 * 비즈보드 게재지면 추가에 따른 sectionCategories 필드 설명 업데이트

* ObjectiveDetailTypeADD_FRIEND 추가
2023.2.21 * 광고 만들기: 소재
- 메시지 소재의 프리미엄동영상(PREMIUM_VIDEO_MESSAGE) 조회 유형 추가
- 카카오 비즈보드의 생성 가능 이미지 배너(IMAGE_BANNER) 높이 증가: 1029x222 px -> 1029x258 px

* 보고서
- CPA, CVR 지표 추가: 회원가입당 비용, 장바구니 열람률, 친구 추가 수당 비용
- 광고계정 보고서 보기 API로 광고계정 보고서 여러 개 보기 API 기능 통합

* 광고반응타겟 관리
- 카카오톡 채널 x 도달 유형 광고반응타겟 추가

* UFO 카테고리
- 관심사 상세 정보/업종 상세 정보 추가 및 수정
2022.12.20 * 광고 만들기: 캠페인
- 유형 X 목표 광고목표 & 전환 추적 설정 조건: 카카오톡 채널 X 도달 유형의 전환추적 설정에 픽셀 & SDK(옵션) 설정 가능으로 변경
2022.12.7 * 광고 만들기: 소재
- 메시지 소재의 쿠폰 에셋 정보(couponBookAssetGroups) 추가
- 메시지 소재 생성, 수정, 복사 불가 케이스 안내 보완

* 보고서
- MetricsGroup.MESSAGE_CLICK에 쿠폰 관련 지표 추가

* 레퍼런스
- 상세 에러 코드 33133, 33252, 75692 추가
2022.9.22 * 타입 정보
- Depth3Location 하위 depth3Name(동/읍/면 이름) 지역 코드 일부 변경
- 추가: B7205A082(경기도 광주시 오포1동), B7205A083(경기도 광주시 오포2동), G15021000(대전광역시 서구 도안동)
- 삭제: B72051007(경기도 광주시 오포읍)
2022.8.25 * 친구그룹
- 친구그룹 등록하기 API 추가

* 소재
- 네이티브 소재 홍보 문구 필드 추가

* 보고서
- MeticsGroup 하위 SLIDE_CLICK(슬라이드 지표)에 기타 클릭 수 추가

* 공통
- 카카오톡 채널 관련 필드명 일부 변경(plusFriendtalkChannel)
   기존 필드명은 10월 정기 배포 전까지만 지원
2022.6.23 * 소재
- 와이드리스트형 메시지 소재의 홍보문구(itemAssetGroups.title) 필수 여부 조건부로 변경

* 광고그룹, 캠페인
- 관리자 정지 사유 API 이름 및 응답 필드 변경
   관리자 정지 사유 보기 → 시스템 정지 사유 보기
   관리자 정지 사유 목록 보기 → 시스템 정지 사유 목록 보기
- 카카오톡 채널 제재 상태 추가, 타입 정보 Status의 운영불가 상태 정보 업데이트

* 보고서 지표 변경
- 타입 정보의 MetricsGroup 업데이트
- 삭제: PIXEL_CONVERSION, SDK_CONVERSION, TALK_CONVERSION_OLD, CHAT_LANDING
- 추가: SLIDE_CLICK(기존 지원 항목, 문서에 누락되어 추가)
- 변경: TALK_CONVERSION
2022.4.25 * 광고반응타겟
- 연산 및 반응 종류 정책 세분화

* UFO 카테고리
- 신규 관심사 상세 정보 추가
   I020601(건강 > 운동 > 홈트레이닝)
   I32010103(비즈니스/경제 > 금융 > 재테크 > 경매), I320104(비즈니스/경제 > 금융 > 가상화폐)
- 일부 업종 상세 정보 명칭 변경
- 일부 업종 키 삭제
   P10210501(배달/선물>꽃집)
   P1519(음식배달/심부름)

* 기타
- 광고반응타겟 생성, 고객파일 등록 최대 50개까지 요청 가능하도록 완화(기존 제한: 30개)
- 신규 API 추가
   광고반응타겟 여러 개 삭제하기
   오디언스 여러 개 삭제하기
   고객파일 여러 개 삭제하기
   친구그룹 여러 개 삭제하기
2022.4.5 * 보고서
- 보고서 지표 그룹(MetricsGroup) 하위 지표 추가
- 동영상 지표(VIDEO): 재생 수, 재생당 비용 지표 추가
- 익스팬더블 지표(EXPANDABLE): 익스팬더블 멀티형 추가에 따른 지표 추가
2022.2.24 * 광고 만들기: 광고그룹
- 일 예산, 입찰금액 최대 값 조정

* 광고그룹 타겟 조회
- 동 단위 타게팅 추가
- 동/읍/면 보기 API 추가
* 문서 구조 개선: 타입 정보 분리
2022.1.20 * 광고 만들기: 소재
- 신규 API 추가: 시스템 정지 사유 보기, 시스템 정지 사유 목록 보기
- 소재 생성 및 조회 응답에 연령인증 메시지 여부(ageVerification) 필드 추가

* 픽셀 & SDK 연동 관리
- role 필드 추가
- 목차명 개선

* 비즈보드 랜딩 설정
- 채널 소식 정보 응답 필드 개선
2022.1.4 * 픽셀 & SDK
- 사용 권한 목록 보기 응답 구성 변경
2021.12.16 * 광고 만들기: 소재
- 디스플레이 소재에 의견증빙 및 심사 처리에 관련된 파라미터와 응답 필드 추가

* 가이드 보완
- 캐러셀 유형 메시지 소재의 API를 통한 수정 불가 안내 추가
- 다음쇼핑 유형 캠페인에 대한 캠페인, 광고그룹, 소재 API 제약 사항 안내 추가
- 디스플레이 소재의 name 자동 생성 포맷 안내 개선
- 일부 문서의 표기, 링크 오류 수정
2021.11.15 * 캠페인, 광고그룹, 소재
- 일부 API 응답의 type 필드 삭제
- 스폰서드 보드 지원 여부 안내 추가

* 레퍼런스
- MetricsGroupSPB(보드 지표) 추가
2021.10.5 * 일부 API 및 UFO 카테고리 제공 종료
- 광고그룹 유사타겟 관리
- 타겟 가능한 유사타겟 목록 보기
- 맞춤타겟 모먼트 타게팅 보기
- 맞춤타겟 카테고리 서비스 보기
- 일부 UFO 카테고리 변경 및 서비스 제거

* 오디언스 유형 변경
- 오디언스 유형(type) 수정: DISPLAY, MESSAGE
- 오디언스 생성: 필수 파라미터에 오디언스 유형 추가, 오디언스 유형별 사용 가능한 파라미터 표 추가(유형에 맞지 않는 파라미터 요청 시 에러 발생)
오디언스 수정: 오디언스 유형 수정 불가
- 응답의 사용하지 않는 모먼트 타겟팅, 유사타겟 제거
- 오디언스 관련 상세 에러코드 업데이트

* 광고그룹 광고반응타겟 관리
- 광고반응타겟 보기: 응답에 오디언스 유형 추가
- 광고반응타겟 생성가능 대상 보기: 생성 가능 대상에 다음쇼핑X도달, 동영상X조회 조합 추가
- 광고반응타겟 생성하기: 필수 파라미터에 오디언스 유형 추가, 오디언스 유형별 사용 가능한 타겟팅 적용
- 광고반응타겟 이름 수정하기: 응답에 오디언스 유형 추가

* 광고 만들기: 광고그룹
- smartMessage 필드 추가 및 수정
- creativeOptimization, dynamicTarget 필드 제거
- 응답 정보에 오디언스 유형 변경사항 반영
- 광고그룹 관련 상세 에러코드 업데이트
- 광고그룹 생성 시 일부 타겟팅 옵션 지원 중단: 유사타겟, 현재 위치 타겟, 종료된 서비스 카테고리(지원 중단된 타겟팅을 사용한 생성 및 수정 요청 시, 메시지 광고그룹은 에러 발생, 디스플레이 광고그룹은 해당 값 무시하고 정상 처리)

* 광고 만들기: 소재
- 비즈보드 캠페인 유형의 landingType 중 "MESSAGE" 사용 불가
2021.8.26 * 광고 만들기: 캠페인
- 캠페인 생성 및 수정 시 적용되는 유형 X 목표 광고목표 & 전환 추적 설정 조건 표의 전환추적 설정 안내 보완

* 레퍼런스
- 메시지 스팸필터 관련 에러코드(75691)와 설명 추가
2021.8.17 * 광고 만들기: 캠페인
- 톡채널X도달 Open API 관련 변경사항 적용

* 광고 만들기: 광고그룹
- 톡채널X도달 Open API 관련 변경사항 적용, 유형별 목차 분리
- 신규 API 추가:
   메시지 광고그룹 예상 모수 조회하기
   메시지 광고그룹 계약해지하기

* 광고 만들기: 소재
- 톡채널X도달 Open API 관련 변경사항 적용, 유형별 목차 분리

* 메시지 설정
- 신규 API 추가:
   카카오TV 채널 목록 보기
   카카오TV 채널 상세 보기
   카카오TV 채널 영상 목록 보기
   카카오TV 채널 영상 상세 보기
   메시지 버튼 쿠폰 목록 보기
   메시지 버튼 쿠폰 상세 보기
   메시지 버튼 애드뷰 목록 보기
   메시지 버튼 소식 목록 보기
   메시지 버튼 비즈니스폼 목록 보기
   메시지 버튼 비즈니스폼 상세 보기

* 레퍼런스
- 톡채널X도달 Open API 관련 응답코드 및 타입 정보 업데이트

* 기타
- Open API 버전 V2, V3 제공 중단에 따른 Legacy 가이드 삭제
2021.8.3 * 광고 만들기: 광고그룹
- 관리자 정지 사유 목록 보기 API 추가

* 소재
- 소재 응답에 익스팬더블 요소 여부 포함

* 캠페인
- 관리자 정지 사유 목록 보기 API 추가
- 캠페인 수정시 수정 불가 항목(캠페인유형 X 목표,광고목표대상) 내용 삭제

* 픽셀 & SDK
- 광고계정당 최대 100개 연동 지원에 대한 안내 추가

MAT
- MAT 관련 API 제공 종료

* 기타
- 카카오 비즈보드 X 도달 유형에 대한 제약 안내 추가
- 문서 내 용어 개선(광고 목표 대상 → 광고 목표 설정, 전환 추적 대상 → 전환 추적 설정)
2021.6.24 * 오디언스 관리
- 신규 API 추가(오디언스 생성하기, 오디언스 수정하기, 오디언스 삭제하기)

* 광고 만들기: 광고그룹
- API 호출 제한 기준 변경: 광고그룹 생성하기, 광고그룹 수정하기, 일 예산 수정하기, 최대 입찰 금액 수정하기, 게재 방식 수정하기, 상태 변경하기
- 캠페인 유형이 카카오 비즈보드인 경우에도 광고그룹 생성하기, 수정하기 가능하도록 변경

* 광고 만들기: 캠페인
- 지원하는 캠페인 유형 정보 업데이트
- API 호출 제한 기준 변경: 캠페인 수정하기, 일 예산 수정하기, 상태 변경하기

* 광고 만들기: 소재
- 캠페인 유형별 생성 가능한 소재 유형 업데이트
- 이미지 규격 변경
- 다이렉트 메시지광고 소재의 format에 CAROUSEL_COMMERCE_MESSAGE(캐러셀형) 추가
2021.5.25 * 오디언스 관리
- 오디언스 관리 API 추가
- Targeting에 오디언스 사용 여부 및 오디언스 기본 정보 추가

* 고객파일
- 고객파일 수정하기 API 추가
2021.4.22 * 광고 만들기: 광고그룹
- 오디언스 관리 기능 추가에 따른 변경사항 적용
- 오디언스 관리 기능을 통해 설정된 광고그룹의 타겟팅은 API를 통한 생성 및 수정 미지원

* MAT
- 연동 코드 생성하기 API 종료

* 픽셀&SDK
- 픽셀&SDK 트랙 수 제한 적용(최대 100개)

* 광고 만들기: 소재
- 네이티브 소재(이미지, 동영상)의 홍보문구 요소 제거

* 동영상 광고 유형 추가 및 소재 통합
- 캠페인 유형, 목표 추가(type: VIDEO, goal: VIEW)
- 신규 캠페인 하위 광고그룹 조회시 type은 DISPLAY
- 신규 캠페인 하위 소재 조회시 format은 VIDEO_NATIVE

* 비즈니스폼
- 비즈니스폼 연동 권한 확대

* 광고그룹 맞춤타겟
- 키워드 타게팅 API 2종 종료
2021.4.15 * 광고 만들기: 소재
- 신규 소재 랜딩 유형(LandingType) '카카오페이 구매(PAY_BUY)' 추가
2021.3.30 * 광고 만들기: 광고그룹
- 카카오톡 비즈보드 유형의 광고그룹에 '섹션카테고리(sectionCategories)' 속성 추가

* 광고그룹 타겟
- 섹션 카테고리 목록 보기 API 추가
2021.3.9 * 입찰가 정책 변경
- 소재 입찰금액 수정하기 API 제거

* 캠페인, 광고그룹 관리자 정지 기능 추가
- 광고 만들기: 캠페인: 관리자 정지 사유보기 API, '관리자 정지(adminStop)' 속성 추가
- 광고 만들기: 광고그룹: 관리자 정지 사유보기 API, '관리자 정지(adminStop)' 속성 추가

* 업종, 관심사 카테고리 일부 삭제
- ID P0510 교통 > 카쉐어링
- ID I1809 스포츠 > 자전거

* 데모그래픽 연령 세분화
- 상세한 연령 타게팅의 필요성으로 5세 단위로 구간 변경
- 보고서: 기존 (구)연령구분 데이터 유지, 신규 연령구분 데이터 추가

* 애드뷰 삭제 validation check 변경
- 기존: 애드뷰를 랜딩으로 사용하는 소재가 존재하는 경우 삭제 불가
- 변경: 애드뷰를 랜딩으로 사용하는 소재 또는 메시지가 존재하는 경우 삭제 불가
2021.2.25 * 카카오모먼트 Open API v1 제공 종료
- 공지사항 참고
2021.2.1 * 비즈보드 랜딩 설정
- 메시지 랜딩 유형 목록 보기 신규 API 추가
- 기존 메시지 랜딩 유형 목록 보기 API 2종 종료(Deprecated):
   /v3/moment/creatives/landing/messages
   /openapi/v4/creatives/landing/messages/${PROFILE_ID}
2021.1.18 * 광고 만들기: 소재
- 카카오모먼트 소재 심사 플랫폼 이관에 따라 의견증빙 조회 방법 변경
- 의견증빙 조회하기 API(v4) 추가
- 의견증빙 조회하기 API(v2) 추가
- 기존 소재 보기/복사/수정 API의 OpinionProof 파라미터 삭제

* 광고 만들기: 광고계정
- 광고계정 생성하기의 요청 헤더 중 광고계정 ID 삭제
2020.12.22 * 애드뷰
- 애드뷰 삭제하기 API 추가

* 업종, 관심사 카테고리 개편
- 업종(UfoBusinessType)/관심사(UfoInterest) 카테고리를 총 445개의 분류로 개편
- 개편 후 기존 카테고리에 대한 매핑(Mapping) 지원
- 신규 카테고리는 최대 4 Depth 구조로 더욱 상세하고 다양한 분류 제공
2020.11.19 * 일부 API 초당 요청 횟수 완화 및 제거, 레퍼런스 참고

* 보고서
- 광고계정 보고서 여러개 보기 API 추가
- 기존 캠페인 및 광고그룹 보고서 여러개 보기 기능 추가

* 레퍼런스
- 에러메시지 추가
- UfoInterest 상세 데이터 일부 삭제:
   I0101(소셜활동)
   I020103(건강증진)
   I1702(사회)
   P0506(길찾기)
   P0704(부동산)
   P22(기업)
   P2201(이벤트/마케팅)
   P2202(기타기업)
   P2303(예약/예매)
   I2303(사진)
   P0106(e러닝)

더 보기