メタフィールドのトリガー
10種類のオーナータイプにわたるメタフィールドの変更をトリガーとして、Shopify Flowのワークフローを実行します。これには、注文、商品、およびお客様のバリエーション(タイプ指定済み)が含まれます。
メタフィールドのトリガーは、10種類のオーナータイプのいずれかにおいて、特定のメタフィールドの定義が変更された際に発動します。監視対象のメタフィールドは、1つの定義ずつ選択するため、数百ものメタフィールドを持つストアであっても、ワークフローが関与するメタフィールドについてのみトリガーが発動することになります。
サポートしている所有者タイプ
商品、商品バリエーション、コレクション、お客様、注文、会社、会社ロケーション、ブログ、ブログ記事、およびページ。
セットアップする方法
このページの例では、「Rating」(custom.rating)という製品メタフィールドを監視しています。これは、レビューアプリが書き込むような値です。
1. メタフィールドを選択してください
- アプリのナビゲーションで「**メタフィールドのトリガー」**を開いてください。
- [トリガーの追加] をクリックしてください。
- メタフィールドが属するリソースタイプ(例:Product)を選択してください。
- リストからメタフィールドの定義を選択してください(数が多ければ名前で検索してください)。その後、「**トリガーを追加」**をクリックしてください。
定義が設定されているメタフィールドのみが表示されます(Shopify管理画面、[設定]、[カスタムデータ])。このリストは1時間のみ保持されるため、先ほど作成した定義が表示されない場合があります。「トリガーの追加」の横にある「メタフィールドを更新」をクリックし、ダイアログを再度開いてください。

2. メタフィールドが監視対象になりました
このメタフィールドは、リストに「有効」として表示されます。他に有効にする設定はありません。ここに追加するだけで有効_になります_。**削除すると、**そのメタフィールドの監視が停止します。
このアプリはまず、既存のレコードにあるそのメタフィールドの現在の値を記録します。そのため、最初の編集操作の時点で、すでに正しい以前の値が反映されます。

3. イベントが持つもの
それ以降、そのメタフィールドに対するすべての編集操作により、Shopify Flow で**「Metafield Update」**イベントが発生します。このイベントには、名前空間とキー、該当するレコード、新しい値、および previousValue(メタフィールドの以前の値)が含まれます。メタフィールドが初めて設定された直後は、previousValue は空になります。 これには、レコードの作成時にすでに値が入力されているメタフィールドも含まれます。例えば、フォームによって作成されたお客様で、その回答がメタフィールドに保存されている場合などです。この場合、イベントは一度だけ発生し、previousValueは空になります。
この例では、評価が4.5から2.5に下がりました。ワークフローの条件「値が3未満で、かつ以前の値が3以上」は、その後の編集のたびにトリガーされるのではなく、評価が3を下回った瞬間に1回だけトリガーされます。手順の詳細はこちら:メタフィールドのトリガー、手順を追って。

ジェネリックなトリガーと型指定されたトリガー
メタフィールドの変更を反映するには、2つの方法があります:
| トリガー | 表紙 | 提供します |
|---|---|---|
| メタフィールドの更新 | 10種類の所有者タイプすべて | 名前空間、キー、所有者ID、旧値および新値 |
| メタフィールドの更新順序 | 注文のみ | 上記に加え、ネイティブのShopify Flow参照としての順序も含まれます |
| 製品のメタフィールドの更新 | 商品のみ | 上記に加え、ネイティブ参照としての製品も含まれます |
| お客様メタフィールドの更新 | お客様限定 | 上記に加え、お客様をネイティブレファレンスとして指定します |
| 商品バリエーションのメタフィールドの更新 | 商品バリエーションのみ | 上記に加え、親製品をネイティブレファレンスとして指定します |
ワークフローでリソース自体に対して操作を行う必要がある場合(たとえば、注文にタグを付けたり、そのラインアイテムを読み取ったりする場合など)は、型指定されたトリガーを使用してください。ネイティブ参照により、Shopify Flowはルックアップステップを経ることなく、独自のShopifyアクションをそのリソースに対して直接実行できます。
値が変更されたことを単に把握したい場合や、型指定されたバリエーションを持たないオーナー型を監視している場合は、汎用トリガーを使用してください。
各タイプ別のトリガーには、「トリガー」ページにそれぞれ独自のスイッチがあり(そのトリガーを使用するShopify Flowワークフローを有効にすると、そのトリガーも有効になります)、汎用トリガー_に加えて_発動します。これらは1つのイベントを共有しているため、両方を有効にしても、上限の消費量は2倍にはなりません。
ガイド
- 注文のメタフィールドが更新された際に、Shopify Flow を実行する
- 製品のメタフィールドが変更された際にShopify Flowをトリガーする
- 顧客のメタフィールドが更新された際に、Shopify Flow を実行する
- メタフィールドのトリガー、手順を追って - 5つのメタフィールド・トリガーそれぞれについて、具体的な例が掲載されています。
