メタフィールド・トリガーの順序
注文のメタフィールドが変更された際に、Shopify Flowのワークフローを開始します。Workflow Trigger Extensionsでその変更を追跡し、変更前の値と変更後の値を取得します。
お客様から、注文完了後にギフトメッセージを追加してほしいというご依頼がサポートへ寄せられました。サポートは、注文のメタフィールド「ギフトメッセージ」(custom.gift_message)にその内容を記入し、梱包チームは荷物が発送される前にその内容を確認する必要があります。
このページでは、Workflow Trigger Extensionsを使用して、注文のメタフィールドが変更された際にShopify Flowワークフローを開始する方法について説明します。手順はこのリソースタイプのすべてのメタフィールドで共通です。例では「ギフトメッセージ」(custom.gift_message)を使用しています。
必要なもの
- メタフィールドの定義です。Shopifyの管理画面で、「設定」>「メタフィールドとメタオブジェクト」>「注文」から作成してください。定義のないメタフィールドは追跡できません。
- 「データへのアクセス」という権限です。アプリの「権限」ページでこの権限を許可してください。詳細は権限とデータへのアクセスをご覧ください。
1. メタフィールドを追跡する
- アプリで「メタフィールドのトリガー」を開き、「トリガーを追加」をクリックしてください。
- リソースの種類として「注文」を選択してください。
- メタフィールド(ここでは「ギフトメッセージ」)にチェックを入れてください。複数の項目に一度にチェックを入れるか、「すべて選択」をご利用いただけます。
- [トリガーの追加] をクリックしてください。
このリソースタイプのすべてのメタフィールド(後で作成するメタフィールドも含む)を追跡するには、個々のメタフィールドにチェックを入れるのではなく、「すべてのメタフィールド」を選択し、次に「すべてのメタフィールドを追跡」をクリックしてください。

新しいトリガーは、アプリが既存の注文にあるメタフィールドの現在の値を読み取っている間は「初期化中」と表示され、その後「アクティブ」となります。この最初の読み取りが行われるため、最初の変更時にはすでに正しい以前の値が反映されているのです。
リストにメタフィールドが含まれていない場合は、「メタフィールド・トリガー」ページにある「メタフィールドを更新」をクリックしてください。アプリは定義のリストを1時間記憶しています。
2. ワークフローが受け取るもの
変更が行われるたびに、Shopify Flow において「メタフィールド Update」トリガーが、以下の値で起動します:
| 変数 | 値 |
|---|---|
resourceType |
ORDER |
resourceId |
注文のIDです。例えば、gid://shopify/Order/1234567890 |
metafieldKey |
名前空間とキー、ここではcustom.gift_messageです |
metafield.value |
新たな価値 |
metafield.previousValue |
変更前の値。メタフィールドが初めて設定された場合は空です。 |
metafield.type |
メタフィールドの型です。例えば、single_line_text_field などです。 |
「注文メタフィールドの更新」は、同じ変更に対する2つ目のトリガーです。これは「メタフィールドの更新」に加えて実行され、注文情報をネイティブなFlow参照として保持するため、Shopify独自の注文アクションを、ルックアップステップを経ずに適用することができます。両者は1つのイベントを共有しているため、両方を使用してもカウントは2回にはなりません。 アプリの「トリガー」ページから有効にするか、このトリガーを使用するワークフローを有効にしてください。
3. ワークフローを構築する
- Shopify Flow でワークフローを作成し、Workflow Trigger Extensionsのトリガー「メタフィールド Update」を選択してください。
- 条件を追加します:
resourceTypeがORDERと等しいこと。メタフィールドの更新は、追跡対象のリソースタイプごとに開始されるため、この条件を設定することで、このワークフローを注文に限定します。そのタイプのメタフィールドを複数追跡している場合は、2つ目の条件として、metafieldKeyがcustom.gift_messageと等しいことを追加してください。 - 必要なアクションを追加してください。この例では、旧値と新値を記載した社内メールを送信します。

例から始めましょう
- このページの下部に添付されている
.flowファイルをダウンロードしてください。 - Shopifyの管理画面で「Shopify Flow」を開き、「インポート」をクリックしてファイルを選択してください。
- 「内部メールを送信」ステップを開き、受信者を入力してください。このファイルには、意図的にアドレスが記載されていません。
- ワークフローを有効にしてください。
自分だけのものにしましょう
- 注文にタグを付ける:「注文タグを追加」アクションを選択し、その注文フィールドに
{{resourceId}}を入力してください。 - 「
metafield.valueが空でない」という条件を追加し、削除されたメッセージが何も送信されないようにします。 - ワークフローでラインアイテムや配送先住所を読み取る必要がある場合は、「注文メタフィールドの更新」を使用してください。
反応の速さ
Shopifyは注文が保存されるとアプリに通知するため、通常、ワークフローは数秒以内に開始されます。
知っておくと便利です
- デフォルトでは、このアプリは過去60日間に作成された注文を監視します。それより古い注文を確認するには、「権限」ページで注文履歴へのフルアクセス権を許可し、アプリの注文履歴設定で期間を長く設定する必要があります。
続きを読む
- メタフィールドのトリガー:すべてのリソースタイプにおけるメタフィールド・トリガーの仕組みについて。
- 注文のメタフィールドが更新された際に、Shopify Flow を実行する:動画付きの具体例です。
- イベント履歴とトラブルシューティング:アプリが送信したすべてのイベントを、旧値と新値とともに確認できます。
