Skip to main content
Explorer で作成するすべてのクエリは AftersellQL(AQL) ステートメントです。ほとんどの場合、クエリは視覚的に作成するため、AQL を手書きすることはありません。このページは、選択できる指標とディメンション、AQL のテキスト形式、タイムゾーンルールのリファレンスです。

利用可能な指標

選択できる指標を、指標ピッカーと同じグループ分けで示します。

収益と利益

コンバージョン

エンゲージメント

ストアのパフォーマンス

Rokt ネットワーク

ディメンション

ディメンションは、指標を属性ごとに分解します。すべてのディメンションがすべての指標と互換性があるわけではなく、Explorer は互換性のない組み合わせを自動的に防ぎます(たとえば、Decline rate と Show rate は Currency で分解できません)。

利用可能なディメンション

利用できないディメンション

以下は開発中です。ピッカーには表示されますが、実装されるまではすべての指標で「Not compatible」と表示されます。

AQL ステートメントの構文

AQL ステートメントは、複数の句で構成される1つの質問です。必須なのは SELECT と期間(SINCE)のみで、それ以外はすべて任意です。任意の句を含める場合は、次の順序で記述する必要があります。
最小限の例として、過去30日間の日次アップセル収益と承諾率を示します。
キーワードは大文字と小文字を区別せず(SELECT と select のどちらも動作します)、ステートメントの末尾にセミコロンは付けません。文字列値はダブルクォートで囲みますが、数値とリストは囲みません。

SELECT と GROUP BY

  • SELECT は測定する指標をカンマ区切りで列挙します。例:SELECT revenue, impressions, accept_rate。
  • GROUP BY は、それらの指標を date、device、surface、funnel などの1つ以上のディメンションで分解します。GROUP BY がない場合は、期間全体の単一の合計値が得られます。

WHERE によるフィルタリング

WHERE は、測定前にデータを絞り込みます。条件は AND で組み合わせます。
impressions、accept_rate、rpv は、デバイス、ファネル、プレースメント、商品でフィルターまたはグループ化できません。ソースとなるロールアップにそれらの列がないためです。これらのいずれかを選択するクエリに WHERE device = "mobile" を追加すると、metric "impressions" cannot be filtered by "device" というエラーで拒否されます。
サポートされる比較演算子は =、!=、IN、NOT IN、>、<、>=、<= です。複数の値に一致させるには、IN でリストを使用します。
experiment はフィルター可能なフィールドではありません。ロールアップのソースがないため、WHERE experiment IN [...] は filters on "experiment" are not supported. というエラーで拒否されます。 funnel フィルターは複数選択をサポートします。is one of(IN)は選択したファネルのみを含め、is not one of(NOT IN)は選択したファネルを除外します。Funnel でグループ化して is one of フィルターを適用すると、チャートには選択したファネルごとに1本の線が表示され、「Other」にまとめられることはありません。

期間と比較

すべてのクエリには、SINCE で設定する期間が必要です。 利用可能なプリセット:last_1d、last_7d、last_30d、last_90d、this_month、last_month、this_year。
  • GRAIN は時系列のバケットサイズを設定します:day、week、month。(hour は構文解析されますが、時間単位のデータを提供するロールアップがないため、そのようなクエリは group_by / time_grain combination is not supported. というエラーで拒否されます。)
  • COMPARE は2つ目の期間を重ねて表示します。直前の同じ長さの期間である previous_period を使用します。ウェアハウスには2026年2月より前のデータがないため、previous_year は Compare ピッカーには表示されません。以前に保存されたクエリが引き続き解析できるよう、AQL での入力のみ可能です。
レポートデータは 2026年2月から開始されるため、それより前の期間を指定すると両方の期間で空の結果が返されます。

チャートの選択

  • CHART は結果の表示方法を設定します:scorecard、line_chart、bar_chart、area_chart、funnel_chart、table。
  • TIMEZONE は日付のバケット化に使用するタイムゾーンを、引用符で囲んだ IANA 名で設定します。例:TIMEZONE "America/New_York"。デフォルトは UTC です(タイムゾーンを参照)。
funnel_chart タイプには特定の要件があります。
  • プレースメントモード。 placement でグループ化し、指標を1つ選択します。ステージは標準のプレースメント順(デフォルトのアップセル、次にダウンセル、次に追加のアップセル)で並びます。プロットされるのは最初の指標のみで、追加の指標は脚注に記載されます。
  • 指標モード。 GROUP BY なしで2つ以上の指標を選択します。各指標がクエリの順序でファネルのステージになります(例:SELECT impressions, conversions はインプレッションからコンバージョンへの離脱を表示します)。すべての指標は同じ単位である必要があります。
プレースメントモードには、プレースメントで分解できる指標が必要です。impressions、accept_rate、rpv は分解できず、これらの指標ではファネルチャートに「These metrics can’t be grouped by placement」と表示されます。

並べ替えと件数制限

  • ORDER BY は、指標またはディメンションで結果を ASC または DESC で並べ替えます。
  • LIMIT は返される行数の上限を設定します。「上位 N 件」の質問に便利です。

その他の例

impressions、accept_rate、rpv はデバイスで分解できません。これらのロールアップはショップ × サーフェス × 日で、デバイスの列がないためです。デバイスの比較には revenue(またはコンバージョンを元にした他の指標)を使用してください。

タイムゾーン

デフォルトでは、クエリは UTC で実行されます。タイムゾーンを上書きすると、日付でバケット化された結果を現地時間で反映できます(ツールバーでの手順はタイムゾーンの設定を参照)。
Impressions、Accept Rate、Revenue Per Visit を含むクエリは、選択したタイムゾーンにかかわらず、常に UTC で日付をバケット化します。これらは UTC の日単位で報告される日次ロールアップを元にしているためです。これらのいずれかを他の指標と組み合わせたクエリでは、日付バケットを揃えるために結果セット全体が UTC にフォールバックします。

TIMEZONE 句

TIMEZONE 句を使うと、AQL で直接タイムゾーンを指定できます。この句は CHART と ORDER BY の間に記述します。
この句がある場合、そのクエリではツールバーの選択が上書きされ、保存して再読み込みしても保持されます。

利用可能なタイムゾーン

ピッカー(および TIMEZONE 句)は、10個のタイムゾーンからなる固定のセットを受け付けます。それ以外の IANA タイムゾーンはサポート対象外として拒否されます。

アカウントのデフォルトとタイムゾーンが結果に与える影響

分析設定で Lock reporting timezone が有効になっている場合、Account default を選択するとそのロックされたタイムゾーンが使用されます(ツールバーには解決されたタイムゾーンが表示されます。例:Timezone: Account default (Paris (CET)))。分析設定ページでは IANA の全リストを選択できますが、Reports が適用するのは上記の10個のタイムゾーンのみです。ロックされたタイムゾーンがそのいずれでもない場合、Account default は通知なしに UTC に解決されます。Lock reporting timezone が有効になっていない場合、Account default は UTC にフォールバックします。 タイムゾーンが設定されている場合、日付のバケット化には UTC ではなく現地時間が使用されます。たとえば、2026-03-29T01:30:00Z のイベントは、ニューヨーク(ET)では3月28日になりますが、パリ(CET)では3月29日になります。タイムゾーンが指定されていないクエリ(以前に保存されたものを含む)は、引き続き UTC で実行されます。