自动事件跟踪

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

使用 Adjust 的自动事件跟踪¶

从每个归因中获取所需的令牌。请参考Adjust仪表板指南以了解如何获取令牌。
- 要自动跟踪购买和更新事件，请在Adjust仪表板上注册这些事件，并获取应用程序令牌和事件令牌。应用程序令牌可以在仪表板主页上获得，事件令牌可以在仪表板 > 所有设置 > 事件中找到。
- 对于安装和打开事件的自动跟踪，不需要令牌。
在 hive_config.xml 中添加令牌。
- 将应用令牌、购买事件令牌和更新事件令牌添加到 hive_config.xml。请参阅下面的示例代码。
- 对于安装和打开事件的自动跟踪，不需要配置 hive_config.xml。
Adjust 仪表板提供 SDK 签名 V3 以防止应用程序欺骗。要使用 SDK 签名，您需要审查与 Adjust 的合同条款。

Note

建议自动跟踪您游戏操作的所有 4 个事件。

SDK 签名集成¶

如果您使用过旧版本的 SDK 签名，请在集成签名库之前检查 SDK 签名迁移。

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

安卓¶

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

在您的模块级 build.gradle 文件中添加 Adjust 归因以使用 SDK 签名..

dependencies {
    implementation "com.com2us.android.hive:hive-analytics-provider-adjust"
}

转到 Adjust 仪表板，并按照将您的数字证书指纹添加到 Adjust 的允许列表页面上的说明设置您的指纹。

您可以通过参考Adjust Suite中的证书设置页面来检查每个应用程序使用的证书方法的指纹提取方法。

iOS¶

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

(omitted)
pod HiveAnalyticsProviderAdjust, $HIVE_SDK_VERSION
(omitted)

统一¶

如果您想在Unity引擎中使用SDK签名，可以在Unity引擎菜单中轻松设置。

如果您在下面的 Inspector 菜单中选择 Hive - Hive 依赖项 (ExternalDependency) 并勾选调整，您可以在没有任何额外设置的情况下使用 SDK 签名。

检查 SDK 签名集成状态¶

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

Note

有关更多详细信息，请参阅Adjust文档。

完全卸载测试设备上的应用程序，以确保安装信息被发送。
进入 Adjust 仪表板测试控制台，输入测试设备信息，然后点击 删除设备 以移除所有设备。
在测试设备上安装应用程序并运行，以确保安装信息被发送到 Adjust。
在测试控制台中输入测试设备的广告 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"> -->
    <Adjust name="Adjust" key="APP_TOKEN">
        <events>
            <event name="Purchase" value="PURCHASE_EVENT_TOKEN" />
            <event name="Update" value="UPDATE_EVENT_TOKEN" />
        </events>
    </Adjust>

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

统一¶

Hive Unity SDK（以下简称“Unity SDK”）不需要移除之前的SDK签名版本设置。

使用 Airbridge 自动跟踪事件¶

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

SDK 签名集成¶

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

hive_config.xml 示例代码¶

安卓/iOS(移动)Windows

<providers>
        <!-- (代码省略) -->
        <!-- 设置 Airbridge -->
        <!-- Airbridge 节点名称字段为 "Airbridge" 固定值。 -->
        <!-- Airbridge 节点 ID 字段不进行设置。 -->
        <!-- event 节点名称、值字段由游戏公司自行设置。 -->

        <Airbridge name="Airbridge" key="APP_SDK_TOKEN" appName="APP_NAME" secretId="SECRET_ID" secret="SECRET">
                <events>
                        <event name="Update" value="Update" />
                </events>
        </Airbridge>

        <!-- (代码省略) -->
</providers>

<providers>
        <!-- (代码省略) -->
        <!-- 设置Airbridge -->
        <!-- Airbridge节点name字段为“Airbridge”固定值。 -->
        <!-- Airbridge节点id字段不进行设置。 -->
        <!-- event节点name、value字段由游戏公司自行设置。 -->

        <Airbridge name="Airbridge" key="APP_SDK_TOKEN" appName="APP_NAME" secretId="SECRET_ID" secret="SECRET">
                <events>
                        <event name="Install" value="Install"/>
                        <event name="Update" value="Update" />
                        <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¶

在 Hive 控制台中进行市场归因 - Airbridge 设置。
- 在 hive_config.xml 中不需要设置与 Airbridge 相关的 secretId、secret 键值。
根据以下说明在 hive_config.xml 中设置它。参考 hive_config.xml 示例代码。
当设置为 Airbridge 中定义的值时，可以作为 Airbridge 标准事件发送。
Airbridge 事件类型
- 安装：需要设置。
- 打开：需要设置。
- 更新：需要设置。
- 预购：需要设置。您可以发送一个标准事件，值为 airbridge.initiateCheckout。
- 购买取消：需要设置。您可以发送一个标准事件，值为 airbridge.ecommerce.order.canceled。
- 购买：需要设置。您可以发送一个标准事件，值为 airbridge.ecommerce.order.completed。

（可选）Airbridge 事件传输延迟
Windows 环境的 PC SDK 提供了一项功能，可以延迟特定 Airbridge 事件的传输，直到登录（登录）之后。通过在 hive_config.xml 中定义相关属性，可以激活和管理此功能。

在 hive_config.xml 文件中的标签内使用 win: 前缀定义相关属性，如下例所示：

    <providers>
<!-- (code omitted) -->
<Airbridge
    win:DeferSendUntilGate="signin"
    win:DeferScope="include"
    win:DeferEventList="Install,Update,Open"
    win:DeferSendTimeout="86400"
    win:DeferQueueMax="1000">
    <events>
        <event name="Install" value="Install"/>
        <event name="Open" value="Open"/>
    </events>
</Airbridge>
<!-- (code omitted) -->
</providers>

在*hive_config.xml*文件中定义的Airbridge事件传输延迟的属性如下：

属性	描述	选项	最大值	备注
win:DeferSendUntilGate	指定事件传输开始的门（时机）	init（默认） signin		设置排队事件实际开始传输到 Airbridge 的时机。 init: 在 SDK 初始化后立即开始传输。 signin: 在登录（Sign-In）事件发生后开始传输。
win:DeferScope	指定延迟传输的事件范围	all include none（默认）		设置应用延迟传输功能的事件范围。 none（默认）：不使用延迟传输。 all: 延迟所有发生事件的传输，直到指定的门。 include（推荐）：仅延迟在 win:DeferEventList 中指定的事件的传输。
win:DeferEventList	延迟传输的事件列表			仅在 win:DeferScope 设置为 include 时应用。列出以','（逗号）分隔的延迟传输事件名称。允许使用空格。示例: "Install,Update,Open"
win:DeferSendTimeout	最大延迟时间（秒）		86400（24小时）	如果在设定时间（秒）内未打开 DeferSendUntilGate，则立即传输等待事件。如果未设置或值为 0，事件将无限期等待，不会传输，直到门打开
win:DeferQueueMax	最大延迟事件存储数量		1000	可以存储在延迟传输队列中的最大事件数量。当超过此数量时，最旧的事件将被自动移除。如果未设置或值为 0，则忽略最大数量限制。

统一¶

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

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

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

out

	事件名称	参数	备注
登录	登录		user.externalUserID: playerId
登出	登出
开始支付	发起结账	totalQuantity currency originalCurrency products	products.name: 产品标题 originalCurrency: 从SDK发送的货币 currency: 设置Airbridge应用时注册的基础货币
购买完成	订单完成	totalQuantity currency originalCurrency value transactionID inAppPurchased products	products.name: 产品标题 value: 产品价格总和 originalCurrency: 从SDK发送的货币 currency: 设置Airbridge时注册的基础货币
购买取消	订单取消	transactionType totalQuantity currency originalCurrency value inAppPurchased products	transactionType: "cancel" products.name: 产品标题 value: 产品价格总和 originalCurrency: 从SDK发送的货币 currency: 设置Airbridge应用时注册的基础货币
订阅	订阅	totalQuantity currency originalCurrency value isRenewal products	products.name: 产品标题 value: 产品价格总和 originalCurrency: 从SDK发送的货币 currency: 设置Airbridge应用时注册的基础货币
广告展示	广告展示	ad_placement ad_platform ad_type ad_unit_id currency eventType revenue	当Adiz, Adkit时自动跟踪更新计划中
广告点击	广告点击	ad_placement ad_platform ad_type ad_unit_id currency eventType revenue	自动跟踪当 Adiz, Adkit 计划更新
评估	评分	按钮类型类别方向	类别: hive_review_click: Hive 评审 UI hive_native_review_request: 市场本地评审弹出窗口方向: 纵向: "1" 横向: "2"
分享	分享

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

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

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

打开: 只需为 Firebase Analytics 进行配置。
更新: 需要为所有归因进行配置：Singular、Appsflyer、Firebase Analytics
购买: 需要为 Singular 和 Firebase Analytics 进行配置。
如果您使用 SDK iOS（原生、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>

Note

为了顺利进行游戏操作，建议自动跟踪所有更新、打开和购买事件。

购买事件发送的信息¶

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

	事件名称	参数	备注
调整	购买	价格货币订单ID pid 标题服务器ID 数量收入	pid: 产品ID 收入: 价格 * 数量
Airbridge	订单完成	总数量货币原始货币价值交易ID 应用内购买产品	products.name: 产品标题价值: 产品价格的总和原始货币: 从SDK发送的货币货币: 设置Airbridge应用时注册的基础货币
Singular	__iap__	r pk pcc pn pc pq pp 市场服务器 psku pvid haid	r: 收入 (价格 * 数量) pk: 订单ID pcc: 货币 pn: 标题 pc: Inapp_Item pq: 数量 pp: 价格市场: google 服务器: serverId psku: 产品ID pvid: Hive PlayerID haid: Hive Analytics ID
AppsFlyer	购买	af_price af_currency af_quantity af_content af_receipt_id custsom_product_id af_content_type af_revenue	custsom_product_id: 产品ID af_content: 产品描述 af_content_type: 标题 af_revenue: 价格 * 数量
Firebase Analytics	购买	价格货币订单ID pid 标题服务器ID 数量收入	pid: 产品ID 收入: 价格 * 数量