基于 Shopify 的客户细分筛选条件

使用此参考指南了解用于基于默认 Shopify 筛选条件创建客户细分的筛选条件名称、运算符和值。

弃单日期

abandoned_checkout_date

按上次弃单日期来包含客户。

运算符 确切日期:=
不在该日期:!=
在该日期或之前:<=
在该日期之前:<
在该日期或之后:>=
在该日期之后:>
介于日期之间:BETWEEN <date1> AND <date2>
不存在:IS NULL存在 IS NOT NULL
格式 绝对日期:YYYY-MM-DD
日期偏移量示例:-4w-10y
指定日期:
  • 今天: = today
  • 昨天: = yesterday
  • 过去 7 天: >= 7_days_ago
  • 过去 30 天: >= 30_days_ago
  • 过去 90 天: >= 90_days_ago
  • 过去 12 个月: >= 12_months_ago
指定日期是默认值,无法更改。对于自定义日期,请使用日期偏移量
示例

包含上次弃单发生在过去一周的客户: abandoned_checkout_date >= 7_days_ago

包含上次弃单发生在过去八个月的客户: abandoned_checkout_date > -8m

备注 日期值基于完整天数,并且取决于您商店所在的时区。

周年日

anniversary()

按与日期参数关联的活动日期来包含客户。

函数参数 date(必需):使用此参数指定要筛选的活动。
运算符 确切日期:=
在两个日期之间:BETWEEN <date1> AND <date2>
格式 绝对日期:YYYY-MM-DD
日期偏移量示例:+4w+3m
指定日期:
  • 今天: = today
  • 在未来 7 天内: BETWEEN today AND +7d
  • 在未来 30 天内: BETWEEN today AND +30d
示例

包含未来 30 天内过生日的客户:
anniversary(date: 'metafields.facts.birth_date') BETWEEN today AND +30d

备注
  • 使用绝对日期时,年份不会用作细分条件。
  • 日期值基于完整天数,并且取决于您商店所在的时区。
  • 若要筛选出生日期,您需要启用 facts.birth_date 标准元字段或创建自己的自定义元字段。详细了解如何添加标准元字段创建自定义元字段定义

消费金额

amount_spent

根据客户在您商店中花费的金额来包含客户。

运算符 等于:=
不等于:!=
大于:>
小于:<
小于或等于:<=
大于或等于:>=
介于: BETWEEN
格式 数值范围:# AND #
编号:#
小数:小数点 (.) 用作小数分隔符。
不接受千位分隔符,例如逗号或空格。
不接受特定于语言的数值格式。
示例 包含在您商店中的花费金额为 1 到 999.99 的客户:
amount_spent BETWEEN 1 AND 999.99
备注
  • 使用的货币基于为您商店选择的货币。请勿通过输入货币符号来指定使用哪种货币。
  • BETWEEN 同时包含开始值和结束值。例如,amount_spent BETWEEN 1 AND 100 表示包含花费金额为 1 到 100 的客户。

城市

customer_cities

包含地址位于指定城市的客户。拥有多个地址的客户可能会包含在使用此筛选条件的多个客户细分中。

运算符 包含此确切城市:CONTAINS
不包含此确切城市:NOT CONTAINS
不存在:IS NULL
存在: IS NOT NULL
格式 countryCode-regionCode-cityCode
示例 包含地址位于纽约市的客户:
customer_cities CONTAINS 'US-NY-NewYorkCity'
备注 若要查找城市,您可以开始键入城市名称,然后从显示的列表中选择相应的值。

公司

companies

包括已配置为 B2B 客户的公司的客户。

运算符 包含此确切公司 ID:CONTAINS
不包含此确切公司 ID:NOT CONTAINS
不存在:IS NULL
存在: IS NOT NULL
公司 ID
格式
示例 是 B2B 客户:
companies NOT NULL
不是 B2B 客户:
companies NULL
包括隶属于特定公司的客户:
companies CONTAINS 3778915041302
备注
  • 创建客户细分时,您可以从显示的列表中按名称选择公司。或者,您可以键入公司的标题,然后从列表中选择它。
  • 公司 ID(而不是公司名称)会输入到代码中。将光标悬停在公司 ID 上时,会显示公司名称。

国家或地区

customer_countries

包含地址位于指定国家或地区的客户。拥有多个地址的客户可能会包含在使用此筛选条件的多个客户细分中。

运算符 包含此确切地点:CONTAINS
不包含此确切地点:NOT CONTAINS
不存在:IS NULL
存在: IS NOT NULL
使用 ISO 的两个字母的国家/地区代码。
格式
示例 包含地址位于美国的客户:
customer_countries CONTAINS 'US'
备注 若要查找某个国家/地区,您可以开始输入该国家/地区的名称,然后从显示的列表中选择相应值。

客户账户状态

customer_account_status

包含具有指定客户账户状态的客户。

运算符 等于:=
不等于: !=
已拒绝:'DECLINED' 已邀请客户创建账户,但被拒绝。
已禁用:'DISABLED' 客户尚未创建账户。
已启用:'ENABLED' 客户已创建账户。
已邀请:'INVITED' 已邀请客户创建账户。
格式
示例 包含受邀创建账户但已拒绝的客户:
customer_account_status = 'DECLINED'
备注

添加客户的日期

customer_added_date

根据将客户添加到您商店的日期来包含客户。

运算符 确切日期:=
不在该日期:!=
在该日期或之前:<=
在该日期之前:<
在该日期或之后:>=
在该日期之后:>
介于日期之间: BETWEEN <date1> AND <date2>
格式 绝对日期:YYYY-MM-DD
日期偏移量示例:-4w-10y
指定日期:
  • 今天: = today
  • 昨天: = yesterday
  • 过去 7 天: >= 7_days_ago
  • 过去 30 天: >= 30_days_ago
  • 过去 90 天: >= 90_days_ago
  • 过去 12 个月: >= 12_months_ago
指定日期是默认值,无法更改。对于自定义日期,请使用日期偏移量。
示例

包含过去一周内添加的客户:
customer_added_date >= 7_days_ago

包含过去八个月内添加的客户:
customer_added_date > -8m

包含在特定日期范围内添加的客户:
customer_added_date BETWEEN 2022-12-01 AND 2022-12-31

备注 日期值基于完整天数,并且取决于您商店所在的时区。

客户邮箱域名

customer_email_domain

包含邮箱属于指定域名的客户。域名是邮箱中 @ 符号之后的部分,例如 gmail.com

运算符 等于:=
不等于:!=
不存在:IS NULL
存在: IS NOT NULL

以下域名仅供参考。您还可以使用这些域名以外的域名。您可以手动输入任何其他有效的域名。

gmail.com:'gmail.com'
yahoo.com:'yahoo.com'
hotmail.com:'hotmail.com'
aol.com:'aol.com'
msn.com:'msn.com'
live.com:'live.com'
outlook.com:'outlook.com'
yahoo.ca: 'yahoo.ca'
格式
示例 包含其邮箱域名为 shopify.com 的客户:
customer_email_domain = 'shopify.com'
备注

客户语言

customer_language

根据客户用于与您商店沟通的语言来包含客户。

运算符 等于:=
不等于:!=
不存在:IS NULL
存在: IS NOT NULL
使用 ISO 639-1 的两个字母的语言代码。
格式

以下值是一些常见 ISO 语言代码的示例。您的数据不仅限于这些语言代码。您可以手动输入任何其他有效的语言代码,但在客户数据中仅提供编辑器中显示的建议值。

英语:'en'
法语:'fr'
西班牙语:'es'
德语:'de'
意大利语:'it'
日语:'ja'
俄语: 'ru'
示例

包含用英语与您商店进行沟通的客户:
customer_language = 'en'

排除使用加拿大英语与您商店进行交流的客户:
customer_language != 'en‑CA'

备注
  • 您可以将区域 ISO 代码添加到值中,以指定该语言的一种方言。例如,您可以对美国使用 'en‑US',对英国使用 'en‑GB',或者对葡萄牙使用 'pt‑PT',以及对巴西使用 'pt‑BR'
  • 如果仅指定了语言前缀,则筛选条件值将用作通配符。例如,如果筛选条件值为 'en',则结果中将包含语言设置为 'en' 的客户以及语言设置为 'en‑GB''en‑CA' 等的客户。

客户标签

customer_tags

根据客户标签来包含客户。

运算符 包含此确切标记:CONTAINS
不包含此确切标记:NOT CONTAINS
不存在:IS NULL
存在: IS NOT NULL
客户标签的名称。
格式
示例 包含具有 GoldStatus 标签的客户:
customer_tags CONTAINS 'GoldStatus'
备注

标签不区分大小写。

详细了解标签及其注意事项

电子邮件事件

shopify_email.EVENT()

根据所选电子邮件事件来包含相应客户。受支持的事件 (EVENT) 如下所示:

  • 已回弹:bounced
  • 已点击:clicked
  • 已送达:delivered
  • 已标记为垃圾邮件:marked_as_spam
  • 已打开:opened
  • 已取消订阅:unsubscribed
函数参数 activity_id(可选):使用此参数选择要筛选的营销活动 ID。
since(可选):使用此参数指定事件的开始日期。
until(可选):使用此参数指定事件的结束日期。
运算符 等于:=
不等于:!=
truefalse
格式 activity_id 支持的格式:
  • ID(一个值)
  • List <ID>:一组具有含点“OR”的值。List 是一组括在括号中的以逗号分隔的值。例如:(1, 2, 3)。列表中的活动 ID 限制为 500 个。

    sinceuntil 支持的 Date 格式如下:
    • 绝对日期: YYYY-MM-DD
    • 日期偏移量示例:-4w-10y
    • 指定日期:
      • 今天: = today
      • 昨天: = yesterday
      • 过去 7 天: >= 7_days_ago
      • 过去 30 天: >= 30_days_ago
      • 过去 90 天: >= 90_days_ago
      • 过去 12 个月: >= 12_months_ago
  • 示例 使用 =!= 运算符指定电子邮件事件是否已发生:
    shopify_email.opened(activity_id: 135195754518) = false
    shopify_email.opened(activity_id: 135195754518) != true

    使用参数 activity_id 指定要筛选的营销活动 ID:
    shopify_email.delivered(activity_id: 135195754518) = true

    使用参数 since 指定电子邮件事件的开始日期:
    shopify_email.delivered(activity_id: 135195754518, since: 2022-01-01) = false

    使用参数 until 指定电子邮件事件的结束日期:
    shopify_email.delivered(activity_id: 135195754518, until: 2022-01-01) = true

    使用参数 sinceuntil 指定电子邮件事件的开始日期和结束日期:
    shopify_email.bounced(activity_id: 135195754518, since: 12_months_ago, until: today) = false
    备注
    • 使用 activity_id 参数创建客户细分时,您可从显示的列表中按名称选择营销活动。
    • 缺少 sinceuntil 参数意味着将筛选所有时间的结果,而没有设定的开始日期或结束日期。
    • 缺少 activity_id 意味着您的筛选范围包括所有 Shopify 电子邮件活动。

    电子邮件订阅状态

    email_subscription_status

    根据客户是否订阅您的营销电子邮件来包含客户。

    运算符 等于:=
    不等于:!=
    不存在:IS NULL
    存在: IS NOT NULL
    未订阅:'NOT_SUBSCRIBED' 客户尚未订阅您的营销电子邮件。
    已订阅:'SUBSCRIBED' 客户已订阅您的营销电子邮件。
    待处理:'PENDING' 客户正在订阅您的营销电子邮件。
    无效:'INVALID' 客户的邮箱营销状态无效。
    格式
    示例 包含已订阅您的电子邮件营销的客户:
    email_subscription_status = 'SUBSCRIBED'
    备注

    上次订购日期

    last_order_date

    包含在指定日期下最后一单的客户。

    运算符 确切日期:=
    不在该日期:!=
    在该日期或之前:<=
    在该日期之前:<
    在该日期或之后:>=
    在该日期之后:>
    介于日期之间:BETWEEN <date1> AND <date2>
    不存在:IS NULL存在 IS NOT NULL
    格式 绝对日期:YYYY-MM-DD
    日期偏移量示例:-4w-10y
    指定日期:
    • 今天: = today
    • 昨天: = yesterday
    • 过去 7 天: >= 7_days_ago
    • 过去 30 天: >= 30_days_ago
    • 过去 90 天: >= 90_days_ago
    • 过去 12 个月: >= 12_months_ago
    指定日期是默认值,无法更改。对于自定义日期,请使用日期偏移量。
    示例

    包含在过去一周内下最后一单的客户:
    last_order_date >= 7_days_ago

    包含在过去八个月内下最后一单的客户:
    last_order_date > -8m

    备注 日期值基于完整天数,并且取决于您商店所在的时区。

    订单数量

    number_of_orders

    根据客户在您商店中所下订单数来包含客户。

    运算符 等于:=
    不等于:!=
    大于:>
    小于:<
    小于或等于:<=
    大于或等于:>=
    介于: BETWEEN
    您输入的值必须是整数。
    格式 数值范围:# AND #
    编号: #
    示例 包含下单次数超过 10 次的客户:
    number_of_orders > 10
    备注 BETWEEN 同时包含开始值和结束值。例如,number_of_orders BETWEEN 1 AND 100 表示包含下单次数为 1 到 100 次的客户。

    预测消费层级

    predicted_spend_tier

    包含属于指定的预测消费层级的客户。

    只有当您商店达成的销售次数超过 100 次时,此筛选条件才可用。

    详细了解预测消费层级

    运算符 等于:=
    不等于:!=
    不存在:IS NULL
    存在: IS NOT NULL
    'HIGH'
    'MEDIUM'
    'LOW'
    格式
    示例 包含属于“高”消费层级的客户:
    predicted_spend_tier = 'HIGH'
    备注

    产品订阅状态

    product_subscription_status

    包含具有指定产品订阅状态的客户。

    此筛选条件仅在使用订阅应用时可用。

    运算符 等于:=
    不等于:!=
    不存在:IS NULL
    存在: IS NOT NULL
    有效:'SUBSCRIBED' 客户具有有效的产品订阅。
    已取消:'CANCELLED' 客户已取消其产品订阅。
    已过期:'EXPIRED' 客户的产品订阅已过期。
    失败:'FAILED' 客户的付款失败。
    从未订阅:'NEVER_SUBSCRIBED' 客户从未订阅。
    已暂停:'PAUSED' 客户已暂停其产品订阅。
    格式
    示例 包含具有有效产品订阅的客户:
    product_subscription_status = 'SUBSCRIBED'
    备注

    购买的产品

    products_purchased()

    包含购买指定产品的客户。此外,您还可以包含在指定日期范围内购买此产品的客户。


    函数参数 id(可选):使用此参数指定您要筛选的客户已买产品。
    tag(可选):使用此参数指定您要筛选的已购买产品的产品标签。
    since(可选):使用此参数指定活动的开始日期。
    until(可选):使用此参数指定活动的结束日期。
    运算符 等于:=
    不等于:!=
    truefalse
    格式 id 支持的格式:
  • ID(一个值)
  • List <ID>:以列表形式提供的一组值。例如:(1012132033639, 2012162031638, 32421429314657)。列表中的产品 ID 限制为 500 个。

    tag 支持的格式:
  • String(单个值)

    sinceuntil 支持的 Date 格式如下:

    绝对日期:YYYY-MM-DD
    日期偏移量示例:-4w-10y
    指定日期:
    • 今天: = today
    • 昨天: = yesterday
    • 过去 7 天: >= 7_days_ago
    • 过去 30 天: >= 30_days_ago
    • 过去 90 天: >= 90_days_ago
    • 过去 12 个月: >= 12_months_ago
    指定日期是默认值,无法更改。对于自定义日期,请使用日期偏移量。
  • 示例 使用 =!= 运算符指定产品是否已被购买:products_purchased() != true
    products_purchased(id: 2012162031638) = true
    products_purchased(id: (2012162031638, 1012132033639)) = false products_purchased(tag: 'red') = true


    筛选从 2022 年 1 月 1 日至今购买过特定产品的客户:
    products_purchased(id: 1012132033639, since: 2022-01-01, until: today) = true
    筛选从 2022 年 1 月 1 日至今购买过具有 'red' 标签的产品的客户:
    products_purchased(tag: 'Red', since: 2022-01-01, until: today) = true
    过去 30 天内:
    products_purchased(since: 30_days_ago) = true
    截止 2022 年 1 月 1 日:
    products_purchased(until: 2022-01-01) = true

    对于日期范围,sinceuntil 参数的顺序并不重要。对于 2022 年 1 月 1 日至 2022 年 6 月 1 日(含)的时间范围,您可以表达为以下任一种方式:

    2022 年 1 月 1 日到 2022 年 6 月 1 日(含):
    products_purchased(id: 1012132033639, since: 2022-01-01, until: 2022-06-01) = true
    2022 年 1 月 1 日到 2022 年 6 月 1 日(含):
    products_purchased(id: 1012132033639, until: 2022-06-01, since: 2022-01-01) = true
    备注
    • 使用 id 参数创建客户细分时,您可以按产品名称或图片从显示的列表中选择产品。或者,您可以键入产品的标题,然后从列表中选择它。
    • 产品 ID(不是产品标题)会输入到代码中。您将光标悬停在产品 ID 上时,会显示产品标题和图片。
    • 缺少 sinceuntil 参数意味着将筛选所有时间的结果,而没有设定的开始日期或结束日期。
    • 缺少 id 代表您的筛选条件包含了所有产品。

    短信订阅状态

    sms_subscription_status

    根据客户是否订阅您的营销短信来包含客户。

    详细了解如何收集客户联系信息

    运算符 等于:=
    不等于:!=
    不存在:IS NULL
    存在: IS NOT NULL
    已订阅:'SUBSCRIBED' 客户已订阅您的营销短信。
    待处理:'PENDING' 客户正在订阅您的营销短信。
    已编校:'REDACTED' 由于 GDPR 删除请求,客户有待处理的编校
    已取消订阅:'UNSUBSCRIBED' 客户已取消订阅您的营销短信。
    未订阅:'NOT_SUBSCRIBED' 客户从未订阅过您的营销短信。
    格式
    示例 包含已订阅您的营销短信的客户:
    sms_subscription_status = 'SUBSCRIBED'
    备注

    州或省

    customer_regions

    包含地址位于某个国家的指定地区的客户。拥有多个地址的客户可能会包含在使用此筛选条件的多个客户细分中。

    运算符 包含此确切地点:CONTAINS
    不包含此确切地点:NOT CONTAINS
    不存在:IS NULL
    存在: IS NOT NULL
    ISO 国家/地区代码与 ISO 3166-2 细分代码一起使用。
    格式
    示例 包含地址位于纽约州的客户:
    customer_regions CONTAINS 'US-NY'
    备注 若要查找某个地区,您可以开始输入该地区的名称,然后从显示的列表中选择相应值。

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

    免费试用