SHOPLINE QLを使って分析レポートをカスタマイズする方法

SHOPLINE QLは、SHOPLINEでより柔軟なカスタムレポートを作成するための分析検索言語です。SHOPLINE QLを使うと、分析したい指標を選択し、レポートデータをフィルタリングし、結果をディメンションでグループ化し、簡単な計算でカスタム指標を作成できます。

このガイドでは、一般的なSHOPLINE QL用語、基本的な検索構造、よく使われる句、検索例、および重要な使用上の注意点を紹介します。

一般的なSHOPLINE QL用語の理解

このガイドの例を使用する前に、以下の一般的なSHOPLINE QL用語を理解しておくと役立ちます：

SHOPLINE QLの構造の理解

SHOPLINE QLの検索は句で構成されます。各句は、SHOPLINEにどのデータを検索するか、どのフィールドを表示するか、結果をどのようにフィルタリングまたはグループ化するか、どの期間を使用するかを指示します。

SHOPLINE QLでカスタムレポートを作成する際、各検索には以下を含める必要があります：

• FROM: データセットを指定します。
• VIEW: 表示するフィールド、指標、または計算値を指定します。
• 期間: DURINGを使うか、SINCE / UNTILで日付範囲を指定します。

典型的なSHOPLINE QL検索は以下のようになります：

FROM sales
  VIEW total_sales, order_cnt
  FILTER payment_status IN ('Payment successful', 'Unpaid')
  GROUP BY day
  DURING last_30_day
  COMPARE previous_period
  EXTEND TOTALS
  ORDER BY total_sales DESC
  LIMIT 20

以下の表は、利用可能なSHOPLINE QLの句とその目的をまとめたものです。句名をクリックすると、詳細と例がある専用セクションに移動します。

カスタムレポートでのSHOPLINE QLの設定

カスタムレポートの作成または編集時にSHOPLINE QLを入力して実行できます。SHOPLINE QLエディターを使用してクエリを作成し、保存前にレポート結果をプレビューしてください。

カスタムレポートでSHOPLINE QLを設定するには：

1. SHOPLINE管理画面で、分析 > レポートに移動します。
2. カスタムレポートを作成をクリックして新しいレポートを作成するか、既存のカスタムレポートを開いて修正します。
3. レポート名を入力します。レポート名は一意である必要があります。既に存在する場合は、名前の変更を求められます。
4. ドロップダウンリストからデータセットを選択します。現在、新規作成されたカスタムレポートは販売データのみをサポートしています。
5. 次へをクリックし、レポートエディターでSHOPLINE QLエディターにクエリを入力します。
6. 実行をクリックしてレポート結果をプレビューします。
7. プレビューを確認し、結果が正しければレポートを保存します。

クエリでのSHOPLINE QL句の使用

以下のセクションでは、最も一般的に使用されるSHOPLINE QL句の目的、構文、および使用例について説明します。

FROM と VIEW

FROMはクエリ対象のデータセットを指定します。VIEWはレポートに表示したいフィールド、指標、または計算値を指定します。

例えば、本日の売上を表示するには：

FROM sales
  VIEW total_sales
  DURING today

同じレポートで複数の指標を表示することもできます：

FROM sales
  VIEW total_sales, net_sales, order_cnt
  DURING last_7_day

既存の指標を基に新しい指標を作成するには、VIEW内で算術演算子を使用し、ASで新しい指標名を付けます。

例えば、平均注文額を計算するには：

FROM sales
  VIEW (net_sales / order_cnt) AS average_order_value
  DURING last_month

例えば、総売上と割引に基づいて調整後売上を計算するには：

FROM sales
  VIEW (gross_sales - discounts) AS adjusted_sales
  DURING last_month

SHOPLINE QLは以下の算術演算子をサポートしています：

計算フィールドに複数の演算子が含まれる場合、乗算と除算は加算と減算より先に計算されます。計算の順序を制御するために括弧を使用することもできます。

例えば、調整後の売上を最初に計算し、その結果を注文数で割るには：

FROM sales
  VIEW ((gross_sales - discounts) / order_cnt) AS average_adjusted_sales
  DURING last_month

FILTER

FILTER は指標が計算される前にデータを絞り込みます。特定のステータス、商品、ロケーション、またはその他の条件に一致する履歴のみを含めるために使用できます。

例えば、支払いが成功した売上のみを表示するには：

FROM sales
  VIEW total_sales
  FILTER payment_status IN ('Payment successful')
  DURING today

例えば、名前に shirt を含む商品の売上を表示するには：

FROM sales
  VIEW total_sales, order_cnt
  FILTER product_spu_name CONTAINS ('shirt')
  DURING last_30_day

FILTER は以下の比較演算子をサポートしています：

例えば、売上が 100 より大きい履歴のみを含めるには：

FROM sales
  VIEW total_sales
  FILTER total_sales > 100
  DURING last_30_day

また、複数のフィルター条件を組み合わせるために AND、OR、NOT を使用したり、特定の値に一致させるために IN、NOT IN、CONTAINS、NOT CONTAINS を使用することもできます。

例えば、支払いが成功したものを含め、特定の顧客タイプを除外するには：

FROM sales
  VIEW total_sales
  FILTER (payment_status IN ('Payment successful')) AND NOT buyer_type IN ('New customer', 'Returning customer')
  DURING today

例えば、特定の注文ステータスの注文を除外するには：

FROM sales
  VIEW total_sales
  FILTER order_status NOT IN ('Completed', 'Shipped')
  DURING today

POSTFILTER

POSTFILTER は、指標が計算された後に結果をフィルタリングします。これは、最初にデータをグループ化し、その後特定の条件を満たすグループ化された結果のみを保持したい場合に便利です。

例えば、過去30日間の州/省別の売上を表示し、売上が 1000 を超えるロケーションのみを表示するには：

FROM sales
  VIEW total_sales
  GROUP BY province
  DURING last_30_day
  POSTFILTER total_sales > 1000

FILTER と POSTFILTER は異なる段階で適用されます。FILTER は指標が計算される前の元データをフィルタリングし、POSTFILTER は指標が生成された後の計算結果をフィルタリングします。

例えば、最初に各州/省の売上を計算し、その後特定の金額に達したロケーションのみを表示したい場合は、POSTFILTER を使用します。

GROUP BY

GROUP BY は、ディメンションごとにレポートデータをグループ化します。GROUP BY がない場合、レポートは通常、集計結果を返します。GROUP BY を追加すると、指定したディメンションごとに結果が分解されます。

例えば、過去30日間の日別売上を表示するには：

FROM sales
  VIEW total_sales
  GROUP BY day
  DURING last_30_day

例えば、過去30日間の州/省および市別の売上を表示するには：

FROM sales
  VIEW total_sales
  GROUP BY province, city
  DURING last_30_day

一般的な時間ディメンションには以下があります：

DURING, SINCE, and UNTIL

各SHOPLINE QL検索には時間範囲を含める必要があります。DURING を使ってプリセットの時間範囲を選択するか、SINCE と UNTIL を使って正確な日付を指定します。

プリセットの時間範囲を使うには：

FROM sales
  VIEW total_sales
  DURING last_30_day

特定の日付範囲を使うには：

FROM sales
  VIEW total_sales
  SINCE '2026-05-01' UNTIL '2026-05-31'

日付と時間の両方を指定するには：

FROM sales
  VIEW total_sales
  SINCE '2026-05-01 00:00:00' UNTIL '2026-05-31 23:59:59'

一般的なDURINGの時間範囲には以下が含まれます：

COMPARE

COMPAREは選択した時間範囲を別の時間範囲と比較します。

例えば、直近30日間のデータを前の期間と比較するには：

FROM sales
  VIEW total_sales
  GROUP BY day
  DURING last_30_day
  COMPARE previous_period

現在サポートされている比較タイプは以下の通りです：

EXTEND TOTALS

EXTEND TOTALSはレポート結果に集計合計を追加します。これはロケーション、商品、または他のディメンションでデータをグループ化し、全体の合計も見たい場合に便利です。

例えば、直近30日間の州/県別の売上を表示し、集計合計を含めるには：

FROM sales
  VIEW total_sales, order_cnt
  GROUP BY province
  DURING last_30_day
  EXTEND TOTALS

ORDER BY, LIMIT, and OFFSET

ORDER BYは結果を並べ替えます。LIMITはクエリで返される行数を制御します。OFFSETは指定した行数をスキップし、通常はLIMITと一緒に使用されます。

例えば、過去30日間の売上で上位10商品を表示するには：

FROM sales
  VIEW total_sales, order_cnt
  GROUP BY product_spu_name
  DURING last_30_day
  ORDER BY total_sales DESC
  LIMIT 10

ASC は結果を低い順に並べ替えます。DESC は結果を高い順に並べ替えます。

最初の40行をスキップして次の20行を表示するには：

FROM sales
  VIEW total_sales
  GROUP BY product_spu_name
  DURING last_30_day
  ORDER BY total_sales DESC
  LIMIT 20
  OFFSET 40

FROM sales
  VIEW total_sales, order_cnt
  GROUP BY product_spu_name
  DURING last_30_day
  ORDER BY total_sales DESC
  LIMIT 10

FROM sales
  VIEW total_sales, net_sales
  GROUP BY day
  DURING last_30_day
  COMPARE previous_period
  ORDER BY day ASC
  LIMIT 30

FROM sales
  VIEW total_sales, order_cnt
  FILTER product_spu_name CONTAINS ('shirt')
  GROUP BY product_spu_name
  DURING last_7_day
  ORDER BY total_sales DESC
  LIMIT 20

FROM sales
  VIEW total_sales, order_cnt
  GROUP BY province
  DURING this_month
  EXTEND TOTALS
  ORDER BY total_sales DESC
  LIMIT 50

FROM sales
  VIEW total_sales
  GROUP BY province
  DURING last_30_day
  POSTFILTER total_sales > 1000

FROM sales
  VIEW total_sales
  FILTER payment_status IN ('success', 'failed')
  SINCE '2026-05-01 00:00:00' UNTIL '2026-05-20 23:59:59'