实现用户事件

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

用户信息

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

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

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

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

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

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

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

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

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