チェックアウト離脱データを取得

チェックアウト離脱のデータを必要とするワークフローでは、チェックアウト離脱データを取得アクションを使用して、ストアからチェックアウト離脱の情報を取得できます。チェックアウト離脱とは、お客様がチェックアウトセッションを開始したものの、完了しなかったことを示します。

設定

フィールド

チェックアウト離脱データを取得アクションには、以下のフィールドが含まれています。

データを取得アクションで使用されるフィールド。
フィールド説明
データの並べ替えの基準必須。検索クエリによって返されるデータを並べ替えるためのパラメーターです。
結果の最大数必須。選択した検索クエリによって返される結果の最大数です。1 回につき最大 100 件まで返すことができます。
クエリ必須。一般的なクエリから選択するか、[詳細] を選択して独自のクエリを作成します。

クエリ文字列

以下は、過去 1 日間に作成されたチェックアウト離脱を取得するクエリの例です。

created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

created_at 変数は、チェックアウト離脱クエリで使用できる絞り込みであり、複数回使用したり、他の変数と組み合わせたりすることができます。scheduledAt のLiquid変数は、スケジュールされた時間トリガーを使用したワークフローで使用できます。date_minus の Liquid タグは、日付から時間を引くことができる、Flow の特別なタグです。

データをクエリする際には、以下の点を知っておくと便利です。

  • 利用可能なチェックアウト離脱の絞り込みのリスト

  • クエリは特定の構文に従う必要があります。

  • クエリフィールドの値は、必ずしも文書化されているわけではありません。場合によっては、API ドキュメントを確認することで値を見つけることができます。あるいは、管理画面で絞り込みを行う際に、URL 内でフィールドの値を見つけられることもよくあります。たとえば、一部の注文クエリの値を見つけるには、管理画面の注文管理ページを絞り込み、URL を確認します。

  • Shopify GraphiQL アプリを使用すると、ストアでクエリを実行したりテストしたりすることができます。

  • クエリが失敗した場合にどうなるかに注意してください。多くの場合、API は (結果がないのではなく) すべての結果を返します。

返されるデータ

すべてのデータを取得アクションは、0 から 100 のリソースのリストを返します。ユースケースに応じて、このデータをさまざまな方法で使用できます。

  • リストの各アイテムにタグ付けするなど、各アイテムを個別に処理する必要がある場合は、For each アクションを使用できます。
  • 返された結果の数を数えるなど、データを集計する必要がある場合は、Count または Sum アクションを使用できます。
  • すべてのアイテムを含むメールを送信するなど、リストを出力する必要がある場合は、後続のアクションで返されたデータを直接使用できます。

このアクションに続くステップで返されたデータにアクセスするには、チェックアウト離脱のリストである、Get abandoned checkout data という名前の変数を使用します。この変数は、条件とアクションの両方で使用できます。たとえば、次のように、内部メールを送信するアクションでチェックアウト離脱のリストを送信できます。

{% for single_checkout in getAbandonedCheckoutData %}
  * {{ single_checkout.email }} - {{ single_checkout.totalPrice }}
{% endfor %}

トリガー

このアクションは、スケジュールされた時間トリガーを含むあらゆるワークフローで使用できます。スケジュールされた時間トリガーを使用するワークフローでは、イベントの結果としてではなく、指定した時間にワークフローが開始されます。ワークフローを開始する特定のイベントがストアやアプリ内に存在しないため、自動的に含まれるデータはありません。

API リファレンス

このアクションで使用される API の詳細については、チェックアウト離脱クエリを参照してください。