Query pro モード query-pro-mode

Last update: Sat May 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
Dashboards

作成対象：

Developer
User

Query pro モードは、Adobe Experience Platform UI でカスタム SQL クエリを使用してインサイトを生成するプロセスをガイドする、SQL エディターベースのワークフローです。カスタム SQL クエリでインサイトを生成する前に、まず以下を行う必要がありますダッシュボードの作成.

SQL を作成 compose-sql

Query pro モードでのダッシュボードの作成を選択すると、 SQL を入力 ダイアログが表示されます。ドロップダウンメニューからクエリするデータベース（インサイトデータモデル）を選択し、query pro エディターでデータセットに適したクエリを入力します。

NOTE

Query pro モードは、Data Distiller SKU を購入したユーザーのみが使用できます。このガイド付きデザインモードは、すべてのユーザーが既存のデータモデルからインサイトを作成できます。

を参照してください。クエリエディターユーザーガイド ui 要素について説明します。

この SQL を入力データセットのドロップダウンメニューと「実行」アイコンがハイライト表示されたダイアログ。ダイアログには SQL クエリが入力され、「クエリパラメーター」タブが表示されます。

クエリパラメーター query-parameters

次を含める global または日付フィルタークエリがクエリパラメーターの使用 query pro モードで文を作成する場合、クエリでクエリパラメーターを使用する場合は、サンプル値を指定する必要があります。サンプル値を使用すると、SQL ステートメントを実行してグラフを作成できます。ステートメントを作成するときに指定するサンプル値は、実行時に日付またはグローバルフィルターに選択する実際の値に置き換えられます。

IMPORTANT

グローバルフィルターを使用する場合は、SQL にクエリパラメーターを配置し、そのクエリパラメーターをウィジェットコンポーザーのグローバルフィルターにリンクする必要があります。以下のスクリーンショットでは、 CONSENT_VALUE_FILTER SQL でグローバルフィルターのクエリパラメーターとして使用されます。を参照してください。グローバルフィルタードキュメントこの方法について詳しくは、こちらを参照してください。

クエリを実行するには、「実行」アイコン（）サードパーティリクエストを待機する、特別なコア Adobe JavaScript モジュールです。クエリエディターに「結果」タブが表示されます。次に、設定を確認してウィジェットコンポーザーを開き、を選択します。 を選択.

TIP

クエリでクエリパラメーターを使用する場合は、クエリを 1 回実行して、使用されるすべてのクエリパラメーターキーを事前入力します。クエリは失敗しますが、UI には自動的に「クエリパラメーター」タブが表示され、含まれているすべてのキーが一覧表示されます。キーに適切な値を追加します。

この SQL を入力 sql 入力を含むダイアログ、結果タブが表示され、「選択」がハイライト表示されます。

ウィジェットコンポーザーに、実行した SQL の列が入力されるようになりました。ダッシュボードのタイプは、左上に示されます（この場合は）手動 SQL 入力. 鉛筆アイコン（）を選択して、任意の時点で SQL を編集できます。

TIP

使用可能な属性は、実行された SQL から取得された列です。

ウィジェットを作成するには、にリストされている属性を使用します属性列。検索バーを使用して、属性を検索したり、リストをスクロールしたりできます。

作成方法と属性列がハイライト表示されたウィジェットコンポーザー

属性を追加 add-attributes

ウィジェットに属性を追加するには、プラスアイコン（）を選択します。表示されるドロップダウンメニューを使用すると、SQL で決定されたオプションからグラフに属性を追加できます。グラフのタイプが異なると、X 軸や Y 軸のドロップダウンなど、オプションが異なります。

このドーナツグラフの例では、オプションはサイズと色です。色はドーナツグラフの結果を色分けし、サイズは使用される実際の指標です。に属性を追加しますカラーフィールドで、その属性の構成に基づいて結果を異なる色に分割します。

TIP

上下の矢印アイコン（

）を選択して、棒グラフまたは折れ線グラフの X 軸と Y 軸の配置を切り替えます。

アドアイコンドロップダウンと切り替え矢印がハイライト表示されたウィジェットコンポーザー。

ウィジェットのグラフまたはグラフのタイプを変更するには、の使用可能なオプションから選択しますマークドロップダウン。次のオプションがありますライン, ドーナツ, 大きい数、および棒グラフ. 選択すると、ウィジェットの現在の設定のプレビュービジュアライゼーションが生成されます。

ウィジェットのプレビューがハイライト表示されたウィジェットコンポーザー。

ウィジェットのプロパティ properties

プロパティアイコン（）を選択し、プロパティパネルを開きます。が含まれるプロパティパネルで、ウィジェットの名前を ウィジェットのタイトル テキストフィールド。グラフのさまざまな要素の名前を変更することもできます。

NOTE

プロパティサイドバーで使用できる特定のフィールドは、編集しているグラフのタイプによって異なります。

プロパティアイコンと「ウィジェットタイトル」フィールドがハイライト表示されたウィジェットコンポーザー。

ウィジェットコンポーザーで保存すると、ウィジェットがダッシュボードにローカルに保存されます。作業内容を保存し、後で再開する場合は、保存. ウィジェット名の下のチェックマークアイコンは、ウィジェットが保存されたことを示します。または、ウィジェットの設定が完了したら、を選択します。 保存して閉じる をクリックして、ダッシュボードにアクセスできるその他すべてのユーザーがウィジェットを使用できるようにします。「キャンセル」を選択して作業を中断し、カスタムダッシュボードに戻ります。

「保存」、「ウィジェットを保存」、「保存して閉じる」がハイライト表示されたウィジェットコンポーザー

ダッシュボードとグラフの編集 edit

を選択編集ダッシュボード全体または任意のインサイトを編集できます。編集モードでは、ウィジェットのサイズ変更、SQL の編集、グローバルおよび時間フィルターの作成と適用を行うことができます。これらのフィルターは、ダッシュボードウィジェットに表示されるデータを制限します。これは、様々なユースケースに合わせてインサイトをすばやく更新し、微調整する便利な方法です。

「編集」がハイライト表示されたカスタムダッシュボード。