Android

これは、プロモーションを設定するためのSDK Androidの手順です。

ライブラリの追加¶

SDKプロモーションを使用するために、モジュールレベルの build.gradle ファイルに外部ライブラリを追加します。以下は build.gradle の例です。

dependencies {
   // Promotion
   implementation "com.com2us.android.hive:hive-promotion"
   // Promotion Google In-App Review
   implementation "com.com2us.android.hive:hive-promotion-google-inappreview"
   // Add this if you want to use Promotion video function.
   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>

UAディファードディープリンクの使用¶

UAの遅延ディープリンクは、ユーザーに招待報酬を提供するために用意された招待コードリンク（URL）であり、以下の2つの方法で機能します：

• ユーザーがゲームアプリをインストールしている場合、リンクをクリックするとゲームアプリが起動し、アプリ内の特定の場所に移動し、その後招待報酬が提供されます。
• ユーザーがゲームアプリをインストールしていない場合、リンクをクリックするとユーザーはマーケットプレイスに誘導され、ゲームアプリをインストールします。ゲームアプリをインストールして起動した後、招待リンクに含まれる識別情報を通じて招待報酬が提供されます。

ディファードディープリンクを使用するには、次の内容をAndroidManifest.xmlファイルに追加します。

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

    <!-- Add this when using the sandbox server -->
    <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>

    <!-- Add this when using the production server -->
    <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ストアのみをサポートしています。友達招待リンクをユーザー獲得(UA)を通じて共有したい場合は、設定してください。既存の方法またはディファードディープリンク方法のいずれかを自由に使用できます。

UAディファードディープリンクを使用したユーザー獲得 (UA)の操作シーケンスは次のとおりです:

1. ユーザーAはUA招待リンクを介して遅延ディープリンクを共有します。
2. ユーザーBが招待リンクを通じてアプリにアクセスすると、サーバーはリンク情報を分析して、BがAの招待でゲームをプレイしたことを確認します：報酬のための情報を取得します。
3. ユーザーBのデバイスにアプリがインストールされていない場合、リンクはアプリのインストールに導きます。すでにインストールされている場合、アプリが起動し、AとBの情報がプロモーションサーバーに送信されます。

直接リンクの使用¶

直接リンクは、クリックするとユーザーをゲームアプリ内の特定の場所（ゲームアプリをインストールした後）に移動させるURLであり、ユーザーのエンゲージメントを促進するために特定のウェブビューを表示します。

ユーザーが直接リンクを通じて誘導される宛先アドレスは、Hive Console > Direct Link Managementで設定されており、マーケットプレイス、ゲームアプリ内の特定の場所（ディープリンク）、特定のウェブビューなど、さまざまな宛先をユーザーのOS環境に応じて柔軟に設定できます。

ゲームアプリと直接リンクが併用される際の操作手順は以下の通りです:

1. 様々な宛先リンク（マーケットリンク、ディープリンク、ウェブURL）として直接リンクを共有します
2. ユーザーが直接リンクをクリックすると、Hive Console > Direct Link Managementで設定された宛先に応じて次のように動作します： - マーケットナビゲーション：ユーザーのゲームアプリのインストール状況に関係なく、Hive Console > Direct Link Managementで設定されたマーケットリンクに移動します - アプリ内ナビゲーション（ディープリンク） - ユーザー環境にゲームアプリがインストールされている場合：ゲームアプリ内の指定された場所に移動します（スキームディープリンク） - ユーザー環境にゲームアプリがインストールされていない場合：各OS環境でサポートされている**マーケット内のゲームアプリインストール場所**またはディープリンク作成時に設定された**未インストールユーザーのナビゲーションURL**に移動します - ウェブURL：ユーザーのゲームアプリのインストール状況に関係なく、ゲームの外部にある特定のウェブビューに移動します
3. ユーザーが「ゲームアプリ実行 > ログイン > ユーザーエンゲージメント（UE）SetReadyアクション」の順に進むと、ゲームアプリはリンク情報に含まれるイベントを実行します（関連機能やUIの表示を行ったり、UEで定義されたカスタム機能を実行したりします）

AndroidターゲットHive SDKに直接リンク機能を適用するには、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}.directlink" />
        </intent-filter>
    </activity>
</manifest>