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>

使用延遲深層連結¶

延遲深層連結以單一 URL 提供，並以兩種主要方式運作：

如果用戶尚未安裝應用程式，他們將被重定向到應用市場以進行安裝。安裝並啟動應用程式後，用戶將被帶到應用程式內的特定位置。
如果用戶已經安裝了應用程式，通過鏈接啟動應用程式將直接帶他們到應用程式內的特定位置。

要使用延遲深層連結，請將以下內容添加到您的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 朋友邀請鏈接
行為	- 當訪問邀請鏈接時，用戶會通過一個誘導遊戲安裝和執行的網頁來安裝和運行遊戲。 - 邀請鏈接不包含任何單獨的信息。	- 當訪問邀請鏈接時，用戶會被引導安裝遊戲（移動到市場）並運行遊戲，而無需單獨的網頁。 - 信息可以包含在邀請鏈接中（由 Hive SDK 控制）。
支持的平台	- 在誘導安裝時，每個市場 URL 可以在自實現的網頁上任意實現。	- 只支持 Google Play 商店（僅在通過 Chrome 瀏覽器訪問時可用）。

使用延遲深層連結的Hive 用戶獲取 (UA)的操作順序如下：

用戶 A 通過 UA 邀請鏈接分享了一個延遲深度鏈接。
當用戶 B 接收到並通過邀請鏈接訪問應用程序時，服務器分析鏈接信息以確認 B 是在 A 的邀請下玩遊戲：獲取獎勵的信息。
如果用戶 B 的設備上未安裝該應用程序，鏈接將引導他們安裝該應用程序。如果已經安裝，則啟動應用程序，並將 A 和 B 的信息發送到推廣服務器。

Note

延遲深層連結指引使用者在應用程式未安裝時安裝應用程式，並在安裝後立即在應用程式啟動後傳遞連結資訊。

使用直接連結¶

直接鏈接以單一 URL 提供，可用於用戶獲取 (UA) 邀請鏈接和用戶參與 (UE，深層鏈接) 功能。

要使用直接链接，请将以下内容添加到您的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>

此外，請參考控制台指南中的促銷設置以在控制台中配置直接鏈接。

Hive 用戶獲取 (UA) 和 Hive 用戶參與 (UE) 使用直接鏈接的操作順序如下：

用戶 A 通過 UA 邀請鏈接分享直接鏈接。
當用戶 B 通過共享鏈接訪問應用時，服務器分析鏈接信息以確認 B 是在 A 的邀請下玩遊戲：獲取獎勵的信息。
B 訪問應用後，鏈接信息中包含的 UE 操作立即執行（例如執行 Hive 相關功能，顯示 UI，或運行遊戲應用為 UE 定義的自定義功能）。
如果用戶 B 的設備上未安裝應用，鏈接將引導他們安裝應用。如果已安裝，則啟動應用並將 A 和 B 的信息發送到推廣服務器。

Note

當應用程式未安裝時，使用直接連結時請注意以下事項：

直接連結引導用戶安裝應用程式，但如果應用程式在安裝後立即啟動，則不會傳遞直接連結資訊。
安裝應用程式後，用戶必須再次點擊直接連結以啟動應用程式並同時傳遞直接連結資訊。