사용자 이벤트 관리

이 페이지에서는 사용자 이벤트 정보를 보고 사용자 이벤트를 영구 삭제하는 방법을 설명합니다.

사용자 이벤트가 발생할 때 기록하려면 실시간 사용자 이벤트 기록을 참조하세요. 과거 이벤트에서 사용자 이벤트 데이터를 가져오려면 이전 사용자 이벤트 가져오기를 참조하세요.

집계된 사용자 이벤트 정보 보기

Google Cloud 콘솔에서 앱의 데이터 페이지에 있는 이벤트 탭에서 앱에 대해 기록된 사용자 이벤트에 대한 정보를 확인할 수 있습니다.

이 페이지에는 수집된 이벤트 수, 조인되지 않은 이벤트 수, 일정 기간 동안 이벤트 수의 변화율, 문서당 평균 이벤트 유형 수와 같은 정보가 표시됩니다. 또한 시간 경과에 따라 각 이벤트 유형의 측정항목을 확인할 수 있습니다. 측정항목은 처음 이벤트를 업로드하고 약 24시간 후에 표시됩니다.

사용자 이벤트 정보를 보려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 AI 애플리케이션 페이지로 이동합니다.

    AI Applications

  2. 사용자 이벤트 정보를 확인하려는 앱의 이름을 클릭합니다.

  3. 데이터 페이지에서 이벤트 탭으로 이동합니다. 이 탭에 사용자 이벤트 정보가 표시됩니다.

사용자 이벤트 삭제

올바르게 기록되지 않은 사용자 이벤트를 삭제해야 하는 경우 userEvents.purge 메서드를 사용하여 삭제할 수 있습니다.

사용자 이벤트 필터를 사용하여 삭제할 이벤트를 지정합니다. 사용자 이벤트 필터를 사용하여 삭제할 이벤트를 지정할 수 있습니다. eventTime, eventType, visitorID, userID 필드를 사용하여 필터링할 수 있습니다.

다음 예시에서는 Zulu 시간 날짜 형식을 사용해야 하는 시간 범위를 필터링합니다.

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

다음 단계