Android SDK - 设置用户 ID

关注
Avatar
Jared Ornstead
Updated

设置用户 ID

将您的内部用户 ID 发送到 Singular，以启用跨设备追踪和用户级数据报告。

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

用户 ID 要求

隐私和最佳实践

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

  • 不含 PII： 用户 ID 不应暴露个人身份信息（PII），例如电子邮件地址、用户名或电话号码。请使用您的第一方数据中独有的哈希值。
  • 跨平台一致性： 为了准确测量跨设备数据，用户 ID 的值必须与您在所有平台（Web/Mobile/PC/Console/Offline）中获取的内部标识符相同。
  • 第一方数据： Singular 在用户级导出、ETL 和内部 BI 回传（如果已配置）中包含用户 ID。用户 ID 属于第一方数据，不会与第三方共享。
  • 持久性： 用户 ID 一直保留，直到使用 unsetCustomUserId() 显式取消或应用被卸载。关闭或重启应用不会清除用户 ID。

实施概述

何时设置用户 ID

使用 setCustomUserId() 设置用户标识符，使用 unsetCustomUserId() 在登出时清除它。

最佳实践： 如果多个用户共用一台设备，请实施登出流程，在登录时调用 setCustomUserId() ，在登出时调用 unsetCustomUserId() 。

如果在应用打开时您已经知道用户 ID，请在初始化 Singular SDK 之前调用 setCustomUserId() 。这样可以确保 Singular 从第一个会话开始就接收到用户 ID。但是，用户 ID 通常在用户注册或登录之前不可用，在这种情况下，请在注册或身份验证流程完成后调用 setCustomUserId() 。

SDK 方法

设置自定义用户 ID

将您的内部用户 ID 发送到 Singular，以进行跨设备追踪和用户级报告。

Kotlin Java 
// Set the user ID after login or registration
Singular.setCustomUserId("custom_user_id")

方法签名： 

public static void setCustomUserId(String customUserId);

取消自定义用户 ID

当用户登出时清除用户 ID，以确保在多用户共用设备上进行准确的会话追踪。

Kotlin Java 
// Unset the user ID on logout
Singular.unsetCustomUserId()

方法签名： 

public static void unsetCustomUserId();