Shopify Flow 的“客户更新”触发器以及此应用中的客户触发器
Shopify Flow 的“客户更新”触发器可以监听哪些内容,在未发生变更时它何时也会运行,以及哪些客户触发器会在变更前后携带该值。
Flow 的“客户更新”触发器会在客户资料或其地址中的最多五个字段之一发生变化时启动工作流程。正如 Shopify 帮助页面所述:“‘客户更新’触发器仅提供客户及其地址的当前值。”以及“工作流程中无法获取已发生变化的字段的先前值。”
该应用有十一项客户触发器。其中十项在发生某种变更时触发,并记录变更前后的值。特别是“同意”、“电子邮件”和“地址”工作流程,必须知道之前的值才能正常运行。
客户更新后可以观看的内容
截至 2026 年 11 月 20 日,Shopify 帮助页面的字段如下:
| 组 | 字段 |
|---|---|
| 客户 | amountSpent, dataSaleOptOut, defaultAddress, firstName, image, lastName, lastOrder, locale, metafield.value, multipassIdentifier, note, numberOfOrders, productSubscriberStatus, state, tags, taxExempt, taxExemptions, verifiedEmail |
| 电子邮箱地址 | defaultEmailAddress,以及其下方的 marketingOptInLevel、marketingState、marketingUpdatedAt、openTrackingLevel、sourceLocation |
| 电话号码 | defaultPhoneNumber、defaultPhoneNumber.smsMarketingConsent,以及其下方的 optInLevel、sourceLocation、state、updatedAt |
| 地址 | addressesV2,其下方依次为 address1、address2、city、company、countryCodeV2、firstName、lastName、latitude、longitude、phone、provinceCode、zip |
Shopify 该页面补充了以下内容:
- 您至少需选择一个字段,最多可选择五个。一个元字段定义或整个命名空间均计入这五个字段之中。
- “在大多数情况下,对未选中的字段所做的更改不会触发工作流程。”
- Shopify 会将默认电子邮件地址或默认电话号码的整体变更记录下来。如果某个工作流程监听的是嵌套字段(例如
defaultEmailAddress.marketingState),那么即使该嵌套字段未发生变化,该工作流程也会触发。Shopify 建议使用检查该字段值的条件。 - 添加或删除一个地址被视为对该地址的修改,并将触发一个监视“地址”组中某个字段的工作流程。
- 在工作流程运行时,“邮寄地址”变量可能为空,例如当地址被删除时。
逐字段
| 发生了什么变化 | Shopify Flow 的客户信息已更新 | 该应用的触发器 | 工作流程还能带来什么 |
|---|---|---|---|
| 电子邮件营销同意书 | defaultEmailAddress.marketingState、marketingOptInLevel:当前值 |
客户电子邮件营销同意条款已变更 | consentState, optInLevel, consentUpdatedAt, oldConsentState, oldOptInLevel |
| 短信营销同意书 | defaultPhoneNumber.smsMarketingConsent.state、optInLevel:当前值 |
客户短信营销同意条款已变更 | consentState, optInLevel, consentUpdatedAt, oldConsentState, oldOptInLevel |
| 电子邮箱地址 | defaultEmailAddress:新地址 |
客户邮箱已更改 | email, oldEmail |
| 电话号码 | defaultPhoneNumber:新号码 |
客户电话号码已变更 | phone, oldPhone |
| 姓名 | firstName、lastName:新名称 |
客户名称已更改 | firstName, lastName, oldFirstName, oldLastName |
| 默认地址 | defaultAddress:新地址 |
客户地址变更 | address和oldAddress,以及这两个字段的每个部分,均作为独立的字段 |
| 标签 | tags:更改后的标签列表 |
已添加客户标签,已删除客户标签 | addedTags, removedTags, previousTags, currentTags |
| 注 | note:新笔记 |
客户备注已更改 | oldNote, newNote |
| 账户状态 | state:新状态 |
客户状态已更改 | oldState, newState |
| 客户元字段 | metafield.value:新值 |
客户元字段更新 | metafield.value, metafield.previousValue |
| 消费金额、订单数量、最近一次订单、地区、免税信息、其他地址 | 在 Shopify Flow 的列表中 | “客户更新”会在这些更新时触发。该应用的任何触发器都不会保留其旧值。 |
对于标签,Shopify Flow 还提供了专有的“添加客户标签”和“移除客户标签”触发器,其中会列出已添加或已移除的标签。
为什么同意工作流程需要先获取状态
一个同意工作流程必须回答一个问题:该客户是刚刚订阅,还是刚刚取消订阅?仅凭当前状态无法判断。一个当前状态为unsubscribed的客户,可能是刚取消订阅一秒钟,也可能是取消订阅了一年,而且Shopify 自身的页面也指出,即使嵌套的电子邮件或电话字段没有发生变化,基于该字段的工作流程仍可能运行。
“客户电子邮件营销同意状态已变更”和“客户短信营销同意状态已变更”在consentState 旁边会显示 oldConsentState。诸如 oldConsentState 等于 subscribed 且 consentState 等于 unsubscribed 之类的条件,仅在变更发生的那一刻成立一次。可直接使用:当客户取消订阅电子邮件营销时,为其添加标签 和 当客户取消订阅短信营销时,为其添加标签。

还有其他需要提前获取该值的工作流程
当电子邮件地址发生变更时,需向旧地址发送提醒。Customer Email Changed 事件包含 oldEmail 和 email 两个字段。向旧地址发送通知是防范账户被劫持的常见安全措施,这需要一个能够将变量作为收件人的电子邮件操作,例如 Workflow Transactional Email。如果没有 oldEmail,就无人可提醒了。
当客户搬家时,请重新核对税务或运输规定。“客户地址变更”字段包含变更前后的国家和省份信息,因此工作流程仅在国家发生变更时才会触发。
欢迎一位账户已激活的客户。状态变更事件包含oldState和newState,因此该工作流程仅对“从受邀状态变为已启用状态”这一步骤做出响应,而对其他所有状态变更则不予理会。
对自定义状态的一个步骤做出响应。例如,当“忠诚度等级”等元字段从“银”变为“金”时:“客户元字段更新”会携带变更前后的值,因此工作流程可以在客户升级时发送祝贺,而在降级时保持静默。
何时更新客户信息才是正确的选择
- 您可以查看消费金额、订单数量、最近一笔订单、地区信息或免税情况。
- 您可以监控客户的任意地址,而不仅仅是默认地址,也不仅限于添加或删除地址的时刻。
- 只需一个显示当前值的简单提示即可。
两者都可以在同一个商店中运行,且互不干扰。
“客户信息更新”功能会显示之前的电子邮件地址还是之前的同意状态?
不。Shopify 的帮助页面指出,该触发器仅提供客户及其地址的当前值。“客户邮箱变更”触发器携带 oldEmail 字段,而两个同意触发器则携带 oldConsentState 字段。
为什么我的营销领域工作流程仍在运行,尽管同意状态并未发生变化?
Shopify
如何设置仅在客户取消订阅时才触发工作流程?
使用“客户电子邮件营销同意状态已更改”事件,条件为consentState等于unsubscribed;如果仅需对该变更采取行动,则添加oldConsentState等于subscribed。
我可以使用 Shopify Flow 中“添加客户标签”的触发器来代替此应用中的触发器吗?
是的。对于客户而言,Flow 拥有自己的标签触发器,会标注新增或移除的标签名称。该应用的触发器还会记录变更前后的标签列表,并且在订单、商品和订单草稿中均以相同方式运作 - 而 Flow 本身并不提供这些功能。
客户触发器会存储个人数据吗?
只有那四个会比对个人数据(姓名、电子邮箱、电话、地址),且仅在你启用它们时才会进行比对。请参阅权限与数据访问。
下一步
- 客户触发器,分步指南 - 每个自定义触发器均附有示例。
- 新旧值:工作流程能如何利用它们 - 按触发器显示其前后所有值。
- Shopify Flow 的更新版触发器和 Workflow Trigger Extensions - 概述。
