安卓

这些是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>