광고주용 실행 가이드

모먼트 참여형광고 비즈니스폼+ 응답 결과 조회 API 세팅 가이드

광고주 카카오계정으로 디벨로퍼스 앱과 비즈니스 토큰을 준비하고, API 개발자가 광고계정 ID와 폼 ID로 응답 결과를 조회할 수 있게 만드는 절차입니다.

광고주 주체 광고계정의 마스터 관리자 카카오계정

개발자 주체 비즈니스폼+ 응답 결과 조회 API 개발자

완료 기준 비즈니스 토큰, 광고계정 ID, 폼 ID로 API 호출 성공

준비물

아래 항목이 준비되어야 마지막 API 호출까지 진행할 수 있습니다.

광고계정 마스터 관리자 권한 광고주 카카오계정이 대상 모먼트 광고계정의 마스터 관리자여야 합니다.

사업자등록번호 일치 디벨로퍼스 앱과 모먼트 광고계정의 사업자등록번호가 일치해야 합니다.

비즈니스폼+ 권한 조회할 폼에 대한 보고서 다운로드 권한이 필요합니다.

비즈니스 토큰 관리 토큰은 광고주 권한을 포함하므로 메신저, 문서, 로그에 노출하지 않습니다.

광고주

광고주가 먼저 할 일

카카오디벨로퍼스에서 앱을 만들고, 비즈 앱으로 전환한 뒤, 카카오모먼트 사용 권한을 신청합니다. 승인 후 REST API 테스트 도구에서 비즈니스 토큰을 발급합니다.

카카오디벨로퍼스 앱 만들기

카카오디벨로퍼스에 접속해 내 애플리케이션에서 새 앱을 생성합니다.

카카오디벨로퍼스에 광고주 카카오계정으로 로그인합니다.
내 애플리케이션으로 이동합니다.
앱 추가하기를 눌러 앱 이름과 사업자 정보를 입력합니다.

비즈 앱으로 전환하기

생성한 앱의 사업자 정보를 등록하고 비즈 앱 전환을 완료합니다.

앱 대시보드에서 앱 설정 > 일반으로 이동합니다.
비즈니스 정보를 등록합니다.
등록 완료 후 비즈 앱 상태를 확인합니다.

디벨로퍼스 앱에 등록한 사업자등록번호는 모먼트 광고계정의 사업자등록번호와 같아야 API 호출 조건을 만족합니다.

카카오모먼트 사용 권한 신청

앱 관리의 추가 기능 신청에서 카카오모먼트 권한을 신청하고 승인 상태를 확인합니다.

앱 관리 > 추가 기능 신청으로 이동합니다.
신청 자격을 확인하고 약관에 동의합니다.
카카오모먼트를 선택해 신청합니다.
신청 완료 후 승인 완료 상태가 될 때까지 확인합니다.

비즈니스 인증 토큰 발급

REST API 테스트 도구에서 비즈니스 토큰 정보를 조회하고 토큰을 확인합니다.

도구 > REST API 테스트 > 비즈니스 토큰 정보 조회로 이동합니다.
위에서 만든 앱을 선택합니다.
카카오모먼트를 선택하고 모든 비즈니스 자산에 동의합니다.
발급된 비즈니스 토큰을 개발자에게 안전한 채널로 전달합니다.

비즈니스 토큰은 광고주님의 권한을 포함합니다. 화면 공유, 메신저, 공개 문서, 로그 저장소에 원문이 남지 않도록 관리합니다.

광고계정 ID와 폼 ID 확인

API 개발자에게 전달할 광고계정 ID와 비즈니스폼+ 폼 ID를 확인합니다.

모먼트 광고계정에서 사업자등록번호가 디벨로퍼스 앱과 같은지 확인합니다.
대상 참여형광고에서 연결된 비즈니스폼+의 폼 ID를 확인합니다.
개발자에게 비즈니스 토큰, 광고계정 ID, 폼 ID를 전달합니다.

모먼트 광고계정 사업자등록번호 확인 — 22. 광고계정 사업자등록번호 확인

개발자

API 개발자가 이어서 할 일

광고주가 전달한 비즈니스 토큰, 광고계정 ID, 폼 ID를 이용해 비즈니스폼+ 응답 결과 조회 API를 호출합니다.

API 스펙 확인

최신 필드와 에러 코드는 카카오디벨로퍼스 비즈니스폼+ 관리 문서를 기준으로 확인합니다.

구분	값	설명
Method	`GET`	응답 결과 조회 요청
URL	`https://apis.moment.kakao.com/openapi/v4/adAccounts/bizFormPlus/report`	카카오모먼트 비즈니스폼+ 응답 결과 조회 엔드포인트
Header	`Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}`	광고주가 발급한 비즈니스 토큰
Header	`adAccountId: ${AD_ACCOUNT_ID}`	조회 대상 모먼트 광고계정 ID
Query	`formId=${FORM_ID}`	비즈니스폼+ 폼 ID. 예: `MA-1006`
Query	`size`, `cursorId`	페이징이 필요할 때 사용. `size`는 최대 1,000개입니다.

광고계정과 폼 ID로 조회 요청하기

실제 토큰은 코드나 문서에 직접 저장하지 말고 서버 환경변수나 보안 저장소에서 주입합니다.

curl 요청 예시

curl -G 'https://apis.moment.kakao.com/openapi/v4/adAccounts/bizFormPlus/report' \
  -H 'Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}' \
  -H 'adAccountId: ${AD_ACCOUNT_ID}' \
  --data-urlencode 'formId=${FORM_ID}' \
  --data-urlencode 'size=100'

hasNext가 true이면 응답의 nextCursor 값을 다음 요청의 cursorId로 전달해 다음 페이지를 조회합니다.

다음 페이지 요청 예시

curl -G 'https://apis.moment.kakao.com/openapi/v4/adAccounts/bizFormPlus/report' \
  -H 'Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}' \
  -H 'adAccountId: ${AD_ACCOUNT_ID}' \
  --data-urlencode 'formId=${FORM_ID}' \
  --data-urlencode 'size=100' \
  --data-urlencode 'cursorId=${NEXT_CURSOR}'

응답 결과 확인

code가 200이고 message가 Success이면 조회가 성공한 상태입니다.

응답 예시

{
  "code": 200,
  "message": "Success",
  "data": [
    {
      "applyId": 21682,
      "submittedAt": "2026-06-09 16:17:02",
      "expiresAt": "2026-09-07 16:17:02",
      "email": null,
      "birthDate": null,
      "gender": null,
      "name": null,
      "phoneNumber": "010-0000-0000",
      "address": null,
      "answers": [],
      "optionalAgreements": [],
      "channelAddStatus": "-",
      "inflowSource": "기타"
    }
  ],
  "hasNext": false,
  "nextCursor": 21682
}

응답 결과에는 전화번호, 이메일, 주소 등 개인정보가 포함될 수 있습니다. 저장 기간, 접근 권한, 다운로드 로그를 내부 보안 기준에 맞춰 관리합니다.

전달 체크리스트

광고주와 개발자가 아래 4가지를 확인하면 세팅과 개발 준비가 끝납니다.

비즈 앱 전환 완료 디벨로퍼스 앱이 비즈 앱 상태입니다.

카카오모먼트 권한 승인 완료 추가 기능 신청에서 카카오모먼트가 승인 완료 상태입니다.

비즈니스 토큰 전달 완료 개발자에게 안전한 채널로 비즈니스 토큰을 전달했습니다.

광고계정 ID·폼 ID 전달 완료 API 요청에 사용할 adAccountId와 formId가 확인되었습니다.