안녕하세요, 이번 개편되는 카카오 비즈폼 플러스의 [ 결과보고서 API 연동문서 ] 를 어디서 확인할 수 있는지 문의드립니다.
홈페이지에 오픈된
이 문서 링크가 아닌 연동 가이드 문서 요청드립니다.
이전 전달받은 비즈니스폼 결과 보고서 API 연동 문서 내에 있는 내용이 필요합니다.
‘’’
3.2. API 연동 테스트
아래 테스트용 샘플 비즈니스폼을 통해 각 API의 JSON 응답결과가 실제로 어떻게 내려오는지 확인하실 수 있습니다.
‘’’
이 부분 테스트 작업 및 상세 커스텀 내용 호출 결과를 확인할 수 있기 때문입니다.
제가 잘못 인지한 부분이 있다면 공유주시기 바랍니다.
감사합니다.
카카오모먼트 API에 대한 최신 공지는 카카오모먼트 공지사항 및 카카오광고 통합 에이전시 에서 확인 가능합니다.
카카오모먼트 API 외 문의사항은 DevTalk 각 카테고리나 FAQ에서 확인 가능합니다. 카카오모먼트 오픈API 외 자주 발생하는 문의는 아래 게시판에서 확인 및 등록 가능합니다.
︎- AdFit SDK FAQ
︎- AdFit SDK 고객센터 문의
︎- 픽셀&SDK FAQ 1
︎- 픽셀&SDK 고객센터 문의
카카오모먼트 오픈API 권한이 없는 앱, 카카오모먼트 오픈API가 아닌 다른 문의의 경우 답변이 늦어지거나 진행이 불가하오니 이 점 양해 부탁드립니다.
※ 사용 중 문의사항은 아래 내용을 기재하신 후 작성해주시길 바랍니다.
호출 시 발생한 오류의 경우 호출 /응답 내용을 상세히 남겨주시는 것이 확인 및 답변에 도움이 됩니다.
카카오 세일즈 담당자를 통해서, 기존 비즈니스폼의 결과 보고서 API 스펙을 확인하실 수 있으십니다.
광고주님의 사업자정보 알려주시면,
카카오 세일즈 담당자를 통해, 안내드릴 수 있도록 전달하겠습니다.
감사합니다.
안녕하세요, 제가 글에 올린 2개 링크도 카카오 비즈니스폼 API 연동 관련 담당자분께서 전달주신 링크인데
제가 원하는 건 이번 개편되는 카카오 비즈폼 플러스의 [ 결과보고서 API 연동문서 ] 입니다.
현재 기존 카카오 비즈니스폼 결과보고서 API 연동문서는 보유중입니다.
비즈폼 플러스와 기존 비즈니스폼 결과보고서 API 연동문서는 다르지 않나요?
현재 고객사를 담당하고 있는 광고 대행사여서요.
고객사 : 토요타
현재 회사 : 하쿠호도제일 입니다.
모먼트 > 참여형 광고
https://business.kakao.com/info/engagementads/
집행을 통해 응답 완료된 데이터는
-
Web : 폼 보고서 > 응답 결과 보고서에서 확인 가능하십니다https://kakaobusiness.gitbook.io/main/ad/moment/engagement/bizformplus/manage#id-6-2-2
-
API : 카카오모먼트 > 비즈니스폼+ 관리 > 비즈니스폼+ 응답 결과 조회 API로 조회 가능하십니다.
https://developers.kakao.com/docs/ko/kakaomoment/bizformplus
비즈니스폼+ 관리 스펙상 설명되어 있는것 처럼
-
kakao developers에서 비즈앱(광고계정에 등록된 사업자등록번호와 동일해야 함)을 만들고
-
모먼트 API 권한 획득
-
비즈니스 인증 기능과 비즈니스폼+ 응답 결과 조회 권한 획득
-
조회할 모먼트 광고계정과 폼ID에 대한 권한 획득
GET 메서드로
비즈니스폼+ 응답 결과 조회를 요청해주시면 됩니다.
안녕하세요. 상세하게 답변주셔서 감사합니다.
카카오모먼트 비즈니스폼+ 응답 결과 조회 API 연동 관련하여 세 가지 문의드립니다.
대상 API : 비즈니스폼+ 응답 결과 조회
(GET https://apis.moment.kakao.com/openapi/v4/adAccounts/bizFormPlus/report)
1. 비즈니스 토큰의 무인 반복 발급 가능 여부
비즈니스 토큰은 refresh_token 방식이 아닌 것으로 확인됩니다. 배치 자동화를 위해, 최초 인가코드 동의 이후 사람 개입 없이 앱 REST API 키와 client_secret만으로 비즈니스 토큰을 반복 발급할 수 있나요?
만약 발급 시마다 유효한 인가코드가 필요하다면, 한 번 발급받은 인가코드를 이후 발급에 재사용할 수 있는지, 아니면 매 발급마다 사용자 동의(authorize)를 다시 거쳐야 하는지도 확인 부탁드립니다.
2. 테스트 앱에서의 호출 가능 여부
이 API를 테스트 앱에서 호출할 수 있나요? 테스트 앱 문서의 ‘테스트 앱용 추가 기능’ 목록에 해당 API가 없고, ‘응답 범위가 멤버로 제한되는’ 제품 목록에도 카카오톡 메시지·소셜·톡캘린더만 명시되어 있어, 비즈니스폼+ 응답 조회가 테스트 앱에서 어떻게 취급되는지 확인이 필요합니다.
3. 테스트 앱 조회 시 응답 범위
2번이 가능한 경우, 원본 앱이 해당 API 사용 권한을 획득한 상태에서 테스트 앱으로 조회하면 실제 운영 폼에 제출된 전체 응답을 받을 수 있나요? 아니면 테스트 앱 멤버 본인과 관련된 응답만 조회되는 등 범위 제한이 적용되나요?
감사합니다.
@yelimkong
안녕하세요. 답변이 늦어 죄송합니다. (제가 멘션을 놓쳤습니다.)
- 비즈니스 토큰의 무인 반복 발급
말씀하신 대로 비즈니스 토큰은 리프레시 토큰 방식이 아닙니다.
발급은 POST 카카오계정 grant_type=authorization_code로 요청하고, 응답에 access_token·token_type·scope만 내려옵니다. 앱 REST API 키와 client_secret만으로 발급하는 경로는 문서상 제공되지 않습니다.
인가 코드 재사용 가능 여부와 무인 자동화 범위는 카카오 로그인·비즈니스 인증 쪽 정책이라 제가 단정해서 말씀드리기 어렵습니다.
- 테스트 앱에서의 호출 가능 여부
테스트 앱으로는 호출할 수 없습니다. 테스트 앱은 비즈니스 정보 등록과 비즈니스 인증이 지원되지 않아, 응답 범위 제한 이전에 비즈니스 토큰 발급 단계에서 막힙니다.
- 테스트 앱 조회 시 응답 범위
2번이 불가하므로 해당 사항이 없습니다.
대신 아래 방법으로 실제 테스트가 가능합니다.
- 대행사 사업자번호로 만든 광고계정과 디벨로퍼스 앱을 쓰면 광고 집행 없이도 폼 생성·응답 제출·API 조회가 모두 됩니다
- 폼은 https://bizformplus.kakao.com?formId=MA-XXXXXX 링크를 카카오톡 채팅방에 붙여넣고 클릭해 접속합니다 (trackId 불필요)
- 동일 카카오계정은 폼당 1회만 응답할 수 있어, 반복 제출 테스트에는 카카오계정이 여러 개 필요합니다
- 별도 mock 데이터는 제공하지 않습니다. 연동 개발은 공식 문서의 응답 예시를 참고해 주세요
감사합니다.
