客户标签
一、需求背景
平台运营人员需要通过客户标签识别客户特征、完成客户分层,并将标签用于客户查询、精准营销和服务跟进。
本期在平台管理端会员模块新增“客户标签”菜单,由平台管理员统一管理平台客户标签,并为平台会员手动或自动打标。
本期不开放店铺会员打标签功能,但标签的数据模型、权限模型和服务接口必须预留“标签归属范围”,便于后续增加店铺自有标签,且不能与平台标签相互覆盖或误删。
二、菜单与权限
1. 菜单位置
平台管理端菜单路径:
客户 > 客户标签
客户标签页面包含以下功能:
- 标签管理
- 手动打标签
- 自动打标签
- 标签客户查询
- 标签变更记录
2. 权限控制
| 权限 | 说明 |
|---|---|
| 查看客户标签 | 查看标签列表、标签客户和变更记录 |
| 手动打标签 | 为单个或批量客户添加、移除标签 |
| 管理客户标签 | 新建、编辑、停用标签组及标签 |
| 管理自动规则 | 新建、编辑、启用和停用自动打标规则 |
| 删除客户标签 | 删除符合删除条件的标签 |
本期以上权限仅配置给平台管理端角色。后续增加店铺会员标签时,应建立独立的店铺端菜单和权限,不复用平台管理员权限。
三、产品目标
- 建立统一的平台客户标签体系,减少名称重复和口径不一致。
- 支持运营人员对单个或批量客户手动添加、移除标签。
- 支持系统根据客户属性、交易和商品等条件自动打标。
- 支持在会员列表按标签筛选客户。
- 所有标签变更均可查询和追溯。
四、标签模型
1. 标签归属范围
标签组必须具有明确的归属范围:
| 标签范围 | 范围编码 | 本期状态 | 说明 |
|---|---|---|---|
| 平台标签 | PLATFORM | 开放 | 由平台管理员创建,可对平台会员打标 |
| 店铺标签 | SHOP | 预留 | 由店铺创建,仅能对本店会员打标 |
本期所有新建标签组默认为平台标签,管理端不展示范围选择项,由系统写入 PLATFORM。
平台标签的数据口径:
- 打标对象为平台会员,不包含未形成平台会员身份的匿名访客。
- 手动打标时可以从平台会员列表选择会员。
- 交易、商品和积分等自动条件默认统计会员在平台全部店铺的数据。
- 如果规则需要限定指定店铺,应将“店铺范围”作为自动规则条件,而不是把标签变为店铺标签。
预留规则:
- 标签组、标签、自动规则、客户标签关系和变更记录均需要保存标签范围。
- 店铺标签还需保存店铺 ID;平台标签的店铺 ID 为空。
- 平台标签和店铺标签允许重名,两者通过范围和店铺 ID 隔离。
- 平台管理员只能管理平台标签;店铺只能管理本店标签。
- 后续店铺端可只读展示平台标签,但不得修改、替换或删除平台标签。
- 店铺标签不得影响平台标签的自动规则和统计人数,平台标签也不得覆盖店铺标签。
2. 标签组
标签必须归属标签组。标签组用于组织同一业务维度下的标签,例如:
- 客户价值:低价值、中价值、高价值
- 购买阶段:未购买、已首购、已复购
- 商品偏好:服装、数码、食品
标签组支持两种组内规则:
| 组内规则 | 说明 | 示例 |
|---|---|---|
| 组内唯一 | 一个客户最多拥有组内一个标签 | 客户价值、购买阶段 |
| 组内多选 | 一个客户可以拥有组内多个标签 | 商品偏好、颜色偏好 |
3. 打标方式
每个标签可以配置以下打标方式:
- 仅手动:只能由有权限的管理员添加或移除。
- 仅自动:只能由自动规则添加或移除,不能人工修改。
- 手动和自动:两种方式均可使用,系统分别记录来源。
同一个客户与同一个标签在页面上只展示一次。标签同时存在手动和自动来源时,移除其中一个来源不会影响另一个来源。
五、标签管理
1. 标签列表
管理端进入“客户 > 客户标签”后展示标签组及标签列表。
| 字段 | 说明 |
|---|---|
| 标签组名称 | 标签所属业务分类 |
| 标签名称 | 标签具体名称 |
| 组内规则 | 组内唯一或组内多选 |
| 打标方式 | 手动、自动、手动和自动 |
| 客户数 | 当前拥有该标签的去重客户数 |
| 自动规则状态 | 草稿、计算中、已启用、已停用、执行失败 |
| 更新时间 | 标签或规则最后修改时间 |
| 操作 | 查看客户、编辑、启停、复制、删除 |
支持按标签组名称、标签名称和状态筛选。
2. 新建标签组
| 字段 | 是否必填 | 规则 |
|---|---|---|
| 标签组名称 | 是 | 1~20 个字符,同一标签范围内不可重名 |
| 标签组说明 | 否 | 最多 100 个字符 |
| 组内规则 | 是 | 组内唯一或组内多选 |
| 标签名称 | 是 | 至少添加一个;每个 1~20 个字符;同组不可重名 |
| 打标方式 | 是 | 至少选择手动或自动中的一种 |
| 标签颜色 | 否 | 用于管理端识别 |
标签组已有客户标签关系后,不允许直接切换组内规则。需要先处理已有冲突关系。
3. 编辑、停用与删除
- 修改标签名称不影响客户已有标签关系,并记录操作日志。
- 停用标签后,不允许继续添加该标签,但保留客户已有标签及历史记录。
- 停用自动规则后,停止增量计算。管理员可选择保留或清除该规则产生的标签,默认保留。
- 删除标签前展示当前标签客户数和业务引用情况。
- 存在客户关系或被营销活动引用的标签不允许直接删除,应先停用并解除引用。
六、手动打标签
1. 操作入口
- 会员列表:选择单个或多个会员后,点击“添加标签”或“移除标签”。
- 会员详情:在客户标签区域添加或移除标签。
2. 添加标签
- 管理员选择一个或多个会员。
- 点击“添加标签”。
- 在弹窗中按标签组查看或搜索标签。
- 选择标签并确认。
- 系统校验标签状态、操作权限和组内规则。
- 页面反馈成功、跳过和失败数量,并写入变更记录。
业务规则:
- 单次同步操作最多处理 1,000 个客户;超过 1,000 个时创建异步任务。
- 重复添加同一标签时保持幂等,不重复展示和计数。
- 仅展示允许手动打标且状态正常的标签。
- 组内多选标签可以选择多个。
- 组内唯一标签会替换客户在该组内已有的手动标签,操作前提示预计替换人数。
3. 移除标签
- 普通手动移除只移除标签的手动来源。
- 标签仍存在自动来源时,提示“人工标签已移除,客户仍满足自动规则”,标签继续展示。
- 自动来源只能由自动规则失效、停用规则时选择清除,或由具备规则管理权限的管理员处理。
- 批量任务提供成功、失败和跳过数量,失败明细支持下载。
七、自动打标签
1. 创建规则
管理员为允许自动打标的标签配置规则。一个标签在同一时间只能启用一个规则版本。
规则由以下内容组成:
- 条件关系:满足全部条件(AND)或满足任一条件(OR)。
- 规则条件:指标、运算符和条件值。
- 自动移除:客户不再满足规则时,是否移除该规则产生的标签。
- 规则优先级:组内唯一标签同时命中时,优先级高的规则生效。
第一期不支持嵌套 AND/OR 条件组。
2. 自动条件
| 分类 | 条件 | 可选规则 | 数据口径 |
|---|---|---|---|
| 客户属性 | 注册时间 | 最近 N 天、自定义区间、早于、晚于 | 会员账号创建时间 |
| 客户属性 | 会员等级 | 是、不是、属于任一 | 当前有效等级 |
| 客户属性 | 手机号、地区、性别、生日 | 有值、无值、等于、属于 | 当前会员资料 |
| 交易 | 累计支付次数 | 等于、大于、大于等于、小于、小于等于、区间 | 支付成功且未全额退款的订单数 |
| 交易 | 累计消费金额 | 数值比较、区间 | 支付金额减成功退款金额 |
| 交易 | 客单价 | 数值比较、区间 | 累计消费金额除以有效支付订单数 |
| 交易 | 首次或最后消费时间 | 最近 N 天、自定义区间、早于、晚于、无消费 | 以支付成功时间为准 |
| 商品 | 购买过指定商品 | 任一或全部商品、分类、品牌 | 存在支付成功且未全额退款的订单明细 |
| 店铺 | 在指定店铺产生交易 | 任一或全部店铺 | 用于限定平台标签规则的数据来源范围 |
| 资产 | 当前积分、累计获得积分 | 数值比较、区间 | 当前积分账户数据 |
客单价在没有有效订单时按“无值”处理,不按 0 元计算。
3. 保存与启用
- 保存前校验数值、时间区间及必填条件。
- AND 条件存在明显互斥时,阻止启用并提示具体条件。
- 支持“预估人数”,展示基于当前数据计算的预计命中客户数和计算时间。
- 规则可保存为草稿,也可保存并启用。
- 启用新规则后,对历史客户执行一次全量计算。
- 修改已启用规则时生成新版本;新版本校验成功后切换并重新计算。
4. 执行机制
- 实时计算:订单支付、退款、客户资料、会员等级或积分发生变化时,重新计算相关规则。
- 定时计算:包含“最近 N 天”等时间滑动条件的规则,每日重新计算。
- 历史补算:新规则启用时计算规则创建前的全部客户。
- 自动移除开启后,客户不再满足条件时只移除当前规则产生的自动来源。
- 自动移除关闭时,客户不再满足条件也保留已有标签。
- 同一事件重复处理不得生成重复关系或重复变更记录。
5. 组内唯一冲突
组内唯一标签采用以下优先级:
- 手动标签优先于自动标签。
- 多个人工操作冲突时,以最后一次有效操作为准。
- 多个自动规则同时命中时,以配置的规则优先级为准。
自动规则的优先级数字越小,优先级越高。
6. 执行异常
- 规则任务失败后自动重试。
- 连续重试失败时,规则状态变为“执行失败”,并通知管理员。
- 新规则版本执行失败时继续保留上一版本的有效结果。
- 规则依赖的商品、分类或品牌被删除后,规则状态变为“配置异常”,停止新增打标并保留已有结果。
八、会员列表与会员详情
1. 会员列表
会员列表新增“客户标签”筛选项:
- 包含任一标签
- 包含全部标签
- 不包含任一标签
会员列表最多直接展示 3 个标签,超出部分显示“+N”。支持按标签筛选后批量打标或导出客户。
2. 会员详情
会员详情新增“客户标签”区域:
- 按标签组展示客户当前标签。
- 展示标签来源、添加时间、操作人或自动规则名称。
- 同一标签存在多个来源时展示全部有效来源。
- 提供添加、移除标签入口。
- 提供标签变更记录入口。
九、标签变更记录
每一次标签变化都必须记录以下信息:
| 字段 | 说明 |
|---|---|
| 客户 | 客户 ID、昵称或手机号脱敏信息 |
| 标签 | 标签组和标签名称 |
| 动作 | 添加、移除或替换 |
| 来源 | 手动、自动规则或业务活动 |
| 触发原因 | 人工操作、规则命中、规则失效、退款等 |
| 操作主体 | 管理员或自动规则名称及版本 |
| 操作时间 | 标签关系发生变化的时间 |
| 任务编号 | 批量任务或规则任务编号 |
支持按客户、标签、动作、来源和时间范围筛选。标签日志普通用户不可修改或删除,保存时间不少于两年。
十、任务中心
批量手动打标、历史全量计算和规则重新计算均创建任务。
任务状态包括:排队中、执行中、部分成功、成功、失败、已取消。
任务详情展示:
- 总客户数
- 成功数
- 跳过数
- 失败数
- 开始和结束时间
- 失败原因及明细下载
仅排队中的任务允许取消。
十一、边界处理
- 客户在任务执行期间被删除:跳过并记录“客户不存在”。
- 标签在任务期间被停用:未执行部分不再添加,记录失败原因。
- 订单部分退款:累计消费金额按退款后净额计算,订单次数仍计一次。
- 订单全额退款:累计消费金额、消费次数和购买商品条件均重新计算。
- 客户合并:多选组取标签并集;唯一组按手动优先、最后操作时间和规则优先级确定最终标签。
- 平台标签:全平台统一管理和计算,不绑定店铺 ID。
- 预留店铺标签:标签组、标签、规则、任务和客户关系必须按店铺 ID 隔离,禁止店铺之间互相读取或打标。
- 同一会员可以同时拥有平台标签和多个店铺范围内的店铺标签;查询时必须明确标签范围。
- 时间条件按平台配置时区计算,数据库时间统一存储为 UTC。
- 消息重复或乱序时,以当前业务数据重新计算,不直接使用事件中的旧统计值。
十二、非功能要求
- 自动规则触发后 5 分钟内完成客户打标,P95 达标。
- 每日定时规则在计划开始后 2 小时内执行完成。
- 会员列表标签筛选响应时间 P95 不超过 2 秒。
- 单会员标签查询响应时间 P95 不超过 500 毫秒。
- 所有标签写入操作和变更日志覆盖率为 100%。
- 批量任务支持重试和断点续跑,单分片失败不影响其他分片。
- 标签相关服务接口必须携带或由登录身份解析标签范围;店铺范围接口还必须校验店铺 ID,禁止仅凭标签 ID 越权操作。
十三、验收标准
1. 手动打标
- 客户没有目标标签时,管理员添加后应立即展示标签并生成手动来源记录。
- 重复添加同一标签时不产生重复关系,结果计为跳过。
- 唯一组已有其他手动标签时,添加新标签后只展示新标签,并记录替换日志。
- 标签同时存在手动和自动来源时,移除手动来源后标签仍然展示。
2. 自动打标
- 规则为“累计消费金额大于等于 1000 元”时,客户净消费达到 1000 元后应在 5 分钟内获得标签。
- 自动移除开启时,客户退款后不再满足规则,应撤销该规则的自动标签来源。
- 自动移除关闭时,客户不再满足规则,已有标签仍然保留。
- 新规则启用后,历史客户全量计算结束时,所有符合条件客户均获得标签。
- 唯一组多个规则同时命中时,只展示优先级最高的自动标签。
3. 查询与审计
- “包含全部标签”只返回同时拥有所有选中标签的客户。
- “不包含任一标签”排除拥有任意一个选中标签的客户。
- 添加、移除、替换和规则失效操作都能查询到时间、原因、来源及操作主体。
十四、版本范围
V1
- 仅开放平台客户标签,标签范围固定为
PLATFORM。 - 标签组和标签管理。
- 组内唯一和组内多选。
- 会员列表及详情的单个、批量手动打标。
- 客户属性、交易、商品、积分自动打标条件。
- AND/OR、自动移除、历史补算、实时计算和每日重算。
- 标签筛选、变更记录和任务中心。
后续版本
- 开放店铺会员标签,标签范围为
SHOP,由店铺独立创建和维护。 - 店铺端只读查看平台标签,并支持将平台标签用于经授权的会员筛选场景。
- 客户导入同步打标。
- 优惠券、营销活动和渠道二维码节点自动打标。
- 嵌套条件组、行为事件标签和标签有效期。
- 企业微信等外部标签同步。
- 标签覆盖率、增长趋势和营销转化分析。