비즈니스폼+ API 문의

카카오모먼트 API
1

안녕하세요.

비즈니스폼+ 응답 결과 조회 API 이용 관련하여 문의드립니다. 아래 API를 이용하고자 합니다.

GET https://apis.moment.kakao.com/openapi/v4/adAccounts/bizFormPlus/report

현재 여러 광고주의 카카오모먼트 광고계정을 관리하고 있습니다.

일반적인 광고계정 관련 API는 권한을 보유한 광고주 계정에 대해 정상적으로 조회가 가능한 것으로 확인되나, 비즈니스폼+ 응답 결과 조회 API 호출 시 아래 오류가 발생하고 있습니다.

{
  "extras": {
    "detailCode": 28105,
    "detailMsg": "앱과 광고계정의 사업자등록번호가 다릅니다."
  }
}

현재 앱에 등록된 사업자등록번호와 광고주의 광고계정에 등록된 사업자등록번호가 서로 다른 상황입니다.

문의드리고 싶은 내용은 다음과 같습니다.

  1. 현재 보유한 광고주 광고계정에 대한 권한(영업권/광고계정 권한 등)이 있는 경우에도, 비즈니스폼+ 응답 결과 조회 API는 앱과 광고계정의 사업자등록번호가 다르면 조회가 불가능한지
  2. 대행사 또는 솔루션 사업자가 하나의 앱/Business Access Token을 이용하여 권한을 보유한 여러 광고주의 비즈니스폼+ 응답 결과를 조회할 수 있는 방법이 있는지
  3. 불가능하다면 광고주별로 별도의 카카오디벨로퍼스 앱을 생성하여 사업자등록번호를 일치시켜야 하는지, 또는 별도의 권한 설정/연동 방법이 있는지

확인 부탁드립니다.

감사합니다.

2

@playd_da
안녕하세요. 카카오 참여형광고 비즈니스폼+ 입니다.
문의 주신 3가지 순서대로 답변드립니다.

  1. 광고계정 권한이 있어도 앱과 광고계정의 사업자등록번호가 다르면 조회할 수 없습니다.
    비즈니스폼+ 응답 결과 조회 API는 다른 카카오모먼트 API와 달리 아래 조건을 모두 충족해야 호출할 수 있습니다.
  • 카카오디벨로퍼스 앱과 광고계정에 등록된 사업자등록번호가 서로 일치
  • 비즈니스 동의항목 moment_bizform_result_read(카카오모먼트 비즈니스폼+ 응답 결과 조회)에 대한 동의
  • 조회할 광고계정 권한과 해당 폼 ID의 폼 보고서 다운로드 권한 보유
    영업권이나 광고계정 권한을 보유하고 있어도 첫 번째 조건을 대신하지는 못합니다. 받으신 28105 에러(앱과 광고계정의 사업자등록번호가 다릅니다)가 이 조건에 해당합니다.

  1. 하나의 앱(Business Access Token)으로 사업자등록번호가 다른 여러 광고주의 응답 결과를 조회하는 방법은 현재 제공하지 않습니다.
    해당 앱으로는 앱과 사업자등록번호가 같은 광고계정의 응답 결과만 조회됩니다.

  2. 광고주의 응답 결과를 API로 받으려면 광고주 사업자등록번호로 비즈 앱 전환된 카카오디벨로퍼스 앱에서 호출해야 합니다. 이 외에 별도의 권한 설정이나 연동 방법은 없습니다.
    앱 설정 순서는 아래와 같습니다.

  1. 카카오디벨로퍼스 앱 생성 후 비즈 앱 전환 (광고주 사업자 정보로 등록)
  2. 앱 소유자 카카오계정 본인인증
  3. [앱] > [추가 기능 신청]에서 카카오모먼트 사용 권한 신청
  4. 비즈니스 인증 > 접근권한에서 moment_bizform_result_read 추가
  5. 호출하는 카카오계정에 폼 보고서 다운로드 권한 확인. 광고계정 마스터는 모든 폼에 자동 부여되고, 멤버는 폼 ID마다 별도로 받아야 합니다.
    (모먼트 > 광고자산 관리 > 비즈니스폼+ 관리 > 폼 ID > 상세 설정 [관리])

참고 문서

감사합니다.