카카오톡 채널 친구 여부 확인 후 쿠폰 발급 가능 여부 문의

REST API
1

문의 시, 사용하시는 개발환경과 디벨로퍼스 앱ID를 알려주세요.

안녕하세요
문의사항이 있어 글 남깁니다

사용 개발환경은 아래와 같습니다

  • 운영 서비스: Cafe24 쇼핑몰 기반 웹 환경
  • 프론트 구현: Cafe24 스마트디자인 페이지 내 JavaScript
  • 서버 처리: 필요 시 Vercel/API 서버에서 REST API로 카카오 API 호출 예정
  • 운영 도메인: https://dangjang.com
  • 카카오 Developers 앱 이름: 당일장터
  • 카카오 Developers 앱 ID: 1453633
  • 카카오톡 채널명: 당일장터
  • 카카오톡 채널 URL: 카카오톡채널
  • Channel Public ID: _RvLCxj

현재 당일장터 카카오톡 채널 친구에게 3,000원 쿠폰을 제공하는 운영안을 검토 중입니다

검토 중인 방식은 아래와 같습니다

  1. 사용자가 카카오톡 채널 또는 웰컴 메시지에서 쿠폰 받기 페이지로 진입
  2. 당일장터 페이지에서 회원 로그인 또는 카카오 로그인 진행
  3. 카카오톡 채널 관계 조회 API로 당일장터 채널 친구 여부 확인
  4. 친구 상태가 ADDED인 경우에만 Cafe24 쿠폰 발급 이력 확인
  5. 동일 쿠폰을 아직 받지 않은 회원에게만 쿠폰 발급

카카오 Developers 문서상 카카오톡 채널 관계 조회 API와 카카오톡 채널 추가 상태 및 내역(plusfriends) 동의항목이 제공되는 것으로 확인했습니다

아래 항목 확인 부탁드립니다

  1. 위와 같은 회원 인증형 채널 친구 쿠폰 수령 페이지 구조가 카카오 정책 상 가능한가요?
  2. 채널 관계 조회 API로 ADDED, BLOCKED, NONE 상태를 확인한 뒤, ADDED 사용자에게만 당일장터 자체 쿠폰을 발급해도 되나요?
  3. created_at, updated_at, 웹훅 이벤트 등을 활용해 기존 친구와 캠페인 기간 중 신규 친구를 구분할 수 있나요?
  4. 카카오 로그인으로 확보한 카카오 user_id와 Cafe24 회원 ID를 내부 매핑한 뒤, 관계 조회 API를 호출하는 방식이 가능한가요?
  5. 채널 친구 여부 확인을 위해 추가로 필요한 권한, 심사, 앱-채널 연결 절차가 있나요?
  6. 특정 기간의 친구 추가 수, 차단 수, 순증 수, 누적 친구 수를 관리자센터 또는 API로 확인할 수 있나요?

정리하면 저희가 확인하고 싶은 내용은 아래 3가지입니다

  1. 카카오 공식 기능만으로 채널 친구 여부 확인 → 미발급 회원 쿠폰 발급 구조가 가능한지
  2. 기존 친구와 신규 친구를 구분해 쿠폰 지급 조건을 제어할 수 있는지
  3. 이를 위해 추가 신청해야 할 권한이나 설정이 무엇인지

확인 부탁드립니다

감사합니다

2

안녕하세요.

데브톡에서는 디벨로퍼스관련 설정과 API 를 안내하는터라
번거로우시겠지만. 카카오비즈니스 파트너센터에 문의 해보시겠어요?

카카오비즈니스 파트너센터 | kakao 고객센터

1개의 좋아요
3

넵, 문의했는데 그쪽에서는 데브톡에 문의하라고 하셔서 이쪽에 문의드렸습니다

4

안녕하세요.

채널 쿠폰 기능 문의로 판단하여 고객센터로 안내드렸는데요.
고객센터에서는 개발 문의로 접수하시면, 데브톡으로 전달 하는 경우가 있습니다.

우선, 카카오디벨로퍼스 서비스 관점에서 채널 기능과 분리하여 안내드리면

  1. 사용자가 카카오톡 채널 또는 웰컴 메시지에서 쿠폰 받기 페이지로 진입

채널 쿠폰 받기 페이지에서 아래 카카오 로그인 기능을 적용 가능한지 쿠폰 받기 페이지 커스터마이징 가능한지 문의 해보셔야합니다.

채널 쿠폰 받기 페이지에서 자동으로 카카오로그인 하고 카카오로그인 동의창을 웹뷰로 띄우는 것이라면 이용자 불편 유발 할 것으로 보이긴 합니다.

  1. 당일장터 페이지에서 회원 로그인 또는 카카오 로그인 진행
  2. 카카오톡 채널 관계 조회 API로 당일장터 채널 친구 여부 확인

카카오로그인 기능은 웹뷰 또는 웹브라우저에서 누구나 사용할 수 있는 기능이므로 기능 사용에 제약은 없습니다.

다만, 카카오로그인은 운영하시는 서비스 회원가입기능과 연동되어 있으므로 채널 쿠폰 받기 페이지에서 동작할 경우

개인정보 제3자 제공동의 부터 운영하시는 사이트 로그인 후 랜딩 페이지로 이동까지 진행되므로 이역시 이용자가 이해하기 어려운 동선으로 보입니다.

  1. 친구 상태가 ADDED인 경우에만 Cafe24 쿠폰 발급 이력 확인
  2. 동일 쿠폰을 아직 받지 않은 회원에게만 쿠폰 발급

이 부분은 채널 쿠폰 발급 여부 조합 정보 조회 기능으로 판단되는데요. 이역시 파트너 관리자 센터에 문의 하셔야합니다.

데브톡에서는 디벨로퍼스에 관한 안내를 하는터라 채널의 기능 제공 가능여부를 확답드릴 수 없어서 고객센터로 안내드렸지만,

답변을 드리며 검토 해보니
말씀하신 내용은 카카오로그인을 사용할 필요가 없는 내용으로
채널 쿠폰 페이지 진입 시, (1) 친구추가 기능 제공 및 친구 여부에 따른 쿠폰 등록 버튼 활성화 (2) 기존 친구와 신규 친구를 구분해 쿠폰 발급 기능 으로 해소 가능한 내용으로 판단됩니다.

즉, 말씀하신 내용을 서비스측에서 카카오톡 내 동선을 직접 변경하는 것이 아니라

카카오비즈니스 파트너센터에 채널 쿠폰 기능 개선제안으로 접수 하는 것이 적절해 보입니다.

검토해보시겠어요?

1개의 좋아요
6
  1. 사용자가 카카오톡 채널 홈의 CTA 버튼을 클릭
  2. CTA 링크로 저희 서버 URL에 진입
  3. 서버에서 카카오 로그인 OAuth를 진행하거나 기존 카카오 로그인 세션 확인
  4. 카카오톡 채널 관계 조회 API와 plusfriends 동의항목을 활용해 사용자의 채널 관계 상태 확인
  5. relation, created_at, updated_at 또는 채널 웹훅 added/blocked 이벤트를 기준으로 아래 3가지 상태를 구분
    • 캠페인 진입 후 신규로 채널 추가한 사용자
    • 기존 채널 친구
    • 차단 후 다시 추가한 사용자
  6. 결과를 저희 DB에 저장
  7. 당일장터 로그인 URL 또는 쿠폰 발급 URL로 redirect
  8. 신규 채널 추가자인 경우에만 Cafe24 쿠폰을 자동 발급

위 구조와 관련해 아래 항목 확인 부탁드립니다

  1. 카카오 채널 홈 CTA 버튼의 외부 URL 클릭만으로는 사용자를 식별할 수 없고, 카카오 로그인 OAuth를 거쳐야 사용자 식별이 가능한 것으로 이해하면 맞을까요?

  2. 카카오 로그인 OAuth 후 확보한 사용자 식별값으로 카카오톡 채널 관계 조회 API를 호출하여 해당 사용자의 채널 관계 상태를 확인할 수 있나요?

  3. 카카오톡 채널 관계 조회 API 사용을 위해 필요한 동의항목이 카카오톡 채널 추가 상태 및 내역(plusfriends)인지 확인 부탁드립니다

  4. 관계 조회 API 응답의 relation 값으로 ADDED, BLOCKED, NONE 상태를 구분할 수 있는지 확인 부탁드립니다

  5. 관계 조회 API 응답의 created_at, updated_at 값을 활용해 기존 친구와 캠페인 진입 후 신규로 친구 추가한 사용자를 구분할 수 있나요?

  6. relation이 이미 ADDED인 경우 기존 친구로 보고 쿠폰 발급 대상에서 제외하고, relation이 NONE이었다가 채널 추가 후 ADDED로 바뀐 경우 신규 추가자로 보고 쿠폰을 발급하는 구조가 가능한가요?

  7. relation이 BLOCKED인 사용자를 차단 이력이 있는 사용자로 보고 쿠폰 발급 대상에서 제외하는 방식이 가능한가요?

  8. 채널 웹훅의 added, blocked 이벤트를 저희 서버에서 수신하여 DB에 저장하면, 이후 OAuth 사용자와 매칭하여 기존 친구 / 신규 친구 / 차단 후 재추가 사용자를 구분하는 데 활용할 수 있나요?

  9. 채널 웹훅에서 전달되는 id 또는 app_user_id와 카카오 로그인 OAuth로 확보한 user_id를 같은 사용자 기준으로 매칭할 수 있나요?

  10. 카카오 로그인 OAuth 완료 후 저희가 지정한 당일장터 로그인 URL 또는 쿠폰 발급 URL로 redirect하는 구조에 제한 사항이 있나요?

  11. 모바일 카카오톡 인앱브라우저에서 채널 홈 CTA → OAuth → 관계 조회 → DB 저장 → 당일장터 URL redirect 흐름을 구현할 때 주의해야 할 제한 사항이 있나요?

정리하면, 저희가 확인하고 싶은 핵심은 아래입니다

카카오 채널 홈 CTA 버튼을 통해 들어온 사용자를 OAuth로 식별한 뒤,
카카오톡 채널 관계 조회 API와 채널 웹훅 데이터를 함께 활용하여
“캠페인 진입 후 신규로 채널을 추가한 사용자”에게만 쿠폰을 자동 발급하는 구조가 가능한지 확인 부탁드립니다

감사합니다

7

안녕하세요.

말씀하신 내용 검토 하여 우선 중요한 제약사항 몇가지 먼저 안내드립니다.

(1) 기재하신 사이트는 카페24를 활용해 892678 디벨로퍼스앱을 사용하고 있고,
기재하신 디벨로퍼스앱 1453633는 동일한 이름의 또다른 디벨로퍼스앱입니다.
동일 서비스에서 다른 디벨로퍼스앱을 사용하는 것은 운영정책 위반이 됩니다.

제5조(금지된 행동) 23. 동일한 서비스에서 여러 개의 개발자 웹사이트 계정 및 애플리케이션을 생성하여 운영하는 행위

(2) 운영하시는 사이트가 독립몰이 아닌 카페24이므로 말씀하신 이벤트로 카카오로그인 연동 시,
해당 유저가 사이트에 가입한적 없는 유저라면 카페24에 신규가입 할때 동의창이 표시안되는 문제가 있습니다.
즉, 개인정보 제3자 정보제공 동의 절차 없이 가입하므로 개인정보 보호법 준수에 문제가 있을 것으로 보입니다.

(3) 카페24와 같은 호스팅 서비스는 회원가입 항목과 동일한 개인정보 동의항목 설정이 동기화됩니다. 하지만 개인정보 동의항목은 회원가입 목적으로만 사용할 수 있어서 이벤트 동선에서 사용하실 수는 없고 이벤트에 앞서 가입이 전제되어야합니다.

1.앞서 안내드린 것과 같이 외부 URL로 카카오톡 인앱브라우저를 띄우고 사이트와 별개의 카카오로그인 했을때, 최초가입자는 동의창이 표시되고 사이트 가입용으로 카페24에서 설정한 개인정보 동의 항목 및 서비스약관 까지 모두 동의 받게 됩니다.

  • 카페24의 가입자 동선에 영향을 주어 미가입자 이벤트 수행 시, 가입 시점 동의를 받지 못하는 상황으로 이러한 동선을 권장 드리지는 않습니다.

2.네, 가능합니다.

3.네, 맞습니다.

4.네, 구분가능합니다. (가이드)

5.신규 캠페인 이후 채널친구 추가 여부는 등록일로 식별 가능합니다. 다만 채널 친구추가 유입 경로까지는 알 수 없으므로 별도 추적하셔야하나 일반적으로 이용자 착오도 있을 수 있고 편의상 등록일로 식별하는 것이 좋습니다.

6.7. 그렇게 신규추가자/차단후 친구추가자로 보는 것은 맞지만, 특정 시점의 relation 값을 모두 알고 있어야 가능하므로 CTA 버튼을 클릭해 채널관계조회 동의 하는 동선상으로는 불가능하며,
쿠폰 발급은 카카오디벨로퍼스에서 제공하고 있지 않아 내용을 알지 못하는데요. 채널 관리자 센터에 쿠폰 발급 시스템 연동은 문의 해보시면 좋을 것 같습니다.

8.일반적인 카카오로그인 가입 동선이 아니므로 운영하시는 서비스 약관 동의 받으시면 가능합니다.

9.네, 동일한 디벨로퍼스앱을 사용한다는 전제로 동일합니다. (동일한 카카오계정이더라도 다른 디벨로퍼스앱을 사용하면 다른 값이 전달됩니다.)

10.앞서 안내드린 (2), (3)번 제약이 있습니다.

  1. 독립몰이 아닌 카페24 사용 제약이 있으므로 말씀하신 내용은 구현 불가하다고 판단되며

아래 내용 제안드립니다.

  • 이벤트용 별도 디벨로퍼스앱 사용 불가

(1) 동일 디벨로퍼스앱에 카카오톡 채널 추가 상태 및 내역(plusfriends) 동의항목 [필수동의] 활성화
ㄴ 기존 사용자도 카카오로그인 시, 동의 안된 plusfriends 동의받기 위해 동의창 표시됨.

(2) 모바일 카카오톡 인앱브라우저에서 채널 홈 CTA → 카페24 사이트 회원가입(기존 회원로그인) → 채널 친구추가 이벤트 표시
ㄴ 카카오로그인 시, 친구추가 동의항목에 동의하여 채널 친구추가될 수도 있고, 채널에서 직접 친구추가할 수도 있습니다.

(3) 카카오톡 채널 친구 추가 웹훅을 별도 서버로 수신 받고 → 별도 서버에서 어드민키를 이용하여 콜백으로 받은 앱유저 ID로 카카오톡 채널 관계 조회 API 호출
ㄴ 미가입자라면 에러 발생
ㄴ 가입자라면 결과 조회 → 채널 친구 추가를 했고, 웹훅 처리 내역에 차단 이력이 없으면 → 쿠폰 발급

  • 카카오로그인으로 plusfriends 동의 받지 않은 유저는 기존 채널 친구 여부를 알 수 있는 방법이 없으므로
  • 이벤트 이후, 웹훅 내역을 저장하여 차단 내역을 저장하면 이벤트 혜택 목적으로 차단후, 친구 추가했는지 조회 가능

검토 해보시겠어요?

1개의 좋아요
8

디테일한 답변 감사드립니다!!

1개의 좋아요