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

关注
Avatar
Eyal Rabinovich
Updated
Singular 虚幻引擎 SDK
集成指南
  1. 基本集成
  2. 跟踪事件和收入
  3. 实现深度链接
  4. 添加SKAdNetwork支持
  5. 高级选项

 

跟踪事件（非收入）

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

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

您可以使用SendEvent和SendEventWithArgs 方法从应用程序向 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 回传常见问题。
  • 查看服务器到服务器集成指南中的"跟踪收入 "部分，了解详情。
从收入提供商发送事件
RevenueCat或adapty等第三方提供商可以向Singular提供购买和订阅收入。

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

从分段发送事件

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

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