透過可設定的資訊主頁，查看 Customer Experience Insights 的使用情況和意見回饋指標。可設定的資訊主頁提供彈性的資料呈現方式和版面配置，因為您可以透過各種圖表建立及維護自訂檢視畫面。可設定的資訊主頁可讓您選取圖表類型、儲存設定，並在下次造訪該頁面時擷取設定。
資訊主頁元件
資訊主頁包含下列元件。
| 元件 | 說明 |
|---|---|
| 資訊主頁 | 頂層資源，用於儲存整個結構和圖表定義。 |
| 區段 | 一個區段可以包含圖塊或巢狀區段 (顯示為分頁標籤)。資訊主頁區段可以有顯示名稱和說明。您可以將 date_range 篩選器套用至整個分頁中的所有圖表。區段會使用格線單位的寬度和高度定義實體尺寸。 |
| 圖塊 | 資訊主頁中的元素，定義為巢狀區段或圖表。預設日期範圍為上週。您也可以進一步查詢日期範圍，例如過去 1 天、過去 2 天、過去 1 週、過去 2 週、過去 1 個月、過去 1 季、過去 1 年，或自訂開始和結束日期。 |
資訊主頁欄位定義
每個資訊主頁都包含下列欄位。控制台只會顯示 display_name 和 description。
| 欄位 | 說明 | 限制/注意事項 |
|---|---|---|
name |
資訊主頁名稱 | 格式：projects/{project}/locations/{location}/dashboards/{dashboard} |
display_name |
使用者提供的資訊主頁名稱 | 最多 100 個字元 |
description |
資訊主頁說明 | 選用 |
create_time |
資訊主頁建立時間戳記 | 僅供輸出 |
update_time |
資訊主頁上次更新時間戳記 | 僅供輸出 |
filter |
篩選資訊主頁中的所有圖表 | 支援選用字串篩選器 |
資料和查詢
圖表使用自然語言 (NL)，Customer Experience Insights 會將其轉換為 SQL 查詢。這些查詢會產生資料和視覺規格，以顯示圖表。視覺規格採用 VEGA-LITE 格式。圖表 API 會使用 GenerativeInsights data 來源、session_id 和 revision_id，儲存圖表的目前 SQL 和視覺規格狀態。
資訊主頁作業
您可以在可設定的資訊主頁上執行下列操作。
建立資訊主頁
請按照下列步驟建立資訊主頁。
控制台
前往 CX Insights 控制台，使用 Google 帳戶登入，然後選取專案。
按一下「資訊主頁」。您可以在這裡查看預建和自訂資訊主頁。
在資訊主頁工作室中，按一下「+ 新增資訊主頁」，即可建立自訂資訊主頁。
每個資訊主頁都會以圖塊的形式顯示。
點選資訊主頁後，即可查看所有圖表的總覽。
REST API
提交類似下列範例的要求。
{
"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
執行下列 curl 指令。在本範例中，酬載會儲存在 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"
編輯資訊主頁
如要編輯資訊主頁，請按照下列步驟操作。
控制台
選擇資訊主頁，然後依序按一下「更多」圖示 more_vert >「編輯」，即可編輯資訊主頁。
您可以選擇下列其中一個選項：
- 「+ 新增動態磚」
- 「+ 新增區段」
- 編輯 重新命名分頁
- content_copy「複製分頁」
- 刪除 刪除分頁
- 選擇日期範圍，即可查看結果。
- 選擇所需動態磚，然後按一下「更多」圖示 more_vert。系統會顯示側邊面板，內含「詢問 AI」、「圖塊設定」和「查詢編輯器」等選項。
其他選項
詢問 AI：按一下「詢問 AI」，然後輸入變更的文字說明。AI 助理可協助您建構資訊主頁。你也可以向 AI 助理提出後續問題。如果按一下「儲存圖表」，可以還原為先前的視覺化圖表。自然語言 (NL) 可讓您指定描述性查詢 (例如「虛擬代理每天的平均對話次數是多少？」)，藉此產生視覺化內容。這些查詢會轉換為 SQL，以便對 BigQuery 執行查詢，並轉換為視覺化規格 (VEGA lite)，以便顯示查詢結果。
圖塊設定：您可以在這個部分直接更新視覺規格，控管圖表屬性。例如：變更圖表的顯示名稱。您可以在下拉式選單中選擇偏好的圖表類型。圖表 API 支援下列圖表類型和資料表示法：
- BAR
- LINE
- AREA
- PIE
- SCATTER
- 資料表
- SCORE_CARD
- SUNBURST
- GAUGE
- SANKEY
重新載入資訊主頁後，您可以進一步指定對話篩選條件或新的時間範圍。
查詢編輯器：您可以與 AI 助理互動，並建構資訊主頁。如果對 AI 生成的 SQL 回覆不滿意，可以直接更新 SQL，重新生成圖表，而 SQL 回覆也會進一步重新填入現有的視覺規格。查詢編輯器會顯示產生的 SQL，其中的資料表名稱會遮蓋，以參照預先定義的預留位置字串 INSIGHTS_DASHBOARD_VIEW。注意：你只能執行 SELECT 作業。
Curl
執行下列 curl 指令。在本範例中，酬載會儲存在 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"
刪除資訊主頁
如要刪除資訊主頁和所有相關圖表，請按照下列步驟操作。
控制台
選擇要刪除的資訊主頁，然後依序點選「更多」more_vert >「刪除」。
Curl
執行下列 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"