Visualizza le metriche di utilizzo e feedback di Customer Experience Insights nel tempo con una dashboard configurabile. Le dashboard configurabili offrono flessibilità nella rappresentazione e nel layout dei dati, perché puoi creare e gestire visualizzazioni personalizzate con una varietà di grafici. La dashboard configurabile ti consente di selezionare un tipo di grafico, memorizzare la configurazione e recuperarla la volta successiva che visiti la pagina.
Componenti della dashboard
Una dashboard contiene i seguenti componenti.
| Componente | Descrizione |
|---|---|
| Dashboard | La risorsa di primo livello che memorizza l'intera struttura e le definizioni dei grafici. |
| Sezione | Una sezione può contenere riquadri o sezioni nidificate (che vengono visualizzate come schede). Le sezioni della dashboard possono avere un nome visualizzato e una descrizione. Puoi applicare il filtro date_range a tutti i grafici di un'intera scheda. Le sezioni definiscono le proprie dimensioni fisiche utilizzando larghezza e altezza in unità della griglia. |
| Riquadro | Un elemento all'interno della dashboard, definito come sezione nidificata o grafico. L'intervallo di date predefinito è l'ultima settimana. Puoi eseguire ulteriori query sull'intervallo di date come ultimo giorno, ultimi 2 giorni, ultima settimana, ultime 2 settimane, ultimo mese, ultimo trimestre, ultimo anno o le date di inizio e di fine personalizzate. |
Definizioni dei campi della dashboard
Ogni dashboard è composta dai seguenti campi. Nella console vengono visualizzati solo display_name e description.
| Campo | Descrizione | Vincoli/Note |
|---|---|---|
name |
Nome dashboard | Formato: projects/{project}/locations/{location}/dashboards/{dashboard} |
display_name |
Nome fornito dall'utente per la dashboard | Massimo 100 caratteri |
description |
Descrizione della dashboard | Facoltativo |
create_time |
Timestamp della creazione della dashboard | Solo output |
update_time |
Timestamp dell'ultimo aggiornamento della dashboard | Solo output |
filter |
Filtrare tutti i grafici nella dashboard | Supporta il filtro facoltativo delle stringhe |
Dati e query
Il grafico utilizza il linguaggio naturale (NL), che Customer Experience Insights traduce in query SQL. Queste query generano i dati e le specifiche visive per visualizzare il grafico. Le specifiche visive sono in formato VEGA-LITE. L'API Chart utilizza l'origine GenerativeInsights data, session_id e revision_id per archiviare gli stati correnti delle specifiche SQL e visive di un grafico.
Operazioni della dashboard
Puoi eseguire le seguenti operazioni sui dashboard configurabili.
Creazione dashboard
Per creare la dashboard:
Console
Vai alla console CX Insights, accedi con il tuo Account Google e seleziona il tuo progetto.
Fai clic su Dashboard. Qui puoi vedere le dashboard predefinite e personalizzate.
In Dashboard Studio, fai clic su + Aggiungi dashboard per creare la tua dashboard personalizzata.
Ogni dashboard viene visualizzata sotto forma di riquadro.
Quando fai clic su una dashboard, viene visualizzata una panoramica di tutti i grafici.
API REST
Invia una richiesta come nell'esempio seguente.
{
"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
Esegui questo comando curl. In questo esempio, il payload viene salvato in 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"
Modifica dashboard
Per modificare la dashboard, segui questi passaggi.
Console
Scegli una dashboard e fai clic su Altro more_vert > Modifica per modificarla.
Scegli una delle seguenti opzioni:
- + Aggiungi riquadro
- + Aggiungi sezione
- Modifica Rinomina scheda
- content_copy Duplica scheda
- elimina Elimina scheda
- Scegli un intervallo di date per visualizzare i risultati.
- Scegli un riquadro e fai clic su Altro more_vert. Viene visualizzato un riquadro laterale con le seguenti opzioni: Chiedi all'AI, Impostazioni riquadro e Editor delle query.
Opzioni aggiuntive
Chiedi all'AI: fai clic su Chiedi all'AI e inserisci una descrizione testuale delle modifiche. L'assistente AI può aiutarti a creare la dashboard. Hai anche la possibilità di fare domande aggiuntive all'assistente AI. Se fai clic su Salva grafico, puoi ripristinare le visualizzazioni precedenti. Il linguaggio naturale (NL) ti consente di generare visualizzazioni specificando query descrittive come Qual è il numero medio di conversazioni al giorno per un agente virtuale? Queste query vengono convertite in SQL per l'esecuzione in BigQuery e in specifiche visive (VEGA-Lite) per la visualizzazione.
Impostazioni riquadro: in questa sezione puoi aggiornare la specifica visiva direttamente per controllare l'attributo del grafico. Ad esempio, modifica il nome visualizzato del grafico. Puoi scegliere il tipo di grafico che preferisci nel menu a discesa. L'API Chart supporta i seguenti tipi di grafici e rappresentazioni dei dati:
- BAR
- LINE
- AREA
- PIE
- SCATTER
- TABELLA
- SCORE_CARD
- SUNBURST
- GAUGE
- SANKEY
Puoi specificare ulteriormente il filtro delle conversazioni o il nuovo intervallo di tempo dopo aver ricaricato la dashboard.
Editor di query: puoi interagire con l'assistente AI e creare una dashboard. Se non sei soddisfatto della risposta SQL generata dall'AI, puoi aggiornare direttamente l'SQL per rigenerare un grafico e la risposta SQL ripopola ulteriormente la specifica visiva esistente. L'editor di query mostra l'SQL generato, il cui nome della tabella è mascherato per fare riferimento a una stringa segnaposto predefinita, INSIGHTS_DASHBOARD_VIEW. Nota: puoi eseguire solo un'operazione SELECT.
Curl
Esegui questo comando curl. In questo esempio, il payload viene salvato in 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"
Elimina dashboard
Per eliminare una dashboard e tutti i grafici correlati:
Console
Scegli un dashboard e fai clic su Altro more_vert > Elimina per eliminare il dashboard.
Curl
Esegui questo comando curl.
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"