비즈니스폼+ 응답 결과 API 조회 항목 중 선택 동의문 관련

카카오모먼트 API에 대한 최신 공지는 카카오모먼트 공지사항카카오광고 통합 에이전시 에서 확인 가능합니다.

카카오모먼트 API 외 문의사항은 DevTalk 각 카테고리나 FAQ에서 확인 가능합니다. 카카오모먼트 오픈API 외 자주 발생하는 문의는 아래 게시판에서 확인 및 등록 가능합니다.

︎- AdFit SDK FAQ
︎- AdFit SDK 고객센터 문의
︎- 픽셀&SDK FAQ 1
︎- 픽셀&SDK 고객센터 문의

카카오모먼트 오픈API 권한이 없는 앱, 카카오모먼트 오픈API가 아닌 다른 문의의 경우 답변이 늦어지거나 진행이 불가하오니 이 점 양해 부탁드립니다.

※ 사용 중 문의사항은 아래 내용을 기재하신 후 작성해주시길 바랍니다.
호출 시 발생한 오류의 경우 호출 /응답 내용을 상세히 남겨주시는 것이 확인 및 답변에 도움이 됩니다.

  • 사업자명 : 하쿠호도제일 (고객사 : 한국토요타자동차(주))

  • APP 이름(ID) : 1513119

  • 문의 내용:

안녕하세요, 비즈니스폼+ 응답 결과 API 조회 시 optionalAgreements 값에서
”[선택] 렉서스의 마케팅 메시지를 카카오톡으로 받습니다.” 값이 조회가 안 되어 문의드립니다.

[필수] 개인정보 수집 및 이용 동의 내용, [필수] 개인정보 제3자 제공 및 활용 동의
두 값은 조회 됩니다.

감사합니다.

                }
            ],
            "optionalAgreements": [
                {
                    "title": "개인정보 수집 및 이용 동의 내용",
                    "agree": true
                },
                {
                    "title": "개인정보 제3자 제공 및 활용 동의",
                    "agree": true
                }
            ],
            "channelAddStatus

@yelimkong
안녕하세요, 카카오모먼트입니다.

문의주신 “[선택] 렉서스의 마케팅 메시지를 카카오톡으로 받습니다.” 항목은
폼 만들기의 카카오톡 채널 추가 설정으로 생성되는 동의 항목입니다.

광고주가 직접 작성하는 동의문과는 별도로 관리되기 때문에
optionalAgreements 배열에는 포함되지 않고, 같은 응답 객체의 channelAddStatus 필드로 내려갑니다.

공유해주신 응답 데이터에도 optionalAgreements 바로 다음에 channelAddStatus가 있으니,
이 값으로 응답자별 채널 추가(마케팅 메시지 수신) 여부를 확인하시면 됩니다.

channelAddStatus 값 정의는 아래와 같습니다.

│ 값 │ 의미 │
│ - │ 폼에서 채널 추가 옵션을 사용하지 않음 │
│already added │ 응답 전부터 이미 해당 채널을 추가한 상태 │
│Y │ 이번 응답에서 채널을 추가함 │
│N │ 이번 응답에서 채널을 추가하지 않음 │

즉, 해당 동의 항목이 누락된 것이 아니라 반환되는 필드가 다른 케이스이며, 현재 응답은 정상입니다.
optionalAgreements에는 [필수]/[선택] 여부와 무관하게 동의문 설정에서 만든 항목들이 title, agree 형태로 담깁니다.

스펙은 아래 문서에서도 확인하실 수 있습니다.
https://developers.kakao.com/docs/ko/kakaomoment/bizformplus

추가로 궁금한 점 있으시면 남겨주세요.

감사합니다.

안녕하세요, 답변 주셔서 감사합니다.
제가 비즈폼 세팅을 진행한 것이 아니라 해당 부분에 대해 이제 이해했습니다.

그렇다면 마케팅 활용을 위한 수집 동의(선택)와 카카오톡 채널 추가는 서로 다른 개념이 맞을까요?

카카오 비즈폼에서 채널 추가와는 별개로,
순수한 마케팅 활용 동의를 받기 위한 선택 동의 항목을 설정하려면 동의문에 별도의 [선택] 동의 항목을 추가하면 되는지도 함께 확인 부탁드립니다.

감사합니다 !

@yelimkong

안녕하세요.

  1. 네, 서로 다른 개념이 맞습니다.

카카오톡 채널 추가는 폼 만들기의 카카오톡 채널 추가 설정을 켜고 채널을 선택하면 [선택] (채널명)의 마케팅 메시지를 카카오톡으로 받습니다. 문구가 자동 생성되는 항목입니다. 동의 시 해당 채널의 친구 추가까지 실제로 처리되고, 그래서 API 응답에서도 optionalAgreements가 아니라 channelAddStatus로 반환됩니다.

  1. 네, 동의문에 별도 [선택] 항목을 추가하시면 됩니다.

동의문 설정의 기타 동의문 추가에서 필수 동의 여부를 '선택’으로 두고 제목과 내용을 직접 작성하시면 됩니다. 폼당 최대 5개까지 만들 수 있고, 이렇게 만든 항목은 API 응답의 optionalAgreements에 title, agree로 담깁니다.

다만 동의문 문구와 필수·선택 지정은 광고주가 직접 작성·관리하는 영역이라 카카오에서 내용을 검토하지 않습니다. 마케팅 목적의 정보 분석·활용 동의와 광고성 메시지 발송을 위한 수신 동의는 법적 성격이 다르니, 적용 전 고객사 법무 검토를 받으시길 권장드립니다.

감사합니다.

네, 빠른 답변 감사합니다 !