手动事件跟踪

除了安装、打开、更新和购买（应用内购买）这些由 Hive SDK 自动跟踪的事件外，您还可以手动跟踪所需的事件。为此，您需要将事件注册到每个归因的仪表板上。例如，您可以跟踪特定事件，如游戏教程的完成（TutorialComplete）或任务目标的完成（MissionClear）。您应该在完成自动事件跟踪的设置后实施手动事件跟踪。

手动事件跟踪与 Adjust¶

要手动跟踪自定义事件，请在 Adjust 控制面板上注册事件，并获取应用程序令牌和事件令牌。应用程序令牌可以在控制面板主页上获得，事件令牌在控制面板 > 所有设置 > 事件中获得。请参考 Adjust 控制面板指南了解如何获取令牌。
在 hive_config.xml 中添加每个事件的应用程序令牌和事件令牌。有关更多详细信息，请参见下面的示例代码。

Adjust 控制面板提供 SDK 签名 V3 以防止应用程序欺骗。要使用 SDK 签名，您必须审查与 Adjust 的合同条款。

<providers>
<!-- （省略） -->
<!-- 请勿设置 Adjust 节点的 id 字段。 -->
<!-- Adjust 节点的 name 字段固定为 "Adjust." -->
<!-- 事件节点的 name 字段由游戏工作室定义。但一旦设置，它应该与 sendEvent() 请求的所有其他营销归因的 name 字段相同。-->
<!-- 从 Hive SDK v4 25.0.0 开始，id、secretId、info1~4 在应用 Adjust v5 时不再使用 -->
<Adjust name="Adjust" key="APP_TOKEN">
        <events>
                <event name="TutorialComplete" value="TutorialComplete_EVENT_TOKEN"/>
                <event name="MissionClear" value="MissionClear_EVENT_TOKEN"/>
        </events>
<!-- （省略） -->
</Adjust>
</providers>

调用分析 API sendEvent() 发送事件。在发送事件时使用 hive_config.xml 中的 event name。name 用作 sendEvent() 的请求参数，您设置的 value 将在每个归因的仪表板上更新。
- Analytics.sendEvent("TutorialComplete");
- Analytics.sendEvent("MissionClear");

手动跟踪事件与 Airbridge¶

获取所需的令牌。有关如何获取令牌的信息，请参阅Airbridge仪表板指南。
- 从仪表板 > 设置 > 令牌管理中获取应用程序SDK令牌和应用程序名称。
将令牌、应用程序名称和事件设置添加到hive_config.xml中。请参阅下面的 hive_config.xml 示例代码。在Windows上，令牌和应用程序名称设置不是必需的，但Hive控制台设置是必需的。
Airbridge提供SDK签名以防止应用程序欺骗。要使用相关功能，您必须首先检查与Airbridge的合同条款。获取密钥并将其作为secretId、secret值添加到hive_config.xml中。有关SDK签名安全信息的更多信息，请参阅Airbridge指南。仅支持Android和iOS，不支持Windows。
如果您同时申请Windows、Android和iOS，请联系Airbridge以获取预设。
通过调用Analytics API sendEvent()发送事件。发送事件时，使用添加到hive_config.xml中的event<标签的name和value。name在调用API时用作参数，value可以在每个归因的仪表板中查看。
- Analytics.sendEvent("TutorialComplete");
- Analytics.sendEvent("MissionClear");

hive_config.xml 示例代码¶

<providers>
    <Airbridge name="Airbridge" key="APP_SDK_TOKEN" appName="APP_NAME" secretId="SECRET_ID" secret="SECRET">
                <events>
                        <event name="TutorialComplete" value="Tutorial Complete" />
                        <event name="MissionClear" value="Mission Clear" />
                </events>
        </Airbridge>
</providers>

使用 Airbridge 发送附加属性¶

在使用 Airbridge 发送应用内事件时，您可以使用 Analytics.sendEventWithAttributes 发送附加属性。

可以发送的附加属性信息如下。

动作，标签：收集可用于 Airbridge 报告中的分组信息。
值：收集用于收入分析的信息。
语义属性：Airbridge 的预定义属性。
- 如果输入的属性字符串不是预定义属性，则可能无法收集。
- 数据格式与语义属性不匹配的事件将不会被收集。由于每个语义属性的数据格式各不相同，因此需要谨慎。
- 数据格式为字符串的语义属性允许最多 1024 个字符。数据格式为 int 或 float 的语义属性允许最多 64 位。
自定义属性：用户定义的属性。

Unity虚幻引擎C++KotlinJavaObjective-CSwift

API 参考: hive.Analytics.sendEventWithAttributes

using hive;    

// 创建 AnalyticsAttributes
var analyticsAttributes = new AnalyticsAttributes();

// Airbridge的特定属性
var airbridgeSpecific = new AirbridgeSpecific();
// 动作
airbridgeSpecific.SetSemanticAction("工具");
// 标签
airbridgeSpecific.SetSemanticLabel("锤子");
// 值
airbridgeSpecific.SetSemanticValue(10);

// 语义属性
airbridgeSpecific.AddSemanticAttribute("type", "Warrior");
airbridgeSpecific.AddSemanticAttribute("score", 20);

// 添加 Airbridge 特定属性
analyticsAttributes.AddModuleSpecificAttributes(airbridgeSpecific);

// 添加自定义属性
analyticsAttributes.AddCustomAttribute("key1", "value1");
analyticsAttributes.AddCustomAttribute("key2", "value2");

Analytics.sendEventWithAttributes("Quest Complete", analyticsAttributes);

#include "HiveAnalytics.h"

// 需要添加代码

API 参考: Analytics::sendEventWithAttributes

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
using namespace std;    
using namespace hive;    

// 创建 AnalyticsAttributes
AnalyticsAttributes* analyticsAttributes = new AnalyticsAttributes();

// Airbridge的特定属性
AirbridgeSpecific* airbridgeSpecific = new AirbridgeSpecific();

std::string semanticAction = "工具";
std::string semanticLabel = "锤子";
float semanticValue = 10.0f;

// 动作
airbridgeSpecific->setSemanticAction(semanticAction);
// 标签
airbridgeSpecific->setSemanticLabel(semanticLabel);
// 值
airbridgeSpecific->setSemanticValue(semanticValue);

// 语义属性
airbridgeSpecific->addSemanticAttribute("type", picojson::value("Warrior"));
airbridgeSpecific->addSemanticAttribute("score", picojson::value(20.0f));

// 添加 Airbridge 特定属性
analyticsAttributes->addModuleSpecificAttributes(airbridgeSpecific);

// 添加自定义属性
analyticsAttributes->addCustomAttribute("key1", picojson::value("value1"));
analyticsAttributes->addCustomAttribute("key2", picojson::value("value2"));

std::string eventName = "任务完成";

Analytics::sendEventWithAttributes(eventName, *analyticsAttributes);

API 参考: Analytics.sendEventWithAttributes

import com.hive.Analytics    
import com.hive.analytics.provider.attributes.AirbridgeSpecific
import com.hive.analytics.provider.attributes.AnalyticsAttributes

// 创建 AnalyticsAttributes
val analyticsAttributes = AnalyticsAttributes()

// Airbridge的特定属性
val airbridgeSpecific = AirbridgeSpecific().apply {
    setSemanticAction("工具")                // 动作
    setSemanticLabel("锤子")               // 标签
    setSemanticValue(10.0f)                  // 值
    addSemanticAttribute("类型", "战士")  // 语义属性
    addSemanticAttribute("分数", 20.0f)     // 语义属性
}

// 添加 Airbridge 特定属性
analyticsAttributes.addModuleSpecificAttribute(airbridgeSpecific)

// 添加自定义属性
analyticsAttributes.addCustomAttribute("key1", "value1")
analyticsAttributes.addCustomAttribute("key2", "value2")

Analytics.sendEventWithAttributes("Quest Complete", analyticsAttributes)

API 参考: Analytics.sendEventWithAttributes

import com.hive.Analytics;
import com.hive.analytics.provider.attributes.AirbridgeSpecific;
import com.hive.analytics.provider.attributes.AnalyticsAttributes;

// 创建 AnalyticsAttributes
AnalyticsAttributes analyticsAttributes = new AnalyticsAttributes();

// Airbridge的特定属性
AirbridgeSpecific airbridgeSpecific = new AirbridgeSpecific();
airbridgeSpecific.setSemanticAction("工具");                // 动作
airbridgeSpecific.setSemanticLabel("锤子");               // 标签
airbridgeSpecific.setSemanticValue(10.0f);                  // 值
airbridgeSpecific.addSemanticAttribute("类型", "战士");  // 语义属性
airbridgeSpecific.addSemanticAttribute("分数", 20.0f);     // 语义属性

// 添加 Airbridge 特定属性
analyticsAttributes.addModuleSpecificAttribute(airbridgeSpecific);

// 添加自定义属性
analyticsAttributes.addCustomAttribute("key1", "value1");
analyticsAttributes.addCustomAttribute("key2", "value2");

Analytics.sendEventWithAttributes("Quest Complete", analyticsAttributes);

API 参考: HIVEAnalytics:sendEventWithAttributes

#import <HIVEService/HIVEService-Swift.h> 

HiveAnalyticsAttributes* analyticsAttributes = [[HiveAnalyticsAttributes alloc] init];

HiveAirbridgeSpecific* airbridgeSpecific = [[HiveAirbridgeSpecific alloc] init];
[airbridgeSpecific setSemanticAction: @"Tool"];
[airbridgeSpecific setSemanticAction: @"Hammer"];
[airbridgeSpecific setSemanticValue: 10.0f];
[airbridgeSpecific addSemanticAttribute: @"type" value: @"Warrior"];
[airbridgeSpecific addSemanticAttribute: @"score" value: @20.0f];

[analyticsAttributes addModuleSpecificAttribute: airbridgeSpecific];
[analyticsAttributes addCustomAttribute: @"key1" value: @"value1"];
[analyticsAttributes addCustomAttribute: @"key2" value: @"value2"];

[HIVEAnalytics sendEventWithAttributes: @"Quest Complete" attributes: analyticsAttributes];

API 参考: HIVEAnalytics:sendEventWithAttributes

#import HIVEService

// 创建 AnalyticsAttributes
let analyticsAttributes = AnalyticsAttributes()

// Airbridge的特定属性
let airbridgeSpecific = AirbridgeSpecific()
airbridgeSpecific.setSemanticAction("工具")
airbridgeSpecific.setSemanticLabel("锤子")
airbridgeSpecific.setSemanticValue(10.0)
airbridgeSpecific.addSemanticAttribute("类型", value: "战士")
airbridgeSpecific.addSemanticAttribute("分数", value: 20.0)

// 添加 Airbridge 特定属性
analyticsAttributes.addModuleSpecificAttribute(airbridgeSpecific)

// 添加自定义属性
analyticsAttributes.addCustomAttribute("key1", value: "value1")
analyticsAttributes.addCustomAttribute("key2", value: "value2")

AnalyticsInterface.sendEventWithAttributes("Quest Complete", attributes: analyticsAttributes)

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

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

按照下面的指南配置 hive_config.xml。有关更多详细信息，请参见下面的示例代码。如果您使用 Hive SDK iOS（原生、Unity、Unreal）进行 AppsFlyer 归因，则需要为 Apple AppID 设置 itunseConnectAppId。

<providers>
        <!-- 配置 Singular -->
        <!-- Singular 节点的名称字段固定为 "Singular." -->
        <!-- 事件节点的名称字段由游戏工作室定义。但一旦设置，它应该与 sendEvent() 请求的所有其他营销归因的名称字段相同。-->
        <!-- 事件节点的值字段由游戏工作室定义。 -->
        <Singular name="Singular" id="SDK_KEY" key="SDK_SECRET_KEY">
                <events>
                        <event name="TutorialComplete" value="教程完成"/>
                        <event name="MissionClear" value="任务完成"/>
                </events>
        </Singular>

        <!-- 配置 AppsFlyer -->
        <!-- AppsFlyer 节点的名称字段固定为 "AppsFlyer." -->
        <!-- 不要设置 AppsFlyer 节点的 id 字段。 -->
        <!-- 事件节点的名称字段由游戏工作室定义。但一旦设置，它应该与 sendEvent() 请求的所有其他营销归因的名称字段相同。-->
        <!-- 事件节点的值字段由游戏工作室定义。 -->
        <AppsFlyer name="AppsFlyer" id="unused" key="DEV_KEY" itunseConnectAppId="909923112">
                <events>
                        <event name="TutorialComplete" value="教程完成"/>
                        <event name="MissionClear" value="任务完成"/>
                </events>
        </AppsFlyer>

        <!-- 配置 Firebase Analytics -->
        <!-- 事件节点的名称字段由游戏工作室定义。但一旦设置，它应该与 sendEvent() 请求的所有其他营销归因的名称字段相同。-->
        <!-- 事件节点的值字段由游戏工作室定义。 -->
        <firebase>
                <events>
                    <event name="TutorialComplete" value="TutorialComplete"/>
                    <event name="MissionClear" value="MissionClear"/>
                </events>
        </firebase>
</providers>

调用分析 API sendEvent() 发送事件。在发送事件时使用 hive_config.xml 中的 事件名称。名称 用作 sendEvent() 的请求参数，您设置的 值 将在每个归因的仪表板上更新。
- Analytics.sendEvent("TutorialComplete");
- Analytics.sendEvent("MissionClear");

通过 sendEvent() 发送事件¶

建议仅在用户活动满足特定条件时（例如完成教程）向归因发送跟踪事件。在Analytics类中调用sendEvent()方法以发送跟踪事件。作为sendEvent()的第一个参数，输入在hive_config.xml文件中定义的<event>元素的name属性的值。

以下是发送 TutorialComplete 事件到营销归因的示例代码，以通知用户已完成教程。

Unity虚幻引擎C++KotlinJavaObjective-CSwift

API 参考: hive.Analytics.sendEvent

using hive;    
    String eventName = "TutorialComplete";    
Analytics.sendEvent(eventName);

#include "HiveAnalytics.h"

FString 事件名称 = TEXT("教程完成");
FHiveAnalytics::SendEvent(事件名称);

API 参考: Analytics::sendEvent

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    string eventName = "TutorialComplete";    
Analytics::sendEvent(eventName);

API 参考: Analytics.sendEvent

import com.hive.Analytics    
    val eventName = "TutorialComplete"    
Analytics.sendEvent(eventName)

API 参考: AnalyticsInterface .sendEvent

import HIVEService    
    let eventName = "TutorialComplete"    
AnalyticsInterface.sendEvent(eventName)

API 参考: HIVEAnalytics:sendEvent

#import <HIVEService/HIVEService-Swift.h>    
    NSString eventName = @"TutorialComplete";    
[HIVEAnalytics sendEvent: eventName];

API 参考: AnalyticsInterface.sendEvent

#import HIVEService   
    let eventName = "TutorialComplete"
AnalyticsInterface.sendEvent(eventName)

在Firebase环境中应用Google Ads设备内测量¶

要在Firebase环境中测量Google Ads提供的设备内转化，您需要实现Firebase Google ODM解决方案。此解决方案需要用户同意提供的电子邮件地址或电话号码。在实施此解决方案的过程中，如果实现了Firebase身份验证或开发者引入的单独身份验证环境，则Hive SDK不会收集电子邮件地址，而是将身份验证后获得的任何电子邮件地址直接传递给Firebase API。

Note

本指南仅适用于iOS应用。Android应用在Firebase环境中测量设备内转换时不需要单独的流程。

实施方法¶

在整个过程中，您必须确保用户设备上的个人识别信息不会泄露到外部。

下载 Google Firebase ODM Unity 插件并将其添加到您的 Unity 项目中。
实现身份验证以在登录后获取 IdP 电子邮件地址或电话号码。
根据 Firebase 定义的方法规范化电子邮件地址或电话号码。
实现将规范化的电子邮件地址/电话号码传递给 Firebase。或者，实现将规范化的电子邮件地址/电话号码的哈希值传递给 Firebase。请参阅下面的示例代码。

Note

插件 API 可以顺序调用，但在每个用户调用一次后，后续调用基本上会被忽略。

示例代码¶

以下是使用Unity插件时的示例代码。

使用哈希值的示例代码¶

电子邮件电话号码

using hive;
// 发送哈希和标准化的电子邮件地址
GoogleODM.setHashedEmailAddress(ComputeSha256Hash("abc@abc.com"));

using hive;
// 发送哈希和标准化的电话号码信息
GoogleODM.setHashedPhoneNumber(ComputeSha256Hash("+821012345678"));

使用纯值的示例代码¶

电子邮件电话号码

using hive;
// 发送标准化的电子邮件地址
GoogleODM.setEmailAddress("abc@abc.com");

using hive;
// 发送规范化的电话号码信息
GoogleODM.setPhoneNumber("+821012345678");