Android

Hive SDK Android에서 프로모션을 사용하기 위한 설정을 안내합니다.

사용할 라이브러리 추가¶

모듈 수준 build.gradle 파일에 Hive SDK 프로모션을 사용하기 위한 외부 라이브러리를 추가합니다. 아래는 build.gradle 예시입니다.

dependencies {
   // Promotion
   implementation "com.com2us.android.hive:hive-promotion"
   // Promotion 구글 앱 내 리뷰
   implementation "com.com2us.android.hive:hive-promotion-google-inappreview"
   // Promotion 동영상 기능을 상용할 경우 추가합니다.
   implementation "com.com2us.android.hive:youtube-helper"
}

딥링크 설정하기¶

딥링크는 이용자를 앱 실행 후 앱 특정 위치로 이동시키는 링크입니다. 프로모션 유저 인게이지먼트에서 딥링크 스킴에 대한 처리를 지원합니다. 딥링크를 사용하려면 AndroidManifest.xml에 아래 내용을 추가합니다.

<manifest>
  <activity android:name="YOUR_MAIN_ACTIVITY">
    <intent-filter>
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="${applicationId}" />
    </intent-filter>
  </activity>
</manifest>

디퍼드 딥링크 설정하기¶

디퍼드 딥링크는 이용자가 앱을 설치하지 않은 경우, 이용자를 앱 마켓으로 이동시켜 앱을 설치하게 한 다음, 앱 실행 후 앱의 특정 위치로 이용자를 이동시키는 링크입니다. 앱을 이미 설치한 이용자는 앱 실행 후 앱 특정 위치로 이동시킵니다. 디퍼드 딥링크를 사용하려면 AndroidManifest.xml에 아래 내용을 추가합니다.

<activity
    android:name="com.hive.userengagement.DeferredDeeplinkActivity"
    android:exported="true">

    <!-- 샌드박스 서버에서 사용 시 추가 -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data
            android:scheme="https"
            android:host="sandbox-promotion.qpyou.cn"
            android:pathPattern="/deeplink/${applicationId}/vid/.*" />
    </intent-filter>

    <!-- 상용 서버에서 사용 시 추가 -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data
            android:scheme="https"
            android:host="promotion.qpyou.cn"
            android:pathPattern="/deeplink/${applicationId}/vid/.*" />
    </intent-filter>
</activity>

디퍼드 딥링크는 Android에서 Google Play 스토어만 지원하고 있습니다. Hive 유저 에퀴지션(UA)을 통해 친구 초대 링크를 공유하고자 하는 경우 설정하세요. 기존 방식과 디퍼드 딥링크 방식 중 자유롭게 사용 가능합니다.

	기존 UA 친구 초대 링크	디퍼드 딥링크를 통한 UA 친구 초대 링크
동작	- 초대링크 접속 시 자체적으로 구현한 웹 페이지에 게임 설치 및 게임 실행 유도 UI를 통해서 유저가 진입 - 초대 링크에 별도의 정보를 담고 있지 않음	- 초대링크 접속 시 별도의 웹 페이지 없이 게임 설치 유도(마켓으로 이동) 및 게임 실행 유도 - 초대링크에 정보를 담을 수 있음 (Hive SDK에서 제어)
지원 플랫폼	- 설치 유도 시 자체적으로 구현한 웹 페이지에 각 마켓 url을 임의 구현 가능	- 구글 플레이 스토어만 지원 (크롬 브라우저를 통해 접속시에만 가능)

디퍼드 딥링크 설정 시 Hive 유저 에퀴지션(UA) 기능의 동작 순서는 다음과 같습니다.

A 유저가 UA 초대 링크를 통해 디퍼드 딥링크 형태의 링크를 공유
초대 링크를 공유 받은 B 유저가 해당 링크를 통해 앱에 접속할 경우 서버는 링크 정보를 분석하여 B가 A의 초대를 받아 게임을 진행하였음을 확인: 보상을 위한 정보 획득
디퍼드 딥링크는 하나의 링크로 제공되며, B 유저의 단말기에 앱이 설지되지 않은 경우에는 앱 설치를 유도하고, 이미 앱을 설치한 경우에는 앱을 실행하여 A 유저와 B 유저의 정보를 프로모션 서버로 전달