React Native SDK - 设置用户 ID

关注
Avatar
Jared Ornstead
Updated
文档

向 Singular 发送用户 ID（可选）

您可以使用 Singular SDK 方法向 Singular 发送内部用户 ID。

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

  • 用户 ID 可以是任何标识符，但不应暴露 PII（个人身份信息）。例如，不应使用用户的电子邮件地址、用户名或电话号码。Singular 建议使用仅对第一方数据唯一的哈希值。
  • 传递给Singular的用户ID值也应该是你在所有平台（Web/移动/PC/控制台/离线）上获取的相同的内部用户ID。
  • Singular 将在用户级导出、ETL 和内部 BI 回传（如果配置）中包含用户 ID。用户 ID 是第一方数据，Singular 不会与其他方共享。
  • 使用 Singular SDK 方法设置的用户 ID 值将一直存在，直到使用unsetCustomUserId 方法取消设置或卸载应用程序为止。关闭或重启应用程序不会取消设置用户 ID。

要设置用户 ID，请使用setCustomUserId 方法。要取消设置（例如，如果用户 "注销 "账户），请致电unsetCustomUserId 。

注意：如果多个用户使用一台设备，我们建议实施注销流程，为每次登录和注销设置和取消设置用户 ID。

如果已经知道应用程序打开时的用户 ID，请在初始化 Singular SDK 之前调用setCustomUserId 。这样，Singular 就能从第一次会话中获得用户 ID。不过，在用户注册或登录之前，用户 ID 通常是不可用的。在这种情况下，请在注册流程完成后调用setCustomUserId 。

Singular.setCustomUserId 方法
说明 向 Singular 发送用户 ID。
签名 static setCustomUserId(customUserId)
使用示例 
Singular.setCustomUserId('custom_user_id');
Singular.unsetCustomUserId 方法
说明 取消设置已发送至 Singular 的用户 ID。
签名 static unsetCustomUserId()
使用示例 
Singular.unsetCustomUserId();

可选：自定义用户 ID 设备映射

重要： 此高级企业功能仅在特殊情况下可用。实施前请咨询 Singular 解决方案工程师。

Singular 可以通过服务器到服务器集成接收额外的移动事件跟踪数据。要使用此功能，必须将用户 ID 映射到 Singular 的移动设备跟踪标识符。

注意：在初始化Singular SDK后或获得用户ID后，请尽快调用此方法。

Singular.SetDeviceCustomUserId方法
说明 设置与登录相同的自定义用户 ID，并将其映射到 Singular 的跟踪标识符。
签名 static setDeviceCustomUserId(customUserId)
使用示例 
Singular.setDeviceCustomUserId('CustomUserId');