Flow 的模板变量

将模板变量添加到操作中,以包含工作流中涉及的客户、订单或产品的相关详细信息。

模板变量是在工作流运行时替换为值的占位符。此类变量描述工作流中涉及的客户、订单和产品的属性。例如,订单号、订单价格、客户姓名等都有对应的模板变量。

大多数模板变量的名称都是自描述性的。例如,显示产品名称的模板变量是 {{ product.title }}。发送消息时,此变量将替换为已订购产品的名称:Large Coffee Mug

向操作中添加模板变量

添加模板变量最简单的方法是,单击添加模板变量链接,然后从列表中选择变量。

您可以将模板变量添加到包含添加模板变量链接的任何文本字段:

工作流开发器的特写,其中显示发送电子邮件操作中的添加模板变量链接。

添加模板变量列表中的模板变量将进行筛选,以便您只看到适用于所选触发器的变量。从列表中选择变量后,该变量将被正确格式化并添加到文本框中。

模板变量

适用于创建客户操作的变量:

  • 客户变量
  • 商店变量

适用于库存数量已更改已添加产品操作的变量:

  • 产品变量
  • 商店变量

适用于订单已付款已分析订单风险操作的变量:

  • 订单变量
  • 商店变量

适用于订单已发货操作的变量:

  • 发货变量
  • 订单变量
  • 商店变量

适用于为订单退款操作的变量:

  • 订单变量
  • 退款变量
  • 商店变量

客户变量

下表介绍了与客户相关的模板变量:

模板变量及其描述。
变量名称 描述
customer.acceptsMarketing 客户是否同意接收营销材料。
customer.averageOrderAmountV2.amount 客户每个订单的平均消费额。
customer.canDelete 商家是否可以从商店中删除顾客。
customer.createdAt 将客户添加到商店的日期和时间。
customer.displayName 客户的全名,名字 + 姓氏。
customer.email
customer.firstName
customer.hasNote 客户是否有与自己相关的备注。
customer.hasTimelineComment 商家是否已在客户页面添加关于该客户的时间备注。
customer.id 全局唯一标识符。
customer.lastName
customer.lifetimeDuration 自首次将客户添加到商店以来的时间。
customer.note 由商家撰写的关于客户的备注。
customer.ordersCount 客户使用期内在商店中所下的订单数。
customer.phone
customer.state 客户居住地所在的州或省。
customer.taxExempt 客户的订单是否免税。
customer.totalSpent 客户在所有时期消费的订单总金额。
customer.UpdatedAt 客户上次更新的日期和时间。
customer.verifiedEmail 电子邮件地址格式是否正确。
customer.defaultAddress.address1 地址行 1(街道地址/邮政信箱/公司名称)。
customer.defaultAddress.address2 地址行 2(公寓/套房/单元/大楼)。
customer.defaultAddress.city 城市/区/郊区/城镇/村。
customer.defaultAddress.company 公司/组织/政府。
customer.defaultAddress.country 州/县/省(或直辖市/自治区)/地区。
customer.defaultAddress.countryCode 国家/地区代码(两个字母)。
customer.defaultAddress.firstName 客户的名字。
customer.defaultAddress.formattedArea 逗号分隔的城市、省/直辖市/自治区和国家/地区列表。
customer.defaultAddress.lastName 客户的姓氏。
customer.defaultAddress.latitude 客户地址的纬度坐标。
customer.defaultAddress.longitude 客户地址的经度坐标。
customer.defaultAddress.name 客户姓名,名字 + 姓氏。
customer.defaultAddress.phone 客户的唯一电话号码。
customer.defaultAddress.province 州/县/省(或直辖市/自治区)/地区。
customer.defaultAddress.provinceCode 省或州代码(两个字母)。
customer.defaultAddress.zip 邮编/邮政编码。
customer.image.altText 用于描述图片的本义或内容的字词或短语。
customer.lastOrder.billingAddressMatchesShippingAddress 账单邮寄地址是否与收货地址一致。
customer.lastOrder.buyerAcceptsMarketing 客户是否同意接收营销材料。
customer.lastOrder.canMarkAsPaid 是否可以手动将订单标记为已付款。
customer.lastOrder.cancelReason 取消订单的原因。
customer.lastOrder.capturable 是否可以捕获订单的付款。
customer.lastOrder.cartDiscountAmountSet.shopMoney.amount 订单级别折扣的金额(不包含任何订单项目折扣)。
customer.lastOrder.clientIp 与此订单关联的客户端的 IP 地址。
customer.lastOrder.closed 订单是否已关闭。
customer.lastOrder.confirmed 是否已为该订单保留库存。
customer.lastOrder.currencyCode 下单时商店采用的货币。
customer.lastOrder.customerLocale
customer.lastOrder.discountCode 客户提供的折扣码。
customer.lastOrder.displayFinancialStatus 可以向商家显示的订单的财务状态。
customer.lastOrder.displayFulfillmentStatus 可向商家显示的订单的发货状态。
customer.lastOrder.email 客户提供的电子邮件地址。
customer.lastOrder.fulfillable 是否存在可以发货的产品。
customer.lastOrder.fullyPaid 订单是否已全额付清。
customer.lastOrder.hasTimelineComment 商家是否对订单添加了时间表评论。
customer.lastOrder.landingPageDisplayText
customer.lastOrder.name 订单上显示的订单的唯一标识符。
customer.lastOrder.netPaymentSet.shopMoney.amount 订单的净收款金额,“总收款金额 - 总退款金额”。
customer.lastOrder.note 与订单关联的备注内容。
customer.lastOrder.phone 客户提供的电话号码。
customer.lastOrder.referralCode 客户访问您商店所使用的链接中的营销推荐代码。
customer.lastOrder.referrerDisplayText 将客户引导至您的在线商店的网址。
customer.lastOrder.refundable 订单是否可以退款。
customer.lastOrder.requiresShipping 订单中是否有任何订单产品需要实际配送。
customer.lastOrder.riskLevel 订单的欺诈风险等级。
customer.lastOrder.subtotalPriceSet.shopMoney.amount 订单项目及其折扣的小计(不包含运费、运费折扣和订单级别折扣)。
customer.lastOrder.taxesIncluded 订单小计价格中是否包括税费。
customer.lastOrder.test 订单是否为测试订单。
customer.lastOrder.totalCapturable 订单的授权金额,即未捕获或正在捕获的金额。
customer.lastOrder.totalDiscountsSet.shopMoney.amount 订单折扣总额(包括订单级别和订单项目折扣)。
customer.lastOrder.totalPriceSet.shopMoney.amount 订单总金额(包括税金和折扣)。
customer.lastOrder.totalReceived 客户收到的订单总金额。
customer.lastOrder.totalRefunded 订单退款总额。
customer.lastOrder.totalShippingPrice 配送订单的总费用。
customer.lastOrder.totalTax 适用于订单的所有税金总额。
customer.lastOrder.totalWeight 订单总重量(克)。
customer.lastOrder.unpaid 是否未对订单付款。

发货变量

下表介绍了与发货相关的模板变量:

与发货相关的模板变量的描述。
变量名称 描述
fulfillment.displayStatus 此发货的人类可读显示状态。
fulfillment.id 全局唯一标识符。
fulfillment.name 此发货的人类可读参考标识符。
fulfillment.status
fulfillment.totalQuantity
fulfillment.service.handle 此配送服务的人类可读唯一标识符。
fulfillment.service.inventoryManagement
fulfillment.service.productBased
fulfillment.service.serviceName
order.all_line_items_shippable

订单变量

下表介绍了与订单相关的模板变量:

与订单相关的模板变量的描述。
变量名称 描述
order.billingAddressMatchesShippingAddress 账单邮寄地址是否与收货地址一致。
order.buyerAcceptsMarketing 客户是否同意接收营销材料。
order.canMarkAsPaid 是否可以手动将订单标记为已付款。
order.cancelReason 取消订单的原因。
order.cancelledAt 订单取消的日期和时间。
order.capturable 是否可以捕获订单的付款。
order.cartDiscountAmountSet.shopMoney.amount 订单级别折扣的金额(不包含任何订单项目折扣)。
order.clientIp 与此订单关联的客户端的 IP 地址。
order.closed 订单是否已关闭。
order.closedAt 订单取消的日期和时间。
order.confirmed 是否已为该订单保留库存。
order.createdAt 创建订单的日期和时间。
order.currencyCode 下单时商店采用的货币。
order.customerLocale
order.discountCode 客户提供的折扣码。
order.displayFinancialStatus 可以向商家显示的订单的财务状态。
order.displayFulfillmentStatus 可向商家显示的订单的发货状态。
order.email 客户提供的电子邮件地址。
order.fulfillable 是否存在可以发货的产品。
order.fullyPaid 订单是否已全额付清。
order.hasTimelineComment 商家是否对订单添加了时间表评论。
order.id 全局唯一标识符。
order.customerJourney.lastVisit.landingPageHtml
order.lineItems 一系列订单订单项
order.name 订单上显示的订单的唯一标识符。
order.netPaymentSet.shopMoney.amount 订单的净收款金额,“总收款金额 - 总退款金额”。
order.note 与订单关联的备注内容。
order.phone 客户提供的电话号码。
order.presentmentCurrencyCode 此订单的客户付款货币。
order.processedAt 处理订单的日期和时间。
order.customerJourney.lastVisit.referralCode 客户访问您商店所使用的链接中的营销推荐代码。
order.customerJourney.lastVisit.referralInfoHtml 将客户引导至您的在线商店的网址。
order.refundable 订单是否可以退款。
order.requiresShipping 订单中是否有任何订单产品需要实际配送。
order.riskLevel 订单的欺诈风险等级。
order.subtotalPriceSet.shopMoney.amount 订单项目及其折扣的小计(不包含运费、运费折扣和订单级别折扣)。
order.taxesIncluded 订单小计价格中是否包括税费。
order.test 订单是否为测试订单。
order.totalCapturableSet.shopMoney.amount 订单的授权金额,即未捕获或正在捕获的金额。
order.totalDiscountsSet.shopMoney.amount 订单折扣总额(包括订单级别和订单项目折扣)。
order.totalPriceSet.shopMoney.amount 订单总金额(包括税金和折扣)。
order.totalReceivedSet.shopMoney.amount 客户收到的订单总金额。
order.totalRefundedSet.shopMoney.amount 订单退款总额。
order.totalShippingPriceSet.shopMoney.amount 配送订单的总费用。
order.totalTaxSet.shopMoney.amount 适用于订单的所有税金总额。
order.totalWeight 订单总重量(克)。
order.unpaid 是否未对订单付款。
order.UpdatedAt 上次修改订单的日期和时间。
order.billingAddress.address1 地址行 1(街道地址/邮政信箱/公司名称)。
order.billingAddress.address2 地址行 2(公寓/套房/单元/大楼)。
order.billingAddress.city 城市/区/郊区/城镇/村。
order.billingAddress.company 公司/组织/政府。
order.billingAddress.country 州/县/省(或直辖市/自治区)/地区。
order.billingAddress.countryCodeV2 国家/地区代码(两个字母)。
order.billingAddress.firstName 客户的名字。
order.billingAddress.formattedArea 逗号分隔的城市、省/直辖市/自治区和国家/地区列表。
order.billingAddress.lastName 客户的姓氏。
order.billingAddress.latitude 客户地址的纬度坐标。
order.billingAddress.longitude 客户地址的经度坐标。
order.billingAddress.name 客户姓名,名字 + 姓氏。
order.billingAddress.phone 客户的唯一电话号码。
order.billingAddress.province 州/县/省(或直辖市/自治区)/地区。
order.billingAddress.provinceCode 省或州代码(两个字母)。
order.billingAddress.zip 邮编/邮政编码。
order.publication.name 发布的名称。
order.publication.supportsFuturePublishing 此发布是否支持未来发布。
order.customer.acceptsMarketing 客户是否同意接收营销材料。
order.customer.averageOrderAmountV2.amount 客户每个订单的平均消费额。
order.customer.canDelete 商家是否可以从商店中删除顾客。
order.customer.displayName 客户的全名,名字 + 姓氏。
order.customer.email
order.customer.firstName
order.customer.hasNote 客户是否有与自己相关的备注。
order.customer.hasTimelineComment 商家是否已在客户页面添加关于该客户的时间备注。
order.customer.lastName
order.customer.lifetimeDuration 自首次将客户添加到商店以来的时间。
order.customer.note 由商家撰写的关于客户的备注。
order.customer.ordersCount 客户使用期内在商店中所下的订单数。
order.customer.phone
order.customer.state 客户居住地所在的州或省。
order.customer.taxExempt 客户的订单是否免税。
order.customer.totalSpent 客户在所有时期消费的订单总金额。
order.customer.verifiedEmail 电子邮件地址格式是否正确。
order.customerJourney.customerOrderIndex
order.customerJourney.daysToConversion
order.displayAddress.address1 地址行 1(街道地址/邮政信箱/公司名称)。
order.displayAddress.address2 地址行 2(公寓/套房/单元/大楼)。
order.displayAddress.city 城市/区/郊区/城镇/村。
order.displayAddress.company 公司/组织/政府。
order.displayAddress.country 州/县/省(或直辖市/自治区)/地区。
order.displayAddress.countryCodeV2 国家/地区代码(两个字母)。
order.displayAddress.firstName 客户的名字。
order.displayAddress.formattedArea 逗号分隔的城市、省/直辖市/自治区和国家/地区列表。
order.displayAddress.lastName 客户的姓氏。
order.displayAddress.latitude 客户地址的纬度坐标。
order.displayAddress.longitude 客户地址的经度坐标。
order.displayAddress.name 客户姓名,名字 + 姓氏。
order.displayAddress.phone 客户的唯一电话号码。
order.displayAddress.province 州/县/省(或直辖市/自治区)/地区。
order.displayAddress.provinceCode 省或州代码(两个字母)。
order.displayAddress.zip 邮编/邮政编码。
order.customerJourney.firstVisit.utmParameters.campaign
order.customerJourney.firstVisit.utmParameters.content
order.customerJourney.firstVisit.utmParameters.medium
order.customerJourney.firstVisit.utmParameters.source
order.customerJourney.firstVisit.utmParameters.term
order.physicalLocation.isActive 指示某个位置是否处于活动状态。
order.physicalLocation.name
order.physicalLocation.shipsInventory 指示此位置是否运送库存。
order.shippingAddress.address1 地址行 1(街道地址/邮政信箱/公司名称)。
order.shippingAddress.address2 地址行 2(公寓/套房/单元/大楼)。
order.shippingAddress.city 城市/区/郊区/城镇/村。
order.shippingAddress.company 公司/组织/政府。
order.shippingAddress.country 州/县/省(或直辖市/自治区)/地区。
order.shippingAddress.countryCodeV2 国家/地区代码(两个字母)。
order.shippingAddress.firstName 客户的名字。
order.shippingAddress.formattedArea 逗号分隔的城市、省/直辖市/自治区和国家/地区列表。
order.shippingAddress.lastName 客户的姓氏。
order.shippingAddress.latitude 客户地址的纬度坐标。
order.shippingAddress.longitude 客户地址的经度坐标。
order.shippingAddress.name 客户姓名,名字 + 姓氏。
order.shippingAddress.phone 客户的唯一电话号码。
order.shippingAddress.province 州/县/省(或直辖市/自治区)/地区。
order.shippingAddress.provinceCode 省或州代码(两个字母)。
order.shippingAddress.zip 邮编/邮政编码。
order.shippingLine.custom
order.shippingLine.originalPriceSet.shopMoney.amount
order.shippingLine.shippingRateHandle
order.shippingLine.title
order.suggestedRefund.amountSet.shopMoney.amount
order.suggestedRefund.maximumRefundableSet.shopMoney.amount
order.suggestedRefund.subtotalSet.shopMoney.amount
order.suggestedRefund.totalTaxSet.shopMoney.amount

产品变量

下表介绍了与产品相关的模板变量:

与产品相关的模板变量的描述。
变量名称 描述
product.availablePublicationCount 已在其中发布产品且没有反馈错误的渠道的数量。
product.createdAt 创建产品的日期和时间。
product.defaultCursor 用于分页的默认光标。
product.description 产品的精简描述,删除了 HTML 标签的单行文本。
product.handle
product.hasOnlyDefaultVariant 产品是否只有一个具有默认选项和值的多属性。
product.hasOutOfStockVariants
product.id 全局唯一标识符。
product.isGiftCard
product.publishedAt 产品发布到在线商店的日期和时间。
product.productType
product.publicationCount 发布产品的渠道数量。
product.publishedOnCurrentChannel 检查产品是否已发布到调用应用的频道。
product.templateSuffix
product.title
product.totalInventory
product.totalVariants
product.tracksInventory
product.UpdatedAt 上次修改产品的日期和时间。
product.vendor
product.feedback.summary
product.seo.description SEO 描述。
product.seo.title SEO 标题。
product_variant.availableForSale 指示产品多属性是否可供销售。
product_variant.barcode
product_variant.compareAtPrice
product_variant.defaultCursor 用于分页的默认光标。
product_variant.displayName 多属性的显示名称,基于产品标题和多属性标题。
product_variant.harmonizedSystemCode
product_variant.id 全局唯一标识符。
product_variant.inventoryManagement
product_variant.inventoryPolicy
product_variant.inventoryQuantity 可销售的多属性总数量
product_variant.inventoryQuantityPrior
product_variant.position
product_variant.price
product_variant.requiresShipping
product_variant.sku
product_variant.taxable
product_variant.title
product_variant.weight
product_variant.weightUnit
product_variant.fulfillmentService.handle 此配送服务的人类可读唯一标识符。
product_variant.fulfillmentService.inventoryManagement
product_variant.fulfillmentService.productBased
product_variant.fulfillmentService.serviceName
product_variant.image.altText 用于描述图片的本义或内容的字词或短语。
product_variant.product.availablePublicationCount 已在其中发布产品且没有反馈错误的渠道的数量。
product_variant.product.defaultCursor 用于分页的默认光标。
product_variant.product.description 产品的精简描述,删除了 HTML 标签的单行文本。
product_variant.product.handle
product_variant.product.hasOnlyDefaultVariant 产品是否只有一个具有默认选项和值的多属性。
product_variant.product.hasOutOfStockVariants
product_variant.product.isGiftCard
product_variant.product.productType
product_variant.product.publicationCount 发布产品的渠道数量。
product_variant.product.publishedOnCurrentChannel 检查产品是否已发布到调用应用的频道。
product_variant.product.templateSuffix
product_variant.product.title
product_variant.product.totalInventory
product_variant.product.totalVariants
product_variant.product.tracksInventory
product_variant.product.vendor

退款变量

下表介绍了与退款相关的模板变量:

与退款相关的模板变量的描述。
变量名称 描述
refund.id 全局唯一标识符。
refund.note
refund.restocked
refund.staffMember.active 员工是否处于活跃状态。
refund.staffMember.email
refund.staffMember.exists
refund.staffMember.firstName
refund.staffMember.isShopOwner 用户是否是所有者。
refund.staffMember.lastName
refund.staffMember.name
refund.staffMember.phone

商店变量

下表介绍了与商店相关的模板变量:

与商店相关的模板变量的描述。
变量名称 描述
shop.channelCount 显示渠道数量。
shop.checkoutApiSupported 指定商店是否通过结账 API 支持结账。
shop.currencyCode
shop.customerAccounts
shop.description
shop.email
shop.ianaTimezone
shop.myshopifyDomain
shop.name
shop.limitedPendingOrderCount.count
shop.setupRequired
shop.taxShipping 指定是否对运费收税。
shop.taxesIncluded 指定适用税费是否包含在产品价格中的设置。
shop.weightUnit
shop.billingAddress.address1 地址行 1(街道地址/邮政信箱/公司名称)。
shop.billingAddress.address2 地址行 2(公寓/套房/单元/大楼)。
shop.billingAddress.city 城市/区/郊区/城镇/村。
shop.billingAddress.company 公司/组织/政府。
shop.billingAddress.country 州/县/省(或直辖市/自治区)/地区。
shop.billingAddress.countryCode 国家/地区代码(两个字母)。
shop.billingAddress.firstName 客户的名字。
shop.billingAddress.formattedArea 逗号分隔的城市、省/直辖市/自治区和国家/地区列表。
shop.billingAddress.lastName 客户的姓氏。
shop.billingAddress.latitude 客户地址的纬度坐标。
shop.billingAddress.longitude 客户地址的经度坐标。
shop.billingAddress.name 客户姓名,名字 + 姓氏。
shop.billingAddress.phone 客户的唯一电话号码。
shop.billingAddress.province 州/县/省(或直辖市/自治区)/地区。
shop.billingAddress.provinceCode 省或州代码(两个字母)。
shop.billingAddress.zip 邮编/邮政编码。
shop.countriesInShippingZones.includeRestOfWorld 是否在所有送货区域定义了“世界其他地区”。
shop.features.branding 商店的品牌推广。
shop.features.financialReports
shop.features.harmonizedSystemCode 在产品上显示协调制度代码。跨境运输时用于海关。
shop.features.liveView 是否显示实时视图。实时视图对正在试用或没有店面的商家是隐藏的。
shop.features.shopifyPlus
shop.features.showMetrics 是否显示指标。在指标变得有意义之前,指标对商家是隐藏的。
shop.features.storefront
shop.primaryDomain.host 域名的主机名(例如:example.com)。
shop.primaryDomain.sslEnabled 是否已启用 SSL。
shop.resourceLimits.maxProductOptions 允许的最大产品选项数。
shop.resourceLimits.maxProductVariants 允许的最大多属性数。
shop.resourceLimits.redirectLimitReached 商店是否已达到其可为资源进行的 URL 重定向数量的限制。

LineItem 模板变量

如果您对使用 Shopify Liquid 有丰富的经验,则您可能希望在工作流中使用 Liquid 标签等高级功能。例如,您可以使用 for 循环标签列出订单商品的详细信息,如每个产品订单的名称及其 SKU 和价格。为此,您还需要使用 LineItem 对象。Flow 支持的 LineItem 对象与 Shopify Liquid 文档中描述的对象略有不同。

下表介绍了 LineItem 对象支持的模板变量:

LineItem 对象支持的模板变量的描述。
模板变量 数据类型 描述
canRestock 布尔 订单项目中订购的产品是否可以在退货或订单取消时补货。
discountedTotal 金钱 应用于订单项目的折扣金额。
discountedUnitPrice 金钱 产品多属性在应用每单位折扣后的单价。
fulfillableQuantity 整数 仍待发货的产品多属性数量。此值基于 _quantity - max(refunded_quantity, fulfilled_quantity) - pending_fulfilled_quantity - open_fulfilledquantity
fulfillmentStatus 字符串 订单中的订单项目的发货进度。有效值:已发货null部分发货
姓名 字符串 订购产品的名称。
nonFulfillableQuantity 整数 无法发货的订单产品数。
originalTotal 金钱 订单项目的总价(不含折扣),基于多属性的原始单价乘以订购数量。
originalUnitPriceSet 金钱 未应用折扣的多属性价格。
数量 数字 订购的多属性产品数。
refundableQuantity 整数 订单项目中可退款的项目数量。
requiresShipping 布尔 多属性是否需要进行实物运输。
sku 字符串 多属性 SKU 编号。
taxable 布尔 该多属性是否应该纳税。
标题 字符串 产品或多属性的标题(此字段仅适用于自定义订单产品)。
totalDiscount 金钱 订单折扣总额。包括订单产品折扣和订单级折扣。
unfulfilledDiscountedTotal 金钱
unfulfilledOriginalTotal 金钱
unfulfilledQuantity 整数
variantTitle 字符串 多属性的名称。
供应商 字符串 制造多属性的供应商的名称。

高级功能

如果您是具有 Shopify Liquid 代码编写经验的开发人员,则还可以使用 Liquid 编写模板变量。详细了解 Flow 的 Liquid 支持

示例

查看使用模板变量的消息和备注的示例。

相关链接

准备好开始使用 Shopify 进行销售了吗?

免费试用