登录
开始免费试用

基于 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

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

函数参数 指定要筛选的事件。例如： 'metafields.facts.birth_date'
运算符 MATCHES：参数为真。
NOT_MATCHES：参数为假。
IS NULL：参数不存在。
IS NOT NULL：参数存在。

对于日期，可用的运算符包括：
等于：=
不等于：!=
大于：>
小于：<
小于或等于：<=
大于或等于：>=
介于： BETWEEN











值 date
格式 绝对日期：YYYY-MM-DD
日期偏移实例：+4w，+3m
指定日期或范围：
  • 今天： = today
  • 在未来 7 天内： BETWEEN today AND +7d
  • 在未来 30 天内： BETWEEN today AND +30d


示例 包含未来 30 天内过生日的客户：
anniversary MATCHES ('metafields.facts.birth_date') BETWEEN today AND +30d
备注
  • anniversary 筛选条件不考虑年份。
  • 日期值基于完整天数，并且取决于您商店所在的时区。
  • 若要筛选出生日期，您需要激活 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 IS NOT NULL
不是 B2B 客户：
companies IS NULL
包括属于特定公司的客户：
companies CONTAINS 3778915041302






备注
  • 创建客户细分时，您可以从显示的列表中按名称选择公司。或者，您可以键入公司的标题，然后从列表中选择它。
  • 公司 ID（而不是公司名称）会输入到代码中。将光标悬停在公司 ID 上时，会显示公司名称。
## 国家或地区

名称： customer_countries

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

运算符 包含此确切地点：CONTAINS
不包含此确切地点：NOT CONTAINS
不存在：IS NULL
存在： IS NOT NULL


值 使用 ISO 的两个字母的国家/地区代码。
格式
示例 包含地址位于美国的客户：
customer_countries CONTAINS 'US'
备注 若要查找某个国家/地区，您可以先输入该国家/地区的名称，然后从显示的列表中选择相应值。
## 使用应用 ID 创建

名称： created_by_app_id

包括由指定应用创建的客户。

运算符 等于：=
不等于： !=
值要进行细分的应用的 ID。
格式应用 ID
示例 包括已在 Shopify 后台中创建的客户：
created_by_app_id = 1830279
备注
  • 创建客户细分时，您可以按所示列表中的名称来选择应用。或者，您可以先键入应用的名称，然后从列表中进行选择。
  • 代码中会输入应用 ID（而不是应用名称）。将光标悬停在应用 ID 上时，将会显示应用名称。
## 客户账户状态

名称： 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： 'gmail.com'
  • Yahoo：'yahoo.com' 或 'yahoo.ca'
  • Hotmail： 'hotmail.com'
  • AOL： 'aol.com'
  • MSN： 'msn.com'
  • Live： 'live.com'
  • Outlook： 'outlook.com'
格式
示例 包含其邮箱域名为 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'
备注 标签不区分大小写。
详细了解标签及其注意事项。
## 距离范围内的客户

名称： customer_within_distance

包括位于已保存地点指定距离范围内的客户。

函数参数 只能对每个筛选条件使用一个距离参数。
coordinates（必需）：使用此参数指定用于创建细分的定位地点。
distance_km（必需）：使用此参数指定要用于搜索客户的距离半径。
distance_mi（必需）：使用此参数指定要用于搜索客户的距离半径。




运算符 MATCHES：参数为真。
NOT_MATCHES：参数为假。
IS NULL：参数不存在。
IS NOT NULL：参数存在。






值
格式 coordinates 支持的格式：
  • 数值（纬度）, 数值（经度）

    • coordinates (纬度, 经度) 支持的格式：
  • 数值：#

    • distance_mi 和 distance_km 支持的格式：
  • 数值：#




    • 示例 此筛选条件需要坐标和一个距离参数才能有效。

    筛选地址在坐标 (45.419190, -75.696727) 10 英里范围内的客户：
    customer_within_distance MATCHES (coordinates = (45.419190, -75.696727), distance_mi = 10 )

    筛选条件可以与其他筛选条件结合使用，以进一步缩小您的客户列表。例如：
    筛选地址在坐标 (43.634,-79.412) 20 公里范围内，并至少下过一个订单的客户：
    customer_within_distance MATCHES (coordinates = (43.634,-79.412), distance_km = 20 ) AND number_of_orders > 0






    备注
    • 当您使用此筛选条件时，Shopify 细分会自动将您保存的地点转换为坐标对，并将其显示为可选择的值。
    • 如果您的商店具有已保存的地点，则 Shopify Magic 会在 magic 翻译中将坐标对自动翻译为您的地点名称。例如：“地址位于’Salt Lake City Store‘地点 10 英里范围内的客户。”
    ## 电子邮件事件

    名称： shopify_email.EVENT

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

    • 已回弹：bounced
    • 已点击：clicked
    • 已送达：delivered
    • 已标记为垃圾邮件：marked_as_spam
    • 已打开：opened
    • 已取消订阅：unsubscribed
    函数参数 activity_id（可选）：使用此参数选择要筛选的营销活动 ID。
    count（可选）：使用此参数指定电子邮件事件发生的次数。
    date（可选）：使用此参数指定事件的日期。



    运算符 MATCHES：在事件发生时使用。
    NOT_MATCHES：在事件未发生时使用。
    IS NULL：参数不存在。
    IS NOT NULL：参数存在。

    对于日期，可用的运算符包括：
    等于：=
    不等于：!=
    大于：>
    小于：<
    小于或等于：<=
    大于或等于：>=
    介于： BETWEEN











    值
    格式 activity_id 支持的格式：
  • =（单个值）
  • IN ：一组括在括号中的以逗号分隔的值，隐含 “OR”。例如：(activity_id IN (1, 2, 3))。集合中的活动 ID 限制为 500 个。

    date 支持的日期格式：



  • 绝对日期： YYYY-MM-DD
  • 日期偏移量示例：
    • 7 天前：-7d

    • 4 周前：-4w

    • 3 个月前：-3m

    • 1 年前：-1y

    • 指定日期：today, yesterday


    • 指定日期是默认值，因此无法更改它。对于自定义日期，请使用日期偏移。

    电子邮件事件过去 26 个月内的数据可用，数据从 2022 年 3 月开始。

    支持的 count 格式：
  • 数值： #








    • 示例 使用 MATCHES 或 NOT MATCHES 运算符指定电子邮件事件是否发生：
    shopify_email.opened MATCHES (activity_id = 135195754518)
    shopify_email.opened NOT MATCHES (activity_id = 135195754518)

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

    使用 date 参数和 >= 运算符指定电子邮件事件的开始日期：
    shopify_email.delivered NOT MATCHES (activity_id = 135195754518, date >= 2022-01-01)

    使用 date 参数和 <= 运算符指定电子邮件事件的结束日期：
    shopify_email.delivered MATCHES (activity_id = 135195754518, date <= 2022-01-01)

    使用 date 参数和 BETWEEN 运算符指定电子邮件事件的开始日期和结束日期：
    shopify_email.bounced NOT MATCHES (activity_id = 135195754518, BETWEEN -12m AND today)













    备注
    • 使用 activity_id 参数创建客户细分时，您可从显示的列表中按名称选择营销活动。
    • 由于数据保留的限制，缺少日期参数意味着将筛选过去 26 个月的结果，而未设置开始和结束日期。
    • 缺少 activity_id 意味着您的筛选范围包括所有 Shopify 电子邮件活动。
    ## 电子邮件订阅状态

    名称： email_subscription_status

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

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


    值 未订阅：'NOT_SUBSCRIBED' 客户尚未订阅您的营销电子邮件。
    已订阅：'SUBSCRIBED' 客户已订阅您的营销电子邮件。
    待处理：'PENDING' 客户正在订阅您的营销电子邮件。
    无效：'INVALID' 客户的邮件营销状态无效。
    取消订阅：'UNSUBSCRIBED' 客户已取消订阅您的营销电子邮件。
    编校：'REDACTED' 客户的电子邮件地址已编校。




    格式
    示例 包含已订阅您的电子邮件营销的客户：
    email_subscription_status = 'SUBSCRIBED'
    备注
    ## 首单日期

    名称： first_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
    指定日期是默认值，因此无法更改它。对于自定义日期，请使用日期偏移。

    示例 包含在上周首次下单的客户：
    first_order_date >= 7_days_ago

    包含在过去八个内首次下单的客户：
    first_order_date > -8m



    备注 日期值基于完整天数，并且取决于您商店所在的时区。
    ## 上次订购日期

    名称： 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 次的客户。
    ## 已下订单

    名称： orders_placed

    包括在指定日期范围内下订单或消费一定金额的客户。

    函数参数 app_id （可选）：使用此参数指定创建了订单的应用。
    location_id（可选）：使用此参数指定下单地点。
    count（可选）：使用此参数指定下单的确切次数。
    amount（可选）：使用此参数指定某个订单的确切消费金额。
    sum_amount（可选）：使用此参数指定所有订单的消费金额。
    date （可选）：使用此参数指定事件的日期。






    运算符 MATCHES：参数为真。
    NOT_MATCHES：参数为假。
    IS NULL：参数不存在。
    IS NOT NULL：参数存在。

    对于日期，可用的运算符包括：
    等于：=
    不等于：!=
    大于：>
    小于：<
    小于或等于：<=
    大于或等于：>=
    介于： BETWEEN











    值
    格式 count、amount 和 sum_amount 支持的格式：
    数字： #

    date 支持的格式：
    绝对日期：YYYY-MM-DD
    日期偏移量示例：
    • 7 天前： -7d
    • 4 周前： -4w
    • 3 个月前： -3m
    • 1 年前： -1y
    指定日期：
    • 今天： today
    • 昨天： yesterday
    指定日期是默认值，无法更改。




    示例 使用 MATCHES 或 NOT_MATCHES 运算符指定是否已下单：
    orders_placed MATCHES ()
    orders_placed NOT MATCHES ()

    筛选在过去 6 个月内下单 3 次以上（含）的客户：
    orders_placed MATCHES (count >= 3, date >= -6m)

    筛选在过去 90 天内消费金额超过 1000 美元（含）的客户：
    orders_placed MATCHES (sum_amount >= 1000, date >= -90d)

    筛选在过去 7 天内消费金额少于 100 美元（含）的客户：
    orders_placed MATCHES (sum_amount <= 100, date >= -7d)

    筛选自 2023 年 1 月 1 日起消费金额超过 1000 美元（含）且下单 3 次以上（含）的客户：
    orders_placed MATCHES (sum_amount >= 1000, count >= 3, date >= 2023-01-01)

    使用 date 参数和 BETWEEN 运算符指定具体日期范围。对于 2023 年 1 月 1 日至 2023 年 6 月 1 日（含）的时间范围，您可以使用以下方式进行表达：
    orders_placed MATCHES (count >= 3, date BETWEEN 2023-01-01 AND 2023-06-01)
















    备注
    • 将光标悬停在金额上时，会显示用于筛选客户的货币。
    • 将光标悬停在以下语法上时：
      amount, sum_amount，会显示语法说明。
    • 缺少parameters意味着您的筛选条件包含所有时间所下的所有订单。
    ## 预测消费层级

    NAME: predicted_spend_tier

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

    运算符 等于：=
    不等于：!=
    不存在：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 （可选）：使用此参数指定您要筛选的客户已购买的产品。
    quantity（可选）：使用此参数指定每个订单购买的产品数量。
    sum_quantity（可选）：使用此参数指定所有订单中购买的产品数量。
    date（可选）：使用此参数指定事件的日期。
    tag（可选）：使用此参数指定要筛选的已售产品的产品标签。



    运算符 MATCHES：参数为真。
    NOT_MATCHES：参数为假。
    IS NULL：参数不存在。
    IS NOT NULL：参数存在。

    对于日期，可用的运算符包括：
    等于：=
    不等于：!=
    大于：>
    小于：<
    小于或等于：<=
    大于或等于：>=
    介于： BETWEEN











    值
    格式 tag 支持的格式：
    string（单个值）

    id 支持的格式：
  • =（单个值）
  • IN ：一组括在括号中的以逗号分隔的值，隐含 “OR”。例如：(id IN (1012132033639, 2012162031638, 32421429314657))。集合中的产品 ID 限制为 500 个。
    支持的 date 格式：
    绝对日期：YYYY-MM-DD
    日期偏移量示例：
    • 7 天前： -7d
    • 4 周前： -4w
    • 3 个月前： -3m
    • 1 年前： -1y
    • 指定日期：today, yesterday
    指定日期是默认值，因此无法更改它。

    支持的 quantity 和 sum_quantity 格式：
    数字： #









    • 示例 使用 MATCHES 或 NOT_MATCHES 运算符指定是否购买某种产品：
    products_purchased MATCHES (id = 2012162031638)
    products_purchased NOT MATCHES (id IN (2012162031638, 1012132033639)) products_purchased MATCHES (tag = 'red')

    筛选 2022 年 1 月 1 日至今购买特定产品的客户：
    products_purchased MATCHES (id = 1012132033639, date BETWEEN 2022-01-01 AND today)

    筛选 2022 年 1 月 1 日至今购买带有 'red' 标签的产品的客户：
    products_purchased MATCHES (tag = 'red', date BETWEEN 2022-01-01 AND today)

    过去 30 天内：
    products_purchased MATCHES (date >= -30d)

    截至 2022 年 1 月 1 日：
    products_purchased MATCHES (date <= 2022-01-01)

    使用 date 参数和 BETWEEN 运算符指定具体日期范围。对于 2022 年 1 月 1 日至 2022 年 6 月 1 日（含）的时间范围，您可以使用以下方式进行表达：
    products_purchased MATCHES (id = 1012132033639, date BETWEEN 2022-01-01 AND 2022-06-01)

    筛选最近购买过大量具有特定标签的产品的客户：
    products_purchased MATCHES (tag = 'product_tag', sum_quantity >= 3, date >= -90d)



















    备注
    • 使用 id 参数创建客户细分时，您可以按产品名称或图片从显示的列表中选择产品。或者，您可以键入产品的标题，然后从列表中选择它。
    • 产品 ID（不是产品标题）会输入到代码中。您将光标悬停在产品 ID 上时，会显示产品标题和图片。
    • 缺少 date 参数意味着将筛选出所有时间的结果，而没有设定开始或结束的日期。
    • 缺少任何参数，都意味着您的筛选条件包含所有时间的全部已售产品。
    ## RFM 组

    名称： rfm_group

    根据客户所属的 RFM 组来包含客户。 详细了解 RFM 客户分析。

    可能的 RFM 组运算符和值列表，包括示例。
    运算符 等于：=
    不等于：!=
    不存在：IS NULL
    存在： IS NOT NULL


    值 休眠：'DORMANT'
    存在风险：'AT_RISK'
    之前忠实：'PREVIOUSLY_LOYAL'
    需要注意：'NEEDS_ATTENTION'
    几乎流失：'ALMOST_LOST'
    忠实：'LOYAL'
    有潜力：'PROMISING'
    活跃： 'ACTIVE'
    新客户：'NEW'
    冠军：'CHAMPIONS'
    潜在客户： 'PROSPECTS'









    格式
    示例 包含需要注意 RFM 组中的客户：
    rfm_group = 'NEEDS_ATTENTION'
    备注
    ## 短信订阅状态

    名称： 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'
    备注 若要查找某个区域，您可以先输入该区域的名称，然后从显示的列表中选择相应值。
    ## 商店抵扣额账户

    名称： store_credit_accounts

    包含在您的商店中有商店抵扣额余额的客户。

    函数参数 balance （可选）：使用此参数指定客户的当前商店抵扣额账户余额。
    currency（可选）：使用此参数指定客户的商店抵扣额余额的货币。
    next_expiry_date（可选）：使用此参数指定最早到期的的未用商店抵扣额的日期。
    last_credit_date（可选）：使用此参数指定客户上次收到商店抵扣额的日期。


    运算符 MATCHES：参数为真。
    NOT_MATCHES：参数为假。
    IS NULL：参数不存在。
    IS NOT NULL：参数存在。

    对于日期，可用的运算符包括：
    等于：=
    不等于：!=
    大于：>
    小于：<
    小于或等于：<=
    大于或等于：>=
    介于： BETWEEN











    值
    格式 currency 支持的格式：
    货币代码：例如 USD

    balance 支持的格式：
    数字： #

    next_expiry_date 和 last_credit_date 支持的格式：
    绝对日期： YYY-MM-DD
    日期偏移量示例：
    7 天前： -7d
    4 周前：-4w
    3 个月前：-3m
    1 年前：-1y
    指定日期：
  • 今天： today
  • 昨天： yesterday
    • 指定日期是默认值，无法更改。












    示例 筛选商店抵扣额账户余额大于或等于 1（任意货币）的客户：
    store_credit_accounts MATCHES (balance >= 1)

    筛选商店抵扣额账户余额大于或等于 1 美元的客户：
    store_credit_accounts MATCHES (balance >= 1, currency: 'USD')

    筛选商店抵扣额在未来 7 天内到期的客户：
    store_credit_accounts MATCHES (next_expiry_date <= +7d)

    筛选最后一次收到商店抵扣额超过 1 个月但仍有余额可消费的客户：
    store_credit_accounts MATCHES (last_credit_date <= -1m, balance >= 1)









    备注
    • 如果您曾向客户发放过商店抵扣额，他们便拥有商店抵扣额账户。客户的商店抵扣额余额可以大于或等于 0。
    • 商店抵扣额账户特定于货币。如果您的细分中不包含 currency 参数，则无论您的货币类型是什么，您的筛选器都会返回所有商店抵扣额账户。
    • 客户可以拥有 0 个至多个商店抵扣额账户，具体取决于您支持的货币数。例如，如果您以加元和美元向客户发放商店抵扣额，则该客户有 2 个商店抵扣额账户。
    ## 店面活动

    名称： storefront.EVENT

    根据店面活动选择是否包含客户。受支持的事件（EVENT）如下所示：

    • 已查看产品：product_viewed
    • 已查看系列系列：collection_viewed
    函数参数 id（可选）：使用此参数指定要筛选的产品或产品系列。
    date（可选）：使用此参数指定事件的日期。
    count （可选）：使用此参数指定查看产品或产品系列的确切次数。

    特定于产品事件的参数：
    标签（可选）：使用此参数指定要筛选的产品标签。这与筛选具有该标签的每个产品 ID 的操作相同。






    运算符 MATCHES：参数为真。
    NOT_MATCHES：参数为假。
    IS NULL：参数不存在。
    IS NOT NULL：参数存在。

    对于日期，可用的运算符包括：
    等于：=
    不等于：!=
    大于：>
    小于：<
    小于或等于：<=
    大于或等于：>=
    介于： BETWEEN











    值
    格式 id 支持的格式：
  • =（单个值）
  • IN ：一组括在括号中的以逗号分隔的值，隐含 “OR”。例如：(id IN (1012132033639, 2012162031638, 32421429314657))。集合中的产品或产品系列 ID 限制为 500 个。
    tag 支持的格式：string（单个值）

    支持的 date 格式： 绝对日期：YYYY-MM-DD
    日期偏移量示例：
    • 7 天前： -7d
    • 4 周前： -4w
    • 3 个月前： -3m
    • 1 年前： -1y
    指定日期：
    • 今天： today
    • 昨天： yesterday
    过去 26 个月内的店面活动数据可用，数据从 2023 年 5 月开始。

    指定日期是默认值，因此无法更改它。对于自定义日期，请使用日期偏移。





    • 示例 使用 MATCHES 或 NOT_MATCHES 运算符指定店面事件是否发生：storefront.product_viewed MATCHES()
    storefront.collection_viewed NOT MATCHES ()

    使用 id 参数指定要筛选的产品：
    storefront.product_viewed MATCHES (id = 2012162031638)
    storefront.collection_viewed MATCHES (id IN (2012162031638, 456, 789))

    使用 tag 参数指定要筛选的产品标签：
    storefront.product_viewed MATCHES (tag CONTAINS 'jeans')

    使用 date 参数和 >= 运算符指定店面事件的开始日期：
    storefront.product_viewed MATCHES (id = 2012162031638, date >= 2023-04-03)
    storefront.collection_viewed MATCHES (id = 2012162031638, date >= -30d)

    使用 date 参数和 <= 运算符指定店面事件的结束日期：
    storefront.product_viewed MATCHES (id = 2012162031638, date <= 2023-04-30)
    storefront.collection_viewed MATCHES (id = 2012162031638, date <= -7d)

    使用 date 参数和 BETWEEN 运算符指定店面事件的开始日期和结束日期：
    storefront.product_viewed MATCHES (id = 2012162031638, date BETWEEN 2023-04-03 AND 2023-04-30)
    storefront.collection_viewed MATCHES (id = 2012162031638, date BETWEEN -90d AND -30d)

    筛选在过去 30 天内查看过特定产品的客户：
    storefront.product_viewed MATCHES (id = 2012162031638, date >= -30d)

    筛选 2023 年 1 月 1 日至今查看过特定产品系列的客户：
    storefront.collection_viewed MATCHES (id = 2012162031638, date BETWEEN 2023-01-01 AND today)

























    备注
    • 使用 id 参数创建客户细分时，您可以按名称或图片从显示的列表中选择产品或产品系列。或者，您可以输入产品或产品系列的标题，然后从列表中进行选择。
    • 产品或产品系列 ID（而不是标题）将被输入代码中。将光标悬停在 ID 上时，会显示产品或产品系列标题和图片。
    • 如果适用，产品系列会使用“另存为产品系列缩略图”的图片。如果不适用，将显示通用图片占位符。
    • 由于数据保留的限制，缺少日期参数意味着将筛选过去 26 个月的结果，而未设置开始和结束日期。
    • 缺少 id 代表您的筛选条件包含了所有产品。
    没有找到您需要的答案？我们将为您提供帮助。