管理使用者事件

本頁說明如何查看使用者事件資訊和清除使用者事件。

如要記錄使用者事件，請參閱「記錄即時使用者事件」一文。如要匯入過去事件的使用者事件資料，請參閱「匯入歷來的使用者事件」。

查看匯總使用者事件資訊

您可以在Google Cloud 控制台的應用程式「資料」頁面中，透過「事件」分頁查看應用程式記錄的使用者事件相關資訊。

這個頁面會顯示擷取的事件數量、未彙整的事件數量、一段時間內事件數量的百分比變化，以及每份文件的事件類型平均計數等資訊。此外，您還可以查看各事件類型的指標隨時間變化。指標會在您首次上傳事件後約 24 小時顯示。

如要查看使用者事件資訊，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「AI Applications」頁面。

    AI 應用程式

  2. 按一下要查看使用者事件資訊的應用程式名稱。

  3. 在「資料」頁面中，前往「事件」分頁。這個分頁會顯示使用者事件資訊。

清除使用者事件

如果您有未正確記錄的使用者事件，且需要移除這些事件，可以使用 userEvents.purge API 方法。

使用使用者事件篩選器指定要移除的事件。您可以使用使用者事件篩選器指定要清除的事件。您可以使用 eventTime、eventType、visitorID 和 userID 欄位進行篩選。

這個範例會篩選時間範圍，但必須使用 Zulu Time 日期格式。

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\"",
  }' \
  "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"
  }
}

使用使用者事件篩選器

您可以篩選要刪除的使用者事件。

篩選器是包含下列一或多個限制的字串：

  • eventTime：提供時間戳記，以便限制要刪除的事件。這個篩選器可指定一次或兩次，並搭配大於 (>) 或小於 (<) 符號。時間範圍必須是單一連續區塊。

  • eventType：將要刪除的事件限制為單一事件類型。

  • visitorID：將要刪除的事件限制為單一訪客 ID。

  • userID：將要刪除的事件限制為單一使用者 ID。

系統只會刪除符合所有限制條件的使用者活動。

舉例來說，如要刪除 2023 年 2 月 1 日當天或之後記錄的所有 add-to-cart 類型使用者事件，請提供下列篩選字串：

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

後續步驟