自动事件跟踪

Hive SDK 可以自动跟踪以下 4 个事件并将其发送到每个归因： 安装、打开、更新、购买（应用内购买） 游戏工作室无需实现代码来跟踪这 4 个事件。

使用 Adjust 的自动事件跟踪¶

1. 从每个归因中获取所需的令牌。请参考Adjust仪表板指南以了解如何获取令牌。

   • 要自动跟踪购买和更新事件，请在Adjust仪表板上注册这些事件，并获取应用令牌和事件令牌。应用令牌可以在仪表板主页上获得，事件令牌可以在仪表板 > 所有设置 > 事件中找到。
   • 对于安装和打开事件的自动跟踪，不需要令牌。

2. 在 hive_config.xml 中添加令牌。

   • 在 hive_config.xml 中添加应用令牌、购买事件令牌和更新事件令牌。有关更多详细信息，请参见下面的示例代码。
   • 对于安装和打开事件的自动跟踪，不需要配置 hive_config.xml。
3. Adjust 仪表板提供了 SDK 签名 V3 以防止应用程序欺骗。要使用 SDK 签名，您需要审查与 Adjust 的合同条款。

SDK 签名集成¶

如果您使用过旧版本的 SDK 签名，请在集成签名库之前检查 SDK 签名迁移。如果您是第一次使用 SDK 签名，请按照以下说明进行操作。

安卓¶

在Android环境中使用SDK签名，请遵循以下说明。

1. 复制adjust-android-signature-xxxxxx.aar库，该库包含在SDK/External文件夹中，并将其添加到您项目的libs文件夹中。
2. 前往Adjust仪表板，并按照将您的数字证书指纹添加到Adjust的允许列表页面上的说明设置您的指纹。您可以通过参考Adjust Suite中的证书设置页面来验证指纹，以遵循您应用中使用的证书方法。

iOS¶

要在 iOS 环境中使用 SDK 签名，请将 ProviderAdjust 子规格添加到您的 Podfile 中。

(omitted)
pod 'HiveAnalyticsProviderAdjust', $HIVE_SDK_VERSION
pod 'HiveAnalyticsProviderAdjust/SignatureV3', $HIVE_SDK_VERSION
(omitted)

统一¶

从菜单中选择 Hive - Hive 依赖项(ExternalDependency) 并激活 调整签名 V3。

检查 SDK 签名集成状态¶

要确认SDK签名库已正确集成，请首先确保Hive SDK设置中的zone设置为sandbox。然后，按照以下步骤操作。

1. 完全卸载测试设备上的应用程序，以确保安装信息被发送。
2. 进入 Adjust Dashboard 测试控制台，输入测试设备信息，然后点击 删除设备 以移除所有设备。
3. 在测试设备上安装应用程序并运行，以确保安装信息被发送到 Adjust。
4. 在测试控制台中输入测试设备的广告 ID 或 IDFA 以检索安装事件信息。
   • SignatureVerificationResult 字段应显示值 有效签名。
   • 检查 SignatureVersion 字段值是否为 3。

SDK 签名迁移¶

要使用最新的SDK签名，您需要删除之前的SDK签名版本设置。

安卓，iOS¶

在hive_config.xml中的Adjust相关设置中，移除所有为secretId、info1、info2、info3和info4设置的键和值。

<providers>
    <!-- (code omitted) -->

    <!-- Do not set the Adjust node id field. -->
    <!-- The Adjust node name field is fixed as "Adjust". -->
    <!-- The event node name field is set arbitrarily by the game company. -->

    <!-- Remove secretId="1" info1="5432112345" info2="334123" info3="555333" info4="111333" below -->
    <Adjust name="Adjust" id="unused" key="APP_TOKEN" secretId="1" info1="5432112345" info2="334123" info3="555333" info4="111333">
        <events>
            <event name="Purchase" value="PURCHASE_EVENT_TOKEN" />
            <event name="Update" value="UPDATE_EVENT_TOKEN" />
        </events>
    </Adjust>

    <!-- (code omitted) -->
</providers>

统一¶

从菜单中选择 Hive - 编辑配置 并激活 Android 或 iOS 选项卡。然后，删除在 Adjust > 应用程序密钥值 中为 secretid, info1 ~ info4 设置的所有值。

使用 Airbridge 自动跟踪事件¶

1. 获取所需的令牌。有关如何发放令牌的更多信息，请参阅Airbridge仪表板指南。
   • 从仪表板 > 设置 > 令牌管理中获取应用程序 SDK 令牌和应用程序名称。
2. 对于 Android 和 iOS，将令牌、应用程序名称和更新事件设置添加到 hive_config.xml 中。请参阅下面的 hive_config.xml 示例代码。
3. 对于 Windows，您需要 Hive 控制台设置，而不是 hive_config.xml 设置。请参阅下面的 Windows 设置。
4. 如果您同时申请 Windows、Android 和 iOS，请联系 Airbridge 进行预配置。
5. Airbridge 提供 SDK 签名 以防止应用程序欺骗。您必须首先检查与 Airbridge 的协议条款以使用此功能。获取密钥并将其添加为 secretId、secret 值在 hive_config.xml 中。有关 SDK 签名安全信息的更多信息，请参阅 Airbridge 指南。此功能仅支持 Android 和 iOS，不支持 Windows。

SDK 签名集成¶

如果您第一次使用SDK签名，请按照以下说明操作。

hive_config.xml 示例代码¶

<providers>
    <Airbridge name="Airbridge" key="APP_SDK_TOKEN" appName="APP_NAME" secretId="SECRET_ID" secret="SECRET">
        <events>
            <event name="Update" value="Update" />
                        <event name="Install" value="Install"/>
            <event name="Open" value="Open"/>
            <event name="PrePurchase" value="airbridge.initiateCheckout"/>
            <event name="PurchaseCancel" value="airbridge.ecommerce.order.canceled"/>
            <event name="Purchase" value="airbridge.ecommerce.order.completed"/>
        </events>
    </Airbridge>
</providers>

安卓，iOS¶

在hive_config.xml中设置与Airbridge相关的secretId和secret键值。

Windows¶

1. 在 Hive 控制台中进行市场归因 - Airbridge 设置。

   • 在 hive_config.xml 中不需要设置与 Airbridge 相关的 secretId、secret 键值。

2. 根据以下说明在 hive_config.xml 中设置它。参考 hive_config.xml 示例代码。
   当设置为 Airbridge 中定义的值时，可以作为 Airbridge 标准事件发送。
   Airbridge 事件类型

   • 安装：需要设置。
   • 打开：需要设置。
   • 更新：需要设置。
   • 预购买：需要设置。您可以发送一个标准事件，值为 airbridge.initiateCheckout。
   • 购买取消：需要设置。您可以发送一个标准事件，值为 airbridge.ecommerce.order.canceled。
   • 购买：需要设置。您可以发送一个标准事件，值为 airbridge.ecommerce.order.completed。

统一¶

从菜单中选择 Hive - 编辑配置 并激活 Android 或 iOS 选项卡。接下来，在 Airbridge 中设置传递的 secretId, secret 的值。

当自动事件发生时发送的信息¶

当特定事件被执行时，该事件会自动发送到 Airbridge 应用归因。此时发送的信息如下。

使用Singular、Appsflyer、Firebase Analytics的自动事件跟踪¶

1. 从每个归因仪表板获取所需的密钥。请参考每个归因仪表板的指南以了解如何获取密钥。
   • Singular: 从仪表板获取 SDK 密钥和 SDK 秘密密钥。
   • Appsflyer: 转到 AppsFlyer 配置 > 应用设置以获取开发密钥。
   • Firebase Analytics: 不需要密钥。

2. 按照下面的指南配置 hive_config.xml。有关更多详细信息，请参见下面的示例代码。

   • 安装: 不需要配置。
   • 打开: 仅需为 Firebase Analytics 配置。
   • 更新: 需要为所有归因进行配置：Singular、Appsflyer、Firebase Analytics
   • 购买: 需要为 Singular 和 Firebase Analytics 配置。
   • 如果您使用 Hive SDK iOS (Native, Unity, Unreal) 进行 AppsFlyer 归因，则需要为 Apple AppID 设置 itunseConnectAppId。

   <providers>
           <!-- 配置为 Singular -->
           <!-- Singular 节点的名称字段固定为 "Singular." -->
           <!-- 事件节点的名称和数值字段由每个游戏工作室定义。 -->
           <Singular name="Singular" id="SDK_KEY" key="SDK_SECRET_KEY">
                   <events>
                           <event name="Purchase" value="purchase"/>
                           <event name="Update" value="update"/>
                   </events>
           </Singular>
   
           <!-- 配置 AppsFlyer -->
           <!-- AppsFlyer 节点的名称字段固定为 "AppsFlyer." -->
           <!-- 不要设置 AppsFlyer 节点的 id 字段. -->
           <!-- 事件节点的名称和数值字段由每个游戏工作室定义. -->
           <AppsFlyer name="AppsFlyer" id="unused" key="DEV_KEY" itunseConnectAppId="909923112">
                   <events>
                           <event name="Update" value="Update"/>
                   </events>
           </AppsFlyer>
   
           <!-- 配置 Firebase Analytics -->
           <!-- 事件节点的名称和值字段由每个游戏工作室定义。 -->
           <firebase>
                   <events>
                           <event name="Purchase" value="purchase"/>
                           <event name="Open" value="open"/>
                           <event name="Update" value="update"/>
                   </events>
           </firebase>
   </providers>
   

购买事件发送的信息¶

如果您使用 Hive IAP 实现游戏的计费，Hive SDK 会自动将购买事件发送到第三方移动应用归因。每个事件发送的信息如下。