Android

這些是SDK Android設置促銷的指示。

添加庫以供使用¶

將外部庫添加到使用 SDK Promotion 的模組級 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），用於給予邀請獎勵，它們以以下兩種方式運作：

當用戶已安裝遊戲應用程式時，點擊鏈接會啟動遊戲應用程式，導航到應用程式內的特定位置，然後提供邀請獎勵。
當用戶未安裝遊戲應用程式時，點擊鏈接會將用戶引導至市場以安裝遊戲應用程式。安裝並啟動遊戲應用程式後，邀請獎勵將通過邀請鏈接中包含的識別信息提供。

要使用延遲深層鏈接，請將以下內容添加到您的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) 操作順序如下：

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

Note

延遲深層連結引導用戶安裝應用程式（如果尚未安裝），並在應用程式安裝後立即啟動時傳遞連結資訊。

使用直接連結¶

直接連結是指當用戶點擊後，將其移動到遊戲應用程式內的特定位置（在安裝遊戲應用程式後），或顯示特定的網頁視圖以促進用戶參與的網址。

用戶通過直接鏈接被導向的目標地址在 Hive Console > Direct Link Management 中進行配置，並且可以根據用戶的操作系統環境靈活配置各種目標，例如市場、遊戲應用內的特定位置（深鏈接）和特定的網頁視圖。

當直接鏈接與遊戲應用程序一起使用時，操作順序如下：

共享直接链接作为各种目标链接（市场链接、深层链接、网页 URL）
当用户点击直接链接时，它的操作如下，根据在 Hive 控制台 > 直接链接管理中配置的目标：
- 市场导航：无论用户的游戏应用安装状态如何，导航到在 Hive 控制台 > 直接链接管理中配置的市场链接
- 应用内导航（深层链接）
- 如果游戏应用已安装在用户环境中：导航到游戏应用内的指定位置（方案深层链接）
- 如果游戏应用未安装在用户环境中：导航到每个操作系统环境支持的**市场中的游戏应用安装位置**或创建深层链接时配置的**未安装用户导航 URL**
- 网页 URL：无论用户的游戏应用安装状态如何，导航到游戏外的特定网页视图
当用户按照“游戏应用执行 > 登录 > 用户参与（UE）SetReady 操作”的顺序进行时，游戏应用执行链接信息中包含的事件（执行相关功能或 UI 显示，执行在 UE 中定义的自定义功能等）

Warning

當遊戲應用程式未在用戶環境中安裝時，根據 Hive SDK 版本的直接鏈接行為的注意事項如下：

Hive SDK v4 低於 25.10.0 - 鼓勵用戶點擊直接鏈接後在其設備上安裝遊戲應用，但如果在安裝後立即執行遊戲應用，則不會傳遞直接鏈接信息。 - 在遊戲應用安裝完成後，再次點擊直接鏈接會在遊戲應用執行的同時將直接鏈接信息傳遞給遊戲應用。然後執行事件。
Hive SDK v4 25.10.0 及以上 - 鼓勵用戶點擊直接鏈接後在其設備上安裝遊戲應用，如果在安裝後立即執行遊戲應用，則直接鏈接以以下兩種方式運作： - 遊戲應用與 Hive SDK 的推廣伺服器通信以獲取直接鏈接信息。推廣伺服器檢查首次點擊直接鏈接的用戶的設備歷史和通信信息，並將適當的直接鏈接信息傳遞給遊戲應用客戶端。然後執行事件。 - 在遊戲應用安裝完成後，再次點擊直接鏈接會在遊戲應用執行的同時將直接鏈接信息傳遞給遊戲應用。然後執行事件。

要在 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>