Lihat Analytics

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

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.

Metrik diperbarui sekitar setiap 6 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 tontonan, rasio penyelesaian per pemutaran, dan rata-rata waktu tonton 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. 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 menyarankan 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

Catatan: Analisis rekomendasi media ada dalam Pratinjau publik.

Gunakan petunjuk berikut untuk melihat analisis rekomendasi media.

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

   Agent Builder

2. Klik nama aplikasi yang ingin Anda lihat analisisnya.

3. Klik Analytics.

4. 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

Catatan:

• Untuk penyimpanan data di multi-region AS dan Uni Eropa, melihat analisis penelusuran berada dalam pratinjau Publik.
• Analisis penelusuran adalah GA untuk penyimpanan data global.
• Metrik dari widget tidak muncul di halaman Analytics.

Gunakan petunjuk berikut untuk melihat analisis untuk aplikasi penelusuran umum atau penelusuran media.

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

   Agent Builder

2. Klik nama aplikasi yang ingin Anda lihat analisisnya.

3. Klik Analytics.

4. Klik tab untuk melihat grup metrik tersebut:

   • Per Penelusuran. Metrik dikelompokkan menurut penelusuran.
   • 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.

5. 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.
   • 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.

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

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

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:

1. 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.