Catatan: Vertex AI Search diganti namanya menjadi Agent Search. Kami sedang dalam proses memperbarui konten untuk mencerminkan branding baru ini.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Lihat Analytics

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

Analytics memberi Anda insight tentang tren penggunaan, kualitas penelusuran dan rekomendasi, serta engagement pengguna akhir aplikasi Anda. Konsol Agent Search memberikan 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 media dan penelusuran kustom: 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 di-refresh 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 lihat item. Diperlukan untuk rasio klik-tayang.
Peristiwa media selesai. Diperlukan untuk rasio penyelesaian per pemutaran dan rasio penyelesaian per rekomendasi.
Peristiwa media diputar. 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:

Peristiwa penelusuran. Diperlukan untuk rasio klik-tayang.
Peristiwa lihat item. Diperlukan untuk rasio klik-tayang.

Informasi berikut juga digunakan untuk beberapa analisis:

Tayangan. Anda dapat memberikan tayangan (penayangan atau klik item) yang dapat diatribusikan ke Agent Search dengan menyertakan item terkait di UserEvent.Documents saat memasukkan peristiwa pengguna. Informasi ini diperlukan untuk atribusi dan untuk menghitung metrik per penelusuran.
Token atribusi. Token atribusi adalah ID unik yang dihasilkan oleh Agent 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 ditayangkan oleh API. Hanya peristiwa pengguna dengan token atribusi yang dibuat 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. Untuk mengizinkan Agent Search mengidentifikasi sesi pengguna sehingga dapat memberikan analisis per sesi dan hasil penelusuran berkualitas lebih tinggi, Google sangat menyarankan agar Anda menetapkan kolom opsional userPseudoId.

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 Google Cloud Konsol, buka halaman AI Applications.

AI Applications
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 Google Cloud Konsol, buka halaman AI Applications.

AI Applications
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 (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 kustom, 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 mengirimkan permintaan penelusuran. Filter ini hanya tersedia jika ditetapkan dalam permintaan penelusuran.
- Setelan pengguna. Pilih setelan layanan kesehatan yang ditetapkan dalam permintaan penelusuran, seperti rawat inap, rawat jalan, atau perawatan hibrida. Filter ini hanya tersedia jika ditetapkan dalam permintaan penelusuran.

Definisi metrik

Tabel berikut menjelaskan cara metrik didefinisikan.

Metrik rekomendasi media

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

Metrik penelusuran media dan kustom

Nama metrik	Definisi Metrik	Catatan
Jumlah penelusuran	Jumlah peristiwa penelusuran	Berdasarkan log penelusuran.
Rasio tanpa 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 lihat item yang dapat diatribusikan ke peristiwa penelusuran sebelumnya. Berdasarkan peristiwa pengguna.
Jumlah suka dan tidak suka masukan	Jumlah suka dan tidak suka	Catatan respons masukan suka/tidak suka yang dikirim oleh pengguna aplikasi.
Rincian alasan tidak suka masukan	Persentase alasan tidak suka	Jika pengguna tidak menyukai jawaban yang dihasilkan, pengguna dapat memilih beberapa alasan untuk menjelaskan ketidaksukaannya. Persentase menunjukkan frekuensi setiap alasan dipilih.
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.
Tayangan halaman per kunjungan penelusuran	Jumlah peristiwa lihat item dalam sesi penelusuran / Jumlah sesi penelusuran	Metrik ini mencakup semua tayangan halaman dalam kunjungan penelusuran, terlepas dari apakah tayangan halaman tersebut dapat diatribusikan ke Agent Search atau tidak. 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
Jumlah tanpa hasil	Jumlah peristiwa penelusuran tanpa hasil
Rasio tanpa hasil per penelusuran	Jumlah peristiwa penelusuran tanpa hasil per penelusuran
Jumlah pasien	Jumlah ID pasien yang penelusurannya dilakukan	Jumlah ini dideduplikasi per pengguna penelusuran, tetapi tidak per pasien. Misalnya, jika pengguna 1 menelusuri pasien A dan B, serta pengguna 2 hanya menelusuri pasien B, jumlahnya adalah tiga.
Jumlah sesi penelusuran pelanggan	Jumlah sesi yang ditentukan pengguna penelusuran	Anda dapat mengirimkan ID sesi dalam penelusuran. Untuk mengetahui informasi selengkapnya, lihat `session`.
Jumlah pengunjung penelusuran	Jumlah pengguna yang mengirimkan permintaan penelusuran	Pengguna dihitung berdasarkan pada `userInfo` kolom.
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.