카카오모먼트

타입 정보

이 문서는 카카오모먼트 API에서 사용되는 각종 타입에 대한 상세 정보를 제공합니다.

A

Enum: ActionButton

값	설명
LINK	바로가기
MORE	알아보기
RESERVATION	예약하기
PURCHASE	구매하기
REQUEST	신청하기
INQUIRE	문의하기
INSTALL	설치하기
RUN	실행하기
DOWNLOAD	다운로드
LAUNCH	사용하기
ADD_FRIEND	채널 추가
SUBSCRIBE	소식 받기
MORE_VIDEO	동영상 더보기
JOIN	가입하기
COUPON	쿠폰 받기
PLAY	게임하기

AdGroup

이름	타입	설명
id	`Long`	광고그룹 번호
name	`String`	광고그룹 이름
adGroupStatus	`Enum: Status[]`	광고그룹 상태

Enum: AdGroupType

값	설명
DISPLAY	디스플레이
DIRECT_MESSAGE	메시지

AdView

이름	타입	설명
id	`Long`	애드뷰 번호 소재 생성 및 수정 시 `landingInfo.adViewItem.id`에 해당 값으로 설정
name	`String`	애드뷰 이름
type	`Enum`	애드뷰 타입 `COMPACT`: 콤팩트뷰 `FULL`: 풀뷰
templateType	`Enum`	애드뷰 템플릿 타입 `IMAGE`: 이미지 `VIDEO`: 동영상 `CAROUSEL`: 캐러셀 `SCROLL`: 스크롤

AdViewItem

이름	타입	설명
id	`Long`	애드뷰 번호

AppTrackingType

이름	타입	설명
RETARGETING	`String`	리타게팅
CONVERSION	`String`	전환
BOTH	`String`	리타게팅과 전환 모두

AssetGroup

이름	타입	설명
assetGroupId	`Long`	슬라이드 번호
ordering	`Integer`	슬라이드 정렬 순서
image	`Image`	슬라이드 이미지
title	`String`	제목
description	`String`	홍보 문구
priceAmount	`String`	가격 정보
priceCurrencyCode	`Enum: CurrencyCode`	통화 정보
discountedPriceAmount	`String`	할인 가격 정보
rspvLandingUrl	`String`	대표 랜딩 URL
pcLandingUrl	`String`	PC 랜딩 URL
mobileLandingUrl	`String`	모바일 랜딩 URL

B

BaseAd

이름	타입	설명
adGroup	`AdGroup`	광고그룹
campaign	`Campaign`	캠페인
operation	`Enum: Operation`	연산 종류 `ONLY`: ONLY `MINUS`: MINUS `AND`: AND 참고: 연산 및 반응 종류 정책
firstIndicator	`Enum: Indicator`	첫 번째 반응 종류 참고: 연산 및 반응 종류 정책
secondIndicator	`Enum: Indicator`	두 번째 반응 종류 `PLAY`: 영상 플레이 `CLICK`: 클릭 `CONVERSION`: 전환 참고: 연산 및 반응 종류 정책
messageAd	`MessageAd`	메시지

BidStrategyTarget

이름	타입	설명
type	`Enum`	자동 입찰 옵션 `TARGET_CPC`: CPC 비용 목표 `TARGET_CPA`: CPA 비용 목표 `TARGET_ROAS`: ROAS 목표 `MAXIMIZE_CONVERSION_VALUE`: 전환 가치 최대화
value	`Long`	목표 값 자동입찰 방식의 목표(비용 또는 ROAS) 값, `type`이 `MAXIMIZE_CONVERSION_VALUE`인 경우 `0`으로 지정

BusinessForm

이름	타입	설명
id	`Long`	모먼트에 연동된 비즈니스폼 ID 메시지 소재 생성시 필요한 ID
adAccountId	`Long`	광고계정 번호
bizFormId	`Long`	비즈니스폼 번호 소재 생성 및 수정시 `landingInfo.bizFormId`에 해당 값으로 설정
title	`String`	비즈니스폼 제목
flowType	`Enum`	비즈니스폼 유형 `APPLY`: 바로응모형 `SURVEY`: 설문조사형 `RESERV`: 신청예약형
linkedDate	`String`	모먼트에 연동된 일시 (`yyyy-MM-dd'T'HH:mm:ss` 형식)
beginDate	`String`	비즈니스폼 시작일시 (`yyyy-MM-dd'T'HH:mm:ss` 형식)
endDate	`String`	비즈니스폼 종료일시 (`yyyy-MM-dd'T'HH:mm:ss` 형식)

Button

이름	타입	설명
title	`String`	버튼명
pcLandingUrl	`String`	버튼 PC 랜딩 URL, 사용 시 PC 카카오톡에서 별도의 URL로 랜딩 `http://` 또는 `https://` 형식의 접속 가능한 URL 필요
mobileLandingUrl	`String`	버튼 모바일 랜딩 URL `http://` 또는 `https://` 형식의 접속 가능한 URL 필요
channelPostId	`Long`	소식 ID 랜딩 유형이 소식 랜딩(`CHANNEL_POST`)일 때 사용 채널 소식 목록 조회 API로 조회되는 소식 ID 필요
channelCouponId	`Long`	쿠폰 ID 랜딩 유형이 쿠폰 랜딩(`CHANNEL_COUPON`)일 때 사용 쿠폰 목록 조회 API로 조회되는 쿠폰 ID 필요
bizFormId	`Long`	비즈니스폼 ID 랜딩 유형이 비즈니스폼 랜딩(`BIZ_FORM`)일 때 사용 비즈니스폼 목록 조회 API로 조회되는 비즈니스폼 ID 필요
adViewId	`Long`	애드뷰 ID 랜딩 유형이 애드뷰 랜딩(`AD_VIEW`)일 때 사용 애드뷰 목록
webembedChannelUrl	`String`	웹임베드 채널 URL 웹임베드 채널에 설정된 URL 노출

ButtonAssetGroup

이름	타입	설명
ordering	`Long`	정렬순번
title	`String`	버튼명
rspvLandingUrl	`String`	반응형 랜딩 URL
mobileLandingUrl	`String`	모바일 랜딩 URL
pcLandingUrl	`String`	PC 랜딩 URL
adViewId	`Long`	애드뷰 ID
bizFormId	`Long`	비즈니스폼 ID
channelPostId	`Long`	채널 소식 ID
channelCouponId	`Long`	채널 쿠폰 ID
thumbnail	`String`	썸네일
highlighted	`Boolean`	하이라이트 버튼 사용
landingType	`Enum`	랜딩 유형 `LANDING_URL`: URL `CHANNEL_COUPON`: 쿠폰 `CHANNEL_POST`: 소식 `AD_VIEW`: 애드뷰 `BIZ_FORM`: 비즈니스폼

C

Carousel

이름	타입	설명
title	`String`	캐러셀 타이틀
description	`String`	캐러셀 홍보 문구
imageUrl	`String`	캐러셀 홍보 영역 이미지 URL
pcLandingUrl	`String`	캐러셀 PC 랜딩 URL, 사용 시 PC 카카오톡에서 별도의 URL로 랜딩 `http://` 또는 `https://` 형식의 접속 가능한 URL 필요
mobileLandingUrl	`String`	캐러셀 모바일 랜딩 URL `http://` 또는 `https://` 형식의 접속 가능한 URL 필요
shareFlag	`Boolean`	캐러셀 공유하기 사용 여부 `true`: 공유하기 사용 `false`: 공유하기 사용 안함 중요: `ageVerification` 값이 `true`인 경우 사용 불가
buttons	`Button[]`	캐러셀 버튼 정보
priceAmount	`Integer`	캐러셀 가격 정보
priceCurrencyCode	`Enum: CurrencyCode`	캐러셀 통화 정보
discountedPriceAmount	`Integer`	캐러셀 할인 가격 정보, `priceAmount` 보다 1% 이상 작은 값 필요

Campaign

이름	타입	설명
id	`Long`	캠페인 번호
adAccountId	`Long`	광고 계정 번호
name	`String`	캠페인 이름
campaignTypeGoal	`CampaignTypeGoal`	캠페인 유형 X 목표
objective	`Objective`	광고 목표 설정
dailyBudgetAmount	`Long`	일 예산 입력하지 않은 경우 예산 "한도 없음"과 같은 의미
config	`Enum: Config`	캠페인 상태
isDailyBudgetAmountOver	`Boolean`	일 예산 초과 여부
statusDescription	`String`	캠페인의 게재와 관련된 현재 상태
trackId	`String`	전환추적설정 번호

Enum: CampaignType

값	설명
TALK_BIZ_BOARD	카카오 비즈보드
DISPLAY	디스플레이
VIDEO	동영상
PRODUCT_CATALOG	상품 카탈로그
TALK_BIZ_BOARD_RESERVED	카카오 비즈보드 CPT
FOCUS_FULL_VIEW	포커스 풀뷰
PC_TALK_RICH_POP	리치팝 올데이
PROFILE_FULL_VIEW	프로필 풀뷰
PC_TALK_BOTTOM	포커스 보드
DAUM_SHOPPING	다음쇼핑
TALK_CHANNEL	카카오톡 채널
PERSONAL_MESSAGE	개인화 메시지

CampaignTypeGoal

이름	타입	설명	필수
campaignType	`Enum: CampaignType`	캠페인 유형	O
goal	`Enum: Goal`	캠페인 목표	O

CategoryData

이름	타입	설명
id	`String`	카테고리 코드 광고그룹 생성 및 수정 시, "targeting.ufoInterests(관심사)" 또는 "targeting.ufoBusinessTypes(업종)"의 값으로 사용
name	`String`	카테고리 이름
children	`CategoryData[]`	하위 카테고리 데이터

ChannelCoupon

이름	타입	설명
id	`Long`	쿠폰 ID
title	`String`	쿠폰 제목
content	`String`	쿠폰 내용
statusCode	`String`	쿠폰의 상태
permalink	`String`	쿠폰 링크
entryImage	`EntryImage`	쿠폰 상세 이미지
createdAt	`String`	쿠폰 생성일시

ChannelCoupons

이름	타입	설명
id	`String`	채널 쿠폰 ID

ChannelPost

이름	타입	설명
id	`Long`	소식 번호
title	`String`	제목
status	`String`	상태
adult	`Boolean`	연령인증 소식 여부 `true`: 연령인증 소식 `false`: 일반 소식
permalink	`String`	소식 URL
createdDate	`String`	소식 생성일
publishedDate	`String`	소식 발행 날짜

Clip

이름	타입	설명
id	`Long`	클립 ID
duration	`Double`	영상 길이
thumbnailUrl	`String`	썸네일 이미지 URL
isOpen	`Boolean`	공개 클립인지 여부

ClipLink

이름	타입	설명
id	`Long`	클립링크 ID
displayTitle	`String`	클림링크 제목
playCount	`Integer`	영상 재생 횟수
likeCount	`Integer`	좋아요 개수
commentCount	`Integer`	댓글 개수
createTime	`Datetime`	생성 시각
updateTime	`Datetime`	업데이트 시각
clip	`Clip`	영상 상세 정보
linkUrl	`String`	클립링크 링크

Enum: Code (네트워크 게재지면 하위 목록 정보)

값	설명
IAB1	예술 및 엔터테인먼트
IAB10	홈/정원
IAB11	법, 정부와 정치
IAB12	언론
IAB13	개인금융
IAB14	사회
IAB15	과학
IAB16	애완동물
IAB17	스포츠
IAB18	스타일/패션
IAB19	컴퓨터/기술
IAB2	자동차
IAB20	여행
IAB21	부동산
IAB22	쇼핑
IAB23	종교
IAB24	미분류
IAB3	산업
IAB4	직업
IAB5	교육
IAB6	가족 및 육아
IAB7	건강 및 운동
IAB8	식음료
IAB9	취미

Enum: Code (게재지면 카카오톡 하위 섹션 카테고리 목록 정보)

값	설명
KKO99-1	채팅지면 노출
KKO99-2	오픈채팅지면 노출
KKO99-4	친구지면 노출
KKO99-5	친구소식지면 노출
KKO99-6	숏폼지면 노출
KKO99-7	기타지면 노출
KKO99-8	카카오쇼핑지면 노출

CohortTargeting

이름	타입	설명
id	`Long`	광고 반응 타겟 번호
name	`String`	광고반응 타겟 이름
cohortId	`Long`	내 광고 반응 타겟 번호
inclusionType	`Enum: InclusionType`	포함 여부

Company

이름	타입	설명
businessRegistrationNumber	`String`	사업자등록번호
name	`String`	회사명

Enum: Config

값	설명
ON	활성화
OFF	비활성화
DEL	삭제

CouponBook

이름	타입	설명
couponBookTitleType	`Enum`	쿠폰 유형 `DISCOUNT_PRICE`: 할인금액 `DISCOUNT_RATE`: 할인율 `FREE_SHIPPING`: 배송비 할인 `FREE_GIFT`: 무료 증정 `UPGRADE`: 업그레이드
couponBookTitle	`String`	쿠폰 타이틀, 쿠폰 유형(`couponBookTitleType`) 값에 따라 입력 `DISCOUNT_PRICE`: 8자리 이하 숫자 `DISCOUNT_RATE`: 2자리 이하 숫자 `FREE_SHIPPING`: 입력 불가 `FREE_GIFT`, `UPGRADE`: 메시지 유형별 상이 중요: 기본텍스트, 캐러셀 커머스, 캐러셀 피드는 최대 7자, 와이드이미지, 와이드리스트, 프리미엄 동영상은 최대 12자
title	`String`	쿠폰 상세 설명 중요: 기본텍스트, 캐러셀 커머스, 캐러셀 피드는 최대 12자, 와이드이미지, 와이드리스트, 프리미엄 동영상은 최대 18자
pcLandingUrl	`String`	쿠폰 PC 랜딩 URL, 사용 시 PC 카카오톡에서 별도의 URL로 랜딩 `http://` 또는 `https://` 형식의 접속 가능한 URL 필요
mobileLandingUrl	`String`	쿠폰 모바일 랜딩 URL `http://` 또는 `https://` 형식의 접속 가능한 URL 필요

CouponBookAssetGroup

이름	타입	설명
couponBookTitle	`String`	쿠폰북 타이틀
couponBookTitleType	`String`	쿠폰북 타이틀 타입
title	`String`	쿠폰북 상세 설명
channelCoupons	`ChannelCoupons`	채널 쿠폰 정보
mobileLandingUrl	`String`	모바일 랜딩 URL
pcLandingUrl	`String`	PC 랜딩 URL
ordering	`Integer`	정렬 순서

Enum: CurrencyCode

값	설명
KRW	₩
USD	$
JPY	¥
EUR	€

Enum: CustomerFileStatus

값	설명
WAITING	고객파일 모수추출 대기중
COMPLETE	모수추출 완료
DELETE	삭제 또는 삭제중인 상태
ERROR	그 외 비정상적인 경우
MODIFYING	수정된 모수 준비중

CustomerFileTargeting

이름	타입	설명
id	Long	고객파일 등록 번호
inclusionType	`Enum: InclusionType`	포함 여부
name	String	고객파일 이름
status	`Enum: CustomerFileStatus`	고객파일의 처리 상태

CustomTargeting

이름	타입	설명
type	`Enum`	맞춤타겟 유형 `PLUSFRIENDGROUP`: 친구그룹 `PLUSFRIEND`: 카카오톡 채널친구 `COHORT`: 광고반응타겟 `SYNCAPP`: 카카오 로그인 사용자
referenceId	`String`	맞춤타겟 id
inclusionType	`Enum`	포함 제외 여부 `INCLUDE`: 포함 `EXCLUDE`: 제외
name	`String`	이름

D

Enum: DatePreset

값	설명
TODAY	오늘, 00시 부터 현재 전 시간까지
YESTERDAY	어제, 00시 부터 24시 까지
LAST_7DAY	어제 24시까지 7일의 기간, 오늘 미포함
LAST_14DAY	어제 24시까지 14일의 기간, 오늘 미포함
LAST_30DAY	어제 24시까지 30일의 기간, 오늘 미포함
THIS_MONTH	이번달, 1일부터 오늘까지 기간
LAST_MONTH	지난달, 1일부터 마지막일까지 기간

Depth2Location: 시 / 군 / 구 이름

전체 목록은 행정구역 타입 정보 CSV 파일(다운로드) 내 Depth2Location 표 참고

이름	타입	설명
value	`String`	시/군/구 키(Key)
description	`String`	설명
depth1Name	`String`	시/도 이름
depth2Name	`String`	시/군/구 이름
deprecated	`Boolean`	행정구역 삭제 여부, 값이 `true`인 경우 삭제된 행정구역이며 삭제되지 않은 경우 필드 미포함

Depth3Location: 동 / 읍 / 면 이름

전체 목록은 행정구역 타입 정보 CSV 파일(다운로드) 내 Depth3Location 표 참고

이름	타입	설명
value	`String`	동/읍/면 키(Key)
description	`String`	설명
depth1Name	`String`	시/도 이름
depth2Name	`String`	시/군/구 이름
depth3Name	`String`	동/읍/면 이름
deprecated	`Boolean`	행정구역 삭제 여부, 값이 `true`인 경우 삭제된 행정구역이며 삭제되지 않은 경우 필드 미포함

Demographics

이름	타입	설명
genderType	`Enum`	성별 전체 선택 유형 `ALL`: 전체 선택(기본값) `NOT_ALL`: 부분 선택
genders	`String[]`	성별 `M`: 남자 `F`: 여자 중요: `genderType`이 `NOT_ALL`인 경우만 요청 가능
ageType	`Enum`	연령 전체 선택 유형 `ALL`: 전체 선택 `NOT_ALL`: 부분 선택
ages	`String[]`	연령대 `15`: 15~19 `20`: 20~24 `25`: 25~29 `30`: 30~34 `35`: 35~39 `40`: 40~44 `45`: 45~49 `50`: 50~54 `55`: 55~59 `60`: 60~64 `65`: 65~69 `70`: 70 이상 중요: `ageType`이 `NOT_ALL`인 경우만 요청 가능
locationType	`Enum`	지역 선택 유형 `ALL`: 전체(국내, 해외) `Domestic`: 국내만 `AREA`: 지역 선택 중요: `locationType`이 `AREA`인 경우만 요청 가능
depth1Locations	`Depth1Location[]`	데모그래픽 > 행정구역 > 시/도 시/도 보기 참고 중요: `locationType`이 `AREA`인 경우만 요청 가능 중요: `depth1Locations`, `depth2Locations`, `depth3Locations` 모두 또는 개별 요청 가능
depth2Locations	`Depth2Location[]`	데모그래픽 > 행정구역 > 시/군/구 시/군/구 보기 참고 중요: `locationType`이 `AREA`인 경우만 요청 가능 중요: `depth1Locations`, `depth2Locations`, `depth3Locations` 모두 또는 개별 요청 가능
depth3Locations	`Depth3Location[]`	데모그래픽 > 행정구역 > 동/읍/면 동/읍/면 보기 참고 중요: `locationType`이 `AREA`인 경우만 요청 가능 중요: `depth1Locations`, `depth2Locations`, `depth3Locations` 모두 또는 개별 요청 가능

Enum: DeviceType

값	설명
ANDROID	안드로이드
IOS	iOS
PC	PC

Enum: Dimension (보고서 조회 레벨 기준)

값	설명
AD_ACCOUNT	`ad_account_id`: 광고계정
CAMPAIGN	`campaign_id`: 캠페인
AD_GROUP	`ad_group_id`: 광고그룹
CREATIVE	`creative_id`: 소재

Enum: Dimension (보고서 조회 기준)

값	설명
CREATIVE_FORMAT	소재 형식 소재 형식: Display `IMAGE_BANNER`: 이미지 배너 `IMAGE_NATIVE`: 이미지 네이티브 `VIDEO_NATIVE`: 비디오 네이티브 `IMAGE_BOX`: 이미지 박스 `CATALOG_DYNAMIC`: 다이나믹 카탈로그 `SERVICE_CONTENT`: 콘텐츠 소재 형식: Message `BASIC_TEXT_MESSAGE`: 기본 텍스트 `WIDE_LIST_MESSAGE`: 와이드 리스트 `WIDE_MESSAGE`: 와이드 이미지 `CAROUSEL_COMMERCE_MESSAGE`: 캐러셀 커머스 `CAROUSEL_FEED_MESSAGE`: 캐러셀 피드 `PREMIUM_VIDEO_MESSAGE`: 프리미엄 동영상 `CATALOG_MESSAGE`: 카탈로그 `SPOTLIGHT_MESSAGE`: 스포트라이트
PLACEMENT	게재지면 `total`: total `KAKAO_TALK`: 카카오톡 `DAUM`: 다음 `KAKAO_STORY`: 카카오스토리 `KAKAO_SERVICE`: 카카오서비스 `NETWORK`: 네트워크
AGE	(구) 연령 `total`: total `15`: 15~19 `20`: 20~25 `26`: 26~30 `31`: 31~40 `41`: 41~50 `51`: 51~70 `-1`: 알 수 없음
AGE_BAND	연령 `total`: total `15`: 15~19 `20`: 20~25 `25`: 25~29 `30`: 30~34 `35`: 35~39 `40`: 40~44 `45`: 45~49 `50`: 50~54 `55`: 55~59 `60`: 60~64 `65`: 65~69 `70`: 70이상 `0`: 알 수 없음
GENDER	성별 `total`: total `M`: 남 `F`: 여 `N`: 알 수 없음
AGE_GENDER	(구) 연령+성별
AGE_BAND_GENDER	연령+성별
LOCATION	지역 `total`: total `A`: 강원특별자치도 `B`: 경기도 `C`: 경상남도 `D`: 경상북도 `E`: 광주광역시 `F`: 대구광역시 `G`: 대전광역시 `H`: 부산광역시 `I`: 서울특별시 `Q`: 세종특별자치시 `J`: 울산광역시 `K`: 인천광역시 `R`: 전남광주통합특별시 `L`: 전라남도 `M`: 전북특별자치도 `N`: 제주특별자치도 `O`: 충청남도 `P`: 충청북도 `Z`: 해외 `U`: 알 수 없음
DEVICE_TYPE	디바이스 `total`: total `PC`: PC `Android`: Android `iOS`: iOS `N/A`: 기타
HOUR	시간대 `total`: total `00`: 00:00~00:59 `01`: 01:00~01:59 `02`: 02:00~02:59 `03`: 03:00~03:59 `04`: 04:00~04:59 `05`: 05:00~05:59 `06`: 06:00~06:59 `07`: 07:00~07:59 `08`: 08:00~08:59 `09`: 09:00~09:59 `10`: 10:00~10:59 `11`: 11:00~11:59 `12`: 12:00~12:59 `13`: 13:00~13:59 `14`: 14:00~14:59 `15`: 15:00~15:59 `16`: 16:00~16:59 `17`: 17:00~17:59 `18`: 18:00~18:59 `19`: 19:00~19:59 `20`: 20:00~20:59 `21`: 21:00~21:59 `22`: 22:00~22:59 `23`: 23:00~23:59

Dimensions

보고서 조회 레벨과 조회 기준의 값을 담은 객체입니다. 조회 레벨 기준과 조회 기준에 따라 응답에 포함되는 키와 값이 달라집니다.

아래는 광고계정 레벨에서 소재 형식을 기준으로 조회한 응답의 예입니다.

{
  "creative_format": "IMAGE BANNER",
  "ad_account_id": "1234"
}

E

EntryImage

이름	타입	설명
type	`String`	미디어 타입, `image`, `video` 등
url	`String`	이미지 URL
thumbnail	`String`	섬네일 이미지
previewImage	`String`	`video` 타입인 경우 섬네일 이미지
playUrl	`String`	`video` 타입인 경우 재생 URL
name	`String`	이름

F

FriendPeriod

이름	타입	설명
startDate	`String`	시작일, `yyyy-MM-dd` 형식
endDate	`String`	종료일, `yyyy-MM-dd` 형식

G

Enum: Goal

값	설명
VISITING	방문
CONVERSION	전환
REACH	도달
VIEW	조회

GroupInfo

이름	타입	설명
title	`String`	내용
hash	`String`	그룹 `hash` 값
ordering	`Integer`	정렬 순서
isHighlighted	`Boolean`	버튼 하이라이트 여부
landingType	`Enum`	그룹 랜딩 유형 `CHANNEL_POST`: 소식 랜딩 `CHANNEL_COUPON`: 쿠폰 랜딩 `AD_VIEW`: 애드뷰 `BIZ_FORM`: 비즈니스폼 `LANDING_URL`: URL 랜딩
image	`ImageInfo`	그룹 이미지 정보
pcLandingUrl	`String`	PC 랜딩URL
mobileLandingUrl	`String`	모바일 랜딩URL
channelPostId	`Long`	그룹 랜딩으로 선택된 채널 소식 ID
channelPostTitle	`String`	그룹 랜딩으로 선택된 채널 소식 내용
channelCouponId	`Long`	그룹 랜딩으로 선택된 채널 쿠폰 ID
channelCouponTitle	`String`	그룹 랜딩으로 선택된 채널 쿠폰 제목
adViewId	`Long`	그룹 랜딩으로 선택된 애드뷰 ID
bizFormId	`Long`	그룹 랜딩으로 선택된 비즈니스폼 ID

I

Image

이름	타입	설명
size	`Long`	파일 사이즈
url	`String`	이미지 URL
fileName	`String`	이미지 파일명
width	`Integer`	넓이
height	`Integer`	높이
mimeType	`String`	Mime 유형

ImageInfo

이름	타입	설명
url	`String`	이미지 URL
imageWidth	`Integer`	이미지 너비
imageHeight	`Integer`	이미지 높이
fileSize	`Long`	파일 사이즈
fileName	`String`	파일명

Enum: InclusionType

값	설명
INCLUDE	포함
EXCLUDE	제외

Enum: Indicator

값	설명
PLAY	영상 플레이
CLICK	클릭
CONVERSION	전환
OPEN	OPEN

IntroCarousel

이름	타입	설명
title	`String`	인트로 타이틀(최대: 25자)
description	`String`	인트로 홍보 문구(최대: 50자)
imageUrl	`String`	인트로 홍보 영역 이미지 URL
pcLandingUrl	`String`	인트로 PC 랜딩 URL, 사용 시 PC 카카오톡에서 별도의 URL로 랜딩 `http://` 또는 `https://` 형식의 접속 가능한 URL 필요
mobileLandingUrl	`String`	인트로 모바일 랜딩 URL `http://` 또는 `https://` 형식의 접속 가능한 URL 필요

Item

이름	타입	설명
imageUrl	`String`	아이템 이미지 URL, 메시지 내 포함할 홍보 이미지 URL 중요: 기본텍스트, 와이드 이미지, 와이드 리스트 아이템에서 카카오톡 채널 동영상을 사용하는 경우, `imageUrl` 대신 `video.mediaId` 만 지정해서 요청(참고: 카카오톡 채널 동영상 요청 시 본문 구성)
title	`String`	아이템 홍보 문구
landing	`Landing[]`	랜딩 정보

ItemAssetGroup

이름	타입	설명
landingType	`Enum`	랜딩 유형 `LANDING_URL`: URL `CHANNEL_COUPON`: 쿠폰 `CHANNEL_POST`: 소식
ordering	`Integer`	정렬 순번
title	`String`	홍보문구 또는 타이틀 아이템 에셋 그룹 내 홍보문구는 와이드 리스트, 캐러셀 커머스(인트로카드 제외), 캐러셀 피드, 카탈로그 유형에 응답
description	`String`	캐러셀 피드형 홍보문구
priceAmount	`String`	가격 정보 캐러셀 커머스형 캐러셀 내 가격 정보
priceCurrencyCode	`Enum: CurrencyCode`	통화 정보
discountedPriceAmount	`String`	할인 가격 정보 캐러셀 커머스형 캐러셀 내 가격 정보
mobileLandingUrl	`String`	모바일 랜딩 URL 랜딩 유형이 LANDING_URL (URL) 일경우 응답
pcLandingUrl	`String`	PC 랜딩 URL 랜딩 유형이 LANDING_URL (URL) 일경우 응답
image	`Image`	이미지 소재 아이템 에셋 그룹 내 Image는 와이드 이미지, 와이드 리스트, 캐러셀 커머스(인트로카드 제외), 캐러셀 피드, 카탈로그 유형에 응답
thumbnail	`Thumbnail`	대표 이미지

L

Landing

이름	타입	설명
pcLandingUrl	`String`	PC 랜딩 URL
mobileLandingUrl	`String`	모바일 랜딩 URL
webembedChannelUrl	`String`	웹임베드 랜딩 URL
channelPostId	`Long`	채널 소식 ID
channelCouponId	`Long`	채널 쿠폰 ID

LandingInfo

이름	타입	설명
landingType	`Enum`	랜딩 유형 `PF_BOT`: 챗봇 `AD_VIEW`: 애드뷰 `MESSAGE`: 메시지 `CHANNEL_WEBVIEW`: 채널웹뷰 `BIZ_FORM`: 비즈니스폼 `BIZ_FORM_PLUS`: 비즈니스폼+ `PAY_BUY`: 카카오페이 구매
profileId	`String`	카카오톡 채널 프로필 ID 중요: `landingType`(랜딩 유형)이 `PF_BOT`(챗봇) 또는 `CHANNEL_WEBVIEW`(채널웹뷰)인 경우 사용 참고: 카카오톡 채널 프로필 목록 조회 API로 조회한 카카오톡 채널 프로필 ID를 요청
action	`String`	키워드 중요: `landingType`(랜딩 유형)이 `PF_BOT`(챗봇)인 경우 사용
adViewItem	`AdViewItem`	애드뷰 객체 중요: `landingType`(랜딩 유형)이 `AD_VIEW`(애드뷰)인 경우 사용
url	`String`	URL 중요: `landingType`(랜딩 유형)이 `CHANNEL_WEBVIEW`(채널웹뷰)인 경우 사용
bizFormId	`Long`	비즈니스폼 번호 중요: `landingType`(랜딩 유형)이 `BIZ_FORM`(비즈니스폼)인 경우 사용
bizFormplusId	`Long`	비즈니스폼+ 번호 중요: `landingType`(랜딩 유형)이 `BIZ_FORM_PLUS`(비즈니스폼+)인 경우 사용
channelPostId	`Long`	채널 소식 ID 중요: `landingType`(랜딩 유형)이 `CHANNEL_POST`(채널 소식)인 경우 사용
shopKey	`String`	카카오페이 구매 상점 키 중요: `landingType`(랜딩 유형)이 `PAY_BUY`(카카오페이 구매)인 경우 사용
productId	`String`	카카오페이 구매 상품 ID 중요: `landingType`(랜딩 유형)이 `PAY_BUY`(카카오페이 구매)인 경우 사용

Location

전체 목록은 행정구역 타입 정보 CSV 파일(다운로드) 내 Depth1Location 표 참고

이름	타입	설명
value	`String`	시/도 Key
description	`String`	설명
depth1Name	`String`	시/도 이름
deprecated	`Boolean`	행정구역 삭제 여부, 값이 `true`인 경우 삭제된 행정구역이며 삭제되지 않은 경우 필드 미포함

M

Enum: MemberType

값	설명
MASTER	마스터 권한
MEMBER	멤버 권한

Message

메시지 유형(type)별 필수 파라미터 정보는 메시지 유형별 구성 요소 참고

이름	타입	설명
type	`Enum`	메시지 유형(지정 필수) `BASIC_TEXT_MESSAGE`: 기본 텍스트 `WIDE_MESSAGE`: 와이드 이미지 `WIDE_LIST_MESSAGE`: 와이드 리스트 `CAROUSEL_COMMERCE_MESSAGE`: 캐러셀 커머스형 `CAROUSEL_FEED_MESSAGE`: 캐러셀 피드형 `CATALOG_MESSAGE`: 카탈로그 `SPOTLIGHT_MESSAGE`: 스포트라이트
title	`String`	메시지 홍보 문구
items	`Item[]`	아이템 정보
buttons	`Button[]`	버튼 정보
couponBook	`CouponBook[]`	쿠폰 정보
introCarousel	`IntroCarousel`	인트로 정보
carousels	`Carousel[]`	캐러셀 정보
catalog	`Catalog[]`	카탈로그 정보
buttonTitle	`String`	스포트라이트 메시지 버튼 이름
landingUrl	`String`	스포트라이트 메시지 랜딩 URL
adFlag	`Boolean`	광고성 메시지 `true`: 광고성 메시지 `false`: 정보성 메시지
shareFlag	`Boolean`	공유하기 사용 여부 `true`: 공유하기 사용 `false`: 공유하기 사용 안함 중요: 연령인증 필요 메시지 여부(`ageVerification`) 값이 `true`인 경우 사용 불가

MessageAd

이름	타입	설명
id	`String`	메시지 소재 ID
name	`String`	메시지 소재명
opStatus	`Enum: Status[]`	메시지 상태

MessageElement

이름	타입	설명
id	`Long`	메시지 소재 ID
adAccountId	`Long`	광고계정 ID
profileId	`String`	카카오톡 채널 프로필 ID
profileName	`String`	카카오톡 채널 프로필명
name	`String`	메시지 소재명
shareFlag	`Boolean`	공유하기
adFlag	`Boolean`	광고성 메시지
creativeFormat	`String`	메시지 소재 유형 `BASIC_TEXT_MESSAGE`: 기본 텍스트 `WIDE_MESSAGE`: 와이드 이미지 `WIDE_LIST_MESSAGE`: 와이드 리스트 `CAROUSEL_COMMERCE_MESSAGE`: 캐러셀커머스 `CAROUSEL_FEED_MESSAGE`: 캐러셀피드 `CATALOG_MESSAGE`: 카탈로그
title	`String`	홍보문구 또는 타이틀 소재 유형별 노출 위치가 상이함 `BASIC_TEXT_MESSAGE`: 기본 텍스트 `WIDE_MESSAGE`: 와이드 이미지 `WIDE_LIST_MESSAGE`: 와이드 리스트 `CAROUSEL_COMMERCE_MESSAGE`: 캐러셀커머스 `CAROUSEL_FEED_MESSAGE`: 캐러셀 피드 `CATALOG_MESSAGE`: 카탈로그
description	`String`	캐러셀 커머스형 인트로 카드 홍보문구
image	`Image`	이미지 소재 기본 텍스트 (BASIC_TEXT_MESSAGE) 유형과 CAROUSEL_COMMERCE_MESSAGE(캐러셀커머스) 유형 인트로 카드에 응답됨
buttonAssetGroups	`ButtonAssetGroup`	버튼 항목
itemAssetGroups	`ItemAssetGroup`	리스트 항목 `WIDE_MESSAGE`: 와이드 이미지 `WIDE_LIST_MESSAGE`: 와이드 리스트 `CAROUSEL_COMMERCE_MESSAGE`: 캐러셀커머스 `CAROUSEL_FEED_MESSAGE`: 캐러셀 피드 `CATALOG_MESSAGE`: 카탈로그
thumbnailUrl	`String`	썸네일 이미지 URL
csInfo	`String`	고객센터 전화번호
couponBookAssetGroups	`CouponBookAssetGroup`	쿠폰북 항목
createdDate	`String`	메시지 소재 생성일 `yyyy-MM-dd'T'HH:mm:ss` 형식
lastModifiedDate	`String`	메시지 소재 마지막 수정일 `yyyy-MM-dd'T'HH:mm:ss` 형식
hasIntro	`Boolean`	캐러셀 커머스 인트로 카드 유무
introLandingType	`String`	캐러셀 커머스 인트로 카드 랜딩 타입
introMobileLandingUrl	`String`	캐러셀 커머스 인트로 카드 모바일 랜딩 URL
introPcLandingUrl	`String`	캐러셀 커머스 인트로 카드 pc 랜딩 URL

MessageSendingInfo

이름	타입	설명
contractCount	`Integer`	구매발송수 예상 발송 모수보다 작게 설정할 수 없음
longTerm	`Boolean`	전체발송 후 새 친구에게도 보내기 `true`: 보내기 `false`: 보내지 않기 중요: `true`(보내기)로 설정한 경우 `schedule` 항목의 `beginDate`(시작일), `beginTime`(시작시간), `endDate`(종료일), `endTime`(종료시간)을 필수로 전달
price	`Long`	발송단가
pushAlarm	`Boolean`	푸시알림 보내지 않기 `true`: 보내지 않기 `false`: 보내기
sendRate	`Integer`	분산발송 하기 `100` `500` `1000` `1500` `2000` `0`: 분산발송 하지 않기
status	`Enum`	메시지 발송 상태 `READY`: 발송 대기 `SENDING`: 발송중 `PAUSE`: 발송중지 `FINISHED`: 발송완료 `STOPPED`: 즉시종료 `EXPIRED`: 기간만료 `SAVE`: 저장
syncStatus	`Enum`	발송시스템과의 연동 상태 `READY`: 연동 대기 `SUCCESS`: 연동 성공 `FAILED`: 연동 실패
ageVerification	`Boolean`	연령인증 메시지 여부 `true`: 연령인증 메시지 `false`: 일반 메시지
startedAT	`String`	발송 시작 시간
finishedAT	`String`	발송 완료 시간

Metrics

보고서 지표와 집계 값을 담은 객체입니다. 지표 그룹에 안내된 상세 지표 이름을 키로, 해당 지표의 집계 결과를 값으로 제공합니다. 요청한 지표 그룹에 따라 응답에 포함되는 키가 달라집니다.

아래는 BASIC 지표 그룹으로 조회한 응답의 예입니다.

{
  "imp": 4,
  "click": 0,
  "ctr": 0.0,
  "cost": 0.0
}

Enum: MetricsGroup

값	설명
BASIC	기본지표 `imp`: 노출수 `click`: 클릭수 `ctr`: 클릭률 `cost`: 비용 `video_play_3s`: 재생수 `vtr`: 재생률
ADDITION	추가지표 `reach`: 도달수 `cost_per_imp`: 노출당 비용 `cost_per_click`: 클릭당 비용 `cost_per_reach`: 도달당 비용 `cost_per_video_play_3s`: 재생당비용
MESSAGE	메시지 기본지표 `msg_send`: 발송 수 `msg_open`: 열람수 `msg_click`: 전체 클릭수 `cost`: 비용 `msg_send_fail`: 발송 실패수
MESSAGE_ADDITION	메시지 추가지표 `cost_per_msg_send`: 발송당 비용 `cost_per_msg_open`: 열람당 비용 `cost_per_msg_click`: 전체 클릭당 비용 `msg_open_rate`: 열람률 `msg_click_rate`: 메시지 클릭률
PIXEL_SDK_CONVERSION	픽셀 & SDK 전환 지표 `conv_cmpt_reg_1d`: 가입 완료 (1일) `conv_cmpt_reg_7d`: 가입 완료 (7일) `conv_view_cart_1d`: 장바구니 보기 (1일) `conv_view_cart_7d`: 장바구니 보기 (7일) `conv_purchase_1d`: 구매 (1일) `conv_purchase_7d`: 구매 (7일) `conv_purchase_p_1d`: 구매 금액 (1일) `conv_purchase_p_7d`: 구매 금액 (7일) `conv_purchase_p_per_cost_1d`: ROAS (1일) `conv_purchase_p_per_cost_7d`: ROAS (7일) `conv_estimated_purchase_p_per_cost_1d`: 추정 ROAS (1일) `conv_estimated_purchase_p_per_cost_7d`: 추정 ROAS (7일) `conv_participation_1d`: 잠재 고객 (1일) `conv_participation_7d`: 잠재 고객 (7일) `conv_signup_1d`: 서비스 신청 (1일) `conv_signup_7d`: 서비스 신청 (7일) `conv_app_install_1d`: 앱 설치 (1일) `conv_app_install_7d`: 앱 설치 (7일) `cost_per_conv_cmpt_reg_1d`: 회원 가입당 비용 (1일) `cost_per_conv_cmpt_reg_7d`: 회원 가입당 비용 (7일) `conv_cmpt_reg_1d_rate`: 회원 가입률 (1일) `conv_cmpt_reg_7d_rate`: 회원 가입률 (7일) `conv_add_to_wishlist_1d`: 관심상품추가 (1일) `cost_per_conv_add_to_wishlist_1d`: 관심상품추가당 비용 (1일) `conv_add_to_wishlist_1d_rate`: 관심상품추가율 (1일) `conv_add_to_wishlist_7d`: 관심상품추가 (7일) `cost_per_conv_add_to_wishlist_7d`: 관심상품추가당 비용 (7일) `conv_add_to_wishlist_7d_rate`: 관심상품추가율 (7일) `conv_add_to_cart_1d`: 장바구니추가(1일) `cost_per_conv_add_to_cart_1d`: 장바구니추가당 비용(1일) `conv_add_to_cart_1d_rate`: 장바구니추가율(1일) `conv_add_to_cart_7d`: 장바구니추가(7일) `cost_per_conv_add_to_cart_7d`: 장바구니추가당 비용(7일) `conv_add_to_cart_7d_rate`: 장바구니추가율(7일) `cost_per_conv_view_cart_1d`: 장바구니 열람당 비용 (1일) `cost_per_conv_view_cart_7d`: 장바구니 열람당 비용 (7일) `conv_view_cart_1d_rate`: 장바구니 열람률 (1일) `conv_view_cart_7d_rate`: 장바구니 열람률 (7일) `cost_per_conv_purchase_1d`: 구매당 비용 (1일) `cost_per_conv_purchase_7d`: 구매당 비용 (7일) `conv_purchase_1d_rate`: 구매율 (1일) `conv_purchase_7d_rate`: 구매율 (7일) `cost_per_conv_participation_1d`: 잠재 고객당 비용 (1일) `cost_per_conv_participation_7d`: 잠재 고객당 비용 (7일) `conv_participation_1d_rate`: 잠재 고객률 (1일) `conv_participation_7d_rate`: 잠재 고객률 (7일) `cost_per_conv_signup_1d`: 서비스 신청당 비용 (1일) `cost_per_conv_signup_7d`: 서비스 신청당 비용 (7일) `conv_signup_1d_rate`: 서비스 신청률 (1일) `conv_signup_7d_rate`: 서비스 신청률 (7일) `cost_per_conv_app_install_1d`: 앱 설치당 비용 (1일) `cost_per_conv_app_install_7d`: 앱 설치당 비용 (7일) `conv_app_install_1d_rate`: 앱 설치율 (1일) `conv_app_install_7d_rate`: 앱 설치율 (7일)
PLUS_FRIEND	카카오친구 지표 `conv_kf_pf_add_1d`: 친구 추가수 (1일) `conv_kf_pf_add_7d`: 친구 추가수 (7일) `cost_per_conv_kf_pf_add_1d`: 친구 추가 수당 비용 (1일) `cost_per_conv_kf_pf_add_7d`: 친구 추가 수당 비용 (7일) `conv_kf_pf_add_1d_rate`: 친구 추가율 (1일) `conv_kf_pf_add_7d_rate`: 친구 추가율 (7일)
VIDEO	동영상 지표 `video_play`: 재생수 `cost_per_video_play_3s`: 재생당 비용 `video_play_auto`: 자동 재생수 `video_play_touch`: 터치 재생수 `video_unmute`: 사운드 ON수 `video_play_5s`: 5초 재생수 `video_play_10s`: 10초 재생수 `video_play_15s`: 15초 재생수 `video_play_30s`: 30초 재생수 `video_play_60s`: 60초 재생수 `video_play_25p`: 25% 재생수 `video_play_50p`: 50% 재생수 `video_play_75p`: 75% 재생수 `video_play_100p`: 100% 재생수
SLIDE_CLICK	슬라이드 지표 `slide1_click`: 슬라이드1 클릭수 `slide2_click`: 슬라이드2 클릭수 `slide3_click`: 슬라이드3 클릭수 `slide4_click`: 슬라이드4 클릭수 `slide5_click`: 슬라이드5 클릭수 `slide6_click`: 슬라이드6 클릭수 `slide7_click`: 슬라이드7 클릭수 `slide8_click`: 슬라이드8 클릭수 `slide9_click`: 슬라이드9 클릭수 `slide10_click`: 슬라이드10 클릭수 `slide_others_click`: 기타 클릭수
MESSAGE_CLICK	메시지 클릭지표 `msg_click_share`: 공유버튼 클릭수 `msg_click_media`: 이미지/동영상 클릭수 `msg_click_title`: 타이틀 클릭수 `msg_click_text`: 텍스트 클릭수 `msg_play_start`: 동영상 클릭수 `msg_play_3s`: 동영상 3초 재생수 `msg_play_5s`: 동영상 5초 재생수 `msg_play_10s`: 동영상 10초 재생수 `msg_play_15s`: 동영상 15초 재생수 `msg_play_30s`: 동영상 30초 재생수 `msg_play_60s`: 동영상 60초 재생수 `msg_click_list1`: 리스트1 클릭수 `msg_click_list2`: 리스트2 클릭수 `msg_click_list3`: 리스트3 클릭수 `msg_click_list4`: 리스트4 클릭수 `msg_play_list1_start`: 리스트 1 재생수 `msg_play_list1_3s`: 리스트 1 3초 재생수 `msg_play_list1_5s`: 리스트 1 5초 재생수 `msg_play_list1_10s`: 리스트 1 10초 재생수 `msg_play_list1_15s`: 리스트 1 15초 재생수 `msg_play_list1_30s`: 리스트 1 30초 재생수 `msg_play_list1_60s`: 리스트 1 60초 재생수 `msg_play_list2_start`: 리스트 2 재생수 `msg_play_list2_3s`: 리스트 2 3초 재생수 `msg_play_list2_5s`: 리스트 2 5초 재생수 `msg_play_list2_10s`: 리스트 2 10초 재생수 `msg_play_list2_15s`: 리스트 2 15초 재생수 `msg_play_list2_30s`: 리스트 2 30초 재생수 `msg_play_list2_60s`: 리스트 2 60초 재생수 `msg_play_list3_start`: 리스트 3 재생수 `msg_play_list3_3s`: 리스트 3 3초 재생수 `msg_play_list3_5s`: 리스트 3 5초 재생수 `msg_play_list3_10s`: 리스트 3 10초 재생수 `msg_play_list3_15s`: 리스트 3 15초 재생수 `msg_play_list3_30s`: 리스트 3 30초 재생수 `msg_play_list3_60s`: 리스트 3 60초 재생수 `msg_play_list4_start`: 리스트 4 재생수 `msg_play_list4_3s`: 리스트 4 3초 재생수 `msg_play_list4_5s`: 리스트 4 5초 재생수 `msg_play_list4_10s`: 리스트 4 10초 재생수 `msg_play_list4_15s`: 리스트 4 15초 재생수 `msg_play_list4_30s`: 리스트 4 30초 재생수 `msg_play_list4_60s`: 리스트 4 60초 재생수 `msg_click_button1`: 버튼1 클릭수 `msg_click_button2`: 버튼2 클릭수 `msg_click_carousel_button1`: 캐러셀 1 버튼1 클릭수 `msg_click_carousel_button2`: 캐러셀 2 버튼1 클릭수 `msg_click_carousel_button3`: 캐러셀 3 버튼1 클릭수 `msg_click_carousel_button4`: 캐러셀 4 버튼1 클릭수 `msg_click_carousel_button5`: 캐러셀 5 버튼1 클릭수 `msg_click_carousel_button6`: 캐러셀 6 버튼1 클릭수 `msg_click_carousel_share1`: 캐러셀 1 버튼2 클릭수 `msg_click_carousel_share2`: 캐러셀 2 버튼2 클릭수 `msg_click_carousel_share3`: 캐러셀 3 버튼2 클릭수 `msg_click_carousel_share4`: 캐러셀 4 버튼2 클릭수 `msg_click_carousel_share5`: 캐러셀 5 버튼2 클릭수 `msg_click_carousel_share6`: 캐러셀 6 버튼2 클릭수 `msg_click_carousel1_coupon`: 캐러셀 1 쿠폰 버튼 클릭수 `msg_click_carousel2_coupon`: 캐러셀 2 쿠폰 버튼 클릭수 `msg_click_carousel3_coupon`: 캐러셀 3 쿠폰 버튼 클릭수 `msg_click_carousel4_coupon`: 캐러셀 4 쿠폰 버튼 클릭수 `msg_click_carousel5_coupon`: 캐러셀 5 쿠폰 버튼 클릭수 `msg_click_carousel6_coupon`: 캐러셀 6 쿠폰 버튼 클릭수 `msg_click_catalog_item1`: 아이템1 클릭수 `msg_click_catalog_item2`: 아이템2 클릭수 `msg_click_catalog_item3`: 아이템3 클릭수 `msg_click_catalog_item4`: 아이템4 클릭수 `msg_click_catalog_item5`: 아이템5 클릭수 `msg_click_catalog_item6`: 아이템6 클릭수 `msg_click_catalog_item7`: 아이템7 클릭수 `msg_click_carousel_more`: 더보기 클릭수 `msg_click_coupon`: 쿠폰 버튼 클릭수 `msg_click_others`: 기타 클릭수
ADVIEW	애드뷰 지표 `ADV_CLICK_BUTTON1`: 버튼1 클릭수 `ADV_CLICK_BUTTON2`: 버튼2 클릭수 `ADV_CLICK_BUTTON_SHARE`: 공유 버튼 클릭수 `ADV_TH1_VIEW`: 이미지/동영상1 노출수 `ADV_TH1_VIDEO_PLAY_AUTO`: 동영상1 자동 재생수 `ADV_TH1_VIDEO_PLAY_TOUCH`: 동영상1 터치 재생수 `ADV_TH1_VIDEO_PLAY_3S`: 동영상1 3초 재생수 `ADV_TH2_VIEW`: 이미지/동영상2 노출수 `ADV_TH2_VIDEO_PLAY_AUTO`: 동영상2 자동 재생수 `ADV_TH2_VIDEO_PLAY_TOUCH`: 동영상2 터치 재생수 `ADV_TH2_VIDEO_PLAY_3S`: 동영상2 3초 재생수 `ADV_TH3_VIEW`: 이미지/동영상3 노출수 `ADV_TH3_VIDEO_PLAY_AUTO`: 동영상3 자동 재생수 `ADV_TH3_VIDEO_PLAY_TOUCH`: 동영상3 터치 재생수 `ADV_TH3_VIDEO_PLAY_3S`: 동영상3 3초 재생수 `ADV_TH4_VIEW`: 이미지/동영상4 노출수 `ADV_TH4_VIDEO_PLAY_AUTO`: 동영상4 자동 재생수 `ADV_TH4_VIDEO_PLAY_TOUCH`: 동영상4 터치 재생수 `ADV_TH4_VIDEO_PLAY_3S`: 동영상4 3초 재생수 `ADV_TH5_VIEW`: 이미지/동영상5 노출수 `ADV_TH5_VIDEO_PLAY_AUTO`: 동영상5 자동 재생수 `ADV_TH5_VIDEO_PLAY_TOUCH`: 동영상5 터치 재생수 `ADV_TH5_VIDEO_PLAY_3S`: 동영상5 3초 재생수 `ADV_TH6_VIEW`: 이미지/동영상6 노출수 `ADV_TH6_VIDEO_PLAY_AUTO`: 동영상6 자동 재생수 `ADV_TH6_VIDEO_PLAY_TOUCH`: 동영상6 터치 재생수 `ADV_TH6_VIDEO_PLAY_3S`: 동영상6 3초 재생수 `ADV_TH7_VIEW`: 이미지/동영상7 노출수 `ADV_TH7_VIDEO_PLAY_AUTO`: 동영상7 자동 재생수 `ADV_TH7_VIDEO_PLAY_TOUCH`: 동영상7 터치 재생수 `ADV_TH7_VIDEO_PLAY_3S`: 동영상7 3초 재생수 `ADV_TH8_VIEW`: 이미지/동영상8 노출수 `ADV_TH8_VIDEO_PLAY_AUTO`: 동영상8 자동 재생수 `ADV_TH8_VIDEO_PLAY_TOUCH`: 동영상8 터치 재생수 `ADV_TH8_VIDEO_PLAY_3S`: 동영상8 3초 재생수 `ADV_TH9_VIEW`: 이미지/동영상9 노출수 `ADV_TH9_VIDEO_PLAY_AUTO`: 동영상9 자동 재생수 `ADV_TH9_VIDEO_PLAY_TOUCH`: 동영상9 터치 재생수 `ADV_TH9_VIDEO_PLAY_3S`: 동영상9 3초 재생수 `ADV_TH10_VIEW`: 이미지/동영상10 노출수 `ADV_TH10_VIDEO_PLAY_AUTO`: 동영상10 자동 재생수 `ADV_TH10_VIDEO_PLAY_TOUCH`: 동영상10 터치 재생수 `ADV_TH10_VIDEO_PLAY_3S`: 동영상10 3초 재생수
BIZ_BOARD	비즈보드 지표 `EXPANDABLE_IMP`: 노출수 (확장) `MOTION_VIDEO_PLAY_AUTO`: 동영상 자동 재생수 (모션) `EXPANDABLE_VIDEO_PLAY_AUTO`: 동영상 자동 재생수 (확장) `MOTION_VIDEO_PLAY_3S`: 동영상 3초 재생수 (모션) `EXPANDABLE_VIDEO_PLAY_3S`: 동영상 3초 재생수 (확장) `EXPANDABLE_CLICK_CTA`: 행동유도 클릭수 (확장) `EXPANDABLE_CLICK_IMAGE1`: 이미지 클릭수 (확장) `EXPANDABLE_VIEWABLE_GOODS_1`: 이미지1 노출수 (확장) `EXPANDABLE_VIEWABLE_GOODS_2`: 이미지2 노출수 (확장) `EXPANDABLE_VIEWABLE_GOODS_3`: 이미지3 노출수 (확장) `EXPANDABLE_VIEWABLE_GOODS_4`: 이미지4 노출수 (확장) `EXPANDABLE_VIEWABLE_GOODS_5`: 이미지5 노출수 (확장) `EXPANDABLE_CLICK_GOODS_1`: 이미지1 클릭수 (확장) `EXPANDABLE_CLICK_GOODS_2`: 이미지2 클릭수 (확장) `EXPANDABLE_CLICK_GOODS_3`: 이미지3 클릭수 (확장) `EXPANDABLE_CLICK_GOODS_4`: 이미지4 클릭수 (확장) `EXPANDABLE_CLICK_GOODS_5`: 이미지5 클릭수 (확장)
SPB	보드 지표 `channel_home_click`: 채널 홈 클릭수 `channel_add_click`: 채널 추가 클릭수 `article1_click`: 아티클1 클릭수 `article2_click`: 아티클2 클릭수 `article3_click`: 아티클3 클릭수 `article4_click`: 아티클4 클릭수 `article5_click`: 아티클5 클릭수 `article6_click`: 아티클6 클릭수 `article7_click`: 아티클7 클릭수 `article8_click`: 아티클8 클릭수 `article9_click`: 아티클9 클릭수 `article10_click`: 아티클10 클릭수
TRIGGER	전면형 유도 지표 `trigger_viewable`: 유도 영역 노출수

Morebutton

이름	타입	설명
pcLandingUrl	`String`	PC 랜딩 URL
mobileLandingUrl	`String`	모바일 랜딩 URL
webembedChannelUrl	`String`	웹임베드 랜딩 URL
channelPostId	`Long`	채널 소식 ID
channelCouponId	`Long`	채널 쿠폰 ID

O

Objective

이름	타입	설명
type	`Enum: ObjectiveType`	광고 목표 설정의 유형
value	`String`	광고 목표 설정의 번호 `type`이 `TALK_CHANNEL`인 경우 카카오톡 채널 프로필 목록 조회 API로 조회한 `id` 값 `type`이 `PIXEL_AND_SDK`인 경우 픽셀 & SDK 목록 조회 API로 조회한 `id` 값
detailType	`Enum: ObjectiveDetailType`	최적화할 전환 종류 중요: `type`이 `PIXEL_AND_SDK`인 경우 사용

Enum: ObjectiveType

값	설명
TALK_CHANNEL	카카오톡채널
PIXEL_AND_SDK	픽셀&SDK

Enum: ObjectiveDetailType

값	설명
PURCHASE	구매
APP_INSTALL	앱설치
COMPLETE_REGISTRATION	회원가입
SIGN_UP	서비스신청
CART	장바구니
PARTICIPATION	잠재고객
ADD_FRIEND	채널 친구 추가 중요: `ObjectiveType`이 `TALK_CHANNEL`일 경우 응답에서만 받을 수 있는 값으로, 해당 값으로 요청은 불가

Enum: Operation

값	설명
ONLY	ONLY
AND	AND
MINUS	MINUS
OR	OR

OpinionFile

이름	타입	설명
id	`Long`	의견증빙 파일 번호
originalFileName	`String`	업로드 시 파일 이름
downloadUrl	`String`	의견증빙 파일 URL

Enum: OptimizationStatus

값	설명
LEVEL_1	1단계 제한된 머신러닝
LEVEL_2	2단계 기본 머신러닝
LEVEL_3	3단계 심화된 머신러닝
LEVEL_4	4단계 최적의 머신러닝
INVALID	조회 불가
READY	학습 대기
null	값 없음 전환 목적이 아닌 경우 상태 값이 없음

P

Enum: Pacing

값	설명
NONE	설정 해제
QUICK	빠른 게재 가능한 한 빨리 광고 결과를 얻을 수 있도록 예산을 최대한 사용하여 광고 노출 유도
NORMAL	일반 게재 일예산을 시간대별로 분할하여 시간대별 분할된 예산만큼 사용할 수 있도록 광고 노출 제어

Enum: PeriodUnit

값	설명
WEEK	주 단위
MONTH	월 단위

Enum: Placement

값	설명
KAKAO_TALK	카카오톡
DAUM	다음
KAKAO_SERVICE	카카오 서비스
NETWORK	네트워크

Enum: PricingType

값	설명
CPC	Cost per Click 광고를 클릭한 경우에 과금, 실시간으로 광고 입찰 경쟁에 참여하여 탄력적인 광고 운영 가능
CPM	Cost per Mille 1,000회 노출당 과금되는 방식, 노출을 기준으로 입찰 경쟁 참여 가능
CPA	Cost per Action '카카오 친구 늘리기' 광고목적 시 클릭으로부터 24시간 이내 발생한 전환(친구추가)에 과금되는 방식
CPV	Cost per View 동영상 조회당 과금되는 방식
CPMS	Cost per Message Send 메시지 발송당 과금되는 방식, 메시지 광고그룹에 사용

R

RejectedReason

이름	타입	설명
rejectedTitle	`String`	심사 보류 원인 제목
rejectedContent	`String`	심사 보류 원인 내용

ResponseMessage

이름	타입	설명
messageAdId	`String`	메시지광고 번호, 최초 생성 시 부여된 메시지 식별용 번호
name	`String`	메시지 이름(최대: 50자), 최초 생성 시 미입력한 경우 자동 생성 규칙이 적용된 값
type	`Enum`	메시지 유형 `BASIC_TEXT_MESSAGE`: 기본 텍스트 `WIDE_MESSAGE`: 와이드 이미지 `WIDE_LIST_MESSAGE`: 와이드 리스트 `CAROUSEL_COMMERCE_MESSAGE`: 캐러셀 커머스형 `CAROUSEL_FEED_MESSAGE`: 캐러셀 피드형 `PREMIUM_VIDEO_MESSAGE`: 프리미엄 메시지 `CATALOG_MESSAGE`: 카탈로그 메시지 `SPOTLIGHT_MESSAGE`: 스포트라이트
title	`String`	메시지 홍보 문구
items	`Item[]`	아이템 정보
buttons	`Button[]`	버튼 정보
couponBook	`CouponBook[]`	쿠폰 정보
introCarousel	`IntroCarousel`	인트로 정보
carousels	`Carousel[]`	캐러셀 정보
catalog	`Catalog[]`	카탈로그 정보
buttonTitle	`String`	스포트라이트 메시지 버튼 이름
landingUrl	`String`	스포트라이트 메시지 랜딩 URL
ageVerification	`Boolean`	연령인증 메시지 여부 `true`: 연령인증 메시지 `false`: 일반 메시지
adFlag	`Boolean`	광고성 메시지 `true`: 광고성 메시지 `false`: 정보성 메시지
shareFlag	`Boolean`	공유하기 사용 여부 `true`: 공유하기 사용 `false`: 공유하기 사용 안함 중요: `ageVerification` 값이 `true`인 경우 사용 불가

S

Schedule

이름	타입	설명	필수
beginDate	`String`	시작 날짜 오늘이거나 또는 오늘 날짜 이후로 설정 형식: yyyy-MM-dd	O
endDate	`String`	종료 날짜 시작 날짜와 같거나 또는 그 이후로 설정 형식: yyyy-MM-dd	X
lateNight	`Boolean`	심야 타게팅	O
detailTime	`Boolean`	상세 시간 설정 여부 `lateNight`(심야타게팅)이 `true`이고, 해당 값을 `false`로 요청할 경우 기본값으로 설정됨(22:00~06:59)	O
mondayTime	`String[]`	월요일 상세 시간 설정 `1`: 노출 설정 `0`: 비노출 설정 24시간이 `1`, `0`으로 이루어진 배열로 배열 크기는 24 예) [`"1"`, `"1"`, `"0"`, ...] 중요: `detailTime`(상세 시간 설정 여부)가 `true`인 경우 필수 요청	X
tuesdayTime	`String[]`	화요일 상세 시간 설정 `1`: 노출 설정 `0`: 비노출 설정 24시간이 `1`, `0`으로 이루어진 배열로 배열 크기는 24 예) [`"1"`, `"1"`, `"0"`, ...] 중요: `detailTime`(상세 시간 설정 여부)가 `true`인 경우 필수 요청	X
wednesdayTime	`String[]`	수요일 상세 시간 설정 `1`: 노출 설정 `0`: 비노출 설정 24시간이 `1`, `0`으로 이루어진 배열로 배열 크기는 24 예) [`"1"`, `"1"`, `"0"`, ...] 중요: `detailTime`(상세 시간 설정 여부)가 `true`인 경우 필수 요청	X
thursdayTime	`String[]`	목요일 상세 시간 설정 `1`: 노출 설정 `0`: 비노출 설정 24시간이 `1`, `0`으로 이루어진 배열로 배열 크기는 24 예) [`"1"`, `"1"`, `"0"`, ...] 중요: `detailTime`(상세 시간 설정 여부)가 `true`인 경우 필수 요청	X
fridayTime	`String[]`	금요일 상세 시간 설정 `1`: 노출 설정 `0`: 비노출 설정 24시간이 `1`, `0`으로 이루어진 배열로 배열 크기는 24 예) [`"1"`, `"1"`, `"0"`, ...] 중요: `detailTime`(상세 시간 설정 여부)가 `true`인 경우 필수 요청	X
saturdayTime	`String[]`	토요일 상세 시간 설정 `1`: 노출 설정 `0`: 비노출 설정 24시간이 `1`, `0`으로 이루어진 배열로 배열 크기는 24 예) [`"1"`, `"1"`, `"0"`, ...] 중요: `detailTime`(상세 시간 설정 여부)가 `true`인 경우 필수 요청	X
sundayTime	`String[]`	일요일 상세 시간 설정 `1`: 노출 설정 `0`: 비노출 설정 24시간이 `1`, `0`으로 이루어진 배열로 배열 크기는 24 예) [`"1"`, `"1"`, `"0"`, ...] 중요: `detailTime`(상세 시간 설정 여부)가 `true`인 경우 필수 요청	X

Schedule

이름	타입	설명	필수
detailTime	`Boolean`	상세 시간 설정 여부	O
beginDate	`String`	시작일	O
beginTime	`String`	시작시간	X
endDate	`String`	종료일	X
endTime	`String`	종료시간	X
mondayTime	`String[]`	월요일 집행 시간	X
tuesdayTime	`String[]`	화요일 집행 시간	X
wednesdayTime	`String[]`	수요일 집행 시간	X
thursdayTime	`String[]`	목요일 집행 시간	X
fridayTime	`String[]`	금요일 집행 시간	X
saturdayTime	`String[]`	토요일 집행 시간	X
sundayTime	`String[]`	일요일 집행 시간	X
lateNight	`Boolean`	심야타게팅 여부	O
periodUnit	`Enum: PeriodUnit`	주/월 구분	X

Enum: Status (캠페인)

값	설명
READY	집행 예정
LIVE	집행 중
FINISHED	집행 완료
OFF	사용자OFF
DELETED	삭제
EXCEED_DAILY_BUDGET	캠페인 일 예산 초과
PAUSED	일시 중지
NO_AVAILABLE_CREATIVE	집행 가능한 소재가 없음
CANCELED	계약해지
SYSTEM_CONFIG_EXTERNAL_SERVICE_STOP	연결 서비스 제한으로 운영불가인 상태
ADACCOUNT_UNAVAILABLE	광고계정 운영불가

Enum: Status (광고그룹)

값	설명
READY	집행 예정
LIVE	집행 중
FINISHED	집행 완료
OFF	사용자OFF
DELETED	삭제
EXCEED_DAILY_BUDGET	광고 그룹 일 예산 초과
PAUSED	일시 중지
NO_AVAILABLE_CREATIVE	집행 가능한 소재가 없음
CANCELED	계약해지
CAMPAIGN_UNAVAILABLE	캠페인 운영불가
SYSTEM_CONFIG_ADMIN_STOP	관리자 정지

Status: 소재

소재의 운영 상태	메시지 소재 가능 여부	설명
OPERATING(운영가능)	가능	운영가능 상태
UNAPPROVED(심사미승인)	불가능	심사승인이 아닌 상태(심사중, 심사보류를 모두 포함)
INVALID_DATE(기간오류)	가능	집행기간이 도래하지 않았거나 이미 지난 상태
MONITORING_REJECTED(모니터링 보류)	불가능	모니터링 보류 상태
SYSTEM_CONFIG_ADMIN_STOP(관리자 정지)	불가능	관리자 정지 상태
OFF(사용자OFF)	가능	사용자 OFF 상태
DELETED(삭제)	가능	삭제된 상태
ADGROUP_UNAVAILABLE(광고그룹 운영불가)	가능	광고 상위단위인 광고그룹이 운영불가인 상태
SYSTEM_CONFIG_VOID(운영불가 콘텐츠오류)	불가능	소재 콘텐츠 오류로 소재 운영불가인 상태

메시지 소재는 운영상태 중 일부의 상태만 될 수 있습니다.

statusDescription: 캠페인

캠페인의 게재와 관련된 현재 상태	캠페인 상태	일 예산 초과 여부
운영중	ON	false
일 예산 초과	ON	true
사용자 OFF	OFF	false
사용자 OFF, 일 예산 초과	OFF	true
삭제됨	DEL	-

statusDescription: 소재 심사 상태

광고 소재의 게재와 관련된 현재 상태	원 소재 심사 상태	소재 상태	수정 소재 심사 상태	심사 결과
운영중	APPROVED	ON	심사승인	없음
운영중(수정사항 심사중)	MODIFICATION_WAITING	ON	심사승인	심사중
운영중(수정사항 심사보류)	MODIFICATION_REJECTED	ON	심사승인	심사보류
심사중	WAITING	ON	심사중	없음
심사보류	REJECTED	ON	심사보류	없음
관리자정지	REJECTED	ON	관리자정지	없음
관리자정지(수정사항 심사중)	MODIFICATION_WAITING	ON	관리자정지	심사중
관리자정지(수정사항 심사보류)	MODIFICATION_REJECTED	ON	관리자정지	심사보류
사용자OFF	APPROVED	OFF	심사승인	없음
사용자OFF, 수정사항 심사중	MODIFICATION_WAITING	OFF	심사승인	심사중
사용자OFF, 수정사항 심사보류	MODIFICATION_REJECTED	OFF	심사승인	심사보류
사용자OFF, 심사중	WAITING	OFF	심사중	없음
사용자OFF, 심사보류	REJECTED	OFF	심사보류	없음
사용자OFF, 관리자정지	REJECTED	OFF	관리자정지	없음
사용자OFF, 관리자정지(수정사항 심사중)	MODIFICATION_WAITING	OFF	관리자정지	심사중
사용자OFF, 관리자정지(수정사항 심사보류)	MODIFICATION_REJECTED	OFF	관리자정지	심사보류
삭제됨	-	DEL	-	-

참고: 광고 소재의 게재와 관련된 상태 구성

광고 소재의 게재와 관련된 상태(statusDescription)는 소재 상태(config), 원소재 심사 상태, 수정소재 심사 상태 조합으로 만들어집니다. 광고 소재는 5가지의 심사 상태가 있습니다.

승인(APPROVED)
심사중(WAITING)
보류(REJECTED)
수정사항심사중(MODIFICATION_WAITING)
수정사항심사보류(MODIFICATION_REJECTED)

보류는 심사보류, 관리자정지인 경우를 통합하여 나타내는 상태입니다. 수정사항심사중과 수정사항심사보류는 원소재가 심사승인, 관리자정지의 경우에만 나타날 수 있는 상태입니다. 원소재가 심사보류, 심사중인 경우에는 수정을 하면 승인/심사중/보류 중의 하나의 상태값을 가집니다.

statusDescription: 디스플레이 광고그룹

디스플레이 광고그룹의 게재와 관련된 현재 상태	광고그룹 상태	일예산초과 여부	집행기간 유효 여부
운영중	ON	false	true
일예산초과	ON	true	true
기간외	ON	false	false
일예산초과, 기간외	ON	true	false
사용자OFF	OFF	false	true
사용자OFF, 일예산초과	OFF	true	true
사용자OFF, 기간외	OFF	false	false
사용자OFF, 일예산초과, 기간외	OFF	true	false
삭제됨	DEL	-	-

디스플레이 광고그룹의 게재와 관련된 상태는 광고그룹 상태(config), 일예산초과 여부(isDailyBudgetAmountOver), 집행기간 유효 여부(isValidPeriod) 조합으로 만들어집니다.

SyncAppTargeting

이름	타입	설명
profileId	`String`	카카오톡 채널 프로필 ID
inclusionType	`Enum: InclusionType`	포함 여부

Enum: SystemConfig

값	설명
ON	활성화
VOID	운영불가 (시스템 무효처리)
ADMIN_STOP	관리자정지
EXTERNAL_SERVICE_STOP	연결 서비스 제한

T

TalkChannelGroupTargeting

이름	타입	설명
id	`Long`	친구그룹 ID
talkChannelGroupFileId	`Long`	친구그룹 파일 ID
name	`String`	친구그룹 이름
inclusionType	`Enum: InclusionType`	포함 여부
fileType	`Enum`	친구그룹 유형 `APP_USER_ID`: 앱유저아이디 `PHONE_NUMBER`: 전화번호 `MESSAGE_RETARGET`: 메시지 발송 대상자
groupKey	`String`	친구그룹 파일의 그룹 키

TalkChannelTargeting

이름	타입	설명
id	`Long`	카카오톡 채널 타게팅 번호
name	`String`	카카오톡 채널 타게팅 이름
inclusionType	`Enum: InclusionType`	포함 여부
profileId	`Integer`	인코딩된 프로필 아이디
profileName	`String`	프로필 이름

Targeting

이름	타입	설명
id	`Long`	오디언스 번호 일반 타겟팅 설정 시 제공하지 않음
name	`String`	오디언스명 일반 타겟팅 설정 시 제공하지 않음
type	`Enum`	오디언스 사용 여부 `NORMAL`: 일반 타겟팅 설정 `DISPLAY`: 디스플레이 오디언스 관리기능 설정 `MESSAGE`: 메시지 오디언스 관리기능 설정
ageType	`Enum`	연령대 전체 선택 종류 `ALL`: 전체 `NOT_ALL`: 부분 선택
ages	`String[]`	연령대
genderType	`Enum`	성별 전체 선택 종류 `ALL`: 전체 `NOT_ALL`: 부분 선택
genders	`String[]`	성별
locations	`Location[]`	시/도 시/도 조회 참고
depth2Locations	`Location[]`	시/군/구 시/군/구 조회 참고
depth3Locations	`Location[]`	데모그래픽 > 행정구역 > 동/읍/면 동/읍/면 조회 참고 중요: `locationType`이 `AREA`인 경우 `locations`(시/도), `depth2Locations`(시/군/구), `depth3Locations`(동/읍/면) 중 하나 이상 요청 필수
ufoInterests	`UfoInterest[]`	관심사 타게팅 맞춤타겟 카테고리 타입 조회 API 참고
ufoDeprecatedInterests	`UfoInterest[]`	지원 중단된 관심사 타게팅 맞춤타겟 카테고리 타입 조회 API 참고
ufoBusinessTypes	`UfoBusinessType[]`	업종 타게팅 맞춤타겟 카테고리 타입 조회 API 참고
ufoDeprecatedBusinessTypes	`UfoBusinessType[]`	지원 중단된 업종 타게팅 맞춤타겟 카테고리 타입 조회 API 참고
talkChannelTargetings	`TalkChannelTargeting[]`	카카오톡 채널 타게팅
syncAppTargetings	`SyncAppTargeting[]`	카카오 로그인 이용자 타게팅
customerFileTargetings	`CustomerFileTargeting[]`	고객파일 타게팅
cohortTargetings	`CohortTargeting[]`	광고반응 타게팅
trackerTargetings	`TrackerTargeting[]`	픽셀&SDK 타게팅
talkChannelGroupTargeting	`TalkChannelGroupTargeting[]`	친구그룹 타게팅

Targeting: 메시지광고

이름	타입	설명	필수
type	`Enum`	타게팅 타입 종류, 요청 시 필수 `WHOLE`: 전체 친구 `SMART`: 추천 친구 `DIRECT`: 직접 설정	O
devices	`Enum: DeviceType[]`	디바이스 선택 유형 `ANDROID`: 안드로이드 `IOS`: iOS	X
demographics	`Demographics[]`	성별, 연령, 지역 정보	X
customs	`CustomTargeting[]`	맞춤타겟 지정	X
friendPeriod	`FriendPeriod[]`	친구기간 설정 설정한 기간 동안 채널 친구가 된 사용자에게만 발송	X
ufoInterests	`UfoInterest[]`	맞춤타겟 > 카카오 데이터 > 카테고리 > 관심사 맞춤타겟 카테고리 타입 조회 참고 참고: 조회만 가능	X
ufoBusinessTypes	`UfoBusinessType[]`	맞춤타겟 > 카카오 데이터 > 카테고리 > 업종 맞춤타겟 카테고리 타입 조회 참고 참고: 조회만 가능	X

Thumbnail

이름	타입	설명
fileSize	`Long`	파일 사이즈
url	`String`	대표 썸네일 이미지 URL
fileName	`String`	대표 썸네일 파일명
imageWidth	`Integer`	넓이
imageHeight	`Integer`	높이
mimeType	`String`	Mime 유형

Enum: TimeUnit

값	설명
DAY	일
ALL	조회 기간 전체

보고서 집계단위	조회할 수 있는 최대 기간
DAY	최대 1개월
ALL	최대 1개월

TrackerTargeting

이름	타입	설명
id	`Long`	트래커 번호
inclusionType	`Enum: InclusionType`	포함 여부
trackId	`String`	트래커 ID
eventCode	`String`	이벤트 코드
trackRuleId	`String`	트래커 룰 번호
trackRuleName	`String`	트래커 룰 이름
term	`Integer`	타겟 기간(최소: 1, 최대: 180)

TrackRule

이름	타입	설명
trackRuleId	`String`	트래커 정보 아이디
trackId	`String`	트래커 아이디
eventCode	`String`	이벤트 코드
name	`String`	트래커 정보 이름
ruleSetStr	`String[]`	룰셋 정의

U

UfoBusinessType

이름	타입	설명
value	`String`	업종 키(Key) 전체 목록은 업종 타입 정보 CSV 파일(다운로드) 내 `UfoBusinessType` 표 참고

UfoInterest

이름	타입	설명
value	`String`	관심사 키(Key) 전체 목록은 관심사 타입 정보 CSV 파일(다운로드) 내 `UfoInterest` 표 참고

V

Video

이름	타입	설명
url	`String`	비디오 URL
fileName	`String`	비디오 파일명
size	`Long`	파일 사이즈
duration	`String`	비디오 재생시간

Video: 디스플레이 소재

이름	타입	설명
url	`String`	비디오 소재 URL

Video: 메시지광고

이름	타입	설명
url	`String`	동영상 URL
autoThumbnailUrl	`String`	자동추출 썸네일 URL
uploadThumbnailUrl	`String`	업로드 썸네일 URL

사이드 메뉴

시작하기

카카오디벨로퍼스

로그인

커뮤니케이션

광고

지도

내비게이션

검색

더 보기