这是仅与 Recommendations AI 相关的文档。如需在受限 GA 阶段试用 Retail Search 和统一 Retail 控制台,请与 Cloud 销售人员联系如果您不打算使用 Retail Search,请保留在 Recommendations 控制台上,直到收到进一步的通知。

如果您使用的是 v1beta 版 Recommendations AI,请迁移到 Retail API 版本

管理用户事件

本页面介绍了如何查看和删除用户事件。如需了解如何在用户事件发生时进行记录,请参阅记录实时用户事件。如需从过去的事件中导入用户事件数据,请参阅导入历史用户事件

查看聚合的用户事件信息

您可以在“Recommendations AI 数据”页面的“事件”标签页中查看您项目的记录用户事件数。指标将在首次将事件上传到 Recommendations AI 后约 24 小时显示。

Recommendations AI 用户事件统计信息

移除用户事件

通常情况下,在记录用户事件后,您应妥善保留。不建议完全清除事件。

事件完全清除操作最长可能需要几天才能完成。如果您计划完全重置用户事件,请考虑创建一个新项目。

如果您的用户事件未正确记录并需要移除这些事件,可以使用 userEvents.purge 方法执行此操作。

使用过滤条件字符串指定要移除的事件。这支持通过按 eventTimeeventTypevisitorIDuserID 字段进行过滤来选择性地删除用户事件。

由于您无法撤消删除操作,因此请在删除用户事件之前执行试运行以测试过滤器字符串。force 字段默认设置为 false;此设置将返回要删除的事件的数量,但不会实际删除它们。准备好实际删除用户事件后,请将 force 字段设置为 true

curl

此示例过滤某个时间范围,该时间范围必须使用祖鲁时间日期格式force 字段设置为 false

curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token)"" \
  -H "Content-Type: application/json; charset=utf-8" \
  --data '{
    "filter":"eventTime > \"2019-12-23T18:25:43.511Z\" eventTime < \"2019-12-23T18:30:43.511Z\"",
    "force":"false"
  }' \
  "https://retail.googleapis.com/v2/projects/[PROJECT_ID]/locations/global/catalogs/default_catalog/userEvents:purge"

您应该会收到类似如下所示的响应对象,其中 purge-user-events-54321 是操作 ID:

{
  "name": "projects/[PROJECT_ID]/locations/global/catalogs/default_catalog/operations/purge-user-events-54321"
}

以下示例请求操作状态:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://retail.googleapis.com/v2/projects/[PROJECT_ID]/locations/global/catalogs/default_catalog/operations/[OPERATION_ID]"

操作状态示例:

{
  "name": "projects/[PROJECT_ID]/locations/global/catalogs/default_catalog/operations/[OPERATION_ID]",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.retail.v2main.PurgeUserEventsResponse",
    "purgedEventsCount": "1"
  }
}

force 字段设置为 true 会强制进行删除。

curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token)"" \
  -H "Content-Type: application/json; charset=utf-8" \
  --data '{
    "filter":"eventTime > \"2019-12-23T18:25:43.511Z\" eventTime < \"2019-12-23T18:30:43.511Z\"",
    "force":"true"
  }' \
"https://retail.googleapis.com/v2/projects/[PROJECT_ID]/locations/global/catalogs/default_catalog/userEvents:purge"

使用用户事件过滤条件

您可以过滤要删除的用户事件。

过滤条件是一个字符串,其中包含一个或多个以下限制条件:

  • eventTime

    提供绑定要删除的事件的时间戳。此过滤条件可以指定一次或两次,大于 (>) 或小于 (<) 符号。有界限时间必须是单个连续的块。

  • eventType

    将要删除的事件限制为单个事件类型。

  • visitorID

    将要删除的事件限制为单个访问者 ID。

  • userID

    将要删除的事件限制为单个用户 ID。

系统仅删除满足所有限制条件的用户事件。

要删除 2019 年 2 月 1 日当天或之后记录的 add-to-cart 类型的所有用户事件,您需要提供以下过滤字符串:

eventTime > "2019-02-01T00:00:00Z" eventType = add-to-cart