跳轉至

自动事件跟踪

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. 複製包含在SDK/External資料夾中的adjust-android-signature-xxxxxx.aar庫,並將其添加到您的項目的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 Analytics -->
            <!-- 事件节点的名称和值字段由每个游戏工作室定义。 -->
            <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: Inapp_Item
  • pq: 數量
  • pp: 價格
  • 市場: google
  • 伺服器: 伺服器ID
  • 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
  • 收入: 價格 * 數量