Konfigurierbare Dashboards

Mit einem konfigurierbaren Dashboard können Sie sich im Zeitverlauf Nutzungs- und Feedbackmesswerte aus Insights zur Customer Experience ansehen. Konfigurierbare Dashboards bieten Flexibilität bei der Datendarstellung und beim Layout, da Sie benutzerdefinierte Ansichten mit einer Vielzahl von Diagrammen erstellen und verwalten können. Mit dem konfigurierbaren Dashboard können Sie einen Diagrammtyp auswählen, die Konfiguration speichern und sie beim nächsten Besuch der Seite wieder abrufen.

Dashboard-Komponenten

Ein Dashboard enthält die folgenden Komponenten.

Komponente Beschreibung
Dashboard Die übergeordnete Ressource, in der die gesamte Struktur und die Diagrammdefinitionen gespeichert sind.
Bereich Ein Bereich kann Kacheln oder verschachtelte Bereiche (die als Tabs angezeigt werden) enthalten. Dashboard-Abschnitte können einen Anzeigenamen und eine Beschreibung haben. Sie können den Filter „date_range“ auf alle Diagramme auf einem Tab anwenden. Abschnitte definieren ihre physischen Abmessungen mithilfe von Breite und Höhe in Rastereinheiten.
Kachel Ein Element im Dashboard, das als verschachtelter Bereich oder Diagramm definiert ist. Der Standardzeitraum ist die letzte Woche. Sie können den Zeitraum weiter eingrenzen, indem Sie „Letzter Tag“, „Letzte 2 Tage“, „Letzte Woche“, „Letzte 2 Wochen“, „Letzter Monat“, „Letztes Quartal“, „Letztes Jahr“ oder die benutzerdefinierten Start- und Enddaten angeben.

Felddefinitionen für Dashboards

Jedes Dashboard besteht aus den folgenden Feldern. In der Console wird nur display_name und description angezeigt.

Feld Beschreibung Einschränkungen/Hinweise
name Dashboard-Name Format: projects/{project}/locations/{location}/dashboards/{dashboard}
display_name Vom Nutzer angegebener Name für das Dashboard Maximal 100 Zeichen
description Beschreibung des Dashboards Optional
create_time Zeitstempel der Dashboard-Erstellung Nur Ausgabe
update_time Zeitstempel der letzten Aktualisierung des Dashboards Nur Ausgabe
filter Filter für alle Diagramme im Dashboard Unterstützt optionalen Stringfilter

Daten und Abfragen

Für das Diagramm wird natürliche Sprache verwendet, die von Customer Experience Insights in SQL-Abfragen übersetzt wird. Mit diesen Abfragen werden die Daten und visuellen Spezifikationen zum Anzeigen des Diagramms generiert. Visuelle Spezifikationen sind im VEGA-LITE-Format. Die Chart API verwendet die Quelle GenerativeInsights data, session_id und revision_id, um den aktuellen SQL- und den aktuellen visuellen Spezifikationsstatus eines Diagramms zu speichern.

Dashboard-Vorgänge

Sie können die folgenden Vorgänge für konfigurierbare Dashboards ausführen.

Dashboard erstellen

So erstellen Sie ein Dashboard:

Console

  1. Rufen Sie die CX Insights Console auf, melden Sie sich mit Ihrem Google-Konto an und wählen Sie Ihr Projekt aus.

    CX Insights-Konsole

  2. Klicken Sie auf Dashboard. Hier sehen Sie sowohl vordefinierte als auch benutzerdefinierte Dashboards.

  3. Klicken Sie im Dashboard-Studio auf + Dashboard hinzufügen, um ein benutzerdefiniertes Dashboard zu erstellen.

  4. Jedes Dashboard wird als Kachel angezeigt.

  5. Wenn Sie auf ein Dashboard klicken, erhalten Sie eine Übersicht aller Diagramme.

REST API

Senden Sie eine Anfrage wie im folgenden Beispiel.

{
"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

Führen Sie folgenden curl-Befehl aus: In diesem Beispiel wird die Nutzlast in create_dashboard_nested.json gespeichert.

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"

Dashboard bearbeiten

So bearbeiten Sie Ihr Dashboard:

Console

  1. Wählen Sie ein Dashboard aus und klicken Sie auf das Dreipunkt-Menü more_vert > Bearbeiten, um das Dashboard zu bearbeiten.

  2. Wählen Sie eine der folgenden Optionen aus:

  • + Kachel hinzufügen
  • + Abschnitt hinzufügen
  • Bearbeiten Tab umbenennen
  • content_copy Tab duplizieren
  • delete Tab löschen
  • Wählen Sie einen Zeitraum aus, um die Ergebnisse anzusehen.
  • Wählen Sie eine Kachel aus und klicken Sie auf das Dreipunkt-Menü more_vert. Eine Seitenleiste mit den folgenden Optionen wird angezeigt: „KI fragen“, „Kacheleinstellungen“ und „Abfrageeditor“.

Zusätzliche Optionen

KI fragen: Klicken Sie auf „KI fragen“ und geben Sie eine Textbeschreibung Ihrer Änderungen ein. Der KI-Assistent kann Sie beim Erstellen des Dashboards unterstützen. Sie haben auch die Möglichkeit, dem KI-Assistenten Folgefragen zu stellen. Wenn Sie auf Diagramm speichern klicken, können Sie ein Rollback auf die vorherigen Visualisierungen durchführen. Mit natürlicher Sprache können Sie Visualisierungen erstellen, indem Sie beschreibende Anfragen wie Wie viele Unterhaltungen führt ein Virtual Agent durchschnittlich pro Tag? angeben. Diese Anfragen werden in SQL für die Ausführung in BigQuery und in eine visuelle Spezifikation (VEGA Lite) für die Darstellung umgewandelt.

Kacheleinstellungen: In diesem Bereich können Sie die visuelle Spezifikation direkt aktualisieren, um das Diagramm-Attribut zu steuern. Beispiel: Ändern Sie den Anzeigenamen des Diagramms. Sie können im Drop-down-Menü den gewünschten Diagrammtyp auswählen. Die Chart API unterstützt die folgenden Diagrammtypen und Datendarstellungen:

  • BAR
  • LINE
  • AREA
  • PIE
  • SCATTER
  • TABELLE
  • SCORE_CARD
  • SUNBURST
  • ANZEIGE
  • SANKEY

Sie können den Konversationsfilter oder den neuen Zeitraum beim Neuladen des Dashboards weiter eingrenzen.

Abfrageeditor: Sie können mit dem KI-Assistenten interagieren und ein Dashboard erstellen. Wenn Sie mit der KI-generierten SQL-Antwort nicht zufrieden sind, können Sie die SQL-Anweisung direkt aktualisieren, um ein Diagramm neu zu generieren. Die SQL-Antwort wird dann in der vorhandenen visuellen Spezifikation aktualisiert. Im Abfrageeditor wird der generierte SQL-Code angezeigt, dessen Tabellenname maskiert ist, um auf einen vordefinierten Platzhalterstring zu verweisen: INSIGHTS_DASHBOARD_VIEW. Hinweis: Sie können nur SELECT-Vorgänge ausführen.

Curl

Führen Sie folgenden curl-Befehl aus: In diesem Beispiel wird die Nutzlast in update_dashboard.json gespeichert.

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"

Dashboard löschen

So löschen Sie ein Dashboard und alle zugehörigen Diagramme:

Console

Wählen Sie ein Dashboard aus und klicken Sie auf das Dreipunkt-Menü more_vert > Löschen, um das Dashboard zu löschen.

Curl

Führen Sie folgenden curl-Befehl aus:

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"