ストア分析データを取得

ストア分析データを取得アクションは、ShopifyQL クエリを実行し、ワークフローで使用する結果を返します。ShopifyQL は、コマース分析のために構築されたクエリ言語です。これを使用して、期間ごとの指標の集計、絞り込みの適用、商品、コレクション、お客様などのディメンションによるグループ化を行うことができます。このアクションによって返されたデータは、このステップに続く条件やアクションで使用できます。

ヒント

ShopifyQL は、Shopify レポートや顧客セグメンテーションでも使用されます。詳細については、ShopifyQL のクエリと構文を参照してください。

トリガー

ストア分析データを取得アクションは、スケジュールされた時間トリガーとのみ互換性があります。イベントベースのトリガーにはストア分析データが含まれません。

設定

フィールド

ストア分析データを取得アクションには次のフィールドが含まれています。

「ストア分析データを取得」アクションで使用されるフィールド。

フィールド	説明
ShopifyQL クエリ	必須。ストアの分析データに対して実行する ShopifyQL クエリです。

ShopifyQL クエリ

sales、sessions、inventory、paymentsなどのサポートされているスキーマを使用して、有効な ShopifyQL クエリを記述できます。たとえば、次のクエリはワークフローが実行された日の販売合計とお客様の数を返します。

FROM sales
  SHOW total_sales, customers
  SINCE today

サポートされているスキーマ、関数、構文などの完全な言語リファレンスについては、ShopifyQL のドキュメントを参照してください。

クエリは、ワークフローを保存する際に検証されます。クエリがストアで正常に実行されるまで、ワークフローを有効にするこはできません。

返されるデータ

ストア分析データを取得アクションは、クエリに一致する行を返します。これはgetAnalyticsDataという名前の変数として利用できます。行はgetAnalyticsData.rowsに保存され、各行はクエリ内の列名をキーとするオブジェクトになります。

この変数は、そのステップに続く条件とアクションの両方で使用できます。たとえば、各行をリストした社内メールを送信するには、次のような Liquid を使用できます。

{% for row in getAnalyticsData.rows %}
* {{ row.total_sales }} in sales from {{ row.customers }} customers
{% endfor %}

各行にアクションを適用するなど、各行を個別に処理するには、getAnalyticsData.rowsを使用してFor each ループ (反復)アクションを使用できます。行をカウントしたり、列の値を合計したりするなど、値を集計する場合は、カウントアクションと合計アクションを使用できます。

メモ

1つのワークフローでデータを取得アクションが複数回使用される場合、変数名に数字が追加されます。たとえば、注文データを取得アクションを2回使用するワークフローでは、返されるデータに対する最初の変数はgetOrderDataとなり、2番目の変数はgetOrderData1となります。この名前をカスタマイズすることはできません。

API リファレンス

このアクションで使用される API の詳細については、GraphQL Admin API のshopifyqlQueryクエリを参照してください。

クエリの複雑さ

各 ShopifyQL クエリには、クエリで使用されるスキーマ、列、絞り込み、および期間から計算される複雑さのコストがあります。クエリが複雑さの制限を超えると、アクションは失敗し、ワークフローを有効にできなくなります。クエリのコストを削減するには、期間を短くしたり、列を削除したり、結合を削除したりすることができます。

クエリコストの計算方法と現在の制限の詳細については、ShopifyQL Admin API のレート制限を参照してください。