客户细分指的是在 SHOPLINE Admin 筛选出的满足指定条件客户的分组，客户细分条件即这些条件的集合。例如：商家可以将所有订阅电子邮件营销的客户保存为一个客户细分。

你可以使用 Admin GraphQL API 中的 segmentCreate API 创建客户细分，本文主要介绍客户细分条件的组成以及如何创建 segmentCreate API 中的 query 参数。

客户细分条件组成​

客户细分条件由多个条件组组成，条件组之间可以是且、或、除关系。例如，邮箱订阅状态等于已订阅 且 客户状态等于已注册 是一个条件组。

每个条件组由多个条件或条件组组成，条件之间可以是且、或关系。例如，邮箱订阅状态等于已订阅 是一个条件。

1.jpg

条件​

SHOPLINE Admin 提供了丰富的条件供商家创建客户细分。

条件列表中文.jpg

条件组​

条件组由多个条件或条件组组成。下图中的 1、2、3 都是条件组。

image13.jpg

组合条件​

组合条件是包含固定条件和条件关系的条件组。

例如下图中的 购买过指定商品 条件，它的含义是在指定时间段内购买过指定商品的客户，它由 购买过指定商品 和 下单时间 两个条件组成，这两个条件之间是且关系，这种条件我们称为组合条件。

在 组合条件字段详细说明 里列举了所有的组合条件。组合条件的组成规则是固定的，不能自定义组合。

3.jpg

创建客户细分条件​

你可以使用 Admin GraphQL API 中的 segmentCreate API 创建客户细分，该 API 中 query 参数可以通过以下方式创建。

条件​

数据结构​

通过以下 JSON 对象可以创建一个 客户状态 等于 已注册 条件。

{
    "type": 0,
    "metafield": false,
    "mfType": null,
    "key": "status",
    "value": [
        3
    ],
    "operator": "IN",
    "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"ENUM\"}",
}

image001.jpg

字段说明​

字段类型是否必填说明
typeNumber是固定为 0，表示这是一个条件
metafieldBoolean否是否为 元字段 条件，true 表示是元字段条件
mfTypeEnumMFType否元字段类型，metafield 为 true 时必填
keyString是条件唯一标识，可参考 条件字段详细说明
valueArray是条件值，可参考 条件字段详细说明
operatorEnumOperator是条件查询时的操作符
extInfoExtInfo是用于控制在 SHOPLINE Admin 页面上展示客户细分的交互

extInfo

extInfo 是一个 JSON 字符串，他的作用是让 SHOPLINE Admin 页面根据不同的条件类型展示不同的交互。

例如：邮箱订阅状态 和 上次购买时间 将展示不同的交互效果：

{
    "key": "emailSubscribeStatus",
    "type": 0,
    "operator": "IN",
    "value": [
        1,
        2
    ],
    "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"ENUM\"}"
}

image1.jpg

{
    "key": "lastOrderTime",
    "type": 0,
    "operator": "BETWEEN",
    "value": [
        1
    ],
    "extInfo": "{\"componentType\":\"DATE\",\"dateType\":\"LAST_7_DAY\"}"
}

image2.jpg

每个条件详细的 extInfo 取值可参考 条件字段详细说明。

EnumOperator

每个条件可选的 operator 值可参考 条件字段详细说明。

EnumMFType

value说明
date日期&单值
date_time时间&单值
number_integer整数&单值
number_decimal小数&单值
single_line_text_field单行文本&单值
multi_line_text_field多行文本
color颜色&单值
boolean布尔值
list.date日期&多值
list.date_time时间&多值
list.number_integer整数&多值
list.number_decimal小数&多值
list.single_line_text_field单行文本&多值
list.color颜色&多值

条件组​

数据结构​

通过以下 JSON 对象可以创建一个条件组。

{
    "type": 1,
    "blockType": 0,
    "relation": "and",
    "children": [
        {
            "type": 0,
            "blockType": 0,
            "key": "emailDomain",
            "value": [
                "@gmail.com"
            ],
            "operator": "IN",
            "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"LIST_PAGE\",\"listSource\":\"emailDomain\",\"label\":[\"@gmail.com\"]}"
        },
        {
            "type": 0,
            "blockType": 0,
            "key": "language",
            "value": [
                "en"
            ],
            "operator": "IN",
            "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"LIST\",\"listSource\":\"language\",\"label\":[\"English\"]}"
        }
    ]
}

image002.jpg

字段说明​

字段类型是否必填说明
typeNumber是固定为 1，表示这是一个条件组
blockTypeNumber是需要展示为 组合条件 时传 1，否则传 0
keyString否blockType 为 1 时必填，取值请参考 组合条件
relationString是children 之间的逻辑关系，可选 and 或 or。and 表示 children 之间是且关系，or 表示 children 之间是或关系
childrenArray是条件或条件组数据集合

条件组合逻辑​

客户细分条件由满足的条件和不满足的条件两部分组成。

满足的条件​

满足的条件由多个条件组组成。对应下图中蓝框部分，在 query 参数中对应 conditions 字段。

cond1.jpg

示例：

{
    "conditions": {
        "type": 1,
        "relation": "and",
        "blockType": 0,
        "children": [
            {
                "type": 1,
                "blockType": 0,
                "relation": "and",
                "children": [
                    {
                        "type": 0,
                        "blockType": 0,
                        "key": "emailDomain",
                        "value": [
                            "@gmail.com"
                        ],
                        "operator": "IN",
                        "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"LIST_PAGE\",\"listSource\":\"emailDomain\",\"label\":[\"@gmail.com\"]}",
                    },
                    {
                        "type": 0,
                        "blockType": 0,
                        "key": "language",
                        "value": [
                            "en"
                        ],
                        "operator": "IN",
                        "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"LIST\",\"listSource\":\"language\",\"label\":[\"English\"]}",
                    }
                ]
            },
            {
                "type": 1,
                "blockType": 0,
                "relation": "and",
                "children": [
                    {
                        "type": 0,
                        "blockType": 0,
                        "key": "userSource",
                        "value": [
                            "1",
                            "2"
                        ],
                        "operator": "IN",
                        "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"ENUM\"}",
                    },
                    {
                        "type": 0,
                        "blockType": 0,
                        "key": "status",
                        "value": [
                            3
                        ],
                        "operator": "IN",
                        "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"ENUM\"}",
                    }
                ]
            }
        ]
    }
}

不满足的条件​

不满足的条件也是一个条件组，但它内部只能添加一个条件组。对应下图中蓝框部分，在 query 参数中对应 not 字段。

not1.jpg

示例：

{
    "not": {
        "type": 1,
        "relation": "and",
        "blockType": 0,
        "children": [
            {
                "type": 1,
                "blockType": 0,
                "relation": "and",
                "children": [
                    {
                        "type": 0,
                        "blockType": 0,
                        "key": "status",
                        "value": [
                            0
                        ],
                        "operator": "IN",
                        "relation": null,
                        "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"ENUM\"}",
                    },
                    {
                        "type": 0,
                        "blockType": 0,
                        "key": "ageLevel",
                        "value": [
                            4
                        ],
                        "operator": "IN",
                        "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"ENUM\"}",
                    }
                ]
            }
        ]
    }
}

完整示例​

以下是 segmentCreate API 中 query 参数的完整示例，注意需要将它转换为 JSON string 传入 API。

{
    "conditions": {
        "type": 1,
        "relation": "and",
        "blockType": 0,
        "children": [
            {
                "type": 1,
                "blockType": 0,
                "relation": "and",
                "children": [
                    {
                        "type": 0,
                        "blockType": 0,
                        "key": "emailDomain",
                        "value": [
                            "@gmail.com"
                        ],
                        "operator": "IN",
                        "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"LIST_PAGE\",\"listSource\":\"emailDomain\",\"label\":[\"@gmail.com\"]}",
                    },
                    {
                        "type": 0,
                        "blockType": 0,
                        "key": "language",
                        "value": [
                            "en"
                        ],
                        "operator": "IN",
                        "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"LIST\",\"listSource\":\"language\",\"label\":[\"English\"]}",
                    }
                ]
            },
            {
                "type": 1,
                "blockType": 0,
                "relation": "and",
                "children": [
                    {
                        "type": 0,
                        "blockType": 0,
                        "key": "userSource",
                        "value": [
                            "1",
                            "2"
                        ],
                        "operator": "IN",
                        "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"ENUM\"}",
                    },
                    {
                        "type": 0,
                        "blockType": 0,
                        "key": "status",
                        "value": [
                            3
                        ],
                        "operator": "IN",
                        "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"ENUM\"}",
                    }
                ]
            }
        ]
    },
    "not": {
        "type": 1,
        "relation": "and",
        "blockType": 0,
        "children": [
            {
                "type": 1,
                "blockType": 0,
                "relation": "and",
                "children": [
                    {
                        "type": 0,
                        "blockType": 0,
                        "key": "status",
                        "value": [
                            0
                        ],
                        "operator": "IN",
                        "relation": null,
                        "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"ENUM\"}",
                    },
                    {
                        "type": 0,
                        "blockType": 0,
                        "key": "ageLevel",
                        "value": [
                            4
                        ],
                        "operator": "IN",
                        "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"ENUM\"}",
                    }
                ]
            }
        ]
    }
}

image003.jpg

Admin GraphQL 示例

mutation {
  segmentCreate(name: "Demo1", query: "{\"conditions\":{\"type\":1,\"relation\":\"and\",\"blockType\":0,\"children\":[{\"type\":1,\"blockType\":0,\"relation\":\"and\",\"children\":[{\"type\":0,\"blockType\":0,\"key\":\"emailDomain\",\"value\":[\"@gmail.com\"],\"operator\":\"IN\",\"extInfo\":\"{\\\"operatorType\\\":\\\"EQ\\\",\\\"componentType\\\":\\\"LIST_PAGE\\\",\\\"listSource\\\":\\\"emailDomain\\\",\\\"label\\\":[\\\"@gmail.com\\\"]}\"},{\"type\":0,\"blockType\":0,\"key\":\"language\",\"value\":[\"en\"],\"operator\":\"IN\",\"extInfo\":\"{\\\"operatorType\\\":\\\"EQ\\\",\\\"componentType\\\":\\\"LIST\\\",\\\"listSource\\\":\\\"language\\\",\\\"label\\\":[\\\"English\\\"]}\"}]},{\"type\":1,\"blockType\":0,\"relation\":\"and\",\"children\":[{\"type\":0,\"blockType\":0,\"key\":\"userSource\",\"value\":[\"1\",\"2\"],\"operator\":\"IN\",\"extInfo\":\"{\\\"operatorType\\\":\\\"EQ\\\",\\\"componentType\\\":\\\"ENUM\\\"}\"},{\"type\":0,\"blockType\":0,\"key\":\"status\",\"value\":[3],\"operator\":\"IN\",\"extInfo\":\"{\\\"operatorType\\\":\\\"EQ\\\",\\\"componentType\\\":\\\"ENUM\\\"}\"}]}]},\"not\":{\"type\":1,\"relation\":\"and\",\"blockType\":0,\"children\":[{\"type\":1,\"blockType\":0,\"relation\":\"and\",\"children\":[{\"type\":0,\"blockType\":0,\"key\":\"status\",\"value\":[0],\"operator\":\"IN\",\"relation\":null,\"extInfo\":\"{\\\"operatorType\\\":\\\"EQ\\\",\\\"componentType\\\":\\\"ENUM\\\"}\"},{\"type\":0,\"blockType\":0,\"key\":\"ageLevel\",\"value\":[4],\"operator\":\"IN\",\"extInfo\":\"{\\\"operatorType\\\":\\\"EQ\\\",\\\"componentType\\\":\\\"ENUM\\\"}\"}]}]}}") {
    segment {
      id
      name
      query
      creationDate
      lastEditDate
    }
    userErrors {
      code
      field
      message
    }
  }
}

字段详细说明​

条件字段详细说明​

以下将按照不同的条件类型（例如：日期、列表选择、金额输入等），说明每个字段的传值方式：

日期​

传入预设区间或者自定义日期区间。

value​

自定义日期区间传时间戳数组，例如：[1701705600000, 1702051199999]；
预设区间传入枚举，例如 [1]。

预设枚举说明
0今天
1过去7天
2过去30天
3过去90天
4过去12个月

operator​

自定义日期区间传 BETWEEN；预设区间传 EQ。

extInfo​

keyvalue
componentType固定传 DATE
dateType自定义区间：CUSTOME，今天：TODAY，过去7天：LAST_7_DAY，过去30天：LAST_30_DAY，过去90天：LAST_90_DAY，过去12个月：LAST_12_MONTH

key​

以下条件是日期类型：

条件key名称说明
createTime客户加入日期店铺首次获得客户信息的日期
singleOrderAmountTime下单时间在 组合条件 中和 singleOrderAmount 一起使用
firstOrderTime首单时间客户首次成单的时间
lastOrderTime上次购买时间客户上次成单的时间
lastAbandonedCreateTime最近一次弃单时间客户最近一次发生弃单的时间
lastLoginTime最近一次登录时间客户最近一次登录网店的时间
loginChannelTime访问时间在 组合条件 中和 loginChannel 一起使用
lastCartCreateTime最近一次加购时间客户最近一次将商品添加到购物车的时间
purchasedItemTime下单时间在 组合条件 中和 purchasedItem 一起使用
purchasedCateTime下单时间在 组合条件 中和 purchasedCate 一起使用

示例​

{
    "key": "lastLoginTime",
    "type": 0,
    "operator": "EQ",
    "value": [
        2
    ],
    "extInfo": "{\"componentType\":\"DATE\",\"dateType\":\"LAST_30_DAY\"}"
}

整数​

传入一个整数范围。

value​

operator 为 BETWEEN 时传入两个整数组成的数组，例如：[2, 10]；
其他情况传入一个整数组成的数组，例如：[10]。

operator​

value说明
EQ等于
NE不等于
GT大于
LT小于
BETWEEN区间

extInfo​

keyvalue
componentType固定传 NUMBER

key​

以下条件是整数类型：

条件key名称说明
payOrderCnt订单数量历史累计成单的订单数量
loginCount访问次数客户90天内访问网店的次数

示例​

{
    "key": "loginCount",
    "type": 0,
    "operator": "EQ",
    "value": [
        2
    ],
    "extInfo": "{\"componentType\":\"NUMBER\"}"
}

小数​

传入一个小数范围。

value​

operator 为 BETWEEN 时传入两个小数组成的数组，例如：[2.3, 10.9]；
其他情况传入一个小数组成的数组，例如：[2.3]。

operator​

value说明
EQ等于
NE不等于
GT大于
LT小于
BETWEEN区间

extInfo​

keyvalue
componentType固定传 FLOAT

key​

目前只有 元字段条件 有小数类型。

示例​

{
    "key": "my_fields.float",
    "type": 0,
    "operator": "EQ",
    "value": [
        1.33
    ],
    "metafield": true,
    "mfType": "list.number_decimal",
    "extInfo": "{\"componentType\":\"FLOAT\",\"mfName\":\"小数\"}"
}

金额​

传入一个金额范围，以分为单位，例如：￥20 对应 2000。

value​

operator 为 BETWEEN 是传入两个金额组成的数组，例如：[2000, 10000]；
其他情况传入一个金额组成的数组，例如：[10000]。

operator​

value说明
EQ等于
NE不等于
GT大于
LT小于
BETWEEN区间

extInfo​

keyvalue
componentType固定传 PRICE

key​

以下条件是金额类型：

条件key名称说明
totalAmount消费金额历史累计的消费金额
singleOrderAmount单次消费金额历次成单的订单金额
unitPrice客单价客户平均每笔订单的消费金额
preferPrice价格偏好根据客户的购买记录计算出的客户偏好的商品价格
preferDiscount优惠敏感度根据客户的购买记录计算出的客户偏好的每笔订单中的优惠金额

示例​

{
    "key": "totalAmount",
    "type": 0,
    "operator": "EQ",
    "value": [
        20000
    ],
    "extInfo": "{\"componentType\":\"PRICE\"}"
}

布尔​

传入布尔值。

value​

true 或 false。

operator​

value说明
EQ等于
NE不等于

extInfo​

keyvalue
componentType固定传 BOOLEAN

key​

目前只有 元字段条件 有布尔类型。

示例​

{
    "key": "my_fields.vip",
    "type": 0,
    "operator": "EQ",
    "value": false,
    "metafield": true,
    "mfType": "boolean",
    "extInfo": "{\"componentType\":\"BOOLEAN\",\"mfName\":\"重要客户\"}"
}

地址​

传入一个地址对象。

value​

key类型是否必填说明
countryString是国家或地区
countryCodeString是国家的 ISO 代码，采用 ISO 3166-1 (alpha 2) 格式
provinceString是省份
provinceCodeString是省份编码
cityString是城市
cityCodeString是城市编码
districtString是地区
districtCodeString是地区编码

operator​

value说明
EQ等于
NE不等于

extInfo​

keyvalue
componentType固定传 ADDRESS

key​

以下条件是地址类型：

条件key名称说明
address地址客户所在的国家、省份、城市

示例​

{
    "key": "address",
    "type": 0,
    "operator": "EQ",
    "value": {
        "countryCode": "US",
        "country": "United States",
        "provinceCode": "4200001",
        "province": "Alabama",
        "cityCode": "",
        "city": "",
        "districtCode": "",
        "district": ""
    },
    "extInfo": "{\"componentType\":\"ADDRESS\"}"
}

标签​

SHOPLINE 预设了一些推荐标签，通过这些标签条件可以快速筛选出指定的客户人群。

operator​

固定传 EQ。表示属于此标签人群。

value​

固定传 1。表示属于此标签人群。

extInfo​

keyvalue
componentType固定传 TAG
subGroup标签分类，参考下方表格

key​

以下条件是标签类型：

条件key名称说明subGroup
isLoginNotPay访问未下单客户访问过店铺但未成单的客户attractNew
isAddCartNotPayIn30近30天加购未下单客户近30天订阅邮件并且有过加购，但是没有下单的客户attractNew
isAbandonedIn30近30天弃单客户近30天内订阅邮件并且有过弃单的客户attractNew
isNotOrderIn30订阅邮件30天内未下单客户近30天内订阅邮件并且未下单的客户attractNew
isFirstOrder订阅邮件的首单客户订阅邮件并且只购买过一次的客户oldRepurch
isRecentHighConsume最近高消费金额客户近90天有过高消费金额的客户oldRepurch
isRecentHighOrder最近高下单数量客户近90天有过高下单次数的客户oldRepurch
isRecentConsumed近期消费过的客户近90天消费过的客户lossRecovery
isOnceActived曾经活跃的客户过去有过高消费但是最近12个月没有消费的客户lossRecovery
isRecentAbandoned近期弃单的客户最近30天有过弃单的客户lossRecovery
isHighValue高价值客户根据RFM计算出的高价值客户keyPperations
isBirthdayInNextMonth下月生日客户下个月过生日的客户keyPperations
isRecentActived近期活跃客户30天内有过登录的客户keyPperations
isRepurchased复购人群客户生命周期为复购阶段的客户keyPperations

示例​

{
    "key": "isNotOrderIn30",
    "type": 0,
    "operator": "EQ",
    "value": 1,
    "extInfo": "{\"subGroup\":\"attractNew\",\"componentType\":\"TAG\",}"
}

枚举列表​

传入一个枚举数据集合。例如 客户状态 的可选值是 黑名单、待邀请、已邀请、已注册，它们不会因商家的客户数据不同而变化。

key​

以下条件是枚举列表类型：

条件key名称说明
userSource客户加入渠道店铺首次获得客户的来源渠道
platform客户加入平台店铺首次获得客户的平台销售渠道
status客户状态客户状态
emailSubscribeStatus邮箱订阅状态客户的电子邮件订阅状态
gender性别客户性别
ageLevel年龄客户年龄阶段
birthdayMonth生日所在月客户生日所在的月份
smsSubscribeStatus短信订阅状态客户的短信订阅状态
preferActivity活动类型偏好根据客户的购买记录计算出的客户偏好的活动类型
rfmRFM价值根据客户的消费金额、消费次数、最近消费时间综合计算得到的客户价值
customerCycle客户生命周期按生命周期分布的客户数量，分为潜客、首单、复购、流失客户

value​

key 对应以下枚举值的集合，例如：[1, 2]

userSource​
value说明
1后台导入
2网店注册
3线下门店
4店铺搬迁
5POS注册
6Multipass联合登录
7Storefront
8手动创建
16社交媒体
17API创建
18网站订阅
19未登录下单
20Google
23TikTok
24Shop App
25Marketplace
26Apple
platform​
value说明
1shopify
2bigcommerce
3woocommerce
4lightspeed
5shoplazza
6etsy
7zalora
8kogan
9amazon
10ebay
status​
value说明
0黑名单
1待邀请
2已邀请
3已注册
emailSubscribeStatus​
value说明
0已取消订阅
1已订阅
2未订阅
3订阅确认中
5无效
gender​
value说明
0未知
1男
2女
3不透露
ageLevel​
value说明
00 - 20
121 - 30
231 - 40
341 - 50
451 - 60
561 - 70
671 - 100
birthdayMonth​
value说明
11月
22月
33月
44月
55月
66月
77月
88月
99月
1010月
1111月
1212月
smsSubscribeStatus​
value说明
0已取消订阅
1已订阅
2未订阅
preferActivity​
value说明
0折扣活动
1限时活动
2捆绑活动
4组合套餐
5赠品活动
6预售活动
rfm​
value说明
0重要价值客户
1一般价值客户
2重要发展客户
3一般发展客户
4重要保持客户
5一般保持客户
6重要挽留客户
7一般挽留客户
customerCycle​
value说明
0潜客
1首单
2复购
3流失

extInfo​

keyvalue
componentType固定传 ENUM
operatorType固定传 EQ

operator​

value说明
IN包含
NOT_IN不包含

示例​

{
    "key": "status",
    "type": 0,
    "operator": "IN",
    "value": [
        3,
        0
    ],
    "extInfo": "{\"operatorType\":\"EQ\",\"componentType\":\"ENUM\"}"
}

动态数据列表​

传入一个动态数据值集合。例如 购买过指定商品 的可选值会根据商家的商品数据不同而变化。

value​

动态数据值集合，例如：数据源是商品，则传入商品id集合，['productId111', 'productId222']。

extInfo​

key类型value说明
componentTypestringLIST、LIST_PAGE。按照下方表格中和条件key的对应关系传入影响查询数据源的方式。LIST 表示调用接口一次性查出并显示所有可选值；LIST_PAGE 表示分页调用接口并展示可选值；
operatorTypestringEQ、IN。按照下方表格中和条件key的对应关系传入影响页面上的操作符显示文案。EQ 显示为 等于 和 不等于，IN 显示为 包含 和 不包含，具体效果参考下方截图
listSourcestring按照下方表格中和条件key的对应关系传入数据源
labelArray[string]例如 value 传入的是商品id集合，label 就传入商品名称集合value 对应的显示文本

Screenshot2.jpg

Screenshot3.jpg

key​

以下条件是动态数据列表类型：

条件key名称说明componentTypeoperatorTypelistSource
language客户语言客户访问店铺使用的语言LISTEQlanguage
lastLoginChannel最近一次访问渠道客户最近一次访问网店时的来源渠道LISTEQloginChannel
loginChannel访问过的渠道客户90天内访问网店时的来源渠道LISTEQloginChannel
purchasedCate购买过指定分类购买过指定分类的商品LISTINcategoryList
preferCate商品分类偏好根据客户的购买记录计算出的客户偏好的商品分类LISTINcategoryList
emailDomain邮箱域名客户的邮箱域名LIST_PAGEEQemailDomain
purchasedItem购买过指定商品购买过指定的商品LIST_PAGEINproductList
preferItemTag商品标签偏好根据客户的购买记录计算出的客户偏好的商品标签LIST_PAGEINproductLabelList
customerTag客户标签客户列表中人工为客户添加的标签LIST_PAGEINcustomerLabelList

operator​

value说明
IN包含
NOT_IN不包含

示例​

{
    "key": "purchasedCate",
    "type": 0,
    "operator": "IN",
    "value": [
        "12257647834446320149372682",
        "12257647834482223391662682"
    ],
    "extInfo": "{\"operatorType\":\"IN\",\"componentType\":\"LIST\",\"listSource\":\"categoryList\",\"label\":[\"fashion shirt\",\"summer vacation\"]}"
}

元字段​

所有属于客户模块下的元字段都可以作为条件。了解 元字段 更多信息。

key​

{metafield.namespace}.{metafield.key}，例如：my_fields.date。

value/operator/extInfo​

这些参数按照对应的条件类型传入。元字段类型和条件类型映射关系：

元字段类型条件类型说明
date日期-
date_time
list.date
list.date_time
boolean布尔-
single_line_text_field动态数据列表extInfo.componentType 传 LIST_PAGE_FRONT
list.single_line_text_field
multi_line_text_field
color
list.color
number_decimal小数-
list.number_decimal
number_integer整数-
list.number_integer
extInfo​

除了各类型条件需要的参数之外，还需要传入以下参数：

key类型是否必填说明
mfNamestring是元字段名称

示例​

{
    "key": "my_fields.date",
    "type": 0,
    "operator": "EQ",
    "value": [
        3
    ],
    "metafield": true,
    "mfType": "list.date",
    "extInfo": "{\"componentType\":\"DATE\",\"mfName\":\"日期\",\"dateType\":\"LAST_90_DAY\"}"
}

组合条件字段详细说明​

relation​

组合条件内的条件之间是且关系，固定传 and。

key​

以下条件是组合条件：

条件key名称包含的基础条件
singleOrderAmount单次消费金额singleOrderAmount 和 singleOrderAmountTime
loginChannel访问过的渠道loginChannel 和 loginChannelTime
purchasedItem购买过指定商品purchasedItem 和 purchasedItemTime
purchasedCate购买过指定分类purchasedCate 和 purchasedCateTime

购买过指定商品 示例

{
    "key": "purchasedItem",
    "type": 1,
    "relation": "and",
    "blockType": 1,
    "children": [
        {
            "key": "purchasedItem",
            "type": 0,
            "operator": "IN",
            "value": [
                "16054924754902568180002744"
            ],
            "extInfo": "{\"operatorType\":\"IN\",\"componentType\":\"LIST_PAGE\",\"listSource\":\"productList\",\"label\":[\"Halloween Pumpkin Print T-shirt\"]}"
        },
        {
            "key": "purchasedItemTime",
            "type": 0,
            "operator": "EQ",
            "value": [
                2
            ],
            "extInfo": "{\"componentType\":\"DATE\",\"dateType\":\"LAST_30_DAY\"}"
        }
    ],
}

3.jpg

这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.