Melihat dan mengekspor data analisis

Analytics memberi Anda insight tentang tren penggunaan, kualitas penelusuran, dan engagement pengguna akhir aplikasi Anda. Konsol ini memberikan pengalaman dasbor interaktif yang didukung oleh Looker. Halaman ini menjelaskan cara melihat analisis untuk aplikasi Anda.

Catatan: Metrik diperbarui kira-kira setiap 6 jam, jadi mungkin perlu beberapa jam sebelum Anda dapat menggunakan halaman Analytics setelah membuat aplikasi.

Sebelum memulai

Pastikan aplikasi Anda terhubung ke penyimpanan data. Metrik aplikasi hanya tersedia sejak penyimpanan data ditautkan ke aplikasi.

Jika tidak memiliki penyimpanan data, Anda harus menghubungkan sumber data Google atau sumber data pihak ketiga ke aplikasi Anda.

Peringatan: Beberapa metrik aplikasi dapat hilang jika penyimpanan data dibatalkan tautannya dari aplikasi.

Peristiwa pengguna untuk Analytics

Bagian ini menjelaskan peristiwa pengguna yang digunakan Gemini Enterprise untuk membuat metrik terkait penelusuran, seperti jumlah penelusuran dan rasio klik-tayang. Tidak ada konfigurasi tambahan yang diperlukan jika Anda menggunakan antarmuka pengguna untuk menelusuri dan mendapatkan jawaban melalui asisten Gemini Enterprise. Namun, jika Anda menggunakan Gemini Enterprise API di aplikasi Anda sendiri, Anda harus mengonfigurasi penelusuran di aplikasi Anda untuk merekam peristiwa pengguna, lalu mengimpor peristiwa pengguna ke aplikasi Anda.

Aplikasi Gemini Enterprise memerlukan peristiwa pengguna berikut untuk mendapatkan 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 Google 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 Google 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.
• Log penelusuran. Log penelusuran didasarkan pada permintaan penelusuran. Untuk mengizinkan Google mengidentifikasi sesi pengguna sehingga dapat memberikan analisis per sesi dan hasil penelusuran berkualitas lebih tinggi, Google sangat menyarankan agar Anda menyetel kolom opsional SearchRequest.UserPseudoId.

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

Melihat analisis Gemini Enterprise

Catatan: Untuk aplikasi di multi-region AS dan Uni Eropa, melihat analisis penelusuran tersedia dalam Pratinjau publik. Analisis penelusuran tersedia untuk aplikasi global di GA.

Anda dapat melihat analisis penelusuran untuk aplikasi Anda. Anda akan melihat metrik yang terkait dengan panggilan penelusuran yang dilakukan ke aplikasi Anda. Jika aplikasi Anda terhubung ke beberapa penyimpanan data, sebaiknya lakukan panggilan penelusuran ke aplikasi dengan menentukan resource engine agar Anda bisa mendapatkan hasil dari semua penyimpanan data yang terhubung.

Gunakan petunjuk berikut untuk melihat analisis tentang aplikasi Anda.

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Klik nama aplikasi yang ingin Anda lihat analitiknya.

3. Klik Analytics.

4. Klik tab untuk melihat grup metrik tersebut:

   • Adopsi: Metrik tentang status adopsi pengguna.
   • Penggunaan dan Kualitas: Metrik tentang masukan pengguna dan penggunaan aplikasi.
   • Agen: Metrik terkait agen dalam aplikasi, seperti riset mendalam, penempaan ide, dan agen kustom.
   • Nilai: Metrik tentang penghematan biaya yang dicapai oleh pengguna yang membuat kueri data dengan aplikasi.

   

   Melihat data analisis untuk adopsi

5. Untuk memfilter metrik, tentukan filter yang tersedia untuk tab metrik, lalu klik tombol Muat Ulang untuk menerapkannya.

Definisi metrik

Tabel berikut menjelaskan cara metrik ditentukan.

Grup metrik	Nama metrik	Definisi metrik	Catatan
Adopsi	Pengguna aktif harian	Jumlah pengguna aktif per hari	Pengguna dianggap aktif jika mereka login dan memicu panggilan API apa pun, seperti saat membuka halaman beranda.
	Pengguna aktif mingguan	Jumlah pengguna aktif per minggu. Minggu dimulai pada hari Senin dan berakhir pada hari Minggu.
	Pengguna aktif bulanan	Jumlah pengguna aktif per bulan
	Rasio retensi 7 hari	Jumlah pengguna yang kembali dalam periode 7 hari saat ini / jumlah pengguna aktif dalam periode 7 hari sebelumnya	Pengguna dianggap sebagai pengguna yang kembali jika pengguna aktif selama periode 7 hari saat ini dan periode 7 hari sebelumnya.
	Tingkat pertumbuhan 7 hari	Perbedaan persentase antara jumlah pengguna aktif dalam periode tujuh hari saat ini dan periode tujuh hari sebelumnya
	Rasio churn 7 hari	Jumlah pengguna yang berhenti menggunakan aplikasi dalam periode 7 hari saat ini / jumlah pengguna aktif dalam periode 7 hari sebelumnya	Pengguna dianggap berhenti menggunakan aplikasi jika pengguna aktif dalam periode 7 hari sebelumnya, tetapi tidak aktif dalam periode 7 hari saat ini.
	Rasio retensi 28 hari	Jumlah pengguna yang kembali dalam periode 28 hari saat ini / jumlah pengguna aktif dalam periode 28 hari sebelumnya
	Tingkat pertumbuhan 28 hari	Perbedaan persentase antara jumlah pengguna aktif dalam periode 28 hari saat ini dan periode 28 hari sebelumnya
	Rasio churn 28 hari	Jumlah pengguna yang berhenti menggunakan aplikasi dalam periode 28 hari saat ini / jumlah pengguna aktif dalam periode 28 hari sebelumnya
	Kursi yang dibeli	Jumlah lisensi (slot) yang telah dibeli organisasi	Mencakup semua tempat duduk yang dibeli sejak mendaftar ke Gemini Enterprise.
	Kursi yang diklaim	Jumlah lisensi pengguna yang telah ditetapkan kepada dan diterima oleh individu dalam organisasi Anda	Mencakup semua kursi yang diklaim sejak mendaftar ke Gemini Enterprise.
Penggunaan dan kualitas	Jumlah penelusuran	Jumlah total penelusuran
	Jumlah jawaban	Jumlah total kueri yang jawabannya dihasilkan oleh Gemini Enterprise	Jawaban yang dibuat oleh agen tidak disertakan dalam jumlah ini.
	Jumlah tindakan	Jumlah total kueri yang dijawab oleh Gemini Enterprise	Mencakup tindakan seperti membuat template email.
	Rasio klik-tayang (CTR) per penelusuran	Jumlah total klik penelusuran / jumlah penelusuran	Klik penelusuran mencakup klik pada hasil penelusuran dan referensi internal.
	Tayangan halaman per kategori	Total jumlah penayangan untuk setiap halaman kategori
	Jumlah suka dan tidak suka pada masukan	Jumlah suka dan tidak suka yang dikirim oleh pengguna	Catatan respons masukan suka/tidak suka yang dikirim oleh pengguna aplikasi.
	Perincian alasan tidak menyukai masukan	Persentase alasan tidak suka	Saat pengguna tidak menyukai jawaban yang dihasilkan, mereka dapat memilih beberapa alasan untuk menjelaskan ketidaksukaan mereka. Persentase menunjukkan seberapa sering setiap alasan dipilih.
	Tingkat keberhasilan penelusuran	Jumlah penelusuran yang berhasil / jumlah penelusuran
	Tingkat jawaban yang berhasil	Jumlah jawaban berhasil / jumlah jawaban
Agen	Pengguna aktif bulanan agen	Jumlah total pengguna aktif yang menggunakan agen dalam bulan kalender terakhir.
	Sesi chat agen bulanan	Jumlah total sesi chat yang dimulai oleh pengguna yang berinteraksi dengan agen tertentu selama bulan kalender terakhir.	Sesi chat ditentukan sebagai interaksi pengguna dengan agen dalam thread chat yang sama dalam satu hari. Jika pengguna melanjutkan percakapan dalam rangkaian chat yang sama pada hari berikutnya, hal ini akan dianggap sebagai sesi baru.
	Agen bulanan yang digunakan	Jumlah total agen yang memiliki setidaknya satu pengguna aktif selama bulan kalender terakhir.
	Total sesi chat bulanan	Jumlah total sesi chat yang dimulai oleh pengguna yang berinteraksi dengan agen selama bulan kalender terakhir.	Sesi chat ditentukan sebagai interaksi pengguna dengan agen dalam thread chat yang sama dalam satu hari. Jika pengguna melanjutkan percakapan dalam rangkaian chat yang sama pada hari berikutnya, hal ini akan dianggap sebagai sesi baru.
	Agen yang dibuat setiap bulan	Jumlah total Agen yang dibuat dalam bulan kalender terakhir.
Nilai (pratinjau publik)
	Penelusuran berhasil	Jumlah penelusuran yang berhasil.	Jumlah penelusuran yang berhasil ditentukan oleh perilaku pengguna setelah penelusuran. Penelusuran dianggap berhasil jika salah satu hal berikut terjadi: Jika hasil penelusuran diklik sebelum penelusuran baru dimulai. Jika respons dari penelusuran menyertakan hasil penelusuran orang, dan tidak diikuti oleh penelusuran lain dalam waktu dua menit. Hal ini karena hasil penelusuran orang ditampilkan di halaman hasil penelusuran dan biasanya tidak memerlukan klik.
	Jawaban yang berhasil	Jumlah jawaban yang berhasil	Keberhasilan jawaban ditentukan oleh perilaku pengguna setelah jawaban tersebut dihasilkan. Keberhasilan diukur berdasarkan masukan yang diberikan atau seberapa cepat pertanyaan lanjutan diajukan. Jika pengguna menyukai jawaban, kueri dianggap berhasil. Jika tidak ada masukan dan pengguna tidak mengajukan kueri lain dalam waktu 30 detik, kueri dianggap berhasil.
	Jam kerja karyawan yang dihemat untuk tanggal yang dipilih	(Jumlah penelusuran yang berhasil + Jumlah jawaban yang berhasil) x Menit yang dihemat per jawaban yang berhasil
	Nilai disimpan untuk tanggal yang dipilih	Jam yang dihemat dalam tanggal yang dipilih ✕ Tarif per jam rata-rata karyawan	Untuk melihat metrik ini, di tab Nilai, tentukan tarif per jam untuk kolom Tarif Per Jam Karyawan.
	Proyeksi penghematan waktu karyawan per tahun	(Jumlah penelusuran yang berhasil + Jumlah jawaban yang berhasil) x Menit yang dihemat per penelusuran yang berhasil	Perkiraan jumlah penelusuran berhasil tahunan berasal dari jumlah penelusuran berhasil dalam rentang tanggal yang dipilih. Setiap kueri diperkirakan menghemat waktu tiga menit, perkiraan ini didasarkan pada riset internal Google.
	Perkiraan nilai tahunan yang dihemat	Perkiraan jam kerja karyawan yang dihemat per tahun ✕ Rata-rata tarif per jam karyawan	Untuk melihat metrik ini, di tab Nilai, tentukan tarif per jam untuk kolom Tarif Per Jam Karyawan.

Metrik ekspor

Ikuti langkah-langkah berikut untuk mengekspor metrik ke tabel BigQuery di projectGoogle Cloud Anda:

1. Verifikasi bahwa Anda memiliki izin dan peran yang diperlukan.

   • Anda harus memiliki peran Pelihat Discovery Engine agar dapat memanggil API.
   • Izin yang diperlukan untuk membuat set data BigQuery
   • Izin yang diperlukan untuk membuat tabel.

2. Buat set data BigQuery:

   1. Buka halaman BigQuery di konsol Google Cloud .

      Buka halaman BigQuery

   2. Di panel Explorer, pilih project yang sama dengan aplikasi Gemini Enterprise Anda untuk membuat set data.

   3. Klik opsi , lalu klik Buat set data.

   4. Di halaman Create dataset:

      • Untuk ID Set Data, masukkan nama set data yang unik. Anda memerlukan nama set data untuk mengekspor metrik melalui API.

      • Untuk Jenis lokasi, tabel berikut menunjukkan cara memetakan lokasi BigQuery ke lokasi aplikasi Gemini Enterprise:

        Catatan: Setelah set data dibuat, lokasi tidak dapat diubah.

        Lokasi multi-region aplikasi Gemini Enterprise	Lokasi multi-region BigQuery
        Global	Amerika Serikat (beberapa wilayah di Amerika Serikat)
        Amerika Serikat (beberapa wilayah di Amerika Serikat)	Amerika Serikat (beberapa wilayah di Amerika Serikat)
        EU (beberapa region di Uni Eropa)	EU (beberapa region di Uni Eropa)

   5. Klik Create dataset.

3. Buat tabel BigQuery kosong untuk set data yang Anda buat.

   1. Di panel Explorer, luaskan project Anda, lalu pilih set data yang Anda buat.
   2. Di bagian Dataset info, klik Create table.
   3. Di panel Create table, tentukan nama untuk tabel Anda di kolom Table. Anda memerlukan nama tabel untuk mengekspor metrik melalui API.
   4. Klik Create table.

4. Panggil metode analytics:exportMetrics untuk mengambil data metrik selama 30 hari terakhir, yang mencakup hari ini.

   Catatan: Anda hanya dapat memanggil metode analytics:exportMetrics 5 kali per hari untuk project Google Cloud , dan 25 kali per hari untukGoogle Cloud organisasi.

   REST

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   -d '{
      "analytics": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID",
      "outputConfig":
         {
            "bigqueryDestination":
            {
               "datasetId": "BIGQUERY_DATASET_ID",
               "tableId": "BIGQUERY_TABLE_ID"
            }
         }
      }' \
   "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/analytics:exportMetrics"
   

   Ganti kode berikut:

   • ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tetapkan salah satu nilai berikut:
     • us- untuk multi-region Amerika Serikat
     • eu- untuk multi-region Uni Eropa
     • global- untuk lokasi Global
     Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
   • LOCATION: multi-region penyimpanan data Anda: global, us, atau eu
   • PROJECT_ID: ID Google Cloud project Anda.
   • APP_ID: ID aplikasi yang ingin Anda ekspor metriknya.
   • BIGQUERY_DATASET_ID: ID set data BigQuery yang Anda buat.
     ID set data mengikuti format <PROJECT_ID>.<DATASET_ID>. Anda hanya perlu memberikan <DATASET_ID>.
   • BIGQUERY_TABLE_ID: ID tabel BigQuery yang Anda buat.
     Dalam tampilan Classic explorer, ID tabel mengikuti format <PROJECT_ID>.<DATASET_ID>.<TABLE_ID>. Anda hanya perlu memberikan <TABLE_ID>.

   Catatan: Jika Anda ingin mengekspor data metrik lagi dan mempertahankan data yang diekspor sebelumnya, buat tabel BigQuery baru dan perbarui BIGQUERY_TABLE_ID sebelum memanggil metode analytics:exportMetrics.

   Respons mencakup nama dan ID operasi. Catat ID operasi yang akan digunakan di langkah berikutnya.
   Contoh:

   {
      "name": "projects/my-project-123/locations/global/collections/default_collection/engines/my-app/operations/OPERATION_ID",
      "metadata": {
         "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsMetadata"
      }
   }
   

   Contoh perintah dan hasil

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   -d '{
      "analytics": "projects/my-project-123/locations/global/collections/default_collection/engines/my-app",
      "outputConfig":
         {
            "bigqueryDestination":
            {
               "datasetId": "123456789012345678901",
               "tableId": "123456789012345678901"
            }
         }
      }' \
   "https://discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/analytics:exportMetrics"
   
   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/operations/export-metrics-123456789012345678901",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsMetadata"
     }
   }
   

5. Untuk melihat status operasi ekspor metrik, panggil metode engines.operations.get:

   REST

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/operations/OPERATION_ID"
   

   Ganti kode berikut:

   • ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tetapkan salah satu nilai berikut:
     • us- untuk multi-region Amerika Serikat
     • eu- untuk multi-region Uni Eropa
     • global- untuk lokasi Global
     Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
   • LOCATION: multi-region penyimpanan data Anda: global, us, atau eu
   • APP_ID: ID aplikasi yang ingin Anda dapatkan operasi yang berjalan lama.
   • OPERATION_ID: ID operasi ekspor metrik yang ditampilkan dalam respons saat Anda menjalankan perintah untuk mengekspor metrik.

   Contoh perintah dan hasil

   Contoh perintah:

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global
   /collections/default_collection/engines/my-app/operations/export-metrics-123456789012345678901"
   

   Contoh respons saat operasi berhasil diselesaikan:

   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/operations/export-metrics-123456789012345678901",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsMetadata",
       "createTime": "2025-09-17T20:04:30.449781Z",
       "updateTime": "2025-09-17T20:04:35.089617Z"
     },
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsResponse"
     }
   }
   

   Contoh respons saat operasi mengalami error:

   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/operations/export-metrics-123456789012345678901",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsMetadata",
       "createTime": "2025-09-17T20:04:30.449781Z",
       "updateTime": "2025-09-17T20:04:35.089617Z"
     },
     "done": true,
     "error": {
       "code": 3,
       "message": "BigQuery job failed with error: Not found: Dataset my-project-123:123456789012345678901 was not found in location US at [1:24]"
     }
   }