유저인게이지먼트(UE, 딥링크)

유저 인게이지먼트(User Engagement)란, 모바일 메시지(SMS), 푸시 알림(Push Notification)으로 전송된 메시지 내의 URL클릭 시, 게임을 실행시키고 게임 내 특정 위치에 바로 도달하는 기능입니다. 다양한 마케팅 이슈에 대응할 수 있도록 구성된 서비스로, 콘솔에서 쿠폰 전송, 게임 접속 유도 목적으로 URL을 생성할 수 있습니다.

주요 기능¶

다양한 목적의 딥링크 생성 및 관리
- 인게임 딥링크를 생성할 수 있습니다.
- 자동 생성된 쿠폰 딥링크 및 생성한 인게임 딥링크에 대한 수정 및 삭제 관리
게임 설치 유무 및 유저의 단말 환경에 따른 대응
- OS별 상황에 알맞는 플로우를 제공합니다.
- 게임 설치 유무에 따른 플로우를 제공합니다.
쿠폰에서 에러 발생시 처리
- 쿠폰 에러 발생 원인을 알리고 대처 방법을 안내합니다.
모바일 랜딩 URL을 PC웹에서 접속시 처리
- 모바일로 접속할 수 있도록 유도합니다.

사용 전 준비 사항¶

게임 클라이언트 내 AD는 AndroidManifest.xml 파일 수정, iOS는 URL Type 추가
OS별로 자동으로 분기할 수 있는 게임 다운로드 URL발급

사용 프로세스¶

딥링크 사용 예시¶

SMS로 보내는 경우¶

보상 지급으로 인한 대량 쿠폰 전송 시, 메시지 내에 쿠폰 딥링크를 넣어 전송할 수 있습니다.
사전등록 이벤트로 인한 대량 쿠폰 전송 시, 메시지 내에 쿠폰 딥링크를 넣어 전송할 수 있습니다.
예시: 사전등록 쿠폰을 받으세요! -> 쿠폰 URL클릭 -> 게임 진입 후 우편함에서 보상 수령

푸시 알림 메시지로 보내는 경우¶

던전 오픈 알림, 깜짝 이벤트 푸시 메시지 내에 인게임 딥링크를 넣어면 게임 내 해당 위치로 바로 도착합니다.
예시 : 던전이 열렸어요! 빨리 접속하세요! -> 푸시 메시지 클릭 -> 게임 내 던전 맵 화면으로 도착

게임 내에서 게임 내로 이동하는 경우¶

게임 내 공지글을 클릭하면, 게임 내 타켓 위치로 이동합니다.
예시 : 새소식 내 이벤트 공지글 -> 링크 클릭 -> 게임 내 이벤트 위치로 이동

딥링크 생성하기¶

딥링크는 다음과 같이 2종류의 딥링크를 생성할 수 있습니다. 마켓별 앱아이디는 하나만 활성화해야합니다.

쿠폰 딥링크
- 쿠폰값이 적용된 딥링크
- 유저가 링크 클릭시 게임이 실행되고 우편함에서 아이템을 수령할 수 있음
인게임 딥링크
- 게임 내에서 배너나 링크 클릭시 게임 내 특정 위치로 이동할 수 있는 것
- 던전, 우편함 등 게임에서 정의한 path 값으로 딥링크를 만들 수 있음

메인화면¶

① 인게임 딥링크 생성하기 : 클릭시 뜨는 팝업에 생성할 내용을 입력할 수 있습니다.

② 검색하기 : 등록된 딥링크 내역 중 조건값으로 검색 할 수 있습니다.

③ 딥링크 생성번호(중복되지 않음)

④ 딥링크 종류 : 쿠폰 딥링크, 인게임 딥링크

⑤ 모바일 OS : 게임별로 지원하는 OS별로 딥링크를 만들어야 합니다.

⑥ 랜딩 URL : 유저에게 제공하는 URL

⑦ 생성자 ID : 최초로 딥링크를 생성산 그룹웨어 ID(실제이름)

⑧ 상세보기 : 생성한 딥링크의 상세내역을 확인

쿠폰 딥링크¶

쿠폰 딥링크는 '프로모션 > 앱설정 > 기본설정'에서 앱아이디 별 다운로드 URL을 입력 후 저장 시 자동으로 AppID별 딥링크가 생성됩니다. 만약, 다운로드 URL를 변경하면 기존 생성된 딥링크의 다운로드 URL이 자동 동기화됩니다. (2019-10-22 기준으로 이전에 생성된 딥링크는 유지됩니다.)

인게임 딥링크¶

메인화면에서 '인게임 딥링크 생성' 버튼 클릭 시, 인게임 딥링크 생성이 가능합니다.

① APP ID : 앱아이디별로 링크를 생성합니다. 따라서 하나의 게임에 OS별로 각각 링크를 생성해야 합니다.

② 이벤트 내용 : 이벤트명 또는 이벤트 내용을 간략히 적습니다.

③ 타겟 위치 입력 : 유저가 클릭시 이동할 path를 입력합니다. - hive 선택 : Hive에서 제공하는 서비스로 이동할 수 있는 path. ex) 1:1 문의하기 등 - game 선택 : 게임 내 이동할 path. 게임팀에 문의하여 입력할것. ex) 던전, 우편함 등 - 하단의 “인게임 딥링크 생성에서 등록할 수 있는 타켓 위치 리스트” 참조

④ 다운로드 URL : 게임별로 통합 다운로드 URL을 발급받아 넣습니다. - 링크 입력시 http:// 필수

⑤ 서비스 상태 : 링크를 삭제하지 않더라도 활성화/비활성화 상태를 선택하여 링크 접근을 차단/미차단 할 수 있습니다.

⑥ 확인 버튼 : 정보 입력후 확인버튼을 누르면 하단 영역에서 입력한 내용을 확인할 수 있습니다. 입력한 내용이 맞는지 확인후 [생성하기] 버튼을 클릭하면 생성 및 등록됩니다.

인게임 딥링크 생성에서 등록할 수 있는 타켓 위치 리스트¶

<Hive 주소인 경우>

AppID://hive/authlogin, AppID://hive/auth/login Hive 로그인 화면으로 이동합니다. 게스트 로그인을 하여 접속한 경우에는 로그인 페이지를, 로그인하여 접속한 경우에는 화면 노출 없이 자동 로그인이 진행됩니다.
AppID://hive/socialinquiry, AppID://hive/social/inquiry 1:1 문의하기 페이지로 이동합니다.
AppID://hive/promotionshow?type={number}, AppID://hive/promotion/show?type={number} Type값({number})으로 입력 받은 값에 해당하는 viewid를 가진 커스텀뷰 페이지로 이동합니다.
- 예시 AppID://hive/promotionshow?type=123456
AppID://hive/offerwallshow, AppID://hive/promotion/offerwall Offerwall 페이지로 이동합니다.
AppID://hive/promotioncoupon?couponid={couponid}, AppID://hive/promotion/coupon?couponid={couponid} {Couponid}로 입력 받은 쿠폰 소모 처리를 진행합니다. 쿠폰 처리를 진행한 결과는 C2SModuleApi_EngagementConsumeCoupon 콜백으로 전달받습니다.
- 예시 AppID://hive/promotioncoupon?couponid=swccoupon2020

<게임 주소인 경우>

AppID://game/{path}?{query} 게임 내부 기능으로 이동하기 위한 스키마. 게임 내부에서 정의된 {path}값을 넣어 줍니다. C2SModuleApi_EngagementProcessScheme 콜백이 발생하며, 해당 콜백이 발생하는 경우 전달되는 이벤트 데이트를 확인하여 해당하는 액션을 취해야 합니다.

딥링크 확인하기¶

메인화면에서 [더보기] 버튼을 클릭합니다.

랜딩 URL 주소를 복사해서 사용합니다. 쿠폰 딥링크의 경우 발급받은 쿠폰번호와 랜딩 URL을 조합하여 사용합니다. (쿠폰에서 쿠폰발행 승인 후, "딥링크로 출력" 가능)

[수정하기] 버튼을 클릭하면 아래와 같이 수정할 수 있는 항목이 입력칸으로 변경되며, 내용 수정 후 [수정완료] 버튼을 클릭하면 저장됩니다.

유저인게이지먼트 사용하기¶

쿠폰 딥링크 : 모바일 메시지(SMS) 에서 사용하기¶

① 콘솔 > 프로모션 > 유저인게이지(UE) 설정 메뉴에서 쿠폰 딥링크를 생성합니다. - 생성 예시 : http://withhive.me/c/540/쿠폰번호

② 쿠폰번호에 넣을 쿠폰번호 리스트를 쿠폰 > 쿠폰발행 에서 요청하여 발급합니다.

③ 쿠폰 발급이 완료되면 쿠폰 > 쿠폰발행 > [완료] 클릭 > [쿠폰발행리스트] 를 클릭합니다.

④ 발행된 쿠폰번호가 랜딩URL 주소와 조합되어, 쿠폰 딥링크URL 리스트로 다운받을 수 있습니다.

⑤ 메세지로 전송시(대량 SMS 전송 등) 쿠폰 딥링크 URL을 넣어 전송합니다.

인게임 딥링크 : 푸시 알림메시지로 보내는 경우¶

① 콘솔 > 노티피케이션 >대용량(Android 혹은 iOS) > [등록] 버튼 클릭 > Option의 User Engagement

② 푸시 클릭시 도착할 위치가 Hive 위치인지, 게임 위치인지 선택합니다.

③ Hive 주소인 경우 다음과 같이 선택할 수 있으며, 자세한 path 리스트및 설명은 “푸시 알림메시지에서 이동할 수 있는 path 목록”을 참조해 주세요.

④ 기본으로 제공되는 주소 외에 추가 파라미터 정보를 붙여서 사용할 수도 있습니다.

⑤ 게임 주소인 경우, game을 선택하고 두번째 항목에서 직접입력을 선택하여 path를 입력합니다. path는 게임팀에 문의하여 입력합니다. 입력을 마치면 입력창 하단에서 생성된 주소를 확인하실 수 있습니다.

⑥ User Engagement 입력을 완료하고 푸시를 발송하면, 유저가 푸시 메시지 클릭시 설정한 주소값(path)로 바로 이동합니다.

푸시 알림메시지에서 이동할 수 있는 path 목록¶

<Hive 주소인 경우>

push://hive/authlogin Hive 로그인 화면으로 이동합니다. 게스트 로그인을 하여 접속한 경우에는 로그인 페이지를, 로그인하여 접속한 경우에는 화면 노출 없이 자동 로그인이 진행됩니다.
push://hive/socalinquery 1:1 문의하기 페이지로 이동합니다.
push://hive/promotionshow?type={number} Type값({number})으로 입력 받은 값에 해당하는 viewid를 가진 커스텀뷰 페이지로 이동합니다.
- 예시 push://hive/promotionshow?type=456123
push://hive/offerwallshow Offerwall 페이지로 이동합니다. (Android Only)
push://hive/promotioncoupon?couponid={couponid} {Couponid}로 입력 받은 쿠폰 소모 처리를 진행합니다. 쿠폰 처리를 진행한 결과는 C2SModuleApi_EngagementConsumeCoupon 콜백으로 전달받습니다.
- 예시 push://hive/promotioncoupon?couponid=swccoupon2020
push://hive/socialmessage?uid={uid}&text={message} {uid}값에 유저 uid정보를 넣고 {message} 부분에 내용을 입력하면 Hive 메시지에서 내용을 확인할 수 있습니다.
- 예시 push://hive/socialmessage?uid=1000123456&text=Hello
push://hive/socialinvitation?uid={uid} {uid}값에 유저 uid 정보를 넣으면, 해당 유저에게 초대 메시지를 전송합니다.
- 예시 push://hive/socialinvitation?uid=1000123456

<게임 주소인 경우>

push://game/{path}?{query} 게임 내부 기능으로 이동하기 위한 스키마. 게임 내부에서 정의된 {path}값을 넣어 줍니다. C2SModuleApi_EngagementProcessScheme 콜백이 발생하며, 해당 콜백이 발생하는 경우 전달되는 이벤트 데이트를 확인하여 해당하는 액션을 취해야 합니다.