Unity SDK - 设置用户 ID

关注
Avatar
Jared Ornstead
Updated
文档

设置用户 ID

向 Singular 发送内部用户 ID，以实现跨设备跟踪和用户级数据报告。

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

用户ID要求

隐私和最佳实践

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

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

实施概述

何时设置用户 ID

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

最佳实践：如果多个用户共用一台设备，请执行注销流程，登录时调用SetCustomUserId() ，注销时调用UnsetCustomUserId() 。

如果在应用程序打开时已经知道用户 ID，请在初始化 Singular SDK 之前调用SetCustomUserId() 。不过，在用户注册或登录之前，用户 ID 通常是不可用的，在这种情况下，应在注册或验证流程完成后调用SetCustomUserId() 。

SDK 方法

设置自定义用户 ID

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

C# 
// Set the user ID after login or registration
SingularSDK.SetCustomUserId("custom_user_id");

方法签名： 

public static void SetCustomUserId(string customUserId)

取消设置自定义用户 ID

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

C# 
// Unset the user ID on logout
SingularSDK.UnsetCustomUserId();

方法签名： 

public static void UnsetCustomUserId()