構成可能なダッシュボードで、Customer Experience Insights の使用状況とフィードバックの指標を時系列で表示します。構成可能なダッシュボードでは、さまざまなグラフを使用してカスタムビューを構築して維持できるため、データ表現とレイアウトの柔軟性が高まります。構成可能なダッシュボードでは、グラフの種類を選択し、構成を保存して、次回ページにアクセスしたときに取得できます。
ダッシュボードのコンポーネント
ダッシュボードには次のコンポーネントが含まれています。
| コンポーネント | 説明 |
|---|---|
| ダッシュボード | 構造とグラフの定義全体を保存する最上位のリソース。 |
| セクション | セクションには、タイルまたはネストされたセクション（タブとして表示されます）を含めることができます。ダッシュボードのセクションには、表示名と説明を設定できます。date_range フィルタは、タブ全体のすべてのグラフに適用できます。セクションは、グリッド単位の幅と高さを使用して物理的な寸法を定義します。 |
| タイル | ダッシュボード内の要素。ネストされたセクションまたはグラフとして定義されます。デフォルトの期間は先週です。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"
Edit dashboard
ダッシュボードを編集する手順は次のとおりです。
コンソール
ダッシュボードを選択し、[その他] more_vert > [編集] をクリックして、ダッシュボードを編集します。
次のいずれかのオプションを選択します。
- + タイルを追加
- + セクションを追加
- 編集 タブの名前を変更
- content_copy タブを複製
- 削除 タブを削除
- 期間を選択して結果を表示します。
- タイルを選択し、その他アイコン more_vert をクリックします。サイドパネルが開き、[AI に質問する]、[タイルの設定]、[クエリエディタ] のオプションが表示されます。
その他のオプション
AI に質問: [AI に質問] をクリックし、変更内容をテキストで入力します。AI アシスタントは、ダッシュボードの作成をサポートします。AI アシスタントにフォローアップの質問をすることもできます。[Save Chart] をクリックすると、以前の可視化にロールバックできます。自然言語（NL）を使用すると、「仮想エージェントの 1 日あたりの平均会話数は？」などの説明的なクエリを指定して、可視化を生成できます。これらのクエリは、BigQuery に対して実行するための SQL と、表示用の視覚仕様（VEGA lite）に変換されます。
タイル設定: このセクションでは、ビジュアル仕様を直接更新して、グラフの属性を制御できます。例: グラフの表示名を変更します。プルダウン メニューで、希望のグラフの種類を選択できます。グラフ API は、次のグラフタイプとデータ表現をサポートしています。
- BAR
- LINE
- 分野
- PIE
- SCATTER
- テーブル
- SCORE_CARD
- SUNBURST
- GAUGE
- SANKEY
ダッシュボードを再読み込みすると、会話フィルタまたは新しい期間をさらに指定できます。
クエリ エディタ: AI アシスタントとやり取りして、ダッシュボードを作成できます。AI によって生成された SQL レスポンスに満足できない場合は、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"