> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Explorer

> Aftersell の Explorer を使って、カスタムアナリティクスクエリとレポートを作成しましょう。

Explorer では、柔軟なクエリビルダー(AftersellQL)を使ってカスタムアナリティクスクエリを作成できます。指標を選択し、結果をディメンションでグループ化し、フィルターを適用し、データをチャートやテーブルで可視化できます。保存したクエリは、継続的なモニタリングのためにウィジェットとしてレポートに追加できます。

<Tip>
  クエリはメニューを使ってビジュアルに構築でき、構文の知識は不要です。クエリを直接入力したい場合、Explorer は基になる AftersellQL テキストも公開しています。構文リファレンスは、以下の [AQL クエリの記述](#writing-aql-queries)をご覧ください。
</Tip>

***

<div id="available-metrics">
  ## 利用可能な指標
</div>

Explorer で選択できる指標を、指標ピッカーと同じ分類でまとめています。

<div id="revenue-profit">
  ### 収益と利益
</div>

| 指標                           | 説明                                                                                                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Revenue**                  | ストアのネイティブ通貨でのアップセル収益。                                                                                                                                         |
| **Revenue (USD)**            | 通貨間の比較のために USD に正規化されたアップセル収益。                                                                                                                                |
| **Revenue Per Visit**        | インプレッションセッションあたりのアップセル収益。商品、プレースメント、ファネル、デバイスでは分解できません。                                                                                                       |
| **Avg. Conversion Value**    | 承諾されたオファーあたりの収益。Average Upsell Value とも呼ばれます。                                                                                                                 |
| **Upsell Revenue Per Order** | アップセル収益(USD)を総注文数で割った値。ストアレベルのみ。                                                                                                                              |
| **Product Profit**           | アップセルされた商品の収益から売上原価(COGS)を差し引いた値。マーチャントが設定した COGS に依存するため、目安として扱ってください。原価が登録されていない商品は収益がそのまま利益として計上され、原価のカバー率はストアによって異なります。商品粒度のみ。ファネル、プレースメント、デバイスでは分解できません。 |

<div id="conversions">
  ### コンバージョン
</div>

| 指標               | 説明                                                                                                              |
| ---------------- | --------------------------------------------------------------------------------------------------------------- |
| **Conversions**  | オファー承諾イベントの数。承諾されたオファー 1 件が 1 コンバージョンとなるため、2 つのオファーを承諾したセッションは 2 回カウントされます。                                     |
| **Accept Rate**  | セッションベース:オファーを見て少なくとも 1 つを承諾したセッションの割合。Conversions とは独立して、異なるロールアップから計算されるため、Conversions ÷ Impressions ではありません。 |
| **Units Sold**   | アップセルオファーを通じて販売された総ユニット数。                                                                                       |
| **Decline Rate** | 明示的に拒否された購入後オファーの割合。購入後のみ。                                                                                      |

<div id="engagement">
  ### エンゲージメント
</div>

| 指標              | 説明                           |
| --------------- | ---------------------------- |
| **Impressions** | オファーを見たユニークセッション数。           |
| **Show Rate**   | インプレッションに至った判定(decision)の割合。 |

<div id="store-performance">
  ### ストアパフォーマンス
</div>

| 指標                            | 説明                                                              |
| ----------------------------- | --------------------------------------------------------------- |
| **Total Store Revenue**       | Shopify で支払われた注文の総収益。ストアレベルのみ。サーフェス、ファネル、プレースメント、デバイスでは分解できません。 |
| **Orders**                    | Shopify で支払われた総注文数。ストアレベルのみ。                                    |
| **Average Total Order Value** | ストア収益を注文数で割った値。ストアレベルの平均注文金額。                                   |

<div id="rokt-network">
  ### Rokt ネットワーク
</div>

| 指標                             | 説明                                                                    |
| ------------------------------ | --------------------------------------------------------------------- |
| **Rokt Revenue**               | ストアに帰属する Rokt ネットワーク収益。                                               |
| **Rokt Transactions**          | ストアの Rokt ネットワークトランザクション数。                                            |
| **Rokt Revenue / Transaction** | 時間バケットごとの、Rokt 収益をトランザクション数で割った値。                                     |
| **Rokt Impressions**           | ストアのプレースメント全体での Rokt ネットワークの総インプレッション数。アップセルの **Impressions** とは別物です。 |
| **Rokt Referrals**             | Rokt ネットワークのリファラル。買い物客を Rokt パートナーに送客したポジティブなエンゲージメントです。              |

***

<div id="dimensions">
  ## ディメンション
</div>

ディメンションを使うと、特定の属性で指標を分解できます。すべてのディメンションがすべての指標と互換性があるわけではありません。

<Note>
  一部のディメンションと指標の組み合わせは互換性がありません。たとえば、**Decline rate** と **Show rate** は **Currency** で分解できません。Explorer は互換性のない組み合わせを自動的に防ぎます。
</Note>

<div id="available-dimensions">
  ### 利用可能なディメンション
</div>

| ディメンション       | 説明                                                                     |
| ------------- | ---------------------------------------------------------------------- |
| **Date**      | 結果を日、週、または月でグループ化します。                                                  |
| **Surface**   | アップセルサーフェス。PPU(購入後)、Checkout、Thank You Page、Cart のいずれか。                |
| **Funnel**    | オファーが属する特定のファネル。                                                       |
| **Product**   | アップセルされた商品。                                                            |
| **Placement** | ファネル内のプレースメント。                                                         |
| **Device**    | デバイスタイプ:Mobile、Desktop、または Unknown。タブレット専用の値はありません。                    |
| **Currency**  | ISO 通貨コード(例:USD、EUR、GBP)。複数通貨ストアで便利です。ストアレベルの指標とほとんどのアップセル指標と互換性があります。 |

<div id="unavailable-dimensions">
  ### 利用できないディメンション
</div>

以下のディメンションは開発中です。ピッカーには表示されますが、ブレイクダウンとしてはまだ利用できません。代わりに、すべての指標に対して「Not compatible」と表示されます。**これらのディメンションが完全に実装された時点で、このドキュメントは更新されます。**

| ディメンション           | 説明                                               |
| ----------------- | ------------------------------------------------ |
| **Flow type**     | アップセルフローのタイプ。                                    |
| **Experiment**    | A/B テストまたは実験のバリアント。                              |
| **Outcome**       | 判定結果(例:eligible、out of stock)。                   |
| **Reason code**   | 判定結果の理由。                                         |
| **Scope**         | 判定のスコープ(Flow、Experience、Placement、または ItemSlot)。 |
| **Response type** | オファーへの反応(Accepted、Declined、または Timeout)。         |

***

<div id="writing-aql-queries">
  ## AQL クエリの記述
</div>

Explorer で作成するすべてのクエリは、**AftersellQL (AQL)** ステートメントです。ほとんどの場合、メニューから指標、ディメンション、フィルター、期間を選んでビジュアルにクエリを作成するため、AQL を手書きする必要はありません。

パワーユーザー向けに、Explorer は基になるクエリを編集可能なテキストとしても公開しています。このセクションはそのテキスト形式のリファレンスです。各句の意味、受け付ける値、すぐに使える例を紹介します。

<div id="how-an-aql-statement-reads">
  ### AQL ステートメントの読み方
</div>

AQL ステートメントは、句(clause)で構成される 1 つの質問です。必須なのは `SELECT` と期間(`SINCE`)だけで、それ以外はすべて任意です。任意の句を含める場合は、以下に示す順序で記述する必要があります。

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT    <metrics>                    -- what to measure (required)
WHERE     <filters>                    -- narrow the data
GROUP BY  <dimensions>                 -- break the numbers down
SINCE     <time range>                 -- the period to cover (required)
GRAIN     <time grain>                 -- bucket size for time series
COMPARE   <comparison>                 -- compare against another period
CHART     <visualization>              -- how to display the result
TIMEZONE  "<timezone>"                 -- timezone for date buckets
ORDER BY  <field> <direction>          -- sort the results
LIMIT     <number>                     -- 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
```

<Note>
  キーワードは大文字と小文字を区別せず(`SELECT` も `select` も動作します)、ステートメントはセミコロンで終わりません。文字列値は二重引用符で囲みます。数値とリストは囲みません。
</Note>

<div id="picking-what-to-measure-and-how-to-slice-it">
  ### 何を測定し、どう分解するかを選ぶ
</div>

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

利用可能な指標とディメンションの一覧、および許可されている組み合わせについては、上記の[利用可能な指標](#available-metrics)と[利用可能なディメンション](#available-dimensions)をご覧ください。Explorer は互換性のない指標とディメンションの組み合わせを自動的に防ぎます。

<div id="filtering-with-where">
  #### `WHERE` によるフィルタリング
</div>

`WHERE` は、測定前にデータを絞り込みます。条件は `AND` で組み合わせます。

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue
WHERE device = "mobile"
GROUP BY date
SINCE last_month
GRAIN day
```

<Warning>
  `impressions`、`accept_rate`、`rpv` は、デバイス、ファネル、プレースメント、商品でフィルタリングまたはグループ化**できません**。これらのソースロールアップにはそのような列がないためです。これらのいずれかを選択するクエリに `WHERE device = "mobile"` を追加すると、`metric "impressions" cannot be filtered by "device"` というエラーで拒否されます。
</Warning>

サポートされている比較演算子は `=`、`!=`、`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.` というエラーで拒否されます。(同じ理由で、下記の**利用できないディメンション**に記載されています。)

<div id="filtering-by-multiple-funnels">
  #### 複数のファネルによるフィルタリング
</div>

**funnel** フィルターは複数選択の演算子をサポートしているため、クエリをファネルのサブセットにスコープできます:

* **is one of** — 選択したファネルのみを含めます(`IN`)。
* **is not one of** — 選択したファネルを除外します(`NOT IN`)。

**is one of** または **is not one of** を選択すると、値の入力欄が、すべてのファネル名を表示するスクロール可能なチェックボックスリストに変わります。必要な数だけファネルを選択してください。

結果を **Funnel** でグループ化して **is one of** フィルターを適用すると、折れ線グラフには選択したファネルごとに 1 本の線が表示されます。デフォルトの系列数を超えて選択した場合でも同様です。選択したファネルが「Other」カテゴリにまとめられることはありません。

<div id="time-ranges-and-comparisons">
  ### 期間と比較
</div>

すべてのクエリには、`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`(直前の同じ長さのウィンドウ)を使用します。`previous_year` は、ウェアハウスに 2026 年 2 月より前のデータが存在しないため、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
```

<Note>
  レポートデータは **2026 年 2 月**から始まるため、それより前のウィンドウは両方の期間とも空の結果を返します。前年比較がまだ提供されていないのも同じ理由です。
</Note>

<div id="choosing-a-chart-and-timezone">
  ### チャートとタイムゾーンの選択
</div>

これらの任意の句は通常、Explorer のビジュアルコントロールによって設定されますが、直接記述することもできます:

* **`CHART`** は結果の表示方法を設定します:`scorecard`、`line_chart`、`bar_chart`、`area_chart`、`funnel_chart`、または `table`。
* **`TIMEZONE`** は日付のバケットに使用するタイムゾーンを、引用符で囲んだ IANA 名で設定します — 例:`TIMEZONE "America/New_York"`。デフォルトは UTC です。

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue
GROUP BY date
SINCE last_30d
GRAIN day
CHART line_chart
TIMEZONE "America/New_York"
```

`funnel_chart` タイプには固有の要件があります:

* **プレースメントモード** — `placement` でグループ化し、指標を 1 つ選択します。ステージは正規のプレースメント順序(アップセルデフォルト → ダウンセル → 追加アップセル)で並びます。プロットされるのは最初の指標のみで、追加で選択した指標は脚注に記載されます。
* **指標モード** — `GROUP BY` なしで 2 つ以上の指標を選択します。各指標はクエリの順序でファネルステージになります(たとえば、`SELECT impressions, conversions` は 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
```

<Warning>
  プレースメントモードには、実際にプレースメントで分解できる指標が必要です。`impressions`、`accept_rate`、`rpv` はできません。これらの場合、ファネルチャートには「These metrics can't be grouped by placement」と表示されます。
</Warning>

```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
```

<div id="sorting-and-limiting">
  ### ソートと件数制限
</div>

* **`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
```

<div id="more-examples">
  ### その他の例
</div>

```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
```

<Note>
  `impressions`、`accept_rate`、`rpv` はデバイスで分解できません。これらのロールアップはショップ × サーフェス × 日で構成され、デバイス列がありません。デバイス比較には `revenue`(または他のコンバージョン由来の指標)を使用してください。
</Note>

```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
```

気に入ったクエリができたら、保存してウィジェットとしてレポートに追加すれば、更新され続けます。[ウィジェットの管理](/ja/aftersell/reports_widgets)をご覧ください。不要になったウィジェットを削除するには、Explorer で読み込み、タイトルバーの **Delete** をクリックします。ウィジェットを削除すると、それが表示されているすべてのレポートから削除されます。**Delete** ボタンは自分が所有するウィジェットにのみ表示されます。グローバルテンプレートウィジェットは読み取り専用です。

***

<div id="exporting-results">
  ## 結果のエクスポート
</div>

Explorer は、クエリ結果をスコアカード、チャート、またはテーブルとして画面に表示します。クエリビューから直接ファイルをダウンロードすることはありません。

結果をファイルとして取得するには、クエリを保存して[ウィジェット](/ja/aftersell/reports_widgets)としてレポートに追加します。各ウィジェットには独自の **Export to CSV** ボタンがあり、ウィジェットのデータを `.csv` ファイルとしてダウンロードできます。標準の Analytics ページのエクスポート(Excel と CSV)については、[データのエクスポート](/ja/aftersell/analytics_in_aftersell#exporting-your-data)をご覧ください。

***

<div id="timezone-support">
  ## タイムゾーンのサポート
</div>

デフォルトでは、クエリは UTC で実行されます。Explorer のツールバーで任意のクエリのタイムゾーンを上書きでき、日付でバケットされた結果(日次、週次、月次のブレイクダウン)を UTC ではなく現地時間で反映できます。

<Note>
  **Impressions**、**Accept Rate**、**Revenue Per Visit** を含むクエリは、選択したタイムゾーンに関係なく、常に UTC で日付をバケットします。これらの指標は、UTC の日単位でのみ報告される日次ロールアップから取得されます。これらの指標のいずれかを他の指標と混在させるクエリでは、日付バケットの整合性を保つために結果セット全体が UTC にフォールバックします。
</Note>

<div id="setting-a-timezone-for-a-query">
  ### クエリのタイムゾーンを設定する
</div>

1. Aftersell 管理画面で Explorer を開きます。
2. ツールバーで(**Compare** の隣にある)**Timezone** セレクタをクリックします。
3. リストから利用可能なタイムゾーンを選択するか、**Account default** を選択してアナリティクス設定で構成されたタイムゾーンを使用します。
4. クエリを実行します。結果は選択したタイムゾーンでバケットされます。

選択したタイムゾーンはクエリとともに保存されます。クエリを保存して再読み込みすると、タイムゾーンは自動的に復元されます。

<div id="account-default-timezone">
  ### アカウントデフォルトのタイムゾーン
</div>

アナリティクス設定で **Lock reporting timezone** を有効にしている場合、ツールバーで **Account default** を選択すると、そのロックされたタイムゾーンがクエリに使用されます。ツールバーのラベルには解決されたゾーンが表示されます。例:**Timezone: Account default (Paris (CET))**。

アナリティクス設定ページは IANA タイムゾーンの全リストを受け付けますが、Reports が対応するのは上記の 10 ゾーンのみです。ロックしたゾーンがそのいずれでもない場合、**Account default** はサイレントに UTC に解決されます。Reports に従わせたい場合は、このリストからロックするゾーンを選択してください。

**Lock reporting timezone** が有効でない場合、**Account default** は UTC にフォールバックします。

<div id="specifying-a-timezone-in-aql">
  ### AQL でタイムゾーンを指定する
</div>

`CHART` と `ORDER BY` の間に置く `TIMEZONE` 句を使って、AQL クエリで直接タイムゾーンを指定することもできます:

```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT ...
CHART ...
TIMEZONE "Asia/Tokyo"
ORDER BY ...
```

この句が存在する場合、そのクエリではツールバーの選択を上書きします。タイムゾーンは、クエリを保存して再読み込みしても保持されます。

<div id="available-timezones">
  ### 利用可能なタイムゾーン
</div>

タイムゾーンピッカーには以下のオプションが含まれます:

| タイムゾーン               | 例となる場所           |
| -------------------- | ---------------- |
| 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) |

これは 10 ゾーンの閉じたセットです。`TIMEZONE` 句にその他の IANA タイムゾーンを指定すると、サポート対象外として拒否されます。

<div id="how-timezone-affects-query-results">
  ### タイムゾーンがクエリ結果に与える影響
</div>

タイムゾーンが設定されている場合、クエリの日付バケットは UTC ではなく現地時間を使用します。たとえば、`2026-03-29T01:30:00Z`(UTC)に発生したイベントは、ニューヨーク時間(ET)では 3 月 28 日に、パリ時間(CET)では 3 月 29 日に該当します。正しいタイムゾーンを設定することで、日次、週次、月次のブレイクダウンがビジネスレポートの期待と一致します。

タイムゾーンを含まないクエリ(以前に保存したクエリを含む)は引き続き UTC で実行されるため、既存の結果には影響しません。

***

<div id="need-help">
  ## サポートが必要ですか?
</div>

Explorer について質問がある場合や、アクセスを有効にしたい場合は、アプリ内チャットから Aftersell サポートチームにお問い合わせください。