이 문서는 카카오모먼트 쉬운 메시지광고에 대해 소개합니다.

카카오모먼트 쉬운 메시지광고는 제휴사에 제공하는 메시지광고 운영 및 관리 서비스입니다.

제휴사는 쉬운 메시지광고 API를 사용해 제휴사 플랫폼에서 카카오모먼트 메시지광고 운영 및 관리 기능을 가맹점에 제공해, 최적의 메시지를 가장 적절한 순간에 적합한 친구에게 발송할 수 있습니다.

쉬운 메시지광고는 메시지광고와 개인화 메시지광고 기능을 제공합니다.

메시지광고(Broadcast MessageAd) 는 카카오톡 채널 친구들에게 하나의 메시지를 발송 예약하고, 예약 시간에 브로드캐스팅 방식으로 대량 발송하는 광고 상품입니다. 발송 대상의 타겟팅 여부를 선택할 수 있습니다.

개인화 메시지광고(Personal MessageAd) 는 카카오톡 채널 친구별 맞춤 메시지를 발송하는 광고 상품입니다. 메시지 템플릿에 변수를 사용해 대상별 개인화된 메시지를 구성할 수 있습니다.

쉬운 메시지광고 API를 사용하려면 아래 절차를 모두 완료해야 합니다. 각 항목의 세부 내용을 확인합니다.

1. 제휴사 앱 생성
   • 카카오비즈니스 간편연결과 동일한 제휴사 앱 사용
   • 앱 관리 페이지의 [앱] > [일반] > [비즈니스 정보]에서 비즈 앱 전환
2. 제휴 및 대행 계약 신청 및 체결
3. 카카오비즈니스 간편연결 연동
4. 비즈니스 인증 도입 및 필요한 쉬운 메시지광고 비즈니스 동의항목을 인가받은 비즈니스 토큰 발급 필요

카카오비즈니스 간편연결과 비즈니스 인증 도입 방법은 쉬운 메시지광고를 사용하는 광고계정과 광고 운영의 주체에 따라 상이합니다. 자세한 내용은 연동 개발을 참고합니다.

쉬운 메시지광고 API를 사용하려면 아래 계약 체결이 필요합니다. 쉬운 메시지광고는 제휴 과정에서 카카오와 제휴 계약을 체결한 제휴사 앱에 사용 권한을 부여합니다. 항목별 내용을 참고합니다.

• 쉬운 메시지광고 제휴사 계약

  1. 카카오 비즈니스 회원 가입으로 제휴사 대표 카카오계정 생성
  2. 카카오 담당자에게 제휴사 계약 신청

• 카카오 광고 대행사 계약

  1. 제휴사 대표 카카오계정으로 카카오광고 통합에이전시 가입
  2. 카카오 담당자에게 공식 대행사 지정, 통합 한도 설정 심사 요청

제휴사 플랫폼에서 쉬운 메시지광고 기능을 가맹점에 제공하려면 먼저 카카오비즈니스 간편연결을 도입해야 합니다. 가맹점은 제휴사 플랫폼에 도입된 카카오비즈니스 간편연결 기능으로 카카오비즈니스 회원가입과 카카오톡 채널 생성 및 연결 절차를 수행합니다.

카카오비즈니스 간편연결에서 자세한 기능과 도입 방법을 확인합니다.

쉬운 메시지광고 API는 비즈니스 인증 도입 후 쉬운 메시지광고 비즈니스 동의항목을 인가받은 비즈니스 토큰으로 요청할 수 있습니다. 제휴사 관리자 또는 가맹점이 비즈니스 인증으로 비즈니스 토큰을 발급받는 과정을 거쳐 쉬운 메시지광고를 이용하도록 기능을 구현해야 합니다.

쉬운 메시지광고 API를 사용하기 위한 비즈니스 인가 코드 요청은 아래 항목을 만족하도록 resource_ids 파라미터를 구성해야 합니다.

• 서비스 코드(ScopeGroup)를 쉬운 메시지광고 서비스 코드인 easy_msg로 지정
• 비즈니스 자산 ID(ResourceId) 지정 시 인가를 요청할 카카오톡 채널 프로필 ID를 함께 지정 필요

아래 구성 예시를 함께 참고합니다.

# 특정 카카오톡 채널 프로필 ID 지정
resource_ids=easy_msg:${CHANNEL_PROFILE_ID}

# 쉬운 메시지광고 권한을 보유한 전체 비즈니스 자산 지정
resource_ids=easy_msg:*

서비스가 쉬운 메시지광고 API를 호출하기 위해 비즈니스 인가 코드 요청 API로 인가받아야 하는 비즈니스 동의항목 목록입니다.

쉬운 메시지광고 API는 제휴사 플랫폼에서 가맹점이 카카오톡 채널을 만든 후, 광고계정과 광고 운영의 주체에 따라 다른 방식의 연동이 필요합니다. 아래 방식별 시퀀스 다이어그램(Sequence Diagram)과 단계별 세부 내용을 확인합니다.

가맹점이 자신의 카카오계정으로 제휴사 플랫폼에서 광고를 직접 운영하는 방식입니다. 광고계정의 생성 주체에 따라 가맹점 광고계정 방식과 제휴사 광고계정 방식으로 나뉩니다.

가맹점이 생성한 광고계정으로 가맹점이 직접 광고를 운영하는 경우의 연동 개발 방법에 대해 안내합니다.

가맹점 직접 운영 및 가맹점 광고계정 방식

• 간편연결 연동
  1. 간편연결 요청을 처리해 가맹점의 카카오톡 채널 프로필 ID를 응답받습니다. 자세한 절차는 간편연결 과정을 참고합니다. (참고: 카카오톡 채널 프로필 ID 확인 방법)
  2. 간편연결에서 채널 프로필 연결 후, 노출되는 메시지광고 설정창의 동의 버튼을 선택하면 가맹점의 광고계정이 생성됩니다.
• 비즈니스 인증 연동 및 기능 제공
  1. 가맹점이 제휴사 플랫폼에서 쉬운 메시지광고 기능을 사용합니다.
  2. 제휴사 앱의 REST API 키로 쉬운 메시지광고 비즈니스 동의항목을 포함해 비즈니스 인가 코드 요청 API를 호출하고 가맹점의 카카오계정 인증 및 비즈니스 동의항목 동의 절차를 수행합니다.
  3. 동의 완료 후 제휴사는 비즈니스 인가 코드를 응답받습니다. 해당 정보로 비즈니스 토큰 요청 API를 호출해 가맹점의 비즈니스 토큰(BUSINESS_ACCESS_TOKEN)을 발급받습니다.
  4. 가맹점의 카카오톡 채널 프로필 ID와 비즈니스 토큰(BUSINESS_ACCESS_TOKEN) 정보로 해당 기능의 API 요청 후 처리 결과를 전달합니다.

제휴사가 대신 생성한 광고계정으로 가맹점이 직접 광고를 운영하는 경우의 연동 개발 방법에 대해 안내합니다.

가맹점 직접 운영 및 파트너 광고계정 방식

• 간편연결 연동
  • 간편연결 요청을 처리해 가맹점의 카카오톡 채널 프로필 ID를 응답받습니다. 자세한 절차는 간편연결 과정을 참고합니다. (참고: 카카오톡 채널 프로필 ID 확인 방법)
• 광고계정 생성
  1. 제휴사 앱의 REST API 키로 쉬운 메시지광고 비즈니스 동의항목를 포함해 비즈니스 인가 코드 요청 API를 요청하고 제휴사 대표 카카오계정으로 인증 및 비즈니스 동의항목 동의 절차를 수행합니다. 제휴 및 대행 계약을 신청한 제휴사 대표 카카오계정을 사용해야 합니다.
  2. 동의 완료 후 제휴사는 비즈니스 인가 코드를 응답받습니다. 해당 정보로 비즈니스 토큰 요청 API를 호출해 제휴사 대표 계정의 비즈니스 토큰(PARTNER_BUSINESS_ACCESS_TOKEN)을 발급받습니다.
  3. 가맹점의 카카오톡 채널 프로필 ID와 제휴사 대표 계정의 비즈니스 토큰(PARTNER_BUSINESS_ACCESS_TOKEN)으로 광고계정 생성 API를 호출해 가맹점의 광고계정을 생성합니다.
• 비즈니스 인증 연동 및 기능 제공
  1. 가맹점이 제휴사 플랫폼에서 쉬운 메시지광고 기능을 사용합니다.
  2. 제휴사 앱의 REST API 키로 비즈니스 인가 코드 요청 API를 호출합니다. 가맹점의 카카오계정 인증 및 비즈니스 동의항목 동의 절차를 수행합니다.
  3. 앱 연결이 완료되면 제휴사는 비즈니스 인가 코드를 응답받습니다. 해당 정보로 비즈니스 토큰 요청 API를 호출해 가맹점의 비즈니스 토큰(BUSINESS_ACCESS_TOKEN)을 발급받습니다.
  4. 가맹점의 카카오톡 채널 프로필 ID와 비즈니스 토큰(BUSINESS_ACCESS_TOKEN) 정보로 해당 기능의 API 요청 후 처리 결과를 전달합니다.

쉬운 메시지광고 문서에서 쓰이는 주요 용어의 뜻을 안내합니다. 카카오모먼트 주요 용어는 카카오모먼트 용어집에서, 카카오디벨로퍼스 주요 용어는 용어집을 참고합니다.

쉬운 메시지광고의 기능별 개발 문서는 아래를 참고합니다.

쉬운 메시지광고 API 사용 중 발생하는 실패 응답과 에러 정보는 에러 코드를 참고합니다. 상세 에러 코드의 경우, 쉬운 메시지광고 API에서만 발생하는 에러 정보는 아래 상세 에러 코드에서 확인할 수 있습니다.

• 쉬운 메시지광고: 광고계정 관리
• 쉬운 메시지광고: 결제 관리
• 쉬운 메시지광고: 메시지광고 관리
• 쉬운 메시지광고: 메시지광고 운영
• 쉬운 메시지광고: 개인화 메시지광고 운영