Sync Dev

Sync Dev

카카오싱크 퍼머링크(일명 카카오싱크 qr) 발급 안내

 

카카오싱크 간편가입을 위한 연동25을 마쳤다면,
아래와 같은 사용자 시나리오를 지원할 수 있습니다.

회원가입유도

위 시나리오의 장점은

오프라인 환경에서 사용자의 QR스캔 & 동의 한 번으로 회원을 확보하실 수 있습니다.
이때 사용자 디바이스에 설치된 카카오톡 클라이언트의 계정 정보를 활용하기에, 사용자가 자신의 카카오계정 id/pw로 로그인하는 절차도 생략됩니다

위 시나리오를 사용자 입장에서 구분하면 아래 순서입니다.

  1. 사용자가 오프라인 매장에 부착된 QR코드를 카카오톡 또는 다른 앱으로 QR코드 스캔
  2. 사용자가 카카오톡 인웹뷰에서 서비스 가입을 위한 ‘카카오싱크 간편가입 화면’ 확인
  3. 사용자가 동의하면 가입 후 멤버십 화면을 보게 됨

위 시나리오의 지원을 위해서는 카카오싱크 퍼머링크라고 부르는 일종의 브릿지 URL이 필요합니다.
카카오싱크 퍼머링크

어떤 앱으로 QR코드를 스캔하더라도,
카카오톡 클라이언트를 실행하고,
카카오톡 인웹뷰를 실행해, 여러분의 서비스 URL로 리다이렉트 해주는 역할을 합니다.

카카오싱크 퍼머링크 발급 방법

카카오싱크 퍼머링크와 QR 코드 발급을 지원하는 홍보도구가 오픈하기 전까지는,
번거로우시겠지만 DevTalk에 새 주제를 작성해 신청해주세요.
(@sally.skk 멘션을 덧붙여 주시면 더 빨리 확인할 수 있습니다)

필요한 정보

  1. 카카오싱크 퍼머링크의 서비스 랜딩URL
  2. 디벨로퍼스 앱과 연결된 카카오톡 채널의 검색용 아이디
    확인방법
    ㄴ https://business.kakao.com/dashboard103 로그인 후, 아래 네모 표시한 아이디를 알려주세요.
    image

신청 시 참고할 점

  • 카카오싱크 퍼머링크는 카카오톡 클라이언트 & 인웹뷰 실행을 지원하는 브릿지 URL로, 리다이렉트할 서비스 URL이 있어야만 의미가 있습니다. 따라서 이 자체로는 카카오싱크 연동을 생략하거나 우회할 수 있는 스펙이 아닙니다. 카카오싱크 연동41을 마친 분들에 한 해 사용하실 수 있습니다.
  • 리다이렉트할 서비스 URL이란 '카카오싱크 간편가입 화면을 호출하는 서비스의 URL을 의미합니다. 자세한 생성 방법은 아래 가이드를 참고하세요
  • 카카오싱크 퍼머링크는 https://pf-link.kakao.com/.../86… 과 같은 URL로, 현재는 카카오IP를 활용한 QR코드 이미지까지는 지원하지 않습니다. QR코드 생성 자체는 QR생성기를 활용해주세요.

카카오싱크 퍼머링크가 랜딩될 서비스 URL 확인 방법

카카오 로그인 API 또는 SDK 연동을 마쳤다면, 서비스 로그인 페이지의 ‘카카오 로그인’ 버튼의 랜딩 URL을 그대로 쓰실 수도 있습니다.

하지만 연동 방식에 따라서는, ‘카카오싱크 간편가입’ 화면을 호출하는 서비스 URL 자체가 없는 경우도 있습니다.

예1) 서비스 로그인 페이지에서 카카오 로그인을 위한 코드 받기를 바로 요청함
예2) 서비스 로그인 페이지에 JavaScript SDK를 import하고 사용자가 카카오 로그인 버튼을 클릭하면 카카오싱크 간편가입 화면을 호출하고 있음

위 경우 아래 방법으로 '카카오싱크 간편가입 화면을 호출하는 서비스 페이지(URL)'를 만들 수 있습니다.

카카오 로그인을 REST API 방식으로 연동한 경우
서비스 URL이 https://example.com/login/kakao41 라고 가정하면, 사용자가 해당 페이지를 보면 항상(또는 userAgent 값이 KAKAOTALK일 때) 코드 받기52 요청을 해주세요(kauth.kakao.com/oauth/authorize?client_id=40…)

카카오 로그인을 JavaScript 방법으로 연동한 경우
서비스 URL이 https://example.com/login/kakao41 라고 가정하면, 사용자가 해당 페이지를 볼 때 '카카오싱크 간편가입 화면(카카오 로그인)'을 호출해주세요.

위처럼 구현하시면 QR 코드를 스캔한 사용자는

1) 카카오싱크 퍼머링크 브릿지를 거쳐, 2) '서비스 URL’에 진입한 뒤, 3) 카카오싱크 간편가입 동의를 하고(이미 동의한 경우 생략), 4) '카카오싱크 간편가입’한 상태로 여러분 서비스 화면에 도달하는 것입니다

또 유입된 경로(예: 오프라인 지점)에 따라, 지점별 행사 페이지를 보여주거나 시즈널 이벤트 페이지로 리다이렉트하실 수도 있습니다(이때 가입처리한 회원이 볼 화면을 조정하시는 것은 여러분의 몫입니다).

  • 사용자의 유입 경로 판별을 위해 카카오싱크 퍼머링크 뒤에 파라미터를 붙여 활용하실 수 있습니다.
    아래 답글에서 확인해주세요.

이전으로