본문 바로가기메인 메뉴 바로가기사이드 메뉴 바로가기

kakao developers

관련사이트
  • 문서
  • 카카오모먼트
  • 이해하기

사이드 메뉴

카카오맵

검색

카카오모먼트

이해하기

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

기능 소개

카카오모먼트 API

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

API로 생성 및 수정이 가능한 캠페인 유형 X 목표는 비즈보드 X 전환, 비즈보드 X 방문, 디스플레이 X 전환, 디스플레이 X 방문, 동영상 X 조회, 카카오톡 채널 X 도달, 개인화 메시지 X 도달 입니다.

카카오모먼트 기능 소개

주요 용어

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

사용하는 ID 종류

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

사용 방법

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

  1. 카카오디벨로퍼스 앱 생성
  2. 비즈 앱 전환
  3. [로그인] > [카카오계정 ID] > [계정 설정] > [본인인증]에서 앱 소유자의 카카오계정 본인인증 완료
  4. 앱 관리 페이지의 [앱] > [추가 기능 신청]에서 사용 권한 신청
비즈니스 인증

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

카카오비즈니스

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

API 목록

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

광고 생성: 광고계정

API설명
광고계정 목록 조회광고계정 목록을 조회합니다.
광고계정 조회특정 광고계정의 상세 정보를 조회합니다.
실시간 잔액 조회광고계정의 실시간 잔액을 조회합니다.
영업권 조회광고계정 영업권을 조회합니다.
영업권 자동 승인광고계정 영업권을 승인합니다.
카카오톡 채널 프로필 목록 조회사용자의 카카오톡 채널 프로필 목록을 조회합니다.
픽셀 & SDK 목록 조회유형, 목표에 따른 권한있는 픽셀 & SDK 목록을 조회합니다.
광고계정 생성새로운 광고계정을 생성합니다.
광고계정 상태 변경광고계정 상태를 ON 또는 OFF로 변경합니다.

광고 생성: 캠페인

API설명
캠페인 목록 조회캠페인 목록을 조회합니다.
캠페인 조회지정한 한 캠페인의 상세 정보를 조회합니다.
캠페인 생성새로운 캠페인을 생성합니다.
캠페인 수정캠페인 정보를 수정합니다.
캠페인 상태 변경지정한 캠페인의 상태를 변경합니다.
디스플레이 캠페인 일 예산 수정캠페인 일 예산을 수정합니다.
캠페인 삭제캠페인을 삭제합니다.
캠페인 시스템 정지 사유 조회지정한 한 캠페인의 시스템 정지 사유를 조회합니다.
캠페인 시스템 정지 사유 목록 조회지정한 캠페인의 최근 2년 동안의 시스템 정지 사유를 조회합니다.

광고 생성: 광고그룹

API설명
광고그룹 목록 조회광고그룹 목록을 조회합니다.
광고그룹 조회각 광고그룹 상세 정보를 조회합니다.
디스플레이 광고그룹 생성캠페인의 하위에 디스플레이 광고그룹을 생성할 수 있습니다.
디스플레이 광고그룹 수정캠페인 하위의 디스플레이 광고그룹 상세 정보를 수정합니다.
디스플레이 광고그룹 일 예산 수정디스플레이 광고그룹 일 예산을 변경합니다.
디스플레이 광고그룹 수동 입찰 최대 입찰금액 수정디스플레이 광고그룹 최대 입찰금액을 수정합니다.
디스플레이 광고그룹 게재 방식 수정디스플레이 광고그룹 게재 방식을 변경하는 API로 디스플레이, 동영상, 비즈보드 유형 (도달 목표 제외) 캠페인 하위 광고그룹만 가능합니다.
메시지 광고그룹 생성카카오톡 채널 X 도달 캠페인 하위의 광고 그룹을 생성합니다.
메시지 광고그룹 수정카카오톡 채널 X 도달 캠페인 하위의 광고 그룹의 상세 정보를 수정합니다.
메시지 광고그룹 예상 모수 조회카카오톡 채널 X 도달 캠페인 하위의 광고그룹 생성 및 수정 시 필요한 구매 발송수 입력을 위한 예상 모수를 조회하는 API입니다.
메시지 광고그룹 계약 해지카카오톡 채널 X 도달 캠페인 하위의 광고그룹에 대해 계약해지를 할 수 있습니다.
개인화 메시지 광고그룹 생성개인화 메시지 X 도달 캠페인 하위의 광고그룹을 생성합니다.
개인화 메시지 광고그룹 수정개인화 메시지 X 도달 캠페인 하위의 광고 그룹의 상세 정보를 수정합니다.
광고그룹 상태 변경광고그룹 상태를 ON, OFF 중에서 변경합니다.
광고그룹 삭제광고그룹을 삭제합니다.
광고그룹 시스템 정지 사유 조회지정한 한 광고그룹의 시스템 정지 사유를 조회합니다.
광고그룹 시스템 정지 사유 목록 조회지정한 한 광고그룹의 최근 2년 동안의 시스템 정지 사유를 조회합니다.

광고그룹 타겟 조회

API설명
시/도 조회데모그래픽의 지역 선택을 위한 시/도 목록을 조회할 수 있습니다.
시/군/구 조회광고그룹 생성 및 수정 시 지역 타겟팅 옵션에 필요한 시/군/구 목록을 조회할 수 있습니다.
동/읍/면 조회광고그룹 생성 및 수정 시 지역 타겟팅 옵션에 필요한 동/읍/면 목록을 조회할 수 있습니다.
네트워크 게재지면 하위 목록 조회광고그룹 생성 및 수정 시 게재지면의 목록을 조회할 수 있습니다.
섹션 카테고리 목록 조회광고그룹 생성 및 수정 시 선택 가능한 섹션 카테고리 목록을 조회할 수 있습니다.
타게팅 가능한 광고반응타겟 조회광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 맞춤타겟의 광고반응타겟 목록을 조회합니다.
타게팅 가능한 픽셀 & SDK 이벤트 조회광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 맞춤타겟의 픽셀 & SDK 이벤트 목록을 조회합니다.
타게팅 가능한 고객파일 목록 조회광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 고객파일 목록을 조회합니다.
타게팅 가능한 친구그룹 목록 조회광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 친구그룹 목록을 조회합니다.
타게팅 가능한 카카오톡 채널 정보 목록 조회광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 카카오톡 채널 정보 목록을 조회합니다.
타게팅 가능한 카카오 로그인 이용자 목록 조회광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 카카오 로그인 이용자 목록을 조회합니다.

광고그룹 맞춤타겟 조회

API설명
맞춤타겟 카테고리 타입 조회광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 맞춤타겟의 카테고리 관심사/업종 데이터를 조회합니다.
맞춤타겟 모먼트 타게팅 조회광고그룹 생성 및 수정 시 타겟팅 옵션으로 요청할 수 있는 맞춤타겟의 모먼트 타게팅을 위한 지역을 조회합니다.

광고 생성: 소재 공통

API설명
소재 목록 조회소재 목록을 조회합니다.
소재 조회각 소재의 상세 정보를 조회합니다.
소재 상태 변경소재 상태를 변경합니다.
소재 삭제소재를 삭제합니다.
시스템 정지 사유 조회지정한 한 소재의 시스템 정지 사유를 조회합니다.
시스템 정지 사유 목록 조회지정한 한 소재의 최근 2년 동안의 시스템 정지 사유를 조회합니다.

비즈보드 랜딩 유형 조회

API설명
비즈니스폼 랜딩 유형 목록 조회소재 생성 및 수정 시 비즈니스폼 랜딩 유형 설정에 사용할 수 있는 비즈니스폼 목록을 조회합니다.
애드뷰 랜딩 유형 목록 조회소재 생성 및 수정 시 애드뷰 랜딩 유형 설정에 필요한 애드뷰 목록을 조회합니다.
채널 소식 랜딩 유형 목록 조회소재 생성 및 수정 시 채널 소식 랜딩 유형 설정에 필요한 애드뷰 목록을 조회합니다.

보고서

API설명
광고계정 보고서 조회광고계정에 대한 보고서를 조회합니다.
캠페인 보고서 조회캠페인에 대한 보고서를 조회합니다.
광고그룹 보고서 조회광고그룹 보고서를 조회합니다.
소재 보고서 조회소재 보고서를 조회합니다.

메시지 관리

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

개인화 메시지 관리

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

메시지광고 운영

API설명
메시지광고 저장카카오톡 채널에서 발송될 메시지광고 내용을 저장합니다.
메시지 수정카카오톡 채널에서 발송될 메시지광고 내용을 수정합니다.
메시지광고 테스트 발송메시지 테스트 발송을 요청합니다.
메시지광고 발송 예약메시지 발송 시작 시간과 발송 대상을 설정합니다.
메시지광고 발송 예약 조회메시지광고 발송 예약을 상세 조회합니다.
메시지광고 발송 예약 수정메시지 발송 시작 시간과 발송 대상을 수정합니다.
타게팅 지역 조회메시지광고 발송 예약 시 지역 설정에 활용할 상세 정보를 조회합니다.
타게팅 모수 및 단가 조회발송 가능한 모수 및 단가를 조회합니다.
메시지광고 종료메시지광고를 종료합니다.

메시지광고 관리

API설명
메시지광고 목록 조회카카오톡 채널 하위에 생성된 메시지광고 목록을 조회합니다.
메시지광고 조회개별 메시지광고의 상세 정보를 조회합니다.
메시지광고 삭제메시지광고를 삭제합니다.
메시지 조회메시지 내용을 상세 조회합니다.
메시지 복사카카오톡 채널에서 발송될 메시지광고의 메시지를 복사합니다.
메시지광고 보고서 조회메시지에 대한 보고서를 조회합니다.

애드뷰 관리

API설명
애드뷰 목록 조회애드뷰 목록을 조회합니다.
애드뷰 조회애드뷰 상세 정보를 조회합니다.
애드뷰 삭제애드뷰를 삭제할 수 있습니다.

비즈니스폼 연동 관리

API설명
연동된 비즈니스폼 목록 조회광고계정에 연동된 비즈니스폼 목록을 조회합니다.
연동 가능한 비즈니스폼 목록 조회연동 가능한 비즈니스폼 목록을 조회할 수 있습니다.
비즈니스폼 연동광고계정에 비즈니스폼을 연동합니다.

픽셀 & SDK 연동 관리

API설명
연동된 픽셀 & SDK 목록 조회광고 계정에 연동된 픽셀 & SDK 목록을 조회합니다.
연동 가능한 픽셀 & SDK 목록 조회연동 가능한 픽셀 & SDK 목록을 조회합니다.
픽셀 & SDK 연동지정한 픽셀 & SDK를 광고계정에 연동합니다.
픽셀 & SDK 연동 해제픽셀 & SDK 연동을 해제합니다.

오디언스 관리

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

광고반응타겟 관리

API설명
광고반응타겟 목록 조회광고그룹 생성 및 수정 시 타게팅 정보로 활용 가능한 광고반응타겟 목록을 조회합니다.
광고반응타겟 조회지정한 광고반응타겟의 상세 정보를 조회합니다.
광고반응타겟 생성 가능 대상 조회광고반응타겟 생성에 필요한 정보인 광고계정 하위의 캠페인 및 광고그룹 정보의 목록을 조회합니다.
광고반응타겟 생성광고반응타겟을 생성합니다.
광고반응타겟 이름 수정광고반응타겟의 이름을 수정합니다.
광고반응타겟 데이터 수정광고반응타겟의 데이터를 수정합니다.
광고반응타겟 삭제광고반응타겟을 삭제합니다.
광고반응타겟 여러 개 삭제복수의 광고반응타겟을 한번에 삭제합니다.
광고반응타겟 사용 현황 조회광고반응타겟 사용 현황 목록을 조회할 수 있습니다.

고객파일 관리

API설명
고객파일 목록 조회업로드된 고객파일 목록을 조회합니다.
고객파일 상세 조회고객파일 상세 정보를 조회합니다.
파일로 등록광고그룹 생성 및 수정 시 사용할 고객파일을 파일 형태로 업로드할 수 있습니다.
URL로 등록광고그룹에서 사용할 고객파일을 URL로 등록할 수 있습니다.
파일로 수정등록되어 있는 고객파일 타겟을 수정할 수 있습니다.
URL로 수정등록된 고객파일 타겟을 수정할 수 있습니다.
고객파일 이름 수정고객파일 이름을 수정합니다.
고객파일 삭제등록된 고객파일을 삭제합니다.
고객파일 여러 개 삭제복수의 고객파일을 한 번에 고객파일을 삭제합니다.
고객파일 사용 현황 조회지정한 고객파일을 사용 중인 광고그룹 및 캠페인 목록을 조회합니다.

친구 그룹 관리

API설명
친구그룹 목록 조회친구그룹 목록을 조회합니다.
친구그룹 등록광고 집행과 운영으로 확보한 고객 식별자 또는 먼저 집행한 메시지 발송 대상자를 친구그룹으로 등록할 수 있습니다.
친구그룹 이름 수정친구그룹 이름을 수정할 수 있습니다.
친구그룹 삭제친구그룹을 삭제할 수 있습니다.
친구그룹 여러 개 삭제복수의 친구그룹을 한 번에 삭제할 삭제할 수 있습니다.
친구그룹 사용 현황 조회친구그룹을 사용 중인 광고 그룹을 조회할 수 있습니다.

광고계정 관리

API설명
사업자 정보 조회사업자 정보를 조회합니다.

변경 이력

변경 날짜변경 이력
2025.8.26
  • 행동유도문구 색상, 버튼 색상 요소 신규 추가
  • 이미지 네이티브, 동영상 네이티브 소재 생성/수정 시 입력 요소에 색상 추가
  • 슬라이드(slides) 아이템 적용 범위 추가
  • 이미지 네이티브, 동영상 네이티브 소재 생성/수정 시 적용 가능
  • 기존 AssetGroup 필드 지원 종료(slides로 이름 변경)
  • AssetGroup은 2025.9.30 이후로 사용 불가하므로 slides로 변경 필요
  • 세로형 홍보 이미지 4:5 비율 신규 추가
  • 이미지 네이티브 소재 이미지 사이즈를 추가
  • 디스플레이 캠페인 하위에 동영상 네이티브 소재 추가 지원
2025.8.5
  • 신규 API 추가
    • 메시지광고 관리, 메시지광고 운영
2024.12.17
  • 캠페인, 광고그룹, 디스플레이 소재, 소재
    • 동영상 캠페인 신규 추가
  • 결제 관리
    • 무통장입금 가상계좌 생성 API 지원 중단으로 문서 삭제
2024.7.8
  • 보고서
    • ROAS 지표 보고서 추가
  • 광고반응타겟 관리
    • 타겟 모수(populationScore) 응답 필드 추가
2024.6.3
  • AssetGroup 업데이트
    • 가격 필드 변경
    • 할인 가격 정보 필드 추가
    • PC 및 모바일 랜딩 URL 필드 추가
2024.4.2
  • 행정구역 및 카테고리 코드 업데이트
  • 광고반응타겟 유형별 정책에 신규 지면 추가
  • 보고서 MetricsGroup에 재생률(VTR) 지표 추가
2024.2.26
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
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
2022.4.5
  • 보고서
    • 보고서 지표 그룹(MetricsGroup) 하위 지표 추가
    • 동영상 지표(VIDEO): 재생 수, 재생당 비용 지표 추가
    • 익스팬더블 지표(EXPANDABLE): 익스팬더블 멀티형 추가에 따른 지표 추가
2022.2.24
  • 광고 생성: 광고그룹
    • 일 예산, 입찰금액 최대 값 조정
  • 광고그룹 타겟 조회
  • 문서 구조 개선: 타입 정보 분리
2022.1.20
2022.1.4
2021.12.16
  • 광고 생성: 소재
    • 디스플레이 소재에 의견증빙 및 심사 처리에 관련된 파라미터와 응답 필드 추가
  • 가이드 보완
    • 캐러셀 유형 메시지 소재의 API로 수정 불가 안내 추가
    • 다음쇼핑 유형 캠페인에 대한 캠페인, 광고그룹, 소재 API 제약 사항 안내 추가
    • 디스플레이 소재의 name 자동 생성 포맷 안내 개선
    • 일부 문서의 표기, 링크 오류 수정
2021.11.15
  • 캠페인, 광고그룹, 소재
    • 일부 API 응답의 type 필드 삭제
    • 스폰서드 보드 지원 여부 안내 추가
  • 레퍼런스
    • MetricsGroupSPB(보드 지표) 추가
2021.10.5
  • 일부 API 및 UFO 카테고리 제공 종료
    • 광고그룹 유사타겟 관리
    • 타겟 가능한 유사타겟 목록 보기
    • 맞춤타겟 모먼트 타게팅 조회
    • 맞춤타겟 카테고리 서비스 보기
    • 일부 UFO 카테고리 변경 및 서비스 제거
  • 오디언스 유형 변경
  • 오디언스 수정: 오디언스 유형 수정 불가
    • 응답의 사용하지 않는 모먼트 타겟팅, 유사타겟 제거
    • 오디언스 관련 상세 에러코드 업데이트
  • 광고그룹 광고반응타겟 관리
    • 광고반응타겟 조회: 응답에 오디언스 유형 추가
    • 광고반응타겟 생성 가능 대상 조회: 생성 가능 대상에 다음쇼핑X도달, 동영상X조회 조합 추가
    • 광고반응타겟 생성: 필수 파라미터에 오디언스 유형 추가, 오디언스 유형별 사용 가능한 타겟팅 적용
    • 광고반응타겟 이름 수정: 응답에 오디언스 유형 추가
  • 광고 생성: 광고그룹
    • smartMessage 필드 추가 및 수정
    • creativeOptimization, dynamicTarget 필드 제거
    • 응답 정보에 오디언스 유형 변경 사항 반영
    • 광고그룹 관련 상세 에러코드 업데이트
    • 광고그룹 생성 시 일부 타겟팅 옵션 지원 중단: 유사타겟, 현재 위치 타겟, 종료된 서비스 카테고리(지원 중단된 타겟팅을 사용한 생성 및 수정 요청 시, 메시지 광고그룹은 에러 발생, 디스플레이 광고그룹은 해당 값 무시하고 정상 처리)
  • 광고 생성: 소재
    • 비즈보드 캠페인 유형의 landingType 중 "MESSAGE" 사용 불가
2021.8.26
2021.8.17
2021.8.3
  • 광고 생성: 광고그룹
  • 소재
    • 소재 응답에 익스팬더블 요소 여부 포함
  • 캠페인
  • 픽셀 & SDK
    • 광고계정당 최대 100개 연동 지원에 대한 안내 추가
  • MAT
    • MAT 관련 API 제공 종료
  • 기타
    • 카카오 비즈보드 X 도달 유형에 대한 제약 안내 추가
    • 문서 내 용어 개선(광고 목표 대상 → 광고 목표 설정, 전환 추적 대상 → 전환 추적 설정)
2021.6.24
  • 오디언스 관리
  • 신규 API 추가(오디언스 생성 API, 오디언스 수정 API, 오디언스 삭제 API)
  • 광고 생성: 광고그룹
    • API 호출 제한 기준 변경: 광고그룹 생성, 광고그룹 수정, 일 예산 수정하기, 최대 입찰 금액 수정하기, 게재 방식 수정하기, 상태 변경하기
    • 캠페인 유형이 카카오 비즈보드인 경우에도 광고그룹 생성, 수정하기 가능하도록 변경
  • 광고 생성: 캠페인
    • 지원하는 캠페인 유형 정보 업데이트
    • API 호출 제한 기준 변경: 캠페인 수정, 일 예산 수정하기, 상태 변경하기
  • 광고 생성: 소재
    • 캠페인 유형별 생성 가능한 소재 유형 업데이트
    • 이미지 규격 변경
    • 다이렉트 메시지광고 소재의 format에 CAROUSEL_COMMERCE_MESSAGE(캐러셀형) 추가
2021.5.25
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)' 속성 추가
  • 광고그룹 타겟
2021.3.9
  • 입찰가 정책 변경
    • 소재 입찰금액 수정하기 API 제거
  • 캠페인, 광고그룹 관리자 정지 기능 추가
  • 업종, 관심사 카테고리 일부 삭제
    • 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 파라미터 삭제
  • 광고 생성: 광고계정
2020.12.22
2020.11.19
  • 일부 API 초당 요청 횟수 완화 및 제거, 레퍼런스 참고
  • 보고서
    • 광고계정 보고서 여러개 보기 API 추가
    • 기존 캠페인 및 광고그룹 보고서 여러개 보기 기능 추가
  • 레퍼런스
    • 에러메시지 추가
    • UfoInterest 상세 데이터 일부 삭제:
    • I0101(소셜활동)
    • I020103(건강증진)
    • I1702(사회)
    • P0506(길찾기)
    • P0704(부동산)
    • P22(기업)
    • P2201(이벤트/마케팅)
    • P2202(기타기업)
    • P2303(예약/예매)
    • I2303(사진)
    • P0106(e러닝)

더 보기

도움이 되었나요?