Shopify Flow 更新后的触发器对比新旧值:工作流程能如何利用它们

新旧值:工作流程能如何利用它们

复制页面

Shopify Flow

Flow 自身更新的触发器会将记录的当前状态传递给工作流程。Shopify 的帮助页面针对每个触发器都明确指出:仅提供当前值,变更前的值不可用。对于“发生变更”的警报而言,这样就足够了。

许多工作流程需要比这更多的信息。“价格下跌了10%以上”需要旧价格;“处理程序已更改,请重定向旧URL”需要旧处理程序;“客户已取消订阅”则需要知道该客户之前曾订阅过。 该应用的每个变更触发器都同时携带这两个值,因此这些工作流程仅包含条件和操作两部分,无需编写代码,也无需手动存储任何数据。

前面的值是从哪里来的

该应用会为每个记录记住其监视字段的最后已知值。当Shopify报告更新时,它会进行比对;若监视字段发生变化,则会触发触发器并传入这两个值。实际应用中有两个细节需要注意:

  • 当应用首次检测到一条记录时,它只会将其记下来。此时不会触发任何操作,因为没有可供比较的对象。当您开启某个触发器后,应用会在后台一次性读取您现有的记录,这样一来,第一次真正的变更就会触发相应操作。对于订单,默认会读取最近60天的数据,您可以在应用中扩展该时间范围。
  • 这些值对应于变更发生时的状态。基于“Shopify Flow 更新”触发器的工作流程会在运行时读取该记录。如果一秒后该记录再次发生变化或被删除,该工作流程将看到更新后的状态,或者无法加载该记录。而该应用中的事件则会保留其创建时的值。 您稍后可在该应用的“事件历史记录”中查看这些值。
“事件历史记录”中出现了一条标记为“成功”的事件,其中包含新旧价格
应用中的“事件历史记录”中显示了一条事件:价格变动前后的数值。

只有利用之前的值才能构建的内容

工作流程 触发器 需要旧值的条件 即用型
当产品或产品系列更名时,将旧网址重定向 产品标识符已更改,产品系列标识符已更改 无:重定向从 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 已更改 none: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:客户元字段更新事件携带 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

触发器完整参考指南列出了每个触发器及其所有字段。

数字本身就包含算术运算结果

Flow 仅进行条件比较,不进行计算,且金额数据以文本形式传入 Flow。因此,无法在工作流程中根据两个价格计算出“下跌超过 10%”的结果。因此,价格、单价、成本和库存触发器会将结果以数字形式发送:

字段 含义 示例
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 会提供某个字段的先前值吗?

但该应用的更新触发器并非如此。Shopify 关于“产品更新”、“订单更新”、“客户更新”及其他更新触发器的帮助页面指出,工作流程中仅提供当前值。而该应用的触发器会发送更新前后的值。

我可以在 Shopify Flow 中计算出旧的值吗?

只有在你自己在变更发生前自行存储了该数据的情况下才行,例如通过另一个工作流程将某个值复制到元字段中,然后在后续步骤中读取该值。该副本必须在首次变更之前就已存在,并且对于每一条记录都必须在相应步骤中保留。该应用会对其监视的字段自动进行此类记录管理。

元字段能否获取之前的值?

是的。该应用的每个元字段触发器都会在metafield.value 旁边提供 metafield.previousValue,涵盖 15 种记录类型。请参阅 Shopify Flow 中的元字段变更:更新的触发器与元字段触发器。

为什么在唱片第一次换面时没有任何声音?

该应用需要一个起始点。当触发器被开启时,它会在后台读取一次您现有的记录。在读取操作到达该记录之前所做的更改仅会被记录下来。下一次更改将触发同步。事件历史记录和故障排除 显示了该同步的状态。

下一步