Android

これは、Hive SDK Android のプロモーション設定に関する指示です。

ライブラリを追加して使用する¶

Hive 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>

ディファードディープリンクの設定¶

ディファードディープリンクは、ユーザーがアプリをインストールしていない場合、ユーザーをアプリマーケットに誘導してアプリをインストールさせ、その後アプリを起動した後にアプリ内の特定の場所に移動させるリンクです。すでにアプリをインストールしているユーザーは、アプリを起動した後にアプリ内の特定の場所に移動します。ディファードディープリンクを使用するには、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ストアのみをサポートしています。友達招待リンクをHive ユーザー獲得(UA)を通じて共有したい場合は、設定してください。既存の方法またはディファードディープリンクの方法のいずれかを自由に使用できます。

	既存のUAフレンド招待リンク	遅延ディープリンクを通じたUAフレンド招待リンク
動作	- 招待リンクにアクセスすると、ユーザーはゲームのインストールと実行を促すUIを持つウェブページを通じてゲームをインストールして実行するように誘導されます。 - 招待リンクには別の情報は含まれていません。	- 招待リンクにアクセスすると、ユーザーはゲームをインストール（マーケットに移動）し、別のウェブページなしでゲームを実行するように誘導されます。 - 招待リンクには情報を含めることができます（Hive SDKによって制御されます）。
サポートされているプラットフォーム	- インストールを促す際、各マーケットURLは自己実装されたウェブページで任意に実装できます。	- Google Playストアのみがサポートされています（Chromeブラウザを通じてアクセスした場合のみ利用可能）。

ディファードディープリンクが設定されると、Hive ユーザー獲得 (UA) 機能の操作の順序は次のようになります:

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