用户 (User ID)

User ID 是分配给每个用户的唯一标识符，用于在用户的所有设备上保持一致的用户数据。这使您能够为受众在他们的设备上提供无缝的用户体验。

用户和设备之间有何关联？

每个用户都被分配一个称为 User ID 的唯一标识符。User ID 可以关联到多个设备，使企业即使用户更换设备也能与他们保持联系。这确保了目标消息能够送达目标用户正在使用的任何设备上。

用户 (User ID) 不是一个独立的实体；它依赖于关联设备的存在。如果最后一个关联设备被移除或关联到另一个用户，该用户将自动从系统中删除。

用户 (User ID) 也作为一个实体，可以将多个设备分组在其下，每个设备都有自己唯一的硬件 ID (HWID)。

用户类型

用户有两种类型：匿名用户和已知用户。匿名用户的 User ID 等于设备 HWID，之后可以替换为实际的 User ID。

已知用户有一个明确的 User ID。您可以在通过 /registerDevice API 调用注册新设备时指定一个 User ID。

获取和管理 User ID

Pushwoosh 提供了多种访问和管理用户的方式：

创建用户

默认情况下，当集成了 Pushwoosh SDK 的应用首次启动时，它会将设备 HWID 设置为 User ID。您可以在登录时从 Pushwoosh SDK 调用 setUserID 方法，设置任何所需的值以将设备与特定用户关联。当用户登出时，您可以通过另一次 setUserID 调用将此值重置为默认值，例如重置为初始的 HWID 值。

导入用户

您可以轻松地从 CSV 文件为特定用户细分导入 User ID。请在细分指南中查找我们的详细说明。

导出用户

要导出 User ID，您可以使用 /exportSegment API 请求，该请求提供了以 CSV 或 JSON 格式导出数据的选项。

从设备日志访问 User ID

User ID 也可以直接从设备日志中访问。有关分步说明，请参阅文章如何获取控制台日志和设备令牌。

用户和设备标签

与设备一样，用户 (User ID) 也可以拥有自己的标签集，这些标签将作为标签来根据用户的特征对用户或设备进行分类和识别。

如何创建用户特定标签

当您设置一个用户特定标签时，它会自动应用于用户及其所有关联设备。这意味着该标签将与用户的个人资料相关联，并会反映在他们的所有设备上。

要从 Pushwoosh Control Panel 创建用户特定标签，请在添加新标签时勾选用户特定复选框。如果您不将标签标记为用户特定，它将仅与设备关联。

管理用户转换

在 Pushwoosh 中，管理用户转换涉及两种主要场景：

从匿名用户到已知用户的转换

当匿名用户成为已知用户时，他们正在使用的设备将与他们的新用户个人资料相关联。在此转换过程中，所有设备属性保持不变。但需要注意的是，所有用户特定属性都会重置为已知用户的值，如果不存在则重置为默认值。

例如，假设一个访客用户一直在使用一个具有默认设置的健身追踪应用。当他们创建账户时，他们的设备数据保持不变。但是，任何用户特定的详细信息，如姓名、电子邮件和自定义目标，都将重置为已知用户的值。

从一个已知用户到另一个已知用户的转换

如果与设备关联的用户通过 Pushwoosh SDK 的 setUserID 方法更改，设备将与新的用户个人资料相关联。

了解更多关于为 Android 和 iOS 设置 User ID 的信息。

您也可以使用 /registerUser API 调用。

与前一个场景一样，设备属性保持不变，确保了平滑的转换。但是，用户特定标签现在将被分配为新用户的值。这是为了确保用户的标签准确反映新用户的个人资料。

举个例子，考虑一个视频流媒体服务中的场景。如果一个注册用户登出，而另一个不同的注册用户在同一设备上登录，设备设置（如首选语言和视频质量设置）将被保留。然而，任何用户特定的信息，如观看历史和推荐，都将为新用户更改。

用于管理用户的 API 方法

Pushwoosh 提供了多种 API 方法来管理您应用内的用户。理解这些方法对于有效的用户数据管理和定位至关重要。以下是改变用户状态或属性的四个关键方法：

1. /applicationOpen

• 如果设备和匿名用户不存在，则创建一个没有推送令牌的设备和匿名用户。
• 在设备上设置设备特定标签。
• 不处理与用户相关的更改。

2. /registerDevice

• 如果设备和用户不存在，则创建一个带有推送令牌的设备和用户。
• 将设备与 API 请求中的用户关联（否则为匿名用户）。
• 将所有指定的标签分配给设备及其关联用户。

警告

为防止潜在的竞态条件（即多个操作试图同时修改共享数据），请避免将 /registerDevice 与 /registerUser 同时使用。

3. /registerUser

• 如果设备和用户不存在，则创建一个没有推送令牌的设备和用户。
• 在用户之间转移设备，同时保留设备标签。

4. /setTags

• 如果设备和匿名用户不存在，则创建一个没有推送令牌的设备和匿名用户。
• 将设备标签分配给设备。
• 将用户标签分配给请求中提供的用户（如果该用户存在）。
• 此方法不转移设备，因此不能创建新的已知用户（您可以使用 /registerUser 方法来创建新的已知用户）。

如果一个用户关联了多个设备，在 Customer Journey 期间哪个设备会收到消息？

当一个用户有多个设备与他们的账户关联时，消息如何在这些设备间传递取决于 Journey 的类型：

基于 Audience 入口和基于 Webhook 入口的 Journey

默认情况下，在这些 Journey 中，消息会发送到与用户关联的最近活跃的设备。这确保了消息能够送达最有可能与之互动的用户。

基于触发器入口的 Journey

默认情况下，消息会发送到最后触发操作的设备。这通过在发生相关用户活动的设备上发送消息来保持上下文和相关性。

发送到所有设备

但是，您可以选择覆盖这些默认设置，将消息同时发送到与 User ID 关联的所有设备。为此，在消息设置中，向下滚动到选项，并打开发送到所有用户设备开关。

这个选项对于需要触达用户所有设备（无论他们当前正在使用哪个设备）的广播或紧急通知可能很有用。