Dasbor yang dapat dikonfigurasi

Lihat metrik penggunaan dan masukan dari Customer Experience Insights dari waktu ke waktu dengan dasbor yang dapat dikonfigurasi. Dasbor yang dapat dikonfigurasi menawarkan fleksibilitas dalam tata letak dan representasi data karena Anda dapat membuat dan mempertahankan tampilan kustom dengan berbagai diagram. Dasbor yang dapat dikonfigurasi memberi Anda kemampuan untuk memilih jenis diagram, menyimpan konfigurasi, dan mengambilnya saat Anda membuka halaman tersebut pada waktu berikutnya.

Komponen dasbor

Dasbor berisi komponen berikut.

Komponen Deskripsi
Dasbor Resource tingkat teratas yang menyimpan seluruh struktur dan definisi diagram.
Bagian Bagian dapat memiliki kartu atau bagian bertingkat (yang muncul sebagai tab). Bagian dasbor dapat memiliki nama tampilan dan deskripsi. Anda dapat menerapkan filter date_range ke semua diagram di seluruh tab. Bagian menentukan dimensi fisiknya menggunakan lebar dan tinggi dalam satuan petak.
Kartu Elemen dalam dasbor, yang ditentukan sebagai bagian bertingkat atau diagram. Rentang tanggal default adalah minggu lalu. Anda dapat membuat kueri lebih lanjut pada date_range sebagai 1 hari terakhir, 2 hari terakhir, 1 minggu terakhir, 2 minggu terakhir, 1 bulan terakhir, 1 kuartal terakhir, 1 tahun terakhir, atau tanggal mulai dan akhir yang disesuaikan.

Definisi kolom dasbor

Setiap dasbor terdiri dari kolom berikut. Hanya display_name dan description yang muncul di konsol.

Kolom Deskripsi Batasan/Catatan
name Nama dasbor Format: projects/{project}/locations/{location}/dashboards/{dashboard}
display_name Nama yang diberikan pengguna untuk dasbor Maksimum 100 karakter
description Deskripsi dasbor Opsional
create_time Stempel waktu pembuatan dasbor Khusus output
update_time Stempel waktu pembaruan terakhir dasbor Khusus output
filter Memfilter semua diagram di dasbor Mendukung filter string opsional

Data dan kueri

Diagram ini menggunakan bahasa alami (NL), yang diterjemahkan Customer Experience Insights dalam kueri SQL. Kueri ini menghasilkan data dan spesifikasi visual untuk menampilkan diagram. Spesifikasi visual dalam format VEGA-LITE. Chart API menggunakan sumber GenerativeInsights data, session_id, dan revision_id untuk menyimpan status SQL dan spesifikasi visual saat ini dari sebuah diagram.

Operasi dasbor

Anda dapat melakukan operasi berikut pada dasbor yang dapat dikonfigurasi.

Buat dasbor

Ikuti langkah-langkah berikut untuk membuat dasbor Anda.

Konsol

  1. Buka konsol CX Insights, login dengan Akun Google Anda, lalu pilih project Anda.

    Konsol CX Insights

  2. Klik Dasbor. Di sini, Anda dapat melihat dasbor bawaan dan kustom.

  3. Di studio Dasbor, klik + Tambahkan dasbor untuk membuat dasbor kustom Anda sendiri.

  4. Setiap dasbor muncul dalam bentuk kartu.

  5. Saat Anda mengklik dasbor, ringkasan semua diagram akan ditampilkan.

REST API

Kirim permintaan seperti contoh berikut.

{
"displayName": "My New Dashboard with Container",
"root_container": {
  "displayName": "Overview tab",
  "widgets": [
   {
      "container": {
        "displayName": "Inner Chart Group 1",
        "widgets": [
          {
            "chart": {
              "displayName": "Most Reported Issues"
              "dataSource": {"generativeInsights": "What are top 5 issues?"}
            }
          },
          {
            "chart": {
              "displayName": "Topic Distribution"
              "dataSource": {"generativeInsights": "What are the topics?"}
            }
          }
        ]
      }
    }
  ]
}
}

Curl

Jalankan perintah curl berikut. Dalam contoh ini, payload disimpan di create_dashboard_nested.json.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth --impersonate-service-account=$SA_EMAIL print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @create_dashboard_nested.json
"https://$ENDPOINT/v1/projects/$PROJECT/locations/$LOCATION/dashboards?dashboard_id=$DASHBOARD_ID"

Mengedit dasbor

Ikuti langkah-langkah berikut untuk mengedit dasbor Anda.

Konsol

  1. Pilih dasbor, lalu klik Lainnya more_vert > Edit untuk mengedit dasbor.

  2. Pilih salah satu opsi berikut:

  • + Tambahkan kartu
  • + Tambahkan bagian
  • edit Ganti nama tab
  • content_copy Duplikasikan tab
  • hapus Hapus tab
  • Pilih rentang tanggal untuk melihat hasil.
  • Pilih kartu, lalu klik Lainnya more_vert. Panel samping akan muncul dengan opsi berikut: Tanya AI, Setelan kartu, dan Editor kueri.

Opsi tambahan

Tanya AI: Klik Tanya AI, lalu masukkan deskripsi teks perubahan Anda. Asisten AI dapat membantu Anda membuat dasbor. Anda juga memiliki opsi untuk mengajukan pertanyaan lanjutan kepada asisten AI. Jika Anda mengklik Simpan Diagram, Anda dapat melakukan rollback ke visualisasi sebelumnya. Natural language (NL) memungkinkan Anda membuat visualisasi dengan menentukan kueri deskriptif seperti Berapa jumlah percakapan rata-rata setiap hari untuk agen virtual? Kueri ini dikonversi menjadi SQL untuk dieksekusi terhadap BigQuery dan spesifikasi visual (VEGA lite) untuk tujuan tampilan.

Setelan petak: Di bagian ini, Anda dapat memperbarui spesifikasi visual secara langsung untuk mengontrol atribut diagram. Misalnya: Mengubah nama tampilan diagram. Anda dapat memilih jenis diagram yang diinginkan di menu drop-down. Chart API mendukung jenis diagram dan representasi data berikut:

  • BAR
  • LINE
  • AREA
  • PIE
  • SEBARKAN
  • TABEL
  • SCORE_CARD
  • SUNBURST
  • GAUGE
  • SANKEY

Anda dapat menentukan lebih lanjut filter percakapan atau rentang waktu baru saat memuat ulang dasbor.

Editor kueri: Anda dapat berinteraksi dengan asisten AI dan membuat dasbor. Jika tidak puas dengan respons SQL yang dihasilkan AI, Anda dapat memperbarui SQL secara langsung untuk membuat ulang diagram dan respons SQL selanjutnya mengisi ulang spesifikasi visual yang ada. Editor kueri menampilkan SQL yang dibuat, yang nama tabelnya disamarkan untuk mereferensikan string placeholder yang telah ditentukan sebelumnya, INSIGHTS_DASHBOARD_VIEW. Catatan: Anda hanya dapat melakukan operasi SELECT.

Curl

Jalankan perintah curl berikut. Dalam contoh ini, payload disimpan di update_dashboard.json.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth --impersonate-service-account=$SA_EMAIL print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @update_dashboard.json \
"https://$ENDPOINT/v1/projects/$PROJECT/locations/$LOCATION/dashboards/$DASHBOARD_ID?update_mask=root_container"

Hapus dasbor

Ikuti langkah-langkah berikut untuk menghapus dasbor dan semua diagram terkait.

Konsol

Pilih dasbor, lalu klik Lainnya more_vert > Hapus untuk menghapus dasbor.

Curl

Jalankan perintah curl berikut.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth --impersonate-service-account=$SA_EMAIL print-access-token)" \
"https://$ENDPOINT/v1/projects/$PROJECT/locations/$LOCATION/dashboards/$DASHBOARD_ID"