基于 Shopify 的客户细分筛选条件
使用本参考指南来了解用于创建基于默认 Shopify 筛选条件的客户细分的筛选条件名称、运算符和值。
本页内容
弃单日期
名称: abandoned_checkout_date
按客户上次弃单的日期来包含客户。
| 运算符 |
日期正好为: =日期不为: !=在某个日期或之前: <=在某个日期之前: <在某个日期或之后: >=在某个日期之后: >在两个日期之间: BETWEEN {date1} AND {date2}不存在: IS NULL存在: IS NOT NULL
|
|---|---|
| 值 | |
| 格式 |
绝对日期: YYYY-MM-DD日期偏移示例: -4w, -10y命名日期:
|
| 示例 |
包含在过去一周内上次弃单的客户:abandoned_checkout_date >= -7d包含在过去八个月内上次弃单的客户: abandoned_checkout_date > -8m
|
| 备注 | 日期值以一整天为单位,具体取决于您商店所在的时区。 |
周年纪念日
名称: anniversary
按与日期参数关联的事件的日期来包含客户。
| 函数参数 |
指定您想用作筛选条件的事件。例如: 'metafields.facts.birth_date'
|
|---|---|
| 运算符 |
IS NULL: 参数不存在。IS NOT NULL: 参数存在。对于日期,可用运算符包括: 等于: =不等于: !=介于...之间: BETWEEN
|
| 值 |
date
|
| 格式 |
绝对日期: YYYY-MM-DD日期偏移示例: +4w, +3m命名日期或范围:
|
| 示例 |
包含生日在未来 30 天内的客户:anniversary ('metafields.facts.birth_date') BETWEEN today AND +30d
|
| 备注 |
|
消费金额
名称: amount_spent
根据客户在您商店中消费的金额来包含客户。
| 运算符 |
等于: =不等于: !=大于: >小于: <小于或等于: <=大于或等于: >=介于...之间: BETWEEN
|
|---|---|
| 值 | |
| 格式 |
数字范围: # AND #数字: #小数:小数点 (.) 用作小数分隔符。 不接受千位分隔符(如逗号或空格)。 不接受特定于语言的格式化数字。 |
| 示例 |
包含在您商店中消费了 1 到 999.99 的客户:amount_spent BETWEEN 1 AND 999.99 |
| 备注 |
|
城市
名称: 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 |
| 备注 |
|
国家/地区
名称: 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
|
| 备注 |
|
客户账户状态
名称: customer_account_status
包含具有指定 客户账户 状态的客户。
| 运算符 |
等于: =不等于: !=
|
|---|---|
| 值 |
已拒绝: 'DECLINED' 客户受邀创建账户,但已拒绝。已停用: 'DISABLED' 客户尚未创建账户,或者您的商店正在使用 新版客户账户。已启用: 'ENABLED' 客户已创建账户。已邀请: 'INVITED' 客户已受邀创建账户,但尚未接受或拒绝。
|
| 格式 | |
| 示例 |
包含已受邀创建账户但已拒绝的客户:customer_account_status = 'DECLINED'
|
| 备注 |
客户添加日期
名称: customer_added_date
根据客户被添加到您商店的日期来包含客户。
| 运算符 |
日期正好为: =日期不为: !=在某个日期或之前: <=在某个日期之前: <在某个日期或之后: >=在某个日期之后: >在两个日期之间: BETWEEN {date1} AND {date2}
|
|---|---|
| 值 | |
| 格式 |
绝对日期: YYYY-MM-DD日期偏移示例: -4w, -10y命名日期:
|
| 示例 |
包含在过去一周内添加的客户:customer_added_date >= -7d包含在过去八个月内添加的客户: 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
|
|---|---|
| 值 |
以下域名作为建议提供。您不局限于这些域名。您可以手动输入任何其他有效的域名:
|
| 格式 | |
| 示例 |
包含电子邮箱域名为 shopify.com 的客户:customer_email_domain = 'shopify.com'
|
| 备注 |
客户语言
名称: customer_language
根据客户用于与您商店进行沟通的语言来包含客户。
| 运算符 |
等于: =不等于: !=不存在: IS NULL存在: IS NOT NULL
|
|---|---|
| 值 | 使用 ISO 639-1 双字母语言代码。 |
| 格式 |
以下值是一些常见 ISO 语言代码的示例。您的数据不局限于这些语言代码。您可以手动输入任何其他有效的语言代码,但在编辑器中作为建议提供给您的值是您的客户数据中唯一可用的值。
|
| 示例 |
包含用英语与您商店沟通的客户:customer_language = 'en'排除用加拿大英语与您商店沟通的客户: customer_language != '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:参数为 true。NOT_MATCHES:参数为 false。IS NULL: 参数不存在。IS NOT NULL:参数存在。 |
| 值 | |
| 格式 |
支持的 coordinates格式:
coordinates(纬度、经度)的支持格式: #支持的 distance_mi, distance_km格式:
# |
| 示例 |
此筛选条件需要 coordinates 和一个距离参数才有效。 筛选地址在坐标 (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_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))。一个集合中最多可包含 500 个活动 ID。date 支持的日期格式:YYYY-MM-DD
命名日期是默认值,无法更改。对于自定义日期,请使用日期偏移量。 可查看最近 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, date BETWEEN -12m AND today)
|
| 备注 |
|
电子邮件订阅状态
名称: 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命名日期:
|
| 示例 |
包含自上周起下达首个订单的客户:first_order_date >= -7d包含自八个月前起下达首个订单的客户: first_order_date > -8m
|
| 备注 | 日期值基于完整天数,并取决于您商店所在的时区。 |
最近一个订单的日期
名称: last_order_date
包含在指定日期下达其最近一个订单的客户。
| 运算符 |
日期正好为: =日期不为: !=在某个日期或之前: <=在某个日期之前: <在某个日期或之后: >=在某个日期之后: >在两个日期之间: BETWEEN {date1} AND {date2}不存在: IS NULL存在: IS NOT NULL
|
|---|---|
| 值 | |
| 格式 |
绝对日期: YYYY-MM-DD日期偏移示例: -4w, -10y命名日期:
|
| 示例 |
包含自上周起下达其最近一个订单的客户:last_order_date >= -7d包含自八个月前起下达其最近一个订单的客户: 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 (可选):使用此参数可指定创建订单的应用。其中包括 Shopify POS 等应用,其应用 ID 为 129785。location_id (可选):使用此参数可指定下达订单的地点。当您在地点中导航到某个地点的详细信息页面时,可以在 Shopify 后台的 URL 中找到该地点的 ID。count (可选):使用此参数可指定下达订单的确切次数。amount (可选):使用此参数可指定一个订单的确切消费金额。sum_amount (可选):使用此参数可指定所有订单的总消费金额。date (可选):使用此参数可指定事件的日期。 |
|---|---|
| 运算符 |
MATCHES:参数为 true。NOT_MATCHES:参数为 false。IS NULL: 参数不存在。IS NOT NULL: 参数存在。对于日期,可用运算符包括: 等于: =不等于: !=大于: >小于: <小于或等于: <=大于或等于: >=介于...之间: BETWEEN
|
| 值 | |
| 格式 |
支持的格式(适用于 count, amount和 sum_amount格式:数字: #支持的格式(适用于 date格式:绝对日期: YYYY-MM-DD日期偏移量示例:
|
| 示例 |
要指定是否已下达订单,请使用 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)筛选从您的 HQ Gift Shop 地点 (1122334455) 或 Main Street 地点 (6677889900) 下达订单的客户: orders_placed MATCHES (location_id IN (1122334455,6677889900))筛选通过 Shopify POS 总共消费超过 500 美元的客户: orders_placed MATCHES (app_id = 129785, sum_amount >= 500)
|
| 备注 |
|
预测消费层级
名称: predicted_spend_tier
包含在指定的预测消费层级内的客户。详细了解预测消费层级。
| 运算符 |
等于: =不等于: !=不存在: IS NULL存在: IS NOT NULL
|
|---|---|
| 值 |
'HIGH''MEDIUM''LOW' |
| 格式 | |
| 示例 |
包含 HIGH 层级中的客户: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:参数为 true。NOT_MATCHES:参数为 false。IS NULL:参数不存在。IS NOT NULL:参数存在。对于日期,可用运算符包括: 等于: =不等于: !=大于: >小于: <小于或等于: <=大于或等于: >=介于...之间: BETWEEN
|
| 值 | |
| 格式 |
支持的格式(适用于 tag格式:字符串 (单个值)支持的 id:
=(单个值)IN :一组用英文逗号分隔的值,带有隐式“OR”,用括号括起来。例如: (id IN (1012132033639, 2012162031638, 32421429314657))。一个集合中最多包含 500 个产品 ID。支持的 date 格式:绝对日期: YYYY-MM-DD日期偏移示例:
支持的 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)
|
| 备注 |
|
RFM 群组
名称: rfm_group
根据客户被划分到的 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 订阅状态
名称: sms_subscription_status
根据客户是否订阅了您的营销 SMS 短信来筛选客户。详细了解收集客户联系信息。
| 运算符 |
等于: =不等于: !=不存在: IS NULL存在: IS NOT NULL
|
|---|---|
| 值 |
已订阅: 'SUBSCRIBED' 客户已订阅您的营销 SMS 短信。待处理: 'PENDING' 客户正在订阅您的营销 SMS 短信。待删除: 'REDACTED' 客户因 GDPR 删除请求而待删除。已退订: 'UNSUBSCRIBED' 客户已退订您的营销 SMS 短信。未订阅: 'NOT_SUBSCRIBED' 客户从未订阅过您的营销 SMS 短信。
|
| 格式 | |
| 示例 |
包括订阅了您的营销 SMS 短信的客户: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:参数为 true。NOT_MATCHES:参数为 false。IS NULL: 参数不存在。IS NOT NULL: 参数存在。对于日期,可用运算符包括: 等于: =不等于: !=大于: >小于: <小于或等于: <=大于或等于: >=介于...之间: BETWEEN
|
| 值 | |
| 格式 |
支持的 currency格式:货币代码:例如 USD支持的 balance格式:数字: #支持的 next_expiry_date 和 last_credit_date格式:绝对日期: YYY-MM-DD日期偏移示例: 7 天前: -7d4 周前: -4w3 个月前: -3m1 年前: -1y指定日期: todayyesterday |
| 示例 |
筛选商店抵扣额账户余额大于或等于 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)
|
| 备注 |
|
在线店面事件
名称: storefront.EVENT
包括根据在线店面事件进行筛选的客户。支持的事件 (EVENT) 包括以下内容:
- 已查看产品:
product_viewed - 已查看产品系列:
collection_viewed
| 函数参数 |
id(可选):使用此参数可指定要筛选的产品或产品系列。date(可选):使用此参数可为事件指定日期。count(可选):使用此参数可指定查看产品或产品系列的确切次数。产品事件特定参数: tag(可选):使用此参数可指定要筛选的产品标签。此操作与筛选具有该标签的每个产品 ID 的行为相同。 |
|---|---|
| 运算符 |
MATCHES:参数为 true。NOT_MATCHES:参数为 false。IS NULL:参数不存在。IS NOT NULL:参数存在。对于日期,可用运算符包括: 等于: =不等于: !=大于: >小于: <小于或等于: <=大于或等于: >=介于...之间: BETWEEN
|
| 值 | |
| 格式 |
支持的 id:
=(单个值)IN :一组用英文逗号分隔的值,带有隐式“OR”,用括号括起来。例如: (id IN (1012132033639, 2012162031638, 32421429314657))一个集合中最多包含 500 个产品或产品系列 ID。支持的 tag:
字符串 (单个值)支持的 date 格式:
绝对日期: YYYY-MM-DD日期偏移示例:
命名日期为默认值,无法更改。对于自定义日期,请使用日期偏移。 |
| 示例 |
使用 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)
|
| 备注 |
|