注文データを取得
注文データを必要とするワークフローでは、[注文データを取得] アクションを実行して、注文情報をストアから取得できます。
設定
フィールド
[注文データを取得] アクションには、以下のフィールドが用意されており、これらのフィールドはクエリの構築に使用されます。
フィールド | 説明 |
---|---|
データの並べ替え方法 | 以下は必須です。検索クエリから返されたデータを並べ替える際の基準になるパラメーターです。 |
結果の最大数 | 以下は必須です。選択した検索クエリが返すことのできる結果の最大数です。一度に最大100件返すことができます。 |
クエリ | 以下は必須です。一般的なクエリから選択するか、[高度] を選択して自分でクエリを作成します。 |
クエリ文字列
これは、過去1日間に更新された注文を取得するクエリの例です。
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'
変数updated_at
は、注文クエリで利用可能な絞り込みであり、複数回使用することや、他の変数と組み合わせることができます。Liquid変数scheduledAt
は、予定時刻にトリガーを使用するワークフローで使用できます。Liquidタグdate_minus
は、日付から時間を差し引くための特別なFlowタグです。
以下の情報は、データのクエリ時に役立ちます。
- 利用可能な注文の絞り込みのリスト- クエリは特定の構文に従う必要があります。
- クエリフィールドの値が必ずしも文書化されているわけではありません。場合によっては、APIドキュメントを見ることで値を確認できます。あるいは、管理画面で絞り込みをするときに、URLからフィールドの値を確認できる場合がしばしばあります。たとえば、注文クエリの値を見つけるには、管理画面の注文ページを絞り込み、URLを確認します。
- Shopify GraphiQLアプリを使用して、ショップでクエリを実行またはテストできます。
- クエリが失敗した際に何が起きるかに注意します。多くの場合、APIはすべての結果を返します (何も返さないことはありません)。
返されたデータ
すべての [データを取得] アクションは、実行すると0〜100の任意のリソースを含むリストを返します。使用例に応じて、さまざまな方法でこのデータを使用することができます。
- それぞれにタグを追加するなど、リストの各項目を個別に処理する必要がある場合は、[For each] アクションを実行します。
- 返された結果の数をカウントするなど、データを集計する必要がある場合は、[カウント] アクションまたは [合計] アクションを実行します。
- すべてのアイテムを記載したメールを送信するなど、リストを出力する必要がある場合は、返されたデータを後続のアクションで直接使用します。
このアクションに続く手順で、返されたデータにアクセスするには、注文のリストである [注文データを取得] という名前の変数を使用します。この変数は、条件とアクションの両方で使用できます。たとえば、以下のような [内部メールを送信] アクションを実行して、お客様のリストを送信することができます。
{% for single_order in GetOrderData %}
- {{ single_order.name }}
{% endfor %}
トリガー
このアクションは、[予定時刻] トリガーが設定されたワークフローなど、どのワークフローでも実行できます。[予定時刻] トリガーが設定されたワークフローは、イベント発生時ではなく指定された時刻に起動します。ストア内やワークフローを起動するアプリ内で特定のイベントが発生しないため、データが自動的に取り込まれることはありません。
APIの詳細
テンプレート
頻繁に返品するお客様の注文をキャンセルする
過去6か月間に5回以上商品を返品したお客様からの注文をキャンセルします。注文データの取得、返品数のカウント、現在の注文のキャンセル、返金とアイテムの補充を行います。このテンプレートは、以下のような目的で使用できます:常習的な返品による損失を削減する、返品になりそうな注文を事前に処理することで注文管理を能率化する、過剰な返品を阻止することで収益性を維持する。テンプレートを表示する
お客様が1日に5件を超える注文を行った場合、注文をキャンセルする
お客様が1日で5件以上の注文をした場合、その注文をキャンセルします。そのお客様が過去24時間以内に注文した注文数をチェックし、この上限を超えた注文をすべてキャンセルし、そのお客様を不正注文の可能性があるとしてタグ付けします。テンプレートを表示する
チャージバックが発生したお客様のフルフィルメント注文を保留する
注文をフルフィルメントする準備が完了すると、ワークフローが過去60日以内にチャージバックがあった同じお客様からの注文をすべて取得します。そのような注文がある場合、各荷物のフルフィルメントを保留し、対応を通知する社内メールを送信します。テンプレートを表示する
お客様が24時間以内に複数の注文をした場合、フルフィルメントを保留する
お客様が24時間以内に複数の注文をしたかどうかを確認します。複数の注文をしている場合、フルフィルメントを保留し、まとめて配送します。テンプレートを表示する
過去24時間以内にお客様が複数の注文を行った場合、注文を保留する
注文が作成されると、お客様が過去24時間以内に他の注文を行ったどうかを確認します。他の注文を行った場合、すべての注文を保留します。テンプレートを表示する
直近1時間の注文件数が10件を下回った場合に通知を送信する
注文の持続性に関する通知を送信します。1時間ごとに注文件数を10件までカウントします。注文件数が10件を下回った場合は、メールで通知を送信します。[予定時刻] ステップ、[注文データを取得] ステップ、[カウント] ステップを使用します。テンプレートを表示する
オンラインストアに直近1日分の注文すべてのサマリーをメールで送信する
毎日、最終日の注文を取得し、オンラインストアに発注された注文のサマリーをメールで送信します。テンプレートを表示する
2日以上前の未発送の注文すべてに関するサマリーをメールで送信する
スケジュールを利用して、2日以上経過したすべての未発送の注文の毎日のサマリーを取得し、注文データを取得、カウント、合計します。テンプレートを表示する
遅れたフルフィルメントの毎日のサマリーをタグ付けして送信する
毎日、2日以内の配送保証を守れなかった注文の総数および総額をまとめたサマリーにタグを付けて、毎日メールで送信します。テンプレートを表示する
チャージバックのあるお客様にタグを付ける
毎時間、このワークフローではチャージバックのある注文を取得し、その注文のお客様にタグを追加します。[予定時刻] トリガー、[商品データを取得] アクション、[項目ごと] ループを使用します。テンプレートを表示する
2日以上前の未発送の注文をタグ付けする
このワークフローでは、毎日、2日以上前の未発送の注文をすべて取得し、その注文にタグを追加します。テンプレートを表示する
タグを使用して、過去6か月間の注文に基づいてお客様をセグメント化する
新しい注文が作成されると、お客様の過去6か月の注文合計と注文数を取得し、お客様にタグを追加します。[注文データを取得]、[カウント]、[合計] を使用します。テンプレートを表示する