構成可能なダッシュボード

構成可能なダッシュボードを使用して、カスタマー エクスペリエンス インサイトの使用状況とフィードバック指標を時系列で表示します。構成可能なダッシュボードでは、さまざまなグラフを使用してカスタムビューを作成して維持できるため、データの表現とレイアウトを柔軟に行うことができます。構成可能なダッシュボードでは、グラフの種類を選択して構成を保存し、次回ページにアクセスしたときに取得できます。

ダッシュボードのコンポーネント

ダッシュボードには次のコンポーネントが含まれています。

コンポーネント 説明
ダッシュボード 構造全体とグラフの定義を保存する最上位のリソース。
セクション セクションには、タイルまたはネストされたセクション（タブとして表示されます）を含めることができます。ダッシュボード セクションには、表示名と説明を設定できます。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）を使用します。これは、カスタマー エクスペリエンス インサイトによって SQL クエリに変換されます。これらのクエリは、グラフを表示するためのデータとビジュアル仕様を生成します。ビジュアル仕様はVEGA-LITE 形式です。グラフ API は、GenerativeInsights data ソース、session_id、revision_id を使用して、グラフの現在の SQL とビジュアル仕様の状態を保存します。

ダッシュボードの操作

構成可能なダッシュボードに対しては、次の操作を行うことができます。

ダッシュボードの作成

ダッシュボードを作成する手順は次のとおりです。

コンソール

  1. CX Insights コンソールに移動し、Google アカウントでログインして、プロジェクトを選択します。

    CX Insights コンソール

  2. [ダッシュボード] をクリックします。ここでは、事前構築済みのダッシュボードとカスタム ダッシュボードの両方を確認できます。

  3. ダッシュボード スタジオで、[+ ダッシュボードを追加] をクリックして、独自のカスタム ダッシュボードを作成します。

  4. 各ダッシュボードはタイル形式で表示されます。

  5. ダッシュボードをクリックすると、すべてのグラフの概要が表示されます。

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

ダッシュボードを編集する手順は次のとおりです。

コンソール

  1. ダッシュボードを選択し、[その他] more_vert > [編集] をクリックしてダッシュボードを編集します。

  2. 次のいずれかのオプションを選択します。

  • [+ タイルを追加]
  • [+ セクションを追加]
  • [編集] [タブの名前を変更]
  • content_copy [**タブを複製**]
  • delete [Delete tab]
  • 結果を表示する期間を選択します。
  • タイルを選択して [**その他**] more_vert をクリックします。次のオプションが表示されたサイドパネルが表示されます: [AI に質問]、[タイルの設定]、[クエリエディタ]。

その他のオプション

[AI に質問]: [AI に質問] をクリックして、変更内容のテキスト説明を入力します。AI アシスタントは、ダッシュボードの作成に役立ちます。AI アシスタントにフォローアップの質問をすることもできます。[グラフを保存]をクリックすると、以前のビジュアリゼーションにロールバックできます。自然言語（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"