Vertex AI Agent Builder diganti namanya menjadi Aplikasi AI. Kami sedang dalam proses memperbarui konten untuk mencerminkan branding baru ini.

Halaman ini diterjemahkan oleh Cloud Translation API.

Lihat Analytics
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Halaman ini menjelaskan cara melihat analisis untuk aplikasi rekomendasi dan penelusuran Anda.

Analisis memberi Anda insight tentang tren penggunaan, kualitas penelusuran dan rekomendasi, serta engagement pengguna akhir aplikasi Anda. Konsol Vertex AI Agent Builder menyediakan pengalaman dasbor interaktif yang didukung oleh Looker.

Untuk aplikasi rekomendasi media: Pratinjau publik. Anda dapat melihat metrik per rekomendasi berdasarkan peristiwa pengguna. Anda dapat memfilter metrik menurut rentang tanggal dan jenis perangkat.
Untuk aplikasi penelusuran umum dan penelusuran media: Anda dapat melihat metrik per penelusuran dan metrik per sesi penelusuran berdasarkan log penelusuran dan peristiwa pengguna. Anda dapat memfilter metrik menurut rentang tanggal, kueri, dan jenis perangkat.
Untuk aplikasi penelusuran layanan kesehatan: Pratinjau publik. Anda dapat melihat metrik per penelusuran berdasarkan log penelusuran.

Metrik diperbarui sekitar setiap enam jam, sehingga perlu waktu beberapa jam sebelum Anda dapat menggunakan halaman Analytics setelah membuat aplikasi.

Sumber data untuk analisis

Bagian ini menjelaskan sumber data untuk analisis, bergantung pada jenis aplikasi.

Anda harus menyelesaikan integrasi peristiwa pengguna agar dapat melihat analisis peristiwa pengguna.

Peristiwa pengguna yang Anda upload akan memengaruhi analisis yang dihasilkan.

Aplikasi rekomendasi media memerlukan peristiwa pengguna berikut untuk melihat beberapa metrik:

Peristiwa tampilan item. Diperlukan untuk rasio klik-tayang.
Peristiwa media selesai. Diperlukan untuk rasio penyelesaian per pemutaran dan rasio penyelesaian per rekomendasi.
Peristiwa pemutaran media. Diperlukan untuk jumlah pemutaran media rekomendasi, rasio pemutaran, rasio penyelesaian per pemutaran, dan waktu tonton rata-rata per pemutaran.

Aplikasi penelusuran memerlukan peristiwa pengguna berikut untuk melihat beberapa metrik:

Menelusuri peristiwa. Diperlukan untuk rasio klik-tayang.
Peristiwa tampilan item. Diperlukan untuk rasio klik-tayang.

Informasi berikut juga digunakan untuk beberapa analisis:

Tayangan iklan. Anda dapat memberikan tayangan (tampilan atau klik item) yang dapat dikaitkan dengan Vertex AI Search dengan menyertakan item terkait di UserEvent.Documents saat menyerap peristiwa pengguna. Informasi ini diperlukan untuk atribusi dan untuk menghitung metrik per penelusuran.
Token atribusi. Token atribusi adalah ID unik yang dihasilkan oleh Vertex AI Search dan ditampilkan dengan setiap permintaan penelusuran. Pastikan untuk menyertakan token atribusi tersebut sebagai UserEvent.attributionToken dengan peristiwa pengguna apa pun yang dihasilkan dari penelusuran. Hal ini diperlukan untuk mengidentifikasi apakah penelusuran dilayani oleh API. Hanya peristiwa pengguna dengan token atribusi yang dihasilkan Google yang digunakan untuk menghitung metrik.
Agen pengguna. Sertakan UserInfo.userAgent dengan peristiwa pengguna sehingga Anda dapat memfilter metrik peristiwa pengguna menurut jenis perangkat.

Log penelusuran

Aplikasi penelusuran menggunakan log penelusuran sebagai sumber data untuk beberapa metrik.

Log penelusuran didasarkan pada permintaan penelusuran. Agar Vertex AI Agent Builder dapat mengidentifikasi sesi pengguna sehingga dapat memberikan analisis per sesi dan hasil penelusuran berkualitas lebih tinggi, Google sangat merekomendasikan agar Anda menetapkan kolom SearchRequest.UserPseudoId opsional.

Jika belum ada log penelusuran atau peristiwa pengguna, nilai default akan ditampilkan untuk semua metrik.

Melihat analisis rekomendasi media

Gunakan petunjuk berikut untuk melihat analisis rekomendasi media.

Di konsol Google Cloud, buka halaman Agent Builder.

Agent Builder
Klik nama aplikasi yang ingin Anda lihat analisisnya.
Klik Analytics.
Untuk memfilter metrik, tentukan salah satu filter berikut, lalu klik tombol Refresh untuk menerapkannya:
- Rentang tanggal. Pilih rentang tanggal standar atau, jika tersedia, masukkan rentang tanggal kustom.
- Jenis perangkat. Pilih jenis perangkat tempat kueri terjadi.

Melihat analisis penelusuran

Gunakan petunjuk berikut untuk melihat analisis aplikasi penelusuran.

Di konsol Google Cloud, buka halaman Agent Builder.

Agent Builder
Klik nama aplikasi yang ingin Anda lihat analisisnya.
Klik Analytics.
Klik tab untuk melihat grup metrik tersebut:
- Per Penelusuran. Metrik dikelompokkan menurut penelusuran. Untuk penelusuran layanan kesehatan, ini adalah satu-satunya grup metrik yang tersedia.
- Per Sesi. Metrik dikelompokkan menurut sesi penelusuran.
- Bandingkan. Metrik dasar ditampilkan bersama metrik dari periode perbandingan. Pilih rentang tanggal untuk metrik dasar pengukuran (rentang waktu sebelumnya) dan metrik perbandingan (rentang waktu berikutnya). Rentang waktu ini tidak boleh tumpang tindih.
Untuk memfilter metrik, tentukan filter, lalu klik tombol Refresh untuk menerapkannya.

Untuk aplikasi media dan aplikasi penelusuran umum, filter berikut tersedia:
- Rentang tanggal. Pilih rentang tanggal standar atau, jika tersedia, masukkan rentang tanggal kustom.
- Kueri penelusuran. Pilih kondisi dan nilai kueri penelusuran. Anda dapat menambahkan beberapa filter kueri penelusuran. Tersedia untuk metrik Per Penelusuran dan Bandingkan.
- Jenis perangkat. Pilih jenis perangkat tempat kueri terjadi.
Untuk aplikasi penelusuran layanan kesehatan, filter berikut tersedia:
- Rentang tanggal. Pilih rentang tanggal standar atau, jika tersedia, masukkan rentang tanggal kustom. Jika Anda memilih tanggal tertentu untuk rentang tanggal kustom, tanggal tersebut adalah tanggal saat penelusuran dilakukan di zona waktu UTC -08.00.
- Kueri penelusuran. Pilih kondisi dan nilai kueri penelusuran. Anda dapat menambahkan beberapa filter kueri penelusuran.
- Lokasi pengguna. Pilih lokasi rumah sakit, klinik, atau penyedia layanan kesehatan yang ditetapkan dalam permintaan penelusuran. Filter ini hanya tersedia jika ditetapkan dalam permintaan penelusuran.
- Peran pengguna. Pilih kategori pekerjaan pengguna yang mengirim permintaan penelusuran. Filter ini hanya tersedia jika ditetapkan dalam permintaan penelusuran.
- Setelan pengguna. Pilih setelan layanan kesehatan yang ditetapkan dalam permintaan penelusuran, seperti perawatan rawat inap, rawat jalan, atau campuran. Filter ini hanya tersedia jika ditetapkan dalam permintaan penelusuran.

Definisi metrik

Tabel berikut menjelaskan cara metrik ditentukan.

Metrik rekomendasi media

Nama metrik	Definisi metrik	Catatan
Jumlah rekomendasi	Jumlah total rekomendasi
Jumlah pemutaran rekomendasi	Frekuensi pemutaran item media yang direkomendasikan
Jumlah klik rekomendasi	Frekuensi item media yang direkomendasikan diklik
Rasio klik-tayang	Jumlah klik rekomendasi / jumlah rekomendasi	Klik rekomendasi adalah peristiwa item tampilan yang dapat diatribusikan ke rekomendasi
Jumlah media rekomendasi yang selesai	Frekuensi item media yang direkomendasikan diputar hingga selesai
Rasio tontonan per rekomendasi	Frekuensi pemutaran item media yang direkomendasikan / jumlah rekomendasi
Rasio penyelesaian per pemutaran	Frekuensi item media yang direkomendasikan diputar hingga selesai / frekuensi item media diputar
Waktu tonton rata-rata per pemutaran	Waktu dalam detik saat item media yang direkomendasikan diputar / frekuensi item media yang direkomendasikan diputar
Rasio penyelesaian per rekomendasi	Frekuensi item media diputar hingga selesai / jumlah rekomendasi
Waktu tonton rata-rata per rekomendasi	Waktu dalam detik saat item media yang direkomendasikan ditonton / jumlah rekomendasi

Metrik penelusuran umum dan media

Nama metrik	Definisi Metrik	Catatan
Jumlah penelusuran	Jumlah peristiwa penelusuran	Berdasarkan log penelusuran.
Tidak ada tarif hasil	Jumlah peristiwa penelusuran tanpa hasil / Jumlah penelusuran	Berdasarkan log penelusuran.
Rasio klik-tayang (CTR) per penelusuran	Jumlah klik penelusuran / Jumlah penelusuran	Klik penelusuran adalah peristiwa item tampilan yang dapat diatribusikan ke peristiwa penelusuran sebelumnya. Berdasarkan peristiwa pengguna.
Jumlah sesi penelusuran	Jumlah sesi penelusuran	Sesi penelusuran adalah sesi pengguna yang berisi setidaknya satu peristiwa penelusuran. Sesi pengguna, yang juga disebut kunjungan, adalah kumpulan peristiwa pengguna yang berkelanjutan. Jika tidak ada aktivitas selama 30 menit, sesi akan berakhir. Berdasarkan log penelusuran.
Kunjungan halaman per kunjungan penelusuran	Jumlah peristiwa item tampilan dalam sesi penelusuran / Jumlah sesi penelusuran	Metrik ini mencakup semua kunjungan halaman dalam kunjungan penelusuran terlepas dari apakah kunjungan tersebut dapat diatribusikan ke Penelusuran Vertex AI. Berdasarkan peristiwa pengguna.
Rasio pantulan	Jumlah pantulan dalam sesi penelusuran/jumlah sesi penelusuran	Pantulan sesi penelusuran didefinisikan sebagai sesi dengan satu penelusuran, tempat pengguna keluar setelah hanya melakukan satu penelusuran. Berdasarkan peristiwa pengguna.

Metrik penelusuran layanan kesehatan

Metrik penelusuran berikut tersedia untuk aplikasi penelusuran layanan kesehatan.

Nama metrik	Definisi Metrik	Catatan
Jumlah penelusuran	Jumlah peristiwa penelusuran
Tidak ada jumlah hasil	Jumlah peristiwa penelusuran tanpa hasil
Rasio hasil per penelusuran tidak ada	Jumlah peristiwa penelusuran tanpa hasil per penelusuran
Jumlah pasien	Jumlah ID pasien yang dilakukan penelusurannya	Data ini dihapus duplikatnya per pengguna penelusuran, tetapi tidak per pasien. Misalnya, jika pengguna 1 menelusuri pasien A dan B dan pengguna 2 hanya menelusuri pasien B, maka jumlahnya adalah tiga.
Jumlah sesi penelusuran pelanggan	Jumlah sesi penelusuran yang ditentukan pengguna	Anda dapat mengirim ID sesi dalam penelusuran. Untuk informasi selengkapnya, lihat `session`.
Jumlah pengunjung penelusuran	Jumlah pengguna yang mengirim permintaan penelusuran	Pengguna dihitung berdasarkan kolom `userInfo`.
Jumlah sesi penelusuran sintetis	Jumlah sesi penelusuran yang ditentukan Google	Sesi penelusuran adalah sesi pengguna yang berisi setidaknya satu peristiwa penelusuran. Sesi pengguna, yang juga disebut kunjungan, adalah kumpulan peristiwa pengguna yang berkelanjutan. Jika tidak ada aktivitas selama 30 menit, sesi akan berakhir.

Menonaktifkan analisis

Anda tidak dapat menonaktifkan analisis untuk aplikasi yang ada, tetapi saat membuat aplikasi, Anda dapat memilih untuk membuatnya dengan analisis dinonaktifkan.

Untuk membuat aplikasi penelusuran yang tidak akan mengumpulkan data analisis:

Ikuti petunjuk REST di Membuat aplikasi penelusuran, dengan menambahkan hal berikut ke perintah curl:

   "disableAnalytics": true

Contoh perintah

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: my-project-123" \
"https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app" \
-d '{
  "displayName": "App without analytics",
  "dataStoreIds": ["my-data-store"],
  "solutionType": "SOLUTION_TYPE_SEARCH",
  "searchEngineConfig": {
     "searchTier": "SEARCH_TIER_ENTERPRISE",
     "searchAddOns": ["SEARCH_ADD_ON_LLM"]
   },
  "disableAnalytics": true
}'

Perintah ini membuat aplikasi yang tidak akan mengumpulkan data analisis penelusuran.