Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menjelaskan cara melihat analisis untuk rekomendasi dan aplikasi penelusuran Anda.
Analytics memberi Anda insight tentang tren penggunaan, kualitas penelusuran dan rekomendasi, serta engagement pengguna akhir aplikasi Anda. Konsol Aplikasi AI 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 kustom 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 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 selesai media. Diperlukan untuk rasio penyelesaian per pemutaran dan
rasio penyelesaian per rekomendasi.
Peristiwa pemutaran media. Diperlukan untuk rekomendasi jumlah pemutaran media,
rasio penayangan, rasio penyelesaian per pemutaran, dan rata-rata waktu tonton per pemutaran.
Aplikasi penelusuran memerlukan peristiwa pengguna berikut untuk melihat beberapa metrik:
Telusuri acara. Diperlukan untuk rasio klik-tayang.
Peristiwa lihat item. Diperlukan untuk rasio klik-tayang.
Informasi berikut juga digunakan untuk beberapa analisis:
Tayangan iklan. Anda dapat memberikan tayangan (penayangan atau klik item) yang dapat diatribusikan ke Vertex AI Search dengan menyertakan item terkait dalam UserEvent.Documents saat memproses peristiwa pengguna. Informasi ini diperlukan untuk atribusi dan untuk menghitung metrik per penelusuran.
Token atribusi. Token atribusi adalah ID unik yang dibuat 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
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 agar
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 Aplikasi AI mengidentifikasi sesi pengguna sehingga dapat memberikan analisis per sesi dan hasil penelusuran berkualitas lebih tinggi, Google sangat menyarankan agar Anda menyetel 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 konsol Google Cloud , buka halaman AI Applications.
Klik nama aplikasi yang ingin Anda lihat analitiknya.
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 Muat Ulang 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. Saat 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 tugas 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 rawat inap, rawat jalan, atau perawatan 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 item media yang direkomendasikan diputar
Jumlah klik rekomendasi
Frekuensi item media yang direkomendasikan diklik
Rasio klik-tayang
Jumlah klik rekomendasi / jumlah rekomendasi
Klik rekomendasi adalah peristiwa lihat item yang dapat diatribusikan ke rekomendasi
Jumlah media rekomendasi yang selesai
Frekuensi item media yang direkomendasikan diputar hingga selesai
Rasio penayangan per rekomendasi
Jumlah pemutaran item media yang direkomendasikan / jumlah rekomendasi
Rasio penyelesaian per pemutaran
Frekuensi item media yang direkomendasikan diputar hingga selesai / frekuensi item media diputar
Rata-rata waktu tonton per pemutaran
Durasi dalam detik item media yang direkomendasikan diputar / frekuensi item media yang direkomendasikan diputar
Rasio penyelesaian per rekomendasi
Frekuensi item media diputar hingga selesai / jumlah rekomendasi
Rata-rata waktu tonton per rekomendasi
Waktu dalam detik saat item media yang direkomendasikan ditonton / jumlah rekomendasi
Metrik media dan penelusuran kustom
Nama metrik
Definisi Metrik
Catatan
Jumlah penelusuran
Jumlah peristiwa penelusuran
Berdasarkan log penelusuran.
Rasio tidak ada 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.
Perincian alasan tidak suka masukan
Persentase alasan tidak suka
Jika pengguna tidak menyukai jawaban yang dihasilkan, pengguna dapat memilih beberapa alasan untuk menjelaskan ketidaksukaan mereka.
Persentase menunjukkan seberapa sering 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 serangkaian 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 penayangan halaman dalam
kunjungan penelusuran
terlepas dari apakah
penayangan halaman tersebut dapat diatribusikan
ke
Vertex AI Search.
Berdasarkan peristiwa pengguna.
Rasio pantulan
Jumlah pantulan dalam sesi penelusuran/Jumlah sesi penelusuran
Pentalan sesi penelusuran ditentukan 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 tanpa hasil
per penelusuran
Jumlah peristiwa penelusuran tanpa hasil per penelusuran
Jumlah pasien
Jumlah ID pasien yang penelusurannya dilakukan
Data ini dideduplikasi
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 yang ditentukan pengguna untuk penelusuran
Anda dapat mengirimkan ID sesi dalam penelusuran Anda.
Untuk informasi selengkapnya,
lihat
session.
Jumlah pengunjung penelusuran
Jumlah pengguna yang mengirim permintaan penelusuran
Sesi penelusuran adalah
sesi pengguna
yang berisi setidaknya
satu peristiwa penelusuran. Sesi pengguna, yang juga disebut kunjungan, adalah serangkaian peristiwa pengguna yang berkelanjutan. Jika tidak ada aktivitas selama 30 menit, sesi akan berakhir.
Menonaktifkan analisis
Anda tidak dapat menonaktifkan analisis untuk aplikasi yang sudah ada, tetapi saat membuat aplikasi, Anda dapat memilih untuk membuatnya dengan analisis yang dinonaktifkan.
Untuk membuat aplikasi penelusuran yang tidak akan mengumpulkan data analisis:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-19 UTC."],[[["\u003cp\u003eThis page details how to access and interpret analytics for recommendations and search apps within the Vertex AI Agent Builder console.\u003c/p\u003e\n"],["\u003cp\u003eAnalytics dashboards, powered by Looker, provide insights into app usage, search and recommendation quality, and user engagement, with data refreshed approximately every six hours.\u003c/p\u003e\n"],["\u003cp\u003eSpecific metrics and filtering options vary depending on whether the app is for media recommendations, generic search, or healthcare search, all of which support filtering by date range and device type.\u003c/p\u003e\n"],["\u003cp\u003eUser events, such as view-item, media-complete, and search events, are critical for generating certain metrics, and for search apps, search logs are used as a data source for some metrics.\u003c/p\u003e\n"],["\u003cp\u003eWhile analytics are enabled by default, new search apps can be created without analytics by setting \u003ccode\u003e"disableAnalytics": true\u003c/code\u003e in the REST API configuration.\u003c/p\u003e\n"]]],[],null,["# View analytics\n\nThis page describes how to view analytics for your recommendations\nand search apps.\n\nAnalytics give you insight into the usage trends, search and recommendation\nquality, and end-user engagement of your app. The AI Applications console\nprovides an interactive dashboard experience powered by Looker.\n\n- **For media recommendations apps**: Public preview. You can see per-recommendation metrics based on user events. You can filter metrics by date range and device type.\n- **For custom search and media search apps**: You can see per-search metrics and per-search-session metrics based on search logs and user events. You can filter metrics by date range, query, and device type.\n- **For healthcare search apps**: Public preview. You can see per-search metrics based on search logs.\n\nMetrics are refreshed about every six hours, so it can take several hours before\nyou can use the **Analytics** page after you create your app.\n\nData sources for analytics\n--------------------------\n\nThis section describes the data sources for analytics depending on app type.\n\nYou must complete user events integration to be\nable to see user event analytics.\n\nWhich user events you upload affect which analytics are generated.\n\nMedia recommendations apps require the following user events to view some\nmetrics:\n\n- **View-item events.** Required for click-through-rate.\n- **Media-complete events.** Required for completion rate per play and completion rate per recommendation.\n- **Media-play events.** Required for recommendation media play count, playthrough rate, completion rate per play, and average watch time per play.\n\nSearch apps require the following user events to view some metrics:\n\n- **Search events.** Required for click-through-rate.\n- **View-item events.** Required for click-through-rate.\n\nThe following information is also used for some analytics:\n\n- **Impressions** . You can provide impressions (item views or clicks) that are attributable to Vertex AI Search by including the associated item in `UserEvent.Documents` when ingesting user events. This information is needed for attribution and to compute per-search metrics.\n- **Attribution tokens** . Attribution tokens are unique IDs generated by Vertex AI Search and returned with each search request. Make sure to include that attribution token as `UserEvent.attributionToken` with any user events resulting from a search. This is needed to identify if a search is served by the API. Only user events with a Google-generated attribution token are used to compute metrics.\n- **User agent** . Include `UserInfo.userAgent` with user events so that you can filter on user event metrics by device type.\n\n### Search logs\n\nSearch apps use search logs as data sources for some metrics.\n\nSearch logs are based on search requests. To allow AI Applications to\nidentify user sessions so that it can deliver per-session analytics and higher\nquality search results, Google strongly recommends that you set the optional\nfield [`userPseudoId`](/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.collections.engines.servingConfigs/search#body.request_body.FIELDS.user_pseudo_id).\n\nIf there are not yet any search logs or user events, default values are shown\nfor all metrics.\n\nView media recommendations analytics\n------------------------------------\n\n| **Note:** Media recommendations analytics are in Public preview.\n\nUse the following instructions to view analytics for media recommendations.\n\n1. In the Google Cloud console, go to the **AI Applications** page.\n\n [AI Applications](https://console.cloud.google.com/gen-app-builder/start)\n2. Click the name of the app that you want to view analytics for.\n\n3. Click **Analytics**.\n\n4. To filter your metrics, specify any of the following filters and then click\n the **Refresh** button to apply them:\n\n - **Date range**. Select a preset date range or, if available, enter a custom date range.\n - **Device type**. Select a device type that queries occurred on.\n\nView search analytics\n---------------------\n\n| **Notes:**\n|\n| - For data stores in US and EU multi-regions, viewing search analytics is in Public preview.\n| - Because AI Applications for healthcare search provides search services only in the US multi-region (\\`us\\`), analytics for healthcare search are in Public preview.\n| - Search analytics are GA for global data stores.\n| - By default, metrics from the widget don't appear on the **Analytics** page. To view widget metrics, contact your Google account team and ask to be added to the allowlist.\n\nUse the following instructions to view analytics for search apps.\n\n1. In the Google Cloud console, go to the **AI Applications** page.\n\n [AI Applications](https://console.cloud.google.com/gen-app-builder/start)\n2. Click the name of the app that you want to view analytics for.\n\n3. Click **Analytics**.\n\n4. Click a tab to view that metric group:\n\n - **Per Search**. Metrics are grouped by searches. For healthcare search, this is the only available metric group.\n - **Per Session**. Metrics are grouped by search sessions.\n - **Compare**. Baseline metrics are shown alongside metrics from a comparison period. Select date ranges for the baseline metrics (an earlier time range) and comparison metrics (a later time range). These time ranges can't overlap.\n5. To filter your metrics, specify the filters and then click\n the **Refresh** button to apply them.\n\n For media apps and for custom search apps, the following filters are\n available:\n - **Date range**. Select a preset date range or, if available, enter a custom date range.\n - **Search query** . Select a condition and search query value. You can add multiple search query filters. Available for **Per Search** and **Compare** metrics.\n - **Device type**. Select a device type that queries occurred on.\n\n For healthcare search apps, the following filters are available:\n - **Date range**. Select a preset date range or, if available, enter a custom date range. When you select a specific date for custom date range, that date is the date when the search took place in the UTC -08:00 time zone.\n - **Search query**. Select a condition and search query value. You can add multiple search query filters.\n - **User location**. Select the location of the hospital, clinic, or the healthcare service provider that was set in the search request. This filter is available only if it was set in the search request.\n - **User role**. Select the job category of the user who sent the search request. This filter is available only if it was set in the search request.\n - **User setting**. Select the healthcare setting set in the search request, such as inpatient, outpatient, or hybrid treatment. This filter is available only if it was set in the search request.\n\nMetrics definitions\n-------------------\n\nThe following tables describe how metrics are defined.\n\n### Media recommendations metrics\n\n### Media and custom search metrics\n\n### Healthcare search metrics\n\nThe following search metrics are available for healthcare search apps.\n\nTurn off analytics\n------------------\n\nYou can't turn off analytics for an existing app, but when you create an app you\ncan choose to create it with analytics turned off.\n\nTo create a search app that won't collect analytics data:\n\n1. Follow the REST instructions in [Create a search app](/generative-ai-app-builder/docs/create-engine-es), adding\n the following to the curl command:\n\n \"disableAnalytics\": true\n\n #### Example command\n\n ```\n curl -X POST \\\n -H \"Authorization: Bearer $(gcloud auth print-access-token)\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-Goog-User-Project: my-project-123\" \\\n \"https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app\" \\\n -d '{\n \"displayName\": \"App without analytics\",\n \"dataStoreIds\": [\"my-data-store\"],\n \"solutionType\": \"SOLUTION_TYPE_SEARCH\",\n \"searchEngineConfig\": {\n \"searchTier\": \"SEARCH_TIER_ENTERPRISE\",\n \"searchAddOns\": [\"SEARCH_ADD_ON_LLM\"]\n },\n \"disableAnalytics\": true\n }'\n\n \n ```\n\n\n This command creates an app that won't collect search analytics data."]]
