-- cap the number of rows
```
最小限の例として、過去30日間の日次アップセル収益と承諾率を示します。
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
```
キーワードは大文字と小文字を区別せず（`SELECT` と `select` のどちらも動作します）、ステートメントの末尾にセミコロンは付けません。文字列値はダブルクォートで囲みますが、数値とリストは囲みません。
### SELECT と GROUP BY
* **`SELECT`** は測定する指標をカンマ区切りで列挙します。例：`SELECT revenue, impressions, accept_rate`。
* **`GROUP BY`** は、それらの指標を `date`、`device`、`surface`、`funnel` などの1つ以上のディメンションで分解します。`GROUP BY` がない場合は、期間全体の単一の合計値が得られます。
### WHERE によるフィルタリング
`WHERE` は、測定前にデータを絞り込みます。条件は `AND` で組み合わせます。
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue
WHERE device = "mobile"
GROUP BY date
SINCE last_month
GRAIN day
```
`impressions`、`accept_rate`、`rpv` は、デバイス、ファネル、プレースメント、商品でフィルターまたはグループ化**できません**。ソースとなるロールアップにそれらの列がないためです。これらのいずれかを選択するクエリに `WHERE device = "mobile"` を追加すると、`metric "impressions" cannot be filtered by "device"` というエラーで拒否されます。
サポートされる比較演算子は `=`、`!=`、`IN`、`NOT IN`、`>`、`<`、`>=`、`<=` です。複数の値に一致させるには、`IN` でリストを使用します。
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
WHERE surface IN ["PPU", "Checkout"]
```
`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` で設定する期間が必要です。
| 形式 | 例 | 意味 |
| - | - | - |
| プリセット | `SINCE last_30d` | **昨日**（UTC）で終わるローリング期間。進行中の当日は意図的に除外されるため、`last_1d` は昨日のみを意味し、`this_month` は1日から昨日までとなります。 |
| カスタム期間 | `SINCE 2026-07-02 UNTIL 2026-07-05` | ISO 形式の日付（`YYYY-MM-DD`）を使用した固定期間。 |
利用可能なプリセット：`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 での入力のみ可能です。
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- A four-day sale vs the four days immediately before it
SELECT revenue, impressions, accept_rate
GROUP BY date
SINCE 2026-07-02 UNTIL 2026-07-05
GRAIN day
COMPARE previous_period
```
レポートデータは **2026年2月**から開始されるため、それより前の期間を指定すると両方の期間で空の結果が返されます。
### チャートの選択
* **`CHART`** は結果の表示方法を設定します：`scorecard`、`line_chart`、`bar_chart`、`area_chart`、`funnel_chart`、`table`。
* **`TIMEZONE`** は日付のバケット化に使用するタイムゾーンを、引用符で囲んだ IANA 名で設定します。例：`TIMEZONE "America/New_York"`。デフォルトは UTC です（[タイムゾーン](#timezones)を参照）。
`funnel_chart` タイプには特定の要件があります。
* **プレースメントモード。** `placement` でグループ化し、指標を1つ選択します。ステージは標準のプレースメント順（デフォルトのアップセル、次にダウンセル、次に追加のアップセル）で並びます。プロットされるのは最初の指標のみで、追加の指標は脚注に記載されます。
* **指標モード。** `GROUP BY` なしで2つ以上の指標を選択します。各指標がクエリの順序でファネルのステージになります（例：`SELECT impressions, conversions` はインプレッションからコンバージョンへの離脱を表示します）。すべての指標は同じ単位である必要があります。
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Placement funnel: conversion drop-off across placements
SELECT conversions
GROUP BY placement
SINCE last_30d
CHART funnel_chart
```
プレースメントモードには、プレースメントで分解できる指標が必要です。`impressions`、`accept_rate`、`rpv` は分解できず、これらの指標ではファネルチャートに「These metrics can't be grouped by placement」と表示されます。
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Metric funnel: impressions to conversions drop-off
SELECT impressions, conversions
SINCE last_30d
CHART funnel_chart
```
### 並べ替えと件数制限
* **`ORDER BY`** は、指標またはディメンションで結果を `ASC` または `DESC` で並べ替えます。
* **`LIMIT`** は返される行数の上限を設定します。「上位 N 件」の質問に便利です。
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Top 20 products by upsell revenue this month
SELECT revenue, conversions, avg_conversion_value
GROUP BY product
SINCE this_month
ORDER BY revenue DESC
LIMIT 20
```
### その他の例
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Daily performance vs the previous period
SELECT revenue, impressions, conversions, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
COMPARE previous_period
```
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Mobile vs desktop revenue over the last 90 days
SELECT revenue
GROUP BY device
SINCE last_90d
ORDER BY revenue DESC
```
`impressions`、`accept_rate`、`rpv` はデバイスで分解できません。これらのロールアップはショップ × サーフェス × 日で、デバイスの列がないためです。デバイスの比較には `revenue`（またはコンバージョンを元にした他の指標）を使用してください。
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Which surface is driving the most revenue?
SELECT revenue, impressions, accept_rate
GROUP BY surface
SINCE last_30d
ORDER BY revenue DESC
```
## タイムゾーン
デフォルトでは、クエリは UTC で実行されます。タイムゾーンを上書きすると、日付でバケット化された結果を現地時間で反映できます（ツールバーでの手順は[タイムゾーンの設定](/ja/aftersell/reports_explorer#setting-a-timezone)を参照）。
**Impressions**、**Accept Rate**、**Revenue Per Visit** を含むクエリは、選択したタイムゾーンにかかわらず、常に UTC で日付をバケット化します。これらは UTC の日単位で報告される日次ロールアップを元にしているためです。これらのいずれかを他の指標と組み合わせたクエリでは、日付バケットを揃えるために結果セット全体が UTC にフォールバックします。
### TIMEZONE 句
`TIMEZONE` 句を使うと、AQL で直接タイムゾーンを指定できます。この句は `CHART` と `ORDER BY` の間に記述します。
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT ...
CHART ...
TIMEZONE "Asia/Tokyo"
ORDER BY ...
```
この句がある場合、そのクエリではツールバーの選択が上書きされ、保存して再読み込みしても保持されます。
### 利用可能なタイムゾーン
ピッカー（および `TIMEZONE` 句）は、10個のタイムゾーンからなる固定のセットを受け付けます。それ以外の IANA タイムゾーンはサポート対象外として拒否されます。
| タイムゾーン | 地域の例 |
| - | - |
| UTC | 協定世界時 |
| America/New\_York | ニューヨーク（ET） |
| America/Chicago | シカゴ（CT） |
| America/Denver | デンバー（MT） |
| America/Los\_Angeles | ロサンゼルス（PT） |
| Europe/London | ロンドン（GMT/BST） |
| Europe/Paris | パリ（CET/CEST） |
| Asia/Tokyo | 東京（JST） |
| Asia/Singapore | シンガポール（SGT） |
| Australia/Sydney | シドニー（AEST/AEDT） |
### アカウントのデフォルトとタイムゾーンが結果に与える影響
分析設定で **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 で実行されます。