设置用户 ID
将您内部的用户 ID 发送到 Singular,以启用跨设备追踪 和用户级别的数据报告。
注意: 如果您使用 Singular 的跨设备解决方案 ,则必须在所有平台上 收集用户 ID。
用户 ID 要求
隐私和最佳实践
在实施用户 ID 追踪时,请遵循以下准则,以确保符合隐私规定 并实现准确的跨设备测量。
- 禁止 PII: 用户 ID 不应暴露个人身份识别信息(PII), 例如电子邮件地址、用户名或电话号码。请使用基于您第一方数据的 唯一哈希值。
- 跨平台一致性: 用户 ID 的值必须是您在所有平台 (Web/移动端/PC/主机/线下)上获取的相同内部标识符, 以实现准确的跨设备测量。
- 第一方数据: Singular 会将用户 ID 包含在用户级别的导出、 ETL 和内部 BI 回调中(如已配置)。 用户 ID 是第一方数据,不会与第三方共享。
-
持久性:
用户 ID 会一直保留,直到使用
unsetCustomUserId()显式取消设置或应用被卸载为止。 关闭或重启应用不会清除用户 ID。
实施概述
何时设置用户 ID
使用
setCustomUserId()
设置用户标识符,使用
unsetCustomUserId()
在登出时清除它。
最佳实践:
如果多个用户共用一台设备,
请实施一个登出流程,在登录时调用
setCustomUserId()
,并在登出时调用
unsetCustomUserId()
。
如果在应用启动时已知用户 ID,请在初始化 Singular SDK 之前调用
setCustomUserId()
。
这可确保 Singular 从第一个会话开始就收到用户 ID。但是,
用户 ID 通常要等到用户注册或登录后才能获取,在这种情况下,
请在注册或身份验证流程完成后调用
setCustomUserId()
。
SDK 方法
设置 Custom User ID
将您内部的用户 ID 发送到 Singular,用于跨设备追踪和 用户级别的报告。
// Set the user ID after login or registration
Singular.setCustomUserId("custom_user_id")// Set the user ID after login or registration
[Singular setCustomUserId:@"custom_user_id"];方法签名:
+ (void)setCustomUserId:(NSString *)customUserId;
+setCustomUserId:
返回
void
— 在调用处没有成功/失败信号。用户 ID 会
附加到 SDK 发送的下一个会话和事件上。
名称相似的
+setDeviceCustomUserId:
被标注为
__attribute__((deprecated))
,仅出于遗留兼容性而存在。新代码中请始终调用
+setCustomUserId:
。
取消设置 Custom User ID
在用户登出时清除用户 ID,以确保在多用户设备上进行准确的 会话追踪。
// Unset the user ID on logout
Singular.unsetCustomUserId()// Unset the user ID on logout
[Singular unsetCustomUserId];方法签名:
+ (void)unsetCustomUserId;