Mengelola peristiwa pengguna

Halaman ini menjelaskan cara melihat informasi peristiwa pengguna dan menghapus peristiwa pengguna.

Untuk merekam peristiwa pengguna saat terjadi, lihat Merekam peristiwa pengguna real-time. Untuk mengimpor data peristiwa pengguna dari peristiwa sebelumnya, lihat Mengimpor peristiwa pengguna historis.

Melihat informasi peristiwa pengguna gabungan

Anda dapat melihat informasi tentang peristiwa pengguna yang direkam untuk aplikasi Anda di konsolGoogle Cloud pada tab Peristiwa di halaman Data aplikasi Anda.

Halaman ini menampilkan informasi seperti jumlah peristiwa yang diproses, jumlah peristiwa yang tidak digabungkan, perubahan persentase jumlah peristiwa selama jangka waktu tertentu, dan jumlah rata-rata jenis peristiwa per dokumen. Selain itu, Anda dapat melihat metrik untuk setiap jenis peristiwa dari waktu ke waktu. Metrik akan muncul sekitar 24 jam setelah Anda pertama kali mengupload peristiwa.

Untuk melihat informasi peristiwa pengguna:

  1. Di konsol Google Cloud , buka halaman AI Applications.

    Aplikasi AI

  2. Klik nama aplikasi yang ingin Anda lihat informasi peristiwa penggunanya.

  3. Di halaman Data, buka tab Peristiwa. Informasi peristiwa pengguna ditampilkan di tab ini.

Menghapus permanen peristiwa pengguna

Jika Anda memiliki peristiwa pengguna yang tidak direkam dengan benar dan perlu menghapusnya, Anda dapat melakukannya menggunakan metode API userEvents.purge.

Tentukan acara yang ingin Anda hapus menggunakan filter acara pengguna. Anda dapat menggunakan filter peristiwa pengguna untuk menentukan peristiwa yang ingin Anda hapus permanen. Anda dapat memfilter dengan kolom eventTime, eventType, visitorID, dan userID.

Contoh ini memfilter rentang waktu, yang harus menggunakan format tanggal Waktu 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"

Anda akan menerima objek respons yang mirip dengan berikut, dengan purge-user-events-54321 adalah ID operasi:

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

Contoh ini meminta status operasi:

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"

Contoh status operasi: 

{
  "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"
  }
}

Menggunakan filter peristiwa pengguna

Anda dapat memfilter peristiwa pengguna yang akan dihapus.

Filter adalah string yang berisi satu atau beberapa batasan berikut:

  • eventTime: Memberikan stempel waktu untuk membatasi peristiwa yang akan dihapus. Filter ini dapat ditentukan satu atau dua kali, dengan simbol lebih besar dari (>) atau lebih kecil dari (<). Waktu yang dibatasi harus berupa satu blok yang berdekatan.

  • eventType: Membatasi acara yang akan dihapus ke satu jenis acara.

  • visitorID: Membatasi acara yang akan dihapus ke satu ID pengunjung.

  • userID: Membatasi acara yang akan dihapus ke satu ID pengguna.

Hanya peristiwa pengguna yang memenuhi semua batasan yang akan dihapus.

Misalnya, untuk menghapus semua peristiwa pengguna berjenis add-to-cart yang dicatat pada atau setelah 1 Februari 2023, Anda akan memberikan string filter berikut:

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

Langkah berikutnya