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 di konsol Google Cloud pada tab Peristiwa di halaman Data aplikasi.

Halaman ini menampilkan informasi seperti jumlah peristiwa yang diserap, 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 ke Rekomendasi untuk Media.

Untuk melihat informasi peristiwa pengguna:

  1. Di konsol Google Cloud, buka halaman Agent Builder.

    Agent Builder

  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 dicatat dengan benar dan perlu menghapusnya, Anda dapat melakukannya menggunakan metode API userEvents.purge.

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

Karena Anda tidak dapat mengurungkan penghapusan, uji filter dengan melakukan uji coba sebelum menghapus peristiwa pengguna. Kolom force ditetapkan ke false secara default; setelan ini akan menampilkan jumlah peristiwa yang akan dihapus tanpa benar-benar menghapusnya. Jika Anda siap untuk benar-benar menghapus peristiwa pengguna, tetapkan kolom force ke true.

Contoh ini memfilter rentang waktu, yang harus menggunakan format tanggal Waktu Zulu. Kolom force ditetapkan ke 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"

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

Menetapkan kolom force ke true akan memaksa penghapusan terjadi.

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"

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 kurang dari (<). Waktu yang dibatasi harus berupa satu blok yang berdekatan.

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

  • visitorID: Membatasi peristiwa 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 jenis add-to-cart yang dicatat ke dalam log pada atau setelah 1 Februari 2023, Anda harus memberikan string filter berikut:

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

Langkah selanjutnya