自动事件跟踪

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 归因添加到您的项目级 build.gradle 文件中以使用 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 欄位應顯示值 Valid Signature。
   • 檢查 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 > App Secret Value 中為 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（原生、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>
   

購買事件中發送的信息¶

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