自动事件跟踪

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. 在您的模块级 build.gradle 文件中添加 Adjust 归因以使用 SDK 签名..

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

2. 前往 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。然後，按照以下步驟操作。

1. 完全卸載測試設備上的應用程式，以確保安裝信息被發送。
2. 前往 Adjust 儀表板測試控制台，輸入測試設備信息，然後點擊 刪除設備 以移除所有設備。
3. 在測試設備上安裝應用程式並運行，以確保安裝信息被發送到 Adjust。
4. 在測試控制台中輸入測試設備的廣告 ID 或 IDFA，以檢索安裝事件信息。
   • SignatureVerificationResult 欄位應顯示值 有效簽名。
   • 檢查 SignatureVersion 欄位值是否為 3。

SDK 簽名遷移¶

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

Android, 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 SDK Unity 不需要移除先前 SDK 簽名版本的設置。

自動追蹤事件與 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>
           <!-- Configure for Singular -->
           <!-- The name field of the Singular node is fixed to "Singular." -->
           <!-- The name and the value field of the event node are defined by each game studio. -->
           <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>
   

在購買事件中發送的信息¶

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