管理用户事件

本页介绍了如何查看用户事件信息和清除用户事件。

如需在用户事件发生时进行记录，请参阅记录实时用户事件。如需从过去的事件中导入用户事件数据，请参阅导入历史用户事件。

查看汇总的用户事件信息

您可以在 Google Cloud 控制台中的应用数据页面事件标签页中查看有关应用的记录用户事件的信息。

此页面会显示提取的事件数、未联接的事件数、一段时间内事件数的百分比变化，以及每种文档的事件类型平均数等信息。此外，您还可以查看一段时间内每种事件类型的指标。指标会在您首次将事件上传到媒体推荐后约 24 小时显示。

如需查看用户事件信息，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

    Agent Builder

  2. 点击您要查看其用户事件信息的应用的名称。

  3. 在数据页面上，前往事件标签页。此标签页会显示用户事件信息。

完全清除用户事件

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

使用用户事件过滤条件指定要移除的事件。您可以使用用户事件过滤条件指定要清除的事件。您可以使用 eventTime、eventType、visitorID 和 userID 字段进行过滤。

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

此示例过滤某个时间范围，该时间范围必须使用祖鲁时间日期格式。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 > \"2023-12-21T18:25:43.511Z\" eventTime < \"2023-12-21T18:30:43.511Z\"",
    "force":"false"
  }' \
  "https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/userEvents:purge"

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

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

以下示例请求操作状态：

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/operations/OPERATION_ID"

操作状态示例：

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.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 > \"2023-12-21T18:25:43.511Z\" eventTime < \"2023-12-21T18:30:43.511Z\"",
    "force":"true"
  }' \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/userEvents:purge"

使用用户事件过滤条件

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

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

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

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

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

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

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

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

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

后续步骤