ヘルプ
ログイン

お客様データを取得する

お客様データを使用するワークフローでは、「お客様データを取得する」アクションを使用して、ストアからお客様情報を取得できます。

このページの内容

設定

フィールド

「お客様データを取得する」アクションには、クエリを作成するために使用される以下のフィールドが含まれています。

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

クエリ文字列

以下は、過去 1 日間に更新されたお客様を取得するためのクエリの例です。

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

updated_at 変数は、お客様クエリで利用できるフィルターで、複数回使用したり、他の変数と組み合わせたりすることができます。scheduledAt Liquid 変数は、[時間でスケジュール] トリガーを使用したワークフローで利用できます。date_minus Liquid タグは、日付から時間を減算できる Flow の特別なタグです。

データをクエリする際は、以下の点を知っておくと役立ちます。

  • 利用可能なお客様フィルターの一覧
  • クエリは特定の構文に従う必要があります
  • クエリフィールドの値は、必ずしも文書化されているわけではありません。場合によっては、API ドキュメントで値が見つかることがあります。あるいは、管理画面で絞り込みを行う際に、URL でフィールド値が見つかることもよくあります。たとえば、注文クエリの値をいくつか見つけるには、管理画面の [注文管理] ページで絞り込みを行い、URL を確認します。
  • Shopify GraphiQL アプリを使用すると、ストアでクエリを実行またはテストすることができます。
  • クエリが失敗した場合の動作に注意してください。多くの場合、API は結果を何も返さないのではなく、すべての結果を返します。

返されるデータ

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

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

このアクションに続くステップで返されたデータにアクセスするには、お客様のリストである [顧客データを取得] という名前の変数を使用します。この変数は、条件とアクションの両方で使用できます。たとえば、次のように [内部メールを送信] アクションで注文のリストを送信できます。

{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}

トリガー

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

API の詳細

テンプレート

すべてのお客様の顧客メタフィールドをタグに変換する

このワークフローは、メタフィールドの値に基づいて、すべてのお客様にタグをバックフィルします。1 時間ごとに実行され、「processed」タグが付いていないお客様を最大 100 人まで取得します。お客様ごとに、custom.test メタフィールドの値を調べて、それをタグとして追加します。このワークフローでは、「processed」タグも追加されるため、次回のスケジュールされたワークフローの実行で、そのお客様が返されることはありません。このワークフローを使用するには、メタフィールドのネームスペースとキーを、ストアのメタフィールドと一致するように変更する必要があります。テンプレートを表示

アクティブでないお客様を削除する

注文を一度もしたことがない 5 年以上前のお客様を削除します。テンプレートを表示