Shopify Flow舊價值與新價值:工作流程能如何運用它們

舊價值與新價值:工作流程能如何運用它們

複製頁面

Shopify Flow

Shopify Flow 自身更新的觸發器會將資料記錄以當前狀態傳遞給工作流程。Shopify 的說明頁面針對每個觸發器都明確指出:僅提供當前值,變更前的值則無法取得。對於「某項內容已變更」的警示而言,這樣就足夠了。

許多工作流程需要的不僅如此。「價格下跌超過 10%」需要舊價格;「處理代號變更,請將舊網址重定向」需要舊處理代號;「客戶取消訂閱」則需要知道該客戶先前曾訂閱過。 此應用程式的每個變更觸發器都會攜帶這兩項值,因此這些工作流程僅需設定條件與動作,無需編寫程式碼,也無需手動儲存任何資料。

前面的數值從何而來

該應用程式會針對每筆記錄,記住其監控欄位的最後已知值。當 Shopify 回報更新時,系統會進行比對;若監控欄位的值有所不同,便會觸發觸發器並傳遞兩個值。實際操作中有兩點細節值得注意:

  • 當應用程式首次偵測到一筆記錄時,它只會將其記下。此時不會觸發任何動作,因為沒有可比對的對象。當您啟用觸發器後,應用程式會在背景中讀取您現有的記錄一次,因此第一次真正的變更就會觸發相應動作。針對訂單,預設會讀取最近 60 天的資料,您可以在應用程式中擴展這個範圍。
  • 這些值屬於變更發生當下的狀態。當工作流程在Shopify Flow的更新觸發器上執行時,會讀取該筆記錄。如果該筆記錄在下一秒再次變更,或是被刪除,該工作流程將看到較新的狀態,或無法載入該筆記錄。此應用程式的事件會保留其建立時的原始值。 您稍後可在應用程式的「事件歷史紀錄」中查看這些值。
「活動記錄」中新增了一項標記為「成功」的活動,其中包含舊價格與新價格
應用程式「活動記錄」中開啟的一項活動:價格變動前與變動後的數值。

唯有運用先前的數值,才能建構出什麼

工作流程 觸發器 需要舊值的條件 即用型
當產品或系列更名時,將舊網址重新導向 產品代號已變更,系列代號已變更 無:重定向從 oldHandle 指向 newHandle 當產品代號變更時,將舊的產品網址進行重定向, 當收藏集識別碼變更時,將舊的收藏集網址重新導向
為價格下跌 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 當庫存數量低於五件時,將產品標記為「庫存不足」

另外還有三種是由商人自行建造的:

  • 當客戶的電子郵件地址變更時,請通知舊的電子郵件地址。Customer Email Changed 事件包含 oldEmail 和 email 兩個參數。請透過將變數設為收件者的電子郵件動作(例如 Workflow Transactional Email),將通知發送至 oldEmail。若未提供舊的電子郵件地址,便無人可收到通知。
  • 針對自訂狀態中的某個階段做出反應。當元資料欄位 loyalty.tier 從 silver 變更為 gold 時:Customer Metafield Update 會攜帶 metafield.previousValue 和 metafield.value,因此工作流程可在客戶升級時送上祝賀,而在降級時則保持靜默。
  • 針對已移除的標籤採取行動。標籤移除後,該記錄的外觀將如同從未擁有過該標籤一般。已移除的標籤包括「訂單」、「客戶」、「產品」及「草稿訂單」標籤。請參閱 當某個特定標籤被新增或移除時,執行工作流程。

根據觸發條件,前後的每個數值

訂單

觸發器 前後對比
新增訂單標籤、移除訂單標籤 addedTags, removedTags, previousTags, currentTags
訂單備註已變更 oldNote, newNote
訂單財務狀態已變更 oldFinancialStatus, newFinancialStatus
訂單處理方式已變更 oldFulfillmentStatus、newFulfillmentStatus,以及 changes.items 中每筆訂單或每批貨件的狀態:已出貨、未出貨、追蹤資訊已更新(包含編號、網址及公司名稱)
訂單顯示狀態已變更 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,兩者也各自作為獨立的欄位
客戶電子郵件行銷同意事項已變更,客戶簡訊行銷同意事項已變更 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清單保持不變
十項草案順序觸發條件 與訂單相同的結構:標籤、備註、屬性、明細項目、狀態、電子郵件及地址
15 種記錄的元資料欄位更新 metafield.value, metafield.previousValue

扳機完整參考指南 列出了每個觸發器及其所有欄位。

數字已包含計算結果

Shopify Flow 的條件僅進行比對,不會進行計算,且金額在 Shopify Flow 中以文字形式傳入。因此,無法在工作流程中根據兩個價格來計算「下跌超過 10%」。因此,價格、單價、成本和庫存觸發器會將結果以數字形式傳送:

領域 意思 範例
delta 新值減去舊值 -5
percentChange 變動值佔原值的百分比 -12.5 表示下降了 12.5 百分比
direction increase、decrease 或 unchanged decrease
Shopify Flow
Shopify Flow 選取器中的「產品變體價格變更」變數。
Shopify Flow 條件:priceChange.percentChange 小於 -10
這是應用程式計算出的百分比所滿足的條件。無需進行任何程式碼步驟。
Shopify Flow 會提供某個欄位的先前值嗎?

但若使用該應用程式自訂的更新觸發器則不然。Shopify 針對「產品更新」、「訂單更新」、「客戶更新」及其他更新觸發器的說明頁面指出,工作流程中僅提供當前值。而此應用程式的觸發器則會傳送更新前與更新後的值。

我可以在 Shopify Flow 中計算出舊的數值嗎?

只有當您在變更發生前自行儲存了該資料時才適用,例如透過另一個工作流程將值複製到元資料欄位中,並在後續讀取該值。該副本必須在首次變更發生前就已存在,並且對於每筆記錄都必須在步驟中保留。該應用程式會針對其監控的欄位自動執行這項記錄管理。

元字段是否可取得前一個值?

是的。此應用程式的每個元欄位觸發器,除了 metafield.value 之外,還會攜帶 metafield.previousValue,適用於 15 種記錄類型。請參閱 Shopify Flow 中的元欄位變更:更新的觸發器與元欄位觸發器。

為什麼在唱片第一次換面時,沒有任何聲音傳出?

此應用程式需要一個起點。當觸發器被啟用時,它會在背景中讀取您現有的記錄一次。在該讀取操作觸及該記錄之前所做的變更,僅會被記錄下來。下一次變更便會觸發。事件歷史紀錄與疑難排解 會顯示該同步的狀態。

後續步驟