实现用户事件

如需配置用户事件，请执行以下操作：

  1. 导入历史用户事件。

  2. 记录实时用户事件。

  3. 使用实体标记用户事件。

  4. 使用归因令牌标记用户事件。

用户信息

visitorId 值表示唯一的用户标识符。当您记录用户事件时，需要此参数。(UserInfo) 包含在您记录具有 visitorId 值和（如果可用）userId 值的用户事件时。

您可以将可选的 userId 值用作用户在不同设备上的唯一永久性标识符，每当用户登录您的网站时，系统都会使用该标识符。当您记录某个用户的 userId 时，Vertex AI Search 商务解决方案可以针对使用多台设备（例如移动设备和网络浏览器）的一个用户生成个性化结果。

用户事件时间戳

当您记录用户事件时，请确保添加事件发生的确切时间戳。准确的时间戳可确保事件以正确的顺序存储。对于使用跟踪代码管理器和 JavaScript Pixel 收集的事件，时间戳会被自动记录。导入事件时，您必须按照 RFC 3339 指定的格式在 eventTime 字段中提供时间戳。

用户事件的自定义属性

您可以为用户事件添加其他自定义属性和功能。在使用推荐功能时，这可以为用户提供更好、更具体的推荐。如需添加自定义特性，请在记录用户事件时使用 attributes。

如果您为注入的用户事件提供自定义特性，则务必也在与预测请求关联的用户事件中添加这些特性。自定义特性的格式设置必须在导入事件和随预测请求提供的事件之间保持一致。这样，便可在训练模型和提供预测时使用这些自定义特性，从而帮助提高推荐质量。

您可以使用 text 字段提供自定义文本值，也可以使用 number 字段提供自定义数值。

例如，下面显示了记录用户事件的请求的 attributes 部分：

"attributes": {
  "user_age": {"text": ["teen", "young adult"]},
  "user_location": {"text": ["CA"]}
}

监控导入运行状况

成功记录用户事件对于获得高质量结果非常重要。您应该监控事件记录错误率，并在必要时采取措施。如需了解详情，请参阅为数据上传问题设置提醒。