Unreal 引擎 SDK 集成: 跟踪事件和收入

Singular 虚幻引擎 SDK
下载
奇异虚幻引擎 SDK 2.4.0 版
兼容性

虚幻引擎 4.23+

集成指南
  1. 基本集成
  2. 跟踪事件和收入
  3. 实现深度链接
  4. 添加SKAdNetwork支持
  5. 高级选项

 

跟踪事件(非收入)

Singular 可以收集有关应用程序内事件的数据,以帮助分析营销活动的绩效并衡量关键绩效指标。

例如,您的组织可能希望收集有关用户登录、注册、教程完成或游戏应用中等级提升的数据。

您可以使用SendEventSendEventWithArgs 方法从应用程序向 Singular 发送事件。

注意: 我们强烈建议以英文传递事件名称和属性,以保证与第三方合作伙伴和分析解决方案(如果您计划使用它们)的兼容性。

SingularSDK SendEvent 方法
说明 使用自定义事件名称向 Singular 发送用户事件以进行跟踪。
签名
public static void SendEvent(FString eventName)

使用示例

// 发送一个不带任何参数的事件,只有一个名称
  USingularSDKBPLibrary::SendEvent("Login");
SingularSDK SendEventWithArgs 方法
说明 向 Singular 发送用户事件以进行跟踪,并附带自定义事件名称和其他自定义参数。
签名
public static void SendEventWithArgs(FString eventName, 
TMap<FString, FString> args)

使用示例

TMap<FString, FString> args;
args.Add(TEXT("Key"), TEXT("Value"));
USingularSDKBPLibrary::SendEventWithArgs("Login", args);

跟踪收入

Singular可以收集通过应用程序获得的收入数据,以帮助分析营销活动的绩效和投资回报率。Singular 将通过报告、日志导出和回传等方式向您提供这些数据。

注意事项 任何以不同货币报告的收入都将自动转换为您在 Singular 账户中设置的贵组织首选货币。

使用SendRevenue向 Singular 传递购买信息,包括自定义事件名称、交易货币和交易金额。SendRevenueWithArgs 与之非常相似,但允许你添加额外的自定义参数。

SingularSDK 发送收入方法
说明 向 Singular 发送收入事件。
签名
public static void SendRevenue(FString eventName,
FString currency, float amount)
注意:传递货币为三个字母的 ISO 4217 货币代码,如"USD", "EUR", "INR"
使用示例
USingularSDKBPLibrary::SendRevenue("Purchase Completed", "USD", 9.99);
SingularSDK SendRevenueWithArgs 方法
说明 向 Singular 发送带有附加自定义参数的收入事件。
签名
public static void SendRevenueWithArgs(FString eventName, 
FString currency, float amount, TMap<FString, FString> args)
注意:以三个字母的 ISO 4217 货币代码形式传递货币,如"USD", "EUR", "INR"
使用示例
// 发送包含产品详细信息的收入事件
  TMap<FString, FString> args;
args.Add(TEXT("Key"), TEXT("Value"));
USingularSDKBPLibrary::SendRevenueWithArgs("Purchase Completed",
"USD", 9.99, args);

混合事件跟踪(高级)

Singular 建议通过集成到应用程序中的 Singular SDK 发送所有事件和收入。不过,Singular 也可以从其他来源收集事件和收入。

任何非通过 Singular SDK 发送的事件都必须符合 Singular 的服务器到服务器事件文档要求,并提供匹配的设备标识符以正确归属事件。

重要

如果服务器到服务器事件请求中使用的设备标识符在 Singular 中没有匹配的设备标识符,就会出现差异。请注意以下可能性:

  • 如果事件请求是在 Singular SDK 从应用程序会话记录设备标识符之前收到的,那么该事件请求将被视为未知设备的 "第一次会话",Singular 将把该设备作为有机归属
  • 如果 Singular SDK 确实记录了设备标识符,但 Singular SDK 标识符与服务器到服务器事件请求中指定的设备标识符不同,那么事件将被错误归属

混合事件跟踪指南

从内部服务器发送事件

Singular可以收集来自服务器的收入数据,帮助分析营销活动的表现和投资回报率。

要求

  • 从应用内注册或登录事件中捕获并传递设备标识符,并将此数据与服务器上的用户 ID 一起存储。由于用户的设备标识符可能会发生变化,因此请确保在用户生成应用程序会话时更新标识符。这将确保服务器端事件归属于正确的设备。
  • 服务器端事件是平台特定的,只能使用与设备平台相匹配的设备标识符发送(如 iOS 设备的 IDFA 或 IDFV)。
  • 您可以使用 Singular 内部 BI 回传机制将事件实时推送到内部端点,以便更新服务器端的数据集。请参阅内部 BI 回传常见问题
  • 查看服务器到服务器集成指南中的"跟踪收入 "部分,了解详情。
从收入提供商发送事件
RevenueCatadapty等第三方提供商可以向Singular提供购买和订阅收入

请点击以下链接了解如何启用这些合作伙伴。

从分段发送事件

要使 Segment 能与 Singular SDK 并行发送事件到 Singular,必须在 Segment 中添加一个"云模式 "目的地。请点击此处查看我们的指南。