管理使用者事件

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

如要記錄使用者事件，請參閱「記錄即時使用者事件」。如要從過往活動匯入使用者事件資料，請參閱「匯入歷來的使用者事件」。

查看匯總使用者事件資訊

您可以在應用程式「資料」頁面的「事件」分頁中，查看應用程式記錄的使用者事件相關資訊。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

後續步驟