カスタムダッシュボードの作成方法

カスタムダッシュボードを使用すると、ユーザーの人口統計またはコンテキスト情報に基づくカスタムKPIと組み込みのメトリクスの組み合わせを使用して、ビジネスニーズを満たす自前のレポートとダッシュボードを設計できます。

カスタムダッシュボードは、ボットビルダーで利用可能なすぐに使用できるダッシュボードレポートに追加されます。デフォルトダッシュボードの詳細については、こちらをご覧ください。

カスタムダッシュボードは、次の3つの簡単なステップを使用して構築できます。

1. メトリクスを導くためにキャプチャする必要のあるデータポイントを特定します。これは、ビジネス要件とニーズに基づきます。
2. これらのデータポイントをボット定義に出力するために、適切なカスタムメタタグを定義します。ボットにカスタムメタタグを追加する方法については、こちらをご覧ください。
3. ウィジェットを設計しプレビューし、そしてこれらのウィジェットでダッシュボードを更新します。このドキュメントの残りの部分では、このステップについて説明します。

会話セッションにはノンインタラクティブセッション、つまりユーザーからのメッセージがない会話が含まれることに注意してください。

ボットに複数のカスタムダッシュボードを追加するために、トップメニューの分析タブにあるカスタムダッシュボードを使用できます。

• これらの各ダッシュボードは、複数のウィジェットを持つことができます。
• これらの各ウィジェットは、事前定義されたデータセットに関連付けることができます。
• ウィジェットによって表される必要なデータを抽出するためのクエリ（SQLと同様）を定義するために、データセットを使用できます。
• データを生成するために、“メッセージ”“セッション”“分析”、および“メタタグ”に関連する情報を使用できます。

上記の各コンポーネントを使用してカスタムダッシュボードを構築する方法を見ていきます。

ダッシュボード

ダッシュボードの基本的な詳細を提供することにより、複数のダッシュボードを追加できます。

• ダッシュボード名はいつでも編集および変更できます。
• すべてのダッシュボードには、“24時間”“7日”または“カスタム範囲”に設定できる日付範囲フィルターが備わっており、これはダッシュボード内のすべてのウィジェットに適用されます。
• ダッシュボードの色のテーマを選択できます。
• 特定のダッシュボードにウィジェットを追加 できます (詳細については以下を参照してください）。
• ウィジェットの上にマウスを置くと表示される移動カーソルを使用して、ダッシュボード上の任意の場所にウィジェットをドラッグでき、ダッシュボード内のウィジェットを並べ替えることができます。
• 詳細アイコン（縦長の省略記号）を使用して、新しいダッシュボード、クローンダッシュボード、エクスポートダッシュボード、または削除ダッシュボードのいずれかを作成できます。
• ダッシュボードデータはJSONフォーマットでエクスポートできます。

ウィジェット

ダッシュボードに複数のウィジェットを追加できます。ウィジェットをダッシュ​​ボードに追加するには、ウィジェットの追加オプションを使用します。ウィジェットの構成は次の2つのステップからなります。

1. データの定義
2. データの表記

データの定義

ウィジェットで取得および表示する情報を指定するために、すべてのウィジェットをクエリ定義に関連付ける必要があります。クエリ定義の生成に使用される構成は次のとおりです。

• データソースを定義するデータセット。以下のような場合があります。
  • 分析分析によりボットと関連した「成功インテント」、「失敗インテント」、「成功タスク」、「失敗タスク」のリストにアクセスできます。「メトリクスタイプ」、「チャネル」、「ユーザーID」などのキーフィールドや、メトリクスレコードに対して追加されたすべてのカスタムフィールドを確認することもできます。
  • メッセージ：このデータセットは、ボットメッセージとユーザーメッセージをボットに提供します。キーフィールドのユーザーID、チャネルなどを表示するか、あるいはメッセージに対して追加された任意のカスタムフィールドを表示するかを選択できます。
  • セッション：ボットに関連付けられている会話セッションのリストを提供するために、このデータセットを使用します。キーフィールドのユーザーID、チャネルなどを表示するか、あるいはセッションに対して追加された任意のカスタムフィールドを表示するかを選択できます。
• 日付範囲はデフォルトで提供されており、プレビュー用に値を設定できます。これは過去7日間にデフォルト設定されており、過去90日から365日までの範囲にカスタマイズできます。
• ウィジェットによって描写されるフィールドを選択します。
  • 選択したデータセットに応じて、フィールドは異なります。詳細なリストについては以下の表を参照してください。たとえば、成功と失敗のインテントを一覧表示するには、“metricType”
  • これらのフィールドには、“min”“max”“sum”“count”“avg”などの集計関数を適用できます。たとえば、トリガーされたインテントの合計をカウントするには、“count(metricType)”
  • エイリアスを表示名とすることができます。たとえば、“count（metricType）を合計として”
  • これらとは別に、ボットにカスタム/メタタグを定義している場合は、次の表記を使用して適切な見出しの下でそれらを使用できます。userTag.tagname = value.つまり、メッセージレベルのカスタムタグを宣言した場合は、メッセージデータセットを選択してmessageTag.TagNameと入力します。v8.1のリリース後は、カスタムタグを使用できますが、これはまだ定義されてません。このため、データセットが空になり、表示も空になることに注意してください。
• Filter Byフィールド（選択条項で指定されたエイリアスではなく実際のフィールド名）を使用して、結果をフィルタリングするための基準を定義できます。これらのフィールドには、次の演算子を適用できます。"=", ">=", "<=", ">", "<", "in", "not in".たとえば、成功したインテントとタスクの両方のダイアログをリストアップするには、“metricType = successintents”または“metricType = successtasks”および“tasktype = dialog”です。複数の条件を組合せている場合、それらは左から右に評価され、括弧（）を使用してもこの順序を変更できないことに注意してください。
• 集計関数を適用するためのGroup Byフィールド（選択条項ズで指定されたエイリアスではなく実際のフィールド名）。たとえば、上記の例では、メトリックタイプ、“metricType”に基づいて合計します
• Sort Byフィールド（実際のフィールド名、選択条項で指定されたエイリアスではない）で、結果を昇順または降順（“asc”または“desc”）に並べ替えます。たとえば、メトリックタイプの降順で並べ替えるには、“metricType desc”

クエリを実行して、結果を表形式で表示します。

データの表記

次のステップは、視覚的に訴えるやり方でデータをレンダリングすることです。データ表記には、次のオプションを使用できます。

• テーブルは、データを単純な行と列の形式で表記します。ディメンションオプションから、列とその順序を指定できます。
• ピボットチャートは、データをまとめるのに役立ちます。ディメンションを指定できます；表示する列；メトリクス―列に対する値；およびオーバーレイ―データ系列を表す必要がある場合に考慮される列。たとえば、ディメンションが「日付」、メトリックが「チャット数」、オーバーレイが「顧客タイプ」に設定されている場合、シリーズとしての個別の顧客タイプごとのチャット数が表示されます。
• 棒グラフを使用して、X軸とY軸を使ってデータを表すことができます。結果は、オーバーレイフィールドに基づいてデータ系列に分割され、複数の線をプロットすることができます。
• 横棒グラフを使用して、X軸とY軸を使って棒グラフを横向きにしてデータを表すことができます。結果は、オーバーレイフィールドに基づいてデータ系列に分割され、複数の線をプロットすることができます。
• 線グラフを使用して、X軸とY軸を使ってデータを表すことができます。結果は、オーバーレイフィールドに基づいてデータ系列に分割され、複数の線をプロットすることができます。
• 円グラフは、シナリオ全体の一部を表現する集計データに使用できます。ディメンションを使用して表示するフィールドを設定し、メトリクスを使用して表示する集計関数を設定します。
• ドーナツチャートは円グラフと同様に、より良い視覚化のために使用できます。
• ラベルチャートは、そのスペース上に値またはメトリックを強調表示するために使用できます。

ウィジェットを視覚化するためにプレビューボタンを使用します。目的に応じて、ウィジェットをダッシュ​​ボードに追加して変更を保存します。メモ：プレビューできるようにするには、クエリを実行する必要があります。

ウイジェットアクション

その他のアイコン（縦長の省略記号）を各ウィジェットに対して使用すると、次のことができます。

• 編集オプションを選択すると、ウィジェット定義ページが開き、定義済みのウィジェットを変更することができます。
• クローンオプションを使用するとウィジェット定義を複製して、それに変更を加えることができます。
• エクスポートオプションを使用すると、ウィジェットデータをエクスポートできます
  • JSONフォーマットは、ウィジェットUIに表示される最終結果を含んでます
  • CSVフォーマットは、ウィジェットに関連付けられているクエリの結果をエクスポートします（ウィジェットUIに従ってデータを変換する前に）
• 削除オプションを使用すると、ダッシュボードからウィジェットを削除できます。

制限事項

• 最大100個のカスタムダッシュボード定義できます。
• 各ダッシュボードは最大100個のウィジェットを含むことができます。
• チャートに最大3つのメトリクスを追加できます。
• 各チャートは1次元で表示できます。
• 日付は過去90日から365日までの範囲にカスタマイズできます。

データセットとフィールド

フィールド名では大文字と小文字が区別されるため、以下の表に示すように使用する必要があることに注意してください。

分析

メッセージ

セッション