카카오모먼트 메시지광고 API에서 랜딩 URL 조회 가능 여부 문의

문의 시, 디벨로퍼스 앱ID를 알려주세요.

  • 친구 api와 피커, 메시지 api 사용을 위한 체크 리스트 ( https://devtalk.kakao.com/t/api-api/116052 ) 먼저 확인해주세요.
  • 메시지 API 권한 신청은 “디벨로퍼스>내 애플리케이션>앱 설정>앱 권한” 메뉴에서 신청 할 수 있습니다.

안녕하세요.

카카오모먼트 메시지광고 관리 API 관련하여 문의드립니다.

현재 아래 API를 통해 메시지광고 목록을 조회하고 있습니다.

POST https://apis.moment.kakao.com/openapi/message/v2/message-ads

응답의 message 필드는 SimpleMessage 형태로 내려오고 있으며, 현재 확인한 응답에는 아래와 같이 type, mainTitle, mainImageUrl 정도만 포함되어 있습니다.

예시:
{
“messageAdId”: “msg-ad-…”,
“messageAdType”: “BROADCAST”,
“name”: “…”,
“message”: {
“type”: “WIDE_MESSAGE”,
“mainTitle”: “…”,
“mainImageUrl”: “https://t1.daumcdn.net/…”
}
}

다만 문서의 ResponseMessage 타입에는 items, buttons, couponBook, introCarousel, carousels 등의 필드가 정의되어 있고, 각 구성요소에는 mobileLandingUrl, pcLandingUrl 등 랜딩 URL 필드가 포함될 수 있는 것으로 확인했습니다.

참고 문서:
https://developers.kakao.com/docs/ko/kakaomoment/type-info#ResponseMessage

문의드리고 싶은 내용은 아래와 같습니다.

  1. message-ads 목록 조회 API에서 ResponseMessage의 items/buttons/couponBook/introCarousel/carousels 같은 상세 구성요소를 응답으로 받을 수 있는 조건이 따로 있나요?

  2. 메시지 광고 생성 시 어떤 메시지 유형 또는 어떤 설정으로 생성해야 위 상세 구성요소와 landing URL 필드가 API 응답에 포함되나요?
    예: WIDE_MESSAGE, WIDE_LIST_MESSAGE, CAROUSEL_FEED_MESSAGE 등

  3. 현재 message-ads 목록 조회 API가 항상 SimpleMessage 간편 정보만 반환한다면, messageAdId 기준으로 상세 메시지 정보와 landing URL을 조회할 수 있는 별도 API가 있을까요?

저희는 메시지 광고에 등록된 landing URL의 UTM 파라미터를 확인하여 외부 분석 데이터와 매핑하려고 합니다.

확인 부탁드립니다.
감사합니다.

@윤종원2495 안녕하세요, 카카오모먼트 담당자입니다.

메시지광고 목록 조회 API는 SimpleMessage만 반환하고 있으며, 상세 정보는 별도의 단건 조회 API를 통해서만 받을 수 있습니다.

messageAdId 기준 상세 메시지 정보 및 landing URL을 조회할 수 있는 단건 조회 API는 메시지광고 조회 API 사용하시면 됩니다.

감사합니다.