Shopify Flowの更新されたトリガーの比較新旧の値:ワークフローでそれらをどのように活用できるか

新旧の値:ワークフローでそれらをどのように活用できるか

ページをコピーする

Shopify Flow

Flow独自の更新済みトリガーは、ワークフローにレコードの現在の状態をそのまま渡します。Shopifyのヘルプページには、各トリガーについて次のように記載されています。利用可能なのは現在の値のみであり、変更前の値は利用できません。何かが変更されたことを通知するアラートとしては、それで十分です。

多くのワークフローでは、それ以上の情報が必要となります。「価格が10%以上下落した」というケースでは、以前の価格が必要です。「ハンドルが変更されたため、以前のURLにリダイレクトする」というケースでは、以前のハンドルが必要です。「お客様が購読を解除した」というケースでは、そのお客様が以前に購読していたことを把握しておく必要があります。 このアプリの変更トリガーにはいずれも両方の値が含まれているため、これらのワークフローは条件とアクションだけで構成されており、コードも不要で、手動で何かを保存する必要もありません。

前の値はどこから来ているのでしょうか

このアプリは、監視対象のフィールドについて、レコードごとに最後に確認された値を記憶しています。Shopifyから更新情報が報告されると、その値を比較し、監視対象のフィールドに違いがある場合は、両方の値を指定してトリガーを発動します。実際に運用する上で重要な点は2つあります:

  • アプリがレコードを初めて検出した際は、単にそのレコードを記憶するだけです。比較対象がないため、何もトリガーされません。トリガーを有効にすると、アプリはバックグラウンドで既存のレコードを一度読み込むため、最初の実際の変更で既にトリガーが作動します。注文については、デフォルトで過去60日分のデータが読み込まれますが、アプリ内でその期間を延長することも可能です。
  • 値は変更が行われた時点のものです。「Flow更新」トリガーに基づくワークフローは、ワークフローの実行時にレコードを読み取ります。1秒後にレコードが再度変更されたり、削除されたりした場合、そのワークフローは新しい状態を認識するか、レコードの読み込みに失敗します。このアプリのイベントは、作成時の値を保持します。 これらの値は、後でアプリの「イベント履歴」で確認することができます。
「イベント履歴」に、成功とマークされたイベントが追加され、旧価格と新価格が記載されています。
アプリの「イベント履歴」に表示された1つのイベント:変更前後の価格です。

前の値を使ってのみ構築できるもの

ワークフロー トリガー 以前の値が必要な条件 すぐにご使用いただけます
商品やコレクションの名前が変更された際に、旧URLをリダイレクトする 製品のハンドルが変更されました、コレクションのハンドルが変更されました なし:リダイレクトはoldHandleからnewHandleへ行われます 商品のハンドルが変更された際に、旧商品のURLをリダイレクトする, コレクションハンドルが変更された際に、古いコレクションのURLをリダイレクトする
価格が10%以上値下がりした商品にタグを付ける 商品バリエーションの価格が変更されました priceChange.percentChangeが-10以下である バリエーションの価格が10%以上値下がりした際に、商品にタグを付ける
商品を「セール中」として表示し、その表示を解除する 商品バリエーションの価格が変更されました priceChange.oldCompareAtPrice.amountが空で、priceChange.newCompareAtPrice.amountが空でない場合、またはその逆の場合 「割引前価格」が追加された場合は、商品を「セール中」としてタグ付けしてください, 「割引前価格」が削除された場合は、セールタグを削除してください
保留中の支払いが到着したら、注文を確定してください 注文の財務状況が変更されました oldFinancialStatusがpendingであり、newFinancialStatusがpaidである場合 未決済の支払いを受け取った際に注文にタグを付ける
チェックアウト後に住所が変更された場合は、倉庫にその旨を連絡してください 注文の配送先住所が変更されました なし:メッセージにはoldShippingAddressとshippingAddressが表示されます チェックアウト後に配送先住所が変更された場合の注文のタグ付け
購読を解除したお客様にはタグを付け、戻ってきた際にはタグを外してください お客様へのメールマーケティングに関する同意内容の変更 consentStateがunsubscribedとなっています。oldConsentStateには、それ以前の状態が記録されています。 お客様がメールマーケティングの配信登録を解除した際には、そのお客様にタグを付けましょう
ERPやフィード用に、以前のSKUを引き続き使用してください 商品バリエーションSKUが変更されました なし:skuChange.oldSkuがメタフィールドに書き込まれます バリエーションSKUが変更された際、以前のSKUを保存する
コストが上昇した際の利益率を見直してください 商品バリエーションの価格が変更されました variantCostChange.percentChangeが5より大きい バリエーションの原価が上昇した際は、利益率の見直し対象として商品にタグを付けてください
在庫が基準値を下回った時点で、その商品を一度だけ「在庫少」としてタグ付けしてください ロケーションにおける在庫数量が変更されました inventoryLevel.oldAvailableが5以上であり、かつinventoryLevel.newAvailableが5未満である 在庫が5を下回った場合、その商品を「在庫少」としてタグ付けしてください

マーチャントたちが自ら建造するものが、さらに3つあります:

  • お客様のメールアドレスが変更された際は、旧アドレスをお知らせください。「Customer Email Changed」イベントには、oldEmailとemailが含まれています。変数を宛先として指定できるメールアクション(例:Workflow Transactional Email)を使用して、oldEmail宛てに通知を送信してください。旧アドレスがなければ、通知を送る相手がなくなってしまいます。
  • 削除されたタグについて処理を行います。タグが削除されると、そのレコードは、そもそもそのタグが存在しなかったかのように見えます。「Order」、「Customer」、「Product」、「下書き注文」の各タグが削除された場合、これらは「削除されたタグ」として指定されます。特定のタグが追加または削除されたときにワークフローを実行する を参照してください。

トリガーごとに、その前後のすべての値

注文

トリガー 「前」と「後」
注文タグの追加、注文タグの削除 addedTags, removedTags, previousTags, currentTags
注文メモが変更されました oldNote, newNote
注文の財務状況が変更されました oldFinancialStatus, newFinancialStatus
注文のフルフィルメントの変更 oldFulfillmentStatus、newFulfillmentStatus、およびchanges.items内の各行または各出荷について:「履行済み」、「未履行」、追跡情報が更新され、追跡番号、URL、および会社が記載されています
注文の表示ステータスが変更されました oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus
注文の属性が変更されました changes.items(changeType、key、oldValue、newValueを含む)
注文明細の変更 changes.itemsには、changeType(追加、削除、数量、価格、またはバリエーションの変更)と、変更前後の数量、価格、バリエーションが含まれます
注文の配送先住所が変更されました shippingAddressとoldShippingAddressも、それぞれ個別のフィールドとして
メタフィールドの更新順序 metafield.value, metafield.previousValue
注文の進捗状況 changes.fieldsおよびchanges.itemsには、財務状況、フルフィルメント状況、タグ、メモ、ラインアイテム、およびカスタム属性について、field、oldValue、newValueが含まれています

お客様

トリガー 「前」と「後」
お客様タグの追加、お客様タグの削除 addedTags, removedTags, previousTags, currentTags
お客様メモが変更されました oldNote, newNote
お客様の状態が変更されました oldState, newState
お客様のお名前が変更されました firstName, lastName, oldFirstName, oldLastName
お客様のメールアドレスが変更されました email, oldEmail
お客様の電話番号が変更されました phone, oldPhone
お客様の住所が変更されました addressとoldAddressも、それぞれ個別のフィールドとして
お客様へのメールマーケティングに関する同意内容が変更されました。お客様へのSMSマーケティングに関する同意内容が変更されました。 consentState, optInLevel, oldConsentState, oldOptInLevel
お客様メタフィールドの更新 metafield.value, metafield.previousValue
お客様への最新情報 タグ、メモ、ステータスに関するchanges.fieldsおよびchanges.items

製品とバリエーション

トリガー 「前」と「後」
商品タグの追加、商品タグの削除 addedTags, removedTags, previousTags, currentTags
「商品名」、「ハンドル」、「説明」、「ステータス」、「ベンダー」、「タイプ」が変更されました 古い値と新しい値、例えばoldTitleとnewTitle
チャンネルに公開された商品、チャンネルから非公開になった商品 channels.added, channels.removed, channels.current
商品バリエーションの価格が変更されました priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction
商品バリエーションの単価が変更されました unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction
商品バリエーションの価格が変更されました variantCostChange.oldCost, newCost, delta, percentChange, direction
商品バリエーションSKUが変更されました skuChange.oldSku, newSku
商品バリエーションのバーコードが変更されました barcodeChange.oldBarcode、newBarcode、新旧のバーコード一覧、added、removed
商品のメタフィールドの更新、商品バリエーションのメタフィールドの更新 metafield.value, metafield.previousValue
製品の更新情報 changes.fieldsおよびchanges.itemsには、タイトル、ハンドル、説明、ステータス、ベンダー、商品タイプ、タグが含まれます。また、各バリエーションごとに、価格、割引前価格、SKU、バーコード、在庫ポリシー、課税対象、タイトル、オプション、画像が含まれます。

在庫、コレクション、ロケーションなど

トリガー 「前」と「後」
各ロケーションにおける在庫数の変動、品切れ、および再入荷について inventoryLevel.oldAvailable、newAvailable、delta、percentChange、direction、およびロケーション
コレクションのタイトル、ハンドル、および説明が変更されました 以前の値と新しい値
ロケーションの更新、会社の更新、会社のロケーションの更新、ディスカウント情報の更新、ブログの更新、ブログ記事の更新、ページの更新 レコードのchanges.fieldsとchanges.itemsは、常に
コレクションの更新、下書き注文の更新、マーケットの最新情報 changesリストは同じですが、「新旧の値を送信」がオンになっている場合
下書き注文を決定する10の要因 注文と同じ構成:タグ、メモ、属性、ラインアイテム、ステータス、メールアドレス、住所
15種類のレコードに対するメタフィールドの更新 metafield.value, metafield.previousValue

トリガーの完全なリファレンスには、すべてのトリガーとそのすべてのフィールドが一覧表示されています。

数値には、すでに算術演算が施されています

Flowでは条件の比較は行いますが、計算は行いません。また、金額はテキストとしてFlowに送信されます。そのため、「10%以上下落した」といった条件は、2つの価格情報からワークフロー内で算出することはできません。したがって、価格、単価、原価、在庫のトリガーは、結果を数値として送信します:

フィールド 意味 例
delta 新しい値から古い値を引いた値 -5
percentChange 旧値に対する変化率 -12.5は、12.5パーセント減少したことを意味します
direction increase、decrease、またはunchanged decrease
Shopify Flowの「商品バリエーション価格変更」用バリアブルピッカー(oldPrice、newPrice、delta、percentChange、direction)
Shopify Flowのピッカーにおいて、「商品バリエーションの価格」の変数が変更されました。
Shopify Flow 条件:priceChange.percentChange が -10 未満である
アプリが算出した割合に関する条件です。コードの記述は不要です。
Shopify Flowでは、フィールドの以前の値を取得することはできますか?

このアプリ独自の更新トリガーではそうではありません。「Product updated」、「Order updated」、「Customer updated」およびその他の更新トリガーに関するShopifyのヘルプページによると、ワークフロー内で利用可能なのは現在の値のみとのことです。一方、このアプリのトリガーでは、変更前と変更後の両方の値が送信されます。

Shopify Flow内で以前の値を算出することはできますか?

変更前に、ご自身で保存しておいた場合に限ります。例えば、別のワークフローで値をメタフィールドにコピーし、それを読み戻すといった方法です。そのコピーは、最初の変更が行われる前に存在しており、すべてのレコードについて各ステップで保持されている必要があります。このアプリは、監視対象のフィールドについて、このような管理を行っています。

メタフィールドでは、以前の値を利用することはできますか?

はい。このアプリのすべてのメタフィールド・トリガーでは、metafield.value のほかに、15 種類のレコードについて metafield.previousValue が含まれています。Shopify Flowにおけるメタフィールドの変更点:更新されたトリガーとメタフィールド・トリガー をご覧ください。

レコードの最初の切り替え時に、なぜ何も動作しなかったのでしょうか?

このアプリには開始点が必要です。トリガーがオンになると、バックグラウンドで既存のレコードを一度読み込みます。その読み込みがレコードに反映される前に加えられた変更は、単に記録されるだけです。次の変更でトリガーが作動します。イベント履歴とトラブルシューティングには、その同期の状態が表示されます。

今後の手順