跳转至

自动事件跟踪

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

使用 Adjust 的自动事件跟踪

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

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

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

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

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。然后,按照以下步骤操作。

Note
有关更多详细信息,请参阅[Adjust文档](https://dev.adjust.com/ko/sdk/android/integrations/signature-library?version=v4#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist)。
  1. 完全卸载测试设备上的应用程序,以确保安装信息被发送。
  2. 进入 Adjust 仪表板测试控制台,输入测试设备信息,然后点击 删除设备 以移除所有设备。
  3. 在测试设备上安装应用程序并运行,以确保安装信息被发送到 Adjust。
  4. 在测试控制台中输入测试设备的广告 ID 或 IDFA 以检索安装事件信息。

  5. SignatureVerificationResult 字段应显示值 Valid Signature

  6. 检查 SignatureVersion 字段值是否为 3

SDK 签名迁移

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

安卓,iOS

hive_config.xml中的Adjust相关设置中,删除为secretIdinfo1info2info3info4设置的所有键和值。

<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. 将令牌、应用程序名称和更新事件设置添加到 hive_config.xml。请参见下面的示例代码。
  3. Airbridge 提供 SDK 签名 以防止应用程序欺骗。要使用相关功能,您必须检查与 Airbridge 的协议。要使用相关功能,请获取密钥并将其添加到 hive_config.xml 中的 secretIdsecret。有关 SDK 签名安全信息的更多信息,请参阅 Airbridge 指南

SDK 签名集成

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

安卓,iOS

hive_config.xml中的Airbridge相关设置中设置secretIdsecret键的值。

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

统一

从菜单中选择 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: sum products.price
  • originalCurrency: 从SDK发送的货币
  • currency: 设置Airbridge时注册的基础货币
购买取消 订单取消
  • transactionType
  • totalQuantity
  • currency
  • originalCurrency
  • value
  • inAppPurchased
  • products
  • transactionType: "cancel"
  • products.name: 产品标题
  • value: sum products.price
  • originalCurrency: 从SDK发送的货币
  • currency: 设置Airbridge应用时注册的基础货币
订阅 订阅
  • totalQuantity
  • currency
  • originalCurrency
  • value
  • isRenewal
  • products
  • products.name: 产品标题
  • value: sum products.price
  • 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
    • 计划更新
评价 评分
  • buttontype
  • category
  • orient
  • 类别:
    • hive_review_click: Hive 评审 UI
    • hive_native_review_request: 市场本地评审弹窗
  • 方向:
    • 竖屏: "1"
    • 横屏: "2"
分享 分享

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

  1. 从每个归因仪表板获取所需的密钥。请参考每个归因仪表板的指南以了解如何获取密钥。
  2. 按照下面的指南配置 hive_config.xml。有关更多详细信息,请参见下面的示例代码。
    • 安装:不需要配置。
    • 打开:您只需为 Firebase Analytics 配置。
    • 更新:您需要为所有归因配置:Singular、Appsflyer、Firebase Analytics
    • 购买:您需要为 Singular 和 Firebase Analytics 配置。
  3. 如果您使用 Hive 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 分析 -->
            <!-- 事件节点的名称和值字段由每个游戏工作室定义。 -->
            <firebase>
                    <events>
                            <event name="Purchase" value="purchase"/>
                            <event name="Open" value="open"/>
                            <event name="Update" value="update"/>
                    </events>
            </firebase>
    </providers>
    
Note

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

购买事件发送的信息

如果您使用 Hive IAP 实现游戏的计费,Hive 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: 应用内项目
  • 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
  • 收入: 价格 * 数量