跳到主要内容

客户标签

一、需求背景​

平台运营人员需要通过客户标签识别客户特征、完成客户分层,并将标签用于客户查询、精准营销和服务跟进。

本期在平台管理端会员模块新增“客户标签”菜单,由平台管理员统一管理平台客户标签,并为平台会员手动或自动打标。

本期不开放店铺会员打标签功能,但标签的数据模型、权限模型和服务接口必须预留“标签归属范围”,便于后续增加店铺自有标签,且不能与平台标签相互覆盖或误删。

二、菜单与权限​

1. 菜单位置​

平台管理端菜单路径:

客户 > 客户标签

客户标签页面包含以下功能:

  • 标签管理
  • 手动打标签
  • 自动打标签
  • 标签客户查询
  • 标签变更记录

2. 权限控制​

权限说明
查看客户标签查看标签列表、标签客户和变更记录
手动打标签为单个或批量客户添加、移除标签
管理客户标签新建、编辑、停用标签组及标签
管理自动规则新建、编辑、启用和停用自动打标规则
删除客户标签删除符合删除条件的标签

本期以上权限仅配置给平台管理端角色。后续增加店铺会员标签时,应建立独立的店铺端菜单和权限,不复用平台管理员权限。

三、产品目标​

  1. 建立统一的平台客户标签体系,减少名称重复和口径不一致。
  2. 支持运营人员对单个或批量客户手动添加、移除标签。
  3. 支持系统根据客户属性、交易和商品等条件自动打标。
  4. 支持在会员列表按标签筛选客户。
  5. 所有标签变更均可查询和追溯。

四、标签模型​

1. 标签归属范围​

标签组必须具有明确的归属范围:

标签范围范围编码本期状态说明
平台标签PLATFORM开放由平台管理员创建,可对平台会员打标
店铺标签SHOP预留由店铺创建,仅能对本店会员打标

本期所有新建标签组默认为平台标签,管理端不展示范围选择项,由系统写入 PLATFORM。

平台标签的数据口径:

  • 打标对象为平台会员,不包含未形成平台会员身份的匿名访客。
  • 手动打标时可以从平台会员列表选择会员。
  • 交易、商品和积分等自动条件默认统计会员在平台全部店铺的数据。
  • 如果规则需要限定指定店铺,应将“店铺范围”作为自动规则条件,而不是把标签变为店铺标签。

预留规则:

  • 标签组、标签、自动规则、客户标签关系和变更记录均需要保存标签范围。
  • 店铺标签还需保存店铺 ID;平台标签的店铺 ID 为空。
  • 平台标签和店铺标签允许重名,两者通过范围和店铺 ID 隔离。
  • 平台管理员只能管理平台标签;店铺只能管理本店标签。
  • 后续店铺端可只读展示平台标签,但不得修改、替换或删除平台标签。
  • 店铺标签不得影响平台标签的自动规则和统计人数,平台标签也不得覆盖店铺标签。

2. 标签组​

标签必须归属标签组。标签组用于组织同一业务维度下的标签,例如:

  • 客户价值:低价值、中价值、高价值
  • 购买阶段:未购买、已首购、已复购
  • 商品偏好:服装、数码、食品

标签组支持两种组内规则:

组内规则说明示例
组内唯一一个客户最多拥有组内一个标签客户价值、购买阶段
组内多选一个客户可以拥有组内多个标签商品偏好、颜色偏好

3. 打标方式​

每个标签可以配置以下打标方式:

  • 仅手动:只能由有权限的管理员添加或移除。
  • 仅自动:只能由自动规则添加或移除,不能人工修改。
  • 手动和自动:两种方式均可使用,系统分别记录来源。

同一个客户与同一个标签在页面上只展示一次。标签同时存在手动和自动来源时,移除其中一个来源不会影响另一个来源。

五、标签管理​

1. 标签列表​

管理端进入“客户 > 客户标签”后展示标签组及标签列表。

字段说明
标签组名称标签所属业务分类
标签名称标签具体名称
组内规则组内唯一或组内多选
打标方式手动、自动、手动和自动
客户数当前拥有该标签的去重客户数
自动规则状态草稿、计算中、已启用、已停用、执行失败
更新时间标签或规则最后修改时间
操作查看客户、编辑、启停、复制、删除

支持按标签组名称、标签名称和状态筛选。

2. 新建标签组​

字段是否必填规则
标签组名称是1~20 个字符,同一标签范围内不可重名
标签组说明否最多 100 个字符
组内规则是组内唯一或组内多选
标签名称是至少添加一个;每个 1~20 个字符;同组不可重名
打标方式是至少选择手动或自动中的一种
标签颜色否用于管理端识别

标签组已有客户标签关系后,不允许直接切换组内规则。需要先处理已有冲突关系。

3. 编辑、停用与删除​

  • 修改标签名称不影响客户已有标签关系,并记录操作日志。
  • 停用标签后,不允许继续添加该标签,但保留客户已有标签及历史记录。
  • 停用自动规则后,停止增量计算。管理员可选择保留或清除该规则产生的标签,默认保留。
  • 删除标签前展示当前标签客户数和业务引用情况。
  • 存在客户关系或被营销活动引用的标签不允许直接删除,应先停用并解除引用。

六、手动打标签​

1. 操作入口​

  • 会员列表:选择单个或多个会员后,点击“添加标签”或“移除标签”。
  • 会员详情:在客户标签区域添加或移除标签。

2. 添加标签​

  1. 管理员选择一个或多个会员。
  2. 点击“添加标签”。
  3. 在弹窗中按标签组查看或搜索标签。
  4. 选择标签并确认。
  5. 系统校验标签状态、操作权限和组内规则。
  6. 页面反馈成功、跳过和失败数量,并写入变更记录。

业务规则:

  • 单次同步操作最多处理 1,000 个客户;超过 1,000 个时创建异步任务。
  • 重复添加同一标签时保持幂等,不重复展示和计数。
  • 仅展示允许手动打标且状态正常的标签。
  • 组内多选标签可以选择多个。
  • 组内唯一标签会替换客户在该组内已有的手动标签,操作前提示预计替换人数。

3. 移除标签​

  • 普通手动移除只移除标签的手动来源。
  • 标签仍存在自动来源时,提示“人工标签已移除,客户仍满足自动规则”,标签继续展示。
  • 自动来源只能由自动规则失效、停用规则时选择清除,或由具备规则管理权限的管理员处理。
  • 批量任务提供成功、失败和跳过数量,失败明细支持下载。

七、自动打标签​

1. 创建规则​

管理员为允许自动打标的标签配置规则。一个标签在同一时间只能启用一个规则版本。

规则由以下内容组成:

  • 条件关系:满足全部条件(AND)或满足任一条件(OR)。
  • 规则条件:指标、运算符和条件值。
  • 自动移除:客户不再满足规则时,是否移除该规则产生的标签。
  • 规则优先级:组内唯一标签同时命中时,优先级高的规则生效。

第一期不支持嵌套 AND/OR 条件组。

2. 自动条件​

分类条件可选规则数据口径
客户属性注册时间最近 N 天、自定义区间、早于、晚于会员账号创建时间
客户属性会员等级是、不是、属于任一当前有效等级
客户属性手机号、地区、性别、生日有值、无值、等于、属于当前会员资料
交易累计支付次数等于、大于、大于等于、小于、小于等于、区间支付成功且未全额退款的订单数
交易累计消费金额数值比较、区间支付金额减成功退款金额
交易客单价数值比较、区间累计消费金额除以有效支付订单数
交易首次或最后消费时间最近 N 天、自定义区间、早于、晚于、无消费以支付成功时间为准
商品购买过指定商品任一或全部商品、分类、品牌存在支付成功且未全额退款的订单明细
店铺在指定店铺产生交易任一或全部店铺用于限定平台标签规则的数据来源范围
资产当前积分、累计获得积分数值比较、区间当前积分账户数据

客单价在没有有效订单时按“无值”处理,不按 0 元计算。

3. 保存与启用​

  • 保存前校验数值、时间区间及必填条件。
  • AND 条件存在明显互斥时,阻止启用并提示具体条件。
  • 支持“预估人数”,展示基于当前数据计算的预计命中客户数和计算时间。
  • 规则可保存为草稿,也可保存并启用。
  • 启用新规则后,对历史客户执行一次全量计算。
  • 修改已启用规则时生成新版本;新版本校验成功后切换并重新计算。

4. 执行机制​

  • 实时计算:订单支付、退款、客户资料、会员等级或积分发生变化时,重新计算相关规则。
  • 定时计算:包含“最近 N 天”等时间滑动条件的规则,每日重新计算。
  • 历史补算:新规则启用时计算规则创建前的全部客户。
  • 自动移除开启后,客户不再满足条件时只移除当前规则产生的自动来源。
  • 自动移除关闭时,客户不再满足条件也保留已有标签。
  • 同一事件重复处理不得生成重复关系或重复变更记录。

5. 组内唯一冲突​

组内唯一标签采用以下优先级:

  1. 手动标签优先于自动标签。
  2. 多个人工操作冲突时,以最后一次有效操作为准。
  3. 多个自动规则同时命中时,以配置的规则优先级为准。

自动规则的优先级数字越小,优先级越高。

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,由店铺独立创建和维护。
  • 店铺端只读查看平台标签,并支持将平台标签用于经授权的会员筛选场景。
  • 客户导入同步打标。
  • 优惠券、营销活动和渠道二维码节点自动打标。
  • 嵌套条件组、行为事件标签和标签有效期。
  • 企业微信等外部标签同步。
  • 标签覆盖率、增长趋势和营销转化分析。