虚幻引擎 SDK - 设置用户 ID

关注
Avatar
Jared Ornstead
Updated
文档

设置自定义用户 ID

将您的内部用户 ID 发送给 Singular，以便在所有平台上实现跨设备跟踪和用户级数据报告。

注：如果使用Singular 的跨设备解决方案，则必须在所有平台上收集用户 ID。

用户 ID 要求

隐私和最佳实践

在实施用户 ID 跟踪时，请遵循以下准则，以确保隐私合规和正确的跨设备测量。

  • 无 PII：用户 ID 不应暴露个人身份信息 (PII)，如电子邮件地址、用户名或电话号码。使用与第一方数据独一无二的哈希值。
  • 跨平台一致性：用户 ID 值必须是您在所有平台（网络/移动/PC/控制台/离线）上获取的相同内部标识符，以便进行准确的跨设备测量。
  • 第一方数据：用户 ID 是第一方数据，不会与第三方共享。
  • 持久性：用户 ID 会一直存在，直到使用UnsetCustomUserId 明确取消设置或卸载应用程序。关闭或重启应用程序不会清除用户 ID。

最佳实践：如果多个用户共用一台设备，请实施一个注销流程，在登录时调用 odedeSetCustomUserId，在注销时调用UnsetCustomUserId 。

实施概述

何时设置用户 ID

使用SetCustomUserId 设置用户标识符，使用UnsetCustomUserId 注销时清除用户标识符。

如果知道应用程序打开时的用户 ID，请在初始化 Singular SDK 之前调用SetCustomUserId 。这样可以确保 Singular 从第一次会话中接收到用户 ID。不过，在用户注册或登录之前，用户 ID 通常是不可用的，在这种情况下，请在注册或身份验证流程完成后调用SetCustomUserId 。

SDK 方法

设置自定义用户 ID

向 Singular 发送内部用户 ID，用于跨设备跟踪和用户级报告。

C++ 
// Set the user ID after login or registration
FString UserId = TEXT("user_abc123xyz");
USingularSDKBPLibrary::SetCustomUserId(UserId);
UE_LOG(LogTemp, Log, TEXT("Custom user ID set: %s"), *UserId);

方法签名： 

static void SetCustomUserId(FString customUserId);

定时：如果您知道应用程序打开时的用户 ID，请在初始化 SDK 之前调用SetCustomUserId 。否则，请在用户注册或登录完成后调用。

取消设置自定义用户 ID

在用户注销时清除用户 ID，以确保对多用户设备进行准确的会话跟踪。

C++ 
// Clear the user ID on logout
USingularSDKBPLibrary::UnsetCustomUserId();
UE_LOG(LogTemp, Log, TEXT("Custom user ID has been cleared"));

方法签名： 

static void UnsetCustomUserId();