实现用户事件

如需配置用户事件,请执行以下操作:

  1. 导入用户历史事件

  2. 记录实时用户事件

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

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

用户信息

visitorId 值表示唯一身份用户标识符。记录用户事件时,此值是必需的。当您记录具有 visitorId 值(如果可用,则还具有 userId 值)的用户事件时,系统会包含 (UserInfo)。

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

用户事件时间戳

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

用户事件的自定义特性

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

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

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

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

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

监控导入运行状况

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