基于 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 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.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'
备注

标签不区分大小写。

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

距离范围内的客户

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

函数参数

只能对每个筛选条件使用一个距离参数。

coordinates(必需):使用此参数指定用于创建细分的 pin 位置。
distance_km(必需):使用此参数指定用于搜索客户的距离半径。
distance_mi(必需):使用此参数指定用于搜索客户的距离半径。
运算符 等于:=
truefalse
格式 coordinates 支持的格式:
  • 数值(纬度), 数值(经度)

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

  • distance_midistance_km 支持的格式:
  • 数值:#

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

    筛选地址在 (40.624940, -111.833060) 坐标 10 英里范围内的客户:
    customer_within_distance(coordinates: (40.624940, -111.833060), distance_mi: 10 ) = true

    如果您的商店具有已保存的地点,则 Shopify Magic 会在 magic 翻译中将坐标对自动翻译为您的地点名称。

    地址位于“Salt Lake City Store”地点 10 英里范围内的客户。

    筛选条件可与其他筛选条件结合使用,以进一步缩小客户列表范围。

    筛选地址在 (43.634,-79.412) 坐标 20 公里范围内并至少下过一个订单的客户:
    customer_within_distance ( coordinates: (43.634,-79.412), distance_km: 20 ) = true AND number_of_orders > 0

    筛选地址在 (45.502,-73.563) 坐标 50 公里范围内的客户:
    customer_within_distance ( coordinates: (45.502,-73.563), distance_km: 50 ) = false
    备注Shopify Segmentation 会自动将您已保存的地点转换为坐标对,该坐标对将在您使用此筛选条件时显示为可选择的值。

    电子邮件事件

    shopify_email.EVENT()

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

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

    sinceuntil 支持的 Date 格式:
    绝对日期:YYYY-MM-DD
    日期偏移量示例:
    7 天前::-7d
    4 周前::-4w
    3 个月前::-3m
    1 年前::-1y

    指定日期::today:yesterday
    指定日期是默认值,无法更改。对于自定义日期,请使用日期偏移量。

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

    count_at_leastcount_at_mostcount 支持的格式:
    数字:#
  • 示例 使用 =!= 运算符指定电子邮件事件是否已发生:
    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 参数意味着将筛选过去 26 个月内的结果,而没有设定的开始日期或结束日期。
    • 缺少 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 次的客户。

    已下订单

    orders_placed()

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

    函数参数 count_at_least (可选):使用此参数指定下单的最小次数。
    count_at_most(可选):使用此参数指定下单的最大次数。
    count(可选):使用此参数指定下单的确切次数。
    amount_at_least(可选):使用此参数指定某个订单的最低消费金额。
    amount_at_most(可选):使用此参数指定某个订单的最高消费金额。
    amount(可选):使用此参数指定某个订单的确切消费金额。
    sum_amount_at_least(可选):使用此参数指定所有订单的最低消费金额。
    sum_amount_at_most(可选):使用此参数指定所有订单的最高消费金额。
    sum_amount(可选):使用此参数指定所有订单的消费金额。
    since(可选):使用此参数指定事件的开始日期。
    until(可选):使用此参数指定事件的结束日期。
    运算符

    等于:=

    不等于:!=

    truefalse
    格式

    count_at_leastcount_at_mostcount 支持的格式:
    数字:#

    amount_at_leastamount_at_mostamount 支持的格式:
    数字:#

    sum_amount_at_leastsum_amount_at_mostsum_amount 支持的格式:
    数字:#

    sinceuntil 支持的 Date 格式:
    绝对日期:YYY-MM-DD
    日期偏移量示例:

    7 天前::-7d
    4 周前::-4w
    3 个月前::-3m
    1 年前::-1y

    指定日期:

    • 今天: :today
    • 昨天: :yesterday

    指定日期是默认值,无法更改。

    示例使用 =!= 运算符指定是否已下订单:

    orders_placed() = true

    orders_placed() = false

    筛选过去 6 个月内下订单次数超过超过 3 次(含)的客户:

    orders_placed(count_at_least:3, since:-6m) = true

    筛选过去 3 个月内消费金额超过 1000 美元(含)的客户:

    orders_placed(sum_amount_at_least: 1000, since:-90d) = true

    筛选上周消费金额低于 100 美元(含)的客户:

    orders_placed(sum_amount_at_most: 100, since:-7d) = true

    筛选自 2023 年 1 月 1 日起消费金额超过 1000 美元(含)且下订单次数超过超过 3 次(含)的客户:

    orders_placed(sum_amount_at_least: 1000, count_at_least: 3, since: 2023-01-01) = true

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

    2023 年 1 月 1 日至 2023 年 6 月 1 日(含):

    orders_placed(count_at_least:3, since: 2023-01-01, until: 2023-06-01) = true

    2023 年 1 月 1 日至 2023 年 6 月 1 日(含):

    orders_placed(count_at_least:3, until: 2023-06-01, since: 2023-01-01) = true

    备注
    • 将光标悬停在金额上时,会显示用于筛选客户的货币。
    • 将光标悬停在以下语法上时:
      amount_at_leastamount_at_most amountsum_amount_at_leastsum_amount_at_most sum_amount,会显示语法说明。
    • 缺少parameters意味着您的筛选条件包含所有时间所下的所有订单。

    预测消费层级

    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 (可选):使用此参数指定您要筛选的客户已购买产品。
    quantity_at_least(可选):使用此参数指定每个订单购买的最低产品数量。
    quantity_at_most(可选):使用此参数指定每个订单购买的最高产品数量。
    quantity(可选):使用此参数指定每个订单购买的产品数量。
    sum_quantity_at_least (可选):使用此参数指定所有订单中购买的最低产品数量。
    sum_quantity_at_most (可选):使用此参数指定所有订单中购买的最高产品数量。
    sum_quantity(可选):使用此参数指定所有订单中购买的产品数量。
    since(可选):使用此参数指定事件的开始日期。
    tag(可选):使用此参数指定要筛选的已购买产品的产品标签。
    until(可选):使用此参数指定事件的结束日期。
    运算符等于:=
    不等于:!=
    truefalse
    格式 tag 支持的格式:
    String(单个值)
    id 支持的格式:ID(单个值)
    List <ID>:以列表形式提供的一组值。例如:(1012132033639, 2012162031638, 32421429314657)。列表中的产品 ID 限制为 500 个。
    sinceuntil 支持的 Date 格式:
    绝对日期:YYYY-MM-DD
    日期偏移量示例:
    7 天前::-7d
    4 周前::-4w
    3 个月前::-3m
    1 年前::-1y

    指定日期::today:yesterday
    指定日期是默认值,无法更改。
    quantity_at_leastquantity_at_mostquantity 支持的格式:
    数字:#
    sum_quantity_at_leastsum_quantity_at_mostsum_quantity 支持的格式:
    数字:#
    示例 使用 =!= 运算符指定产品是否已被购买:
    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: -30d) = 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
    筛选最近购买过大量具有特定标签的产品的客户:
    products_purchased(tag: 'product_tag', sum_quantity_at_least: 3, since: -90d) = true
    备注
    • 使用 id 参数创建客户细分时,您可以按产品名称或图片从显示的列表中选择产品。或者,您可以键入产品的标题,然后从列表中选择它。
    • 产品 ID(不是产品标题)会输入到代码中。您将光标悬停在产品 ID 上时,会显示产品标题和图片。
    • 缺少 sinceuntil 参数意味着将筛选所有时间的结果,而没有设定的开始日期或结束日期。
    • 缺少 parameters 意味着您的筛选条件包含所有时间内购买的所有订单。

    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 (可选):使用此参数指定客户的当前商店抵扣额账户余额。
    balance_at_least(可选):使用此参数指定客户的最低商店抵扣额余额。
    balance_at_most(可选):使用此参数指定客户的最高商店抵扣额账户余额。
    currency(可选):使用此参数指定客户的商店抵扣额余额的货币。
    next_expiry_date(可选):使用此参数指定最早到期的的未用商店抵扣额的日期。
    next_expiry_date_at_least(可选):使用此参数指定最早到期的未用商店抵扣额的最早日期。
    next_expiry_date_at_most(可选):使用此参数指定最早到期的未用商店抵扣额的最近日期。
    last_credit_date(可选):使用此参数指定客户上次收到商店抵扣额的日期。
    last_credit_date_at_least(可选):使用此参数指定客户上次收到商店抵扣额的最早日期。
    last_credit_date_at_most(可选):使用此参数指定客户上次收到商店抵扣额的最近日期。
    运算符 等于:=
    不等于:!=
    truefalse
    格式

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

    balance 支持的格式:
    数值: #

    next_expiry_datelast_credit_date 支持的格式:
    绝对日期:YYY-MM-DD
    日期偏移量示例:
    7 天前:-7d
    4 周前:-4w
    3 个月前:-3m
    1 年前:-1y
    指定日期:

  • 今天: today
  • 昨天: yesterday
  • 指定日期是默认值,无法更改。
    示例

    筛选商店抵扣额账户余额大于或等于 1(任何货币)的客户:
    store_credit_accounts(balance_at_least: 1) = true

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

    筛选商店抵扣额将在未来 7 天内过期的客户:
    store_credit_accounts(next_expiry_date_at_most: +7d) = true

    筛选上次收到商店抵扣额为 1 个月前但仍有可用余额的客户:
    store_credit_accounts(last_credit_date_at_most: -1m, balance_at_least: 1) = true

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

    店面活动

    storefront.EVENT()

    基于店面活动包含客户。受支持的活动 (EVENT) 如下所示:

    • 已查看产品:product_viewed
    • 已查看系列系列:collection_viewed


    函数参数 id(可选):使用此参数指定要筛选的产品或产品系列。
    since(可选):使用此参数指定活动的开始日期。
    until(可选):使用此参数指定活动的结束日期。
    count_at_least(可选):使用此参数指定查看产品或产品系列的最小次数。
    count_at_most(可选):使用此参数指定查看产品或产品系列的最大次数。
    count(可选):使用此参数指定查看产品或产品系列的确切次数。
    特定于活动的参数 tag(可选):使用此参数指定要筛选的产品标签。这与筛选具有该标签的每个产品 ID 的行为相同。
    运算符等于:=
    不等于:!=
    truefalse
    格式 id 支持的格式:
  • ID(一个值)
  • List <ID>:以列表形式提供的一组值。例如:(1012132033639, 2012162031638, 32421429314657)。列表中的产品 ID 限制为 500 个。

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

    sinceuntil 支持的 Date 格式如下:

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

    指定日期是默认值,无法更改。对于自定义日期,请使用日期偏移量。
  • 示例 使用 =!= 运算符指定是否发生店面活动:storefront.product_viewed() = true
    storefront.collection_viewed() = false

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

    使用参数 tag 指定要筛选的产品标签:
    storefront.product_viewed(tag: 'jeans') = true

    使用参数 since 指定店面活动的开始日期:
    storefront.product_viewed(id: 2012162031638, since: 2023-04-03) = true
    storefront.collection_viewed(id: 2012162031638, since:-30d) = true

    使用参数 until 指定店面活动的结束日期:
    storefront.product_viewed(id: 2012162031638, until: 2023-04-30) = true
    storefront.collection_viewed(id: 2012162031638, until:-7d) = true

    使用参数 sinceuntil 指定店面活动的开始日期和结束日期:
    storefront.product_viewed(id: 2012162031638, since: 2023-04-03, until: 2023-04-30) = true
    storefront.collection_viewed(id: 2012162031638, since: -90d, until: -30d) = true

    筛选在过去 30 天内查看了特定产品的客户:
    storefront.product_viewed(id: 2012162031638, since: -30d) = true

    筛选自 2023 年 1 月 1 日至今查看了特定产品系列的客户:
    storefront.collection_viewed(id: 2012162031638, since: 2023-01-01, until: today) = true

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

    2023 年 1 月 1 日到 2023 年 6 月 1 日(含):
    storefront.collection_viewed(id: 2012162031638, since: 2023-01-01, until: 2023-06-01) = true

    2023 年 1 月 1 日至今(含):
    storefront.collection_viewed(id: 2012162031638, until: today, since: 2023-01-01,) = true
    备注
    • 使用 id 参数创建客户细分时,您可以按名称或图片从显示的列表中选择产品或产品系列。或者,您可以输入产品或产品系列的标题,然后从列表中进行选择。
    • 产品或产品系列 ID(而不是标题)将被输入代码中。将光标悬停在 ID 上时,会显示产品或产品系列标题和图片。
    • 产品系列使用另存为产品系列缩略图的图片(如果适用)。如果不适用,将显示通用图片占位符。
    • 受数据保留的影响,同时缺少 sinceuntil 参数意味着将筛选过去 26 个月内的结果,而没有设定的开始日期或结束日期。
    • 缺少 id 代表您的筛选条件包含了所有产品。
    没有找到您需要的答案?我们将为您提供帮助。