安卓

这些是 Hive SDK Android 设置促销的说明。

添加库以供使用¶

将外部库添加到使用 Hive 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>

使用延迟深度链接¶

延迟深度链接以单个 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，深度链接) 功能。

要使用直接链接，请在 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>

此外，请参考控制台指南中的促销设置以在控制台中配置直接链接。

使用直接链接的Hive 用户获取 (UA)和Hive 用户参与 (UE)的操作顺序如下：

用户A通过UA邀请链接分享直接链接。
当用户B通过共享链接访问应用时，服务器分析链接信息以确认B是在A的邀请下玩游戏：获取奖励信息。
用户B访问应用后，链接信息中包含的UE操作被执行（例如执行Hive相关功能，显示UI，或运行游戏应用为UE定义的自定义功能）。
如果用户B的设备上未安装该应用，链接会引导他们安装该应用。如果已经安装，则启动应用，并将A和B的信息发送到推广服务器。

Note

当应用未安装时，请注意使用直接链接时的以下事项：

直接链接引导用户安装应用程序，但如果在安装后立即启动应用程序，则不会传递直接链接信息。
安装应用程序后，用户必须再次点击直接链接以启动应用程序，并同时传递直接链接信息。