跳转到内容
有巢数智

saas运营策略设计

功能简述

Section titled “功能简述”

运营策略是 SaaS 平台的增长与度量体系，定义「人怎么来、钱怎么算、效果怎么看」三件事，为《saas运营管理详细设计》中的运营体系、租户管理与实施交付提供目标口径与数据来源，包括：

  1. 推荐官政策：规定推荐官的准入、分级、归因、积分、结算、推广规范与违规处置，把推荐官计划从功能可用推进到政策可执行
  2. 运营指标设计：建立分层指标体系与统一口径，覆盖租户从获客、转化、交付、激活到续费的全生命周期，并给出推荐官、收入与服务的专项指标
  3. 系统埋点监测：规定埋点分层、事件命名、公共属性、关键事件清单与数据链路，为指标提供可追溯的行为数据
  4. 与 EIM 打通：推荐官带来的注册、认证与付费在 EIM 侧分别沉淀为联系人、线索、客户与销售订单，本文件的指标口径与 EIM 保持一致
  5. 暂不实现：代理商/渠道分销体系、按量计费相关的用量指标、AI 智能定价与智能推荐

本文件只定义策略与口径，具体功能、流程、实体与权限以《saas运营管理详细设计》为准；两者冲突时以业务规则（后者）为准，口径差异在指标字典中登记。

名词解释

Section titled “名词解释”

1. 推荐官政策

名词释义
推荐官签署推荐官协议、通过实名认证并取得专属推荐码的平台注册用户，通过推广带来新客户并获取积分
被推荐人通过推荐官的推广链接、二维码或推荐码完成注册的用户，注册时一次性绑定推荐关系
推荐码推荐官的全局唯一身份标识，格式 R{8位随机码}，用于推广链接与落地页归因
归因判定一次注册/订单归属于哪个推荐官的过程，以注册时绑定的推荐关系为唯一依据
归因有效期自推荐关系绑定起、被推荐人须完成首笔付费订单的时限，超期则未入账积分失效
有效推荐被推荐人完成企业认证且首笔订单确认收款的推荐关系，是积分结算与推荐官升级的唯一计数口径
积分阶段积分产生的业务环节，取值为 #注册、#实名认证、#企业认证、#开通下单，各阶段独立配置积分值
积分系数推荐官等级对应的积分调节倍数，作用于按积分规则算出的基准积分
积分扣回被推荐人订单退款时，已结算积分按原规则反向扣减的处理

2. 运营指标

名词释义
北极星指标衡量平台长期经营健康度的单一核心指标，本平台取年度化回款额，兼顾新签与续费
口径指标的业务定义、计算范围与计算规则，是指标唯一可信的解释来源，以指标字典为准
漏斗转化率相邻两个生命周期环节的比值，用于定位流失最严重的环节
ACV平均客单价，当期新签订单实付金额与新签订单数的比值
到期续费率按到期日归属统计的、当期到期订单中完成续费的比例
NRR净收入保持率，同一批订单本期续费金额与上期成交金额的比值，反映存量客户的扩缩
活跃租户统计周期内产生有效使用行为（登录并使用至少一个已开通应用）的付费租户
自然流量未携带推荐码、且非销售跟进产生的注册与订单

3. 埋点监测

名词释义
埋点在页面或服务端代码中上报用户行为与业务事件的技术手段，是行为分析的数据来源
事件一次被记录的行为，由事件名与一组属性构成，是埋点的最小单位
公共属性所有事件均须携带的上下文属性，如用户、租户、会话、来源与设备信息
结果事件与业务结果强相关的事件（注册成功、支付成功等），以服务端上报为准，参与指标计算
过程事件描述用户操作路径的事件（页面浏览、点击等），以前端上报为主，用于路径与转化分析
幂等去重按事件唯一标识 event_id 去除重复上报的机制，保证同一事件只计一次

设计要点

Section titled “设计要点”

1. 推荐官政策

Section titled “1. 推荐官政策”

1. 政策定位与原则

Section titled “1. 政策定位与原则”
  1. 定位：推荐官计划是平台的低成本获客渠道，与销售直销、应用市场自然流量并列，目标是以可控积分成本换取可归因的新增付费租户
  2. 基本原则：
    1. 结果导向：积分主体（#开通下单）只在被推荐人订单确认收款后结算，未产生真实付费不发放主要积分
    2. 一次性归因：推荐关系在注册时一次性绑定，绑定后不可变更；未绑定推荐关系的注册不产生积分
    3. 风险可控：注册与认证阶段积分记为待入账，随首笔订单确认收款一并入账，超期未付费自动失效
    4. 口径统一：推荐官相关的获客、转化与积分指标以业务库订单与积分流水为准，埋点数据仅用于路径分析，不参与结算
    5. 政策可调：积分值、系数、封顶比例、归因有效期等均为系统配置中的运营策略参数，变更只对新产生的推荐关系生效
  3. 与订单算价的关系：积分抵充位于结算顺序的优惠券抵扣之后、抹零之前；与优惠券的叠加关系沿用优惠券的限制规则，实付金额最小为 0、不允许为负
  4. 合规原则（规避财税风险）：
    1. 推荐官激励一律以积分形式发放，不属于货币报酬，不涉及劳务报酬所得，无需代扣代缴个人所得税
    2. 积分不可提现、不可兑现、不可转让、不可赠与，仅限本人用于订单抵充与积分商场兑换
    3. 积分抵充在财务上按销售折扣处理，冲减订单收入；积分商场兑换按促销费用处理
    4. 平台不向推荐官收集或核验收款账户，不产生资金对外支付
  5. 折算规则：100 积分 = 1 元；业务库金额以分为单位存储，因此 1 积分等价于 1 分，积分与金额分按 1:1 记账，无需换算

2. 准入、分级与退出

Section titled “2. 准入、分级与退出”

  1. 准入条件（全部满足方可成为推荐官）：

    1. 已完成平台注册的自然人账号，且绑定手机号
    2. 通过个人实名认证（与租户的企业认证相互独立，不要求其所属租户已认证）
    3. 线上勾选并签署《推荐官协议》，系统留存协议版本与签署时间
    4. 非平台侧账号：运营端运维、财务账号不得参与推荐官计划

  2. 推荐官分级（暂不考虑）：

    等级名称升级条件（累计有效推荐）积分系数附加权益
    L1见习推荐官01.0基础推广物料
    L2认证推荐官≥ 31.1专属海报模板、推广数据周报
    L3金牌推荐官≥ 101.2优先线索派发、联合活动支持
    1. 以累计有效推荐数升级，当月达标次月生效；等级只升不降，但发生违规处置时按7. 风控、违规与申诉降级或清退
    2. 积分系数作用于该推荐官当期所有阶段积分的计算结果，系数变更仅对变更后结算的积分生效

  3. 退出机制：

    1. 主动退出：推荐官可申请退出，退出后不再产生新的推荐关系与积分；余额可正常兑换消费
    2. 平台清退：发生严重违规（虚假宣传、刷单、冒用官方身份）时立即清退，冻结未结算积分并保留追回已结算积分的权利
    3. 退出后已绑定的推荐关系继续有效，延续至对应积分完成结算或失效

3. 推荐关系归因

Section titled “3. 推荐关系归因”
  1. 归因凭证与优先级：注册表单手工填写推荐码 > 落地页 URL 参数 ?ref=R{8位码} > 扫码落地页写入的 Cookie；多凭证并存时按上述顺序取其一
  2. 归因窗口：点击推广链接或扫码后，归因标记（Cookie + 设备标识）默认保留 30 天；窗口内完成注册即绑定推荐关系，窗口外注册不归因，待定
  3. 绑定规则：
    1. 推荐关系在注册成功时一次性写入，绑定后不可变更、不可转移
    2. 同一被推荐人仅归属一个推荐官，先到先得
    3. 一个手机号仅对应一个平台账号，重复注册不产生新的推荐关系
  4. 无效归因（命中任一即为无效，不产生积分）：
    1. 自推荐：推荐人与被推荐人的手机号、实名信息一致
    2. 关联推荐：推荐人与被推荐人所属租户的统一社会信用代码一致
    3. 平台侧账号、内部员工账号参与的推荐
  5. 归因结果留存：注册事件须记录归因来源（URL 参数/Cookie/表单）、推荐码、归因时间与来源 IP/设备标识，作为风控与申诉的依据
flowchart LR
    A["注册用户\n通过个人实名认证"] --> B["签署推荐官协议"]
    B --> C["生成推广链接/二维码\n推荐码 R+8位"]
    C --> D["被推荐人访问落地页\n写入归因标记"]
    D --> E["被推荐人注册\n一次性绑定推荐关系"]
    E --> F["企业认证通过\n#已认证"]
    F --> G["下单并确认收款\n#已支付"]
    G --> H["积分入账\n转 #可用"]
    H --> I["订单抵充"]
    H --> J["积分商场兑换"]
    D -.->|"超归因窗口"| L["不归因"]
    F -.->|"超归因有效期未付费"| M["待入账积分失效"]

4. 积分规则与结算

Section titled “4. 积分规则与结算”
  1. 积分阶段与计算：
    1. 三阶段积分值在运营端积分规则设置中维护，阶段取值为 #注册、#实名认证、#企业认证、#开通下单
    2. 固定金额型（外部人员）：积分 = 阶段积分值 × 积分系数
  2. 结算时点：
    1. #注册、#实名认证、#企业认证 阶段积分在事件发生时计入待入账，不进入可抵扣余额
    2. 被推荐人首笔订单确认收款后，该推荐关系下的待入账积分与 #开通下单 阶段积分一并由系统自动计算并结算入账，转 #可抵扣
    3. 自推荐关系绑定起超过归因有效期（默认 90 天，待定）仍未产生#已支付订单的，待入账积分自动失效并置 #已作废
  3. 冲回规则：被推荐人订单发生退款时，已结算积分按原规则冲回；优先从当前积分余额扣减，余额不足的从后续积分中抵扣，冲回记录须关联原积分流水
  4. 积分流水须留存推荐官、被推荐人、来源订单、阶段、金额、状态与入账/失效时间，作为对账与结算依据
stateDiagram-v2
    [*] --> 待入账: 注册/实名认证/企业认证阶段达成
    待入账 --> 可用: 被推荐人订单确认收款
    待入账 --> 已作废: 超归因有效期未付费
    可用 --> 已抵充: 用于订单结算
    可用 --> 已兑换: 积分商场兑换商品
    可用 --> 已作废: 超积分有效期未使用
    已抵充 --> 已扣回: 被推荐人订单退款
    可用 --> 已扣回: 被推荐人订单退款

5. 积分使用、抵充与兑换

Section titled “5. 积分使用、抵充与兑换”
  1. 折算规则：100 积分 = 1 元；业务库金额以分为单位存储，因此 1 积分等价于 1 分，积分与金额分按 1:1 记账，无需换算
  2. 订单抵充：
    1. 积分可用于订单结算抵充，抵充发生在优惠券抵扣之后、抹零之前
    2. 单笔订单积分抵充额不超过该订单折扣后金额的比例上限（默认 30%，待定），且不得超过当前可用积分余额
    3. 最小抵充单位为 100 积分（1 元），不足 100 积分的部分不可抵充
    4. 积分抵充金额计入订单优惠，按订单明细标准定价占比分摊至明细，尾差计入最后一个明细
    5. 与优惠券的叠加关系沿用优惠券限制规则；不满足条件时须明确提示不可用的具体原因
  3. 积分商场兑换（待建设）：
    1. 积分商场是积分的第二个出口，推荐官可在商场使用积分兑换商品，商品以积分标价，按 100 积分 = 1 元折算
    2. 本文件仅定义积分侧规则：兑换时实时扣减可用积分、积分置 #已兑换、扣减不可逆
    3. 商品管理、库存、物流、售后与退货退积分规则由积分商场建设时另行定义
    4. 兑换不找零、不折现；商品退货时按商场规则退回积分，退回积分沿用原积分的有效期
  4. 积分有效期：自入账起默认 24 个月有效（待定），到期未使用的积分自动清零并置 #已作废；到期前 30 天提醒推荐官
  5. 积分不可提现、不可兑现、不可转让、不可赠与；不涉及劳务报酬所得，无需代扣代缴个人所得税
  6. 积分展示：租户端我的积分记录展示推荐码、推荐数量、成功数量、当前积分、已使用积分、累计获得积分、即将过期积分与推荐进度，口径与本文件4. 推荐官专项指标一致

6. 推广物料与内容规范

Section titled “6. 推广物料与内容规范”
  1. 平台提供：专属推广链接、推广二维码、标准海报模板、产品介绍话术与常见问题；物料由运营端统一维护与版本管理
  2. 允许行为：私域分享、行业社群与线下活动推广、真实客户案例分享（须脱敏）
  3. 禁止行为：
    1. 在搜索引擎投放平台品牌词及变体词
    2. 虚假宣传、夸大收益、对产品功能与价格作出未经授权的承诺
    3. 冒用平台官方身份（如自称官方客服、官方渠道商）
    4. 以返现、折价收购积分、刷单等方式诱导注册与付费
    5. 宣传或暗示积分可提现、可兑现、可转让
    6. 抓取、购买或批量导入用户数据
  4. 违规推广产生的推荐关系与积分一律作废，并按违规等级处置

7. 风控、违规与申诉

Section titled “7. 风控、违规与申诉”
  1. 风险识别与处置：
风险类型识别规则处置动作
批量注册同一 IP 或设备 24 小时内注册 ≥ 3 个账号推荐关系标记待核查，积分暂缓入账
虚假认证认证资料比对不通过，或同一执照/信用代码关联多个租户积分作废，推荐关系解除
自推荐/关联推荐手机号、信用代码、法人任一相同积分作废，清空待入账积分
刷单套利被推荐人订单短期内退款或集中小额下单自动扣回积分，推荐官降级
积分套现与第三方折价交易积分、协助他人套取积分积分清零，冻结 30 天
异常兑换短周期高频兑换、集中兑换单一高值商品兑换驳回并冻结积分
违规推广命中6. 推广物料与内容规范禁止项警告 → 冻结 30 天 → 清退（视情节）
  1. 处置等级：警告（通知并记录）→ 冻结（暂停积分入账、抵充与兑换）→ 清退（解除推荐关系、作废未入账积分并清零违规所得积分）
  2. 申诉：推荐官可在收到处置通知后 7 个工作日内提交申诉，由运营端运维复核并给出结论；复核期间维持处置状态
  3. 所有风险事件须留痕：推荐官、命中规则、命中证据、处置结果与处理人，纳入审计

8. 政策参数与数据模型扩展

Section titled “8. 政策参数与数据模型扩展”
  1. 运营策略参数（由系统配置维护，不在代码中硬编码）：
参数默认值说明
归因窗口30 天点击/扫码后归因标记的有效期
归因有效期90 天推荐关系绑定后须完成首笔付费的期限
积分折算比例100 积分 = 1 元积分与人民币的折算关系，与金额分单位 1:1
单笔积分封顶比例20%发放积分对应金额占订单实付金额的上限
单笔抵充上限比例30%抵充积分对应金额占折扣后金额的上限
最小抵充单位100 积分订单抵充的最小粒度（1 元）
积分有效期24 个月自入账起的使用期限，到期清零
分级阈值3 / 10L2、L3 的有效推荐数阈值
  1. 对现有数据模型的扩展要求（相对《saas运营管理详细设计》的实体关系）：
    1. tabSaasRecommender 增加：等级 level、状态 status（#正常/#冻结/#清退）、实名信息 idName、协议版本 agreeVersion、签署时间 agreedAt、冻结原因 frozenReason
    2. tabSaasRecdCommission（建议更名为 tabSaasPointRule）增加：积分类型 type（#固定/#比例）、比例值 rate、归因有效期 validDays、封顶比例 capRate
    3. tabSaasProgressDetail（建议更名为 tabSaasPointDetail）增加：状态细化（#待入账/#可用/#已抵充/#已兑换/#已作废/#已扣回）、积分数字段 point、入账时间 accruedAt、有效期截止时间 validUntil、失效时间 expiredAt、归因来源 refSource、来源 IP 与设备标识
    4. 新增 tabSaasRiskEvent 风险事件表：推荐官、规则编码、命中内容、处置结果、处理人与处理时间
    5. 新增 tabSaasRecommenderLevel 等级变更记录表：推荐官、变更前等级、变更后等级、生效时间、变更原因

2. 运营指标设计

Section titled “2. 运营指标设计”

1. 指标体系总览

Section titled “1. 指标体系总览”
  1. 分层结构：北极星指标 → 一级指标（5 类）→ 二级指标（过程与专项）
  2. 北极星指标：年度化回款额，即当期所有#已支付订单的实付金额按服务期折算到年度后的合计；它同时反映新签能力与存量续费能力，是运营决策的第一依据
  3. 一级指标：
一级指标回答的问题主责角色
获客潜在客户从哪里来、来了多少、成本多少运营端运维
转化客户在哪个环节流失、转化效率如何运营端运维
交付交付是否及时、验收是否一次通过运维主管
留存租户是否真正用起来、是否续费运营端运维
收入回款、应收与积分成本是否健康运营端财务
  1. 指标口径三原则：
    1. 结算与财务类指标以业务库为准，埋点数据不参与
    2. 行为路径类指标以埋点数据为准，业务库无法覆盖
    3. 所有指标须在指标字典中登记口径、数据源与责任人，未登记指标不得进入看板

2. 租户生命周期漏斗

Section titled “2. 租户生命周期漏斗”
  1. 漏斗环节与《saas运营管理详细设计》的租户生命周期一一对应：访客 → 注册 → 创建租户 → 企业认证 → 试用激活 → 下单结算 → 确认收款 → 实施交付 → 上线激活 → 续费
  2. 各环节转化率作为运营周会的核心复盘对象，环比波动超过 20% 须给出归因说明
flowchart TB
    V["访客 UV"] -->|"注册转化率"| R["注册账号"]
    R -->|"建租户率"| T["创建租户"]
    T -->|"认证通过率"| C["企业认证通过"]
    C -->|"试用激活率"| TR["试用激活"]
    TR -->|"下单率"| O["下单结算"]
    O -->|"支付率"| P["确认收款"]
    P --> D["实施交付完成"]
    D -->|"激活率"| A["上线激活"]
    A -->|"续费率"| RN["续费/扩购"]
    RN --> A

3. 核心指标口径

Section titled “3. 核心指标口径”

1. 获客

指标口径与公式数据源周期主责
访问 UV/PV官网与应用市场页面去重访客数与浏览量埋点日/周/月运维
新增注册账号数当期完成注册的平台账号数业务库 + 埋点日/周/月运维
新增租户数当期创建且状态为 #注册 及以上的租户数业务库日/周/月运维
推荐来源注册占比携带推荐码的注册数 ÷ 总注册数业务库周/月运维
有效线索数当期由企业登记或订单结算生成、进入 EIM 跟进的线索数EIM周/月运维
CAC当期获客投入 ÷ 当期新签付费租户数财务 + 业务库月/季财务

2. 转化

指标口径与公式数据源周期主责
注册→认证转化率当期认证通过租户数 ÷ 当期新增租户数业务库周/月运维
认证→下单转化率当期首次下单租户数 ÷ 当期认证通过租户数业务库周/月运维
下单→收款转化率当期确认收款订单数 ÷ 当期下单订单数业务库周/月财务
商机转化率当期转销售订单的商机数 ÷ 当期商机总数EIM月运维
平均成交周期Σ（收款确认日 − 下单日）÷ 订单数业务库月/季运维
ACV当期新签订单实付金额 ÷ 新签订单数业务库月/季财务

3. 交付

指标口径与公式数据源周期主责
平均交付时长Σ（验收完成日 − 收款确认日）÷ 交付任务数业务库周/月运维主管
一次验收通过率首次验收即通过的任务数 ÷ 已验收任务数业务库月运维主管
待实施积压量当前状态为 #待实施 与 #实施中 的任务数业务库日/周运维主管
超期未交付量收款确认后超过约定交付天数仍未上线的任务数业务库周运维主管

4. 留存

指标口径与公式数据源周期主责
活跃租户率当期活跃租户数 ÷ 当期有效付费租户数业务库 + 埋点周/月运维
应用使用广度已开通应用中使用 ≥ N 个的租户占比（默认 N=2）埋点月运维
到期续费率当期到期且完成续费的订单数 ÷ 当期到期订单数（按到期日归属，宽限 30 天）业务库月/季运维
NRR同一批订单本期续费金额 ÷ 上期成交金额业务库季/年财务
冻结率当期状态转 #暂停 的租户数 ÷ 期初有效付费租户数业务库月运维
流失挽回率冻结后完成续费解冻的租户数 ÷ 当期冻结租户数业务库月运维

5. 收入

指标口径与公式数据源周期主责
新签回款额当期新签订单的确认收款金额合计业务库日/周/月财务
续费回款额当期续费订单的确认收款金额合计业务库周/月财务
回款率当期确认收款金额 ÷ 当期下单金额业务库月财务
应收余额已下单未收款的订单金额合计业务库周/月财务
积分成本率当期积分入账额 ÷ 当期推荐来源回款额业务库月财务

4. 推荐官专项指标

Section titled “4. 推荐官专项指标”
  1. 结果指标：
指标口径与公式周期
活跃推荐官数当期产生至少一次有效推广行为（生成链接、带来注册）的推荐官数周/月
新增有效推荐数当期新增的有效推荐关系数周/月
推荐来源付费租户数当期由推荐关系带来且首笔订单确认收款的租户数月
推荐来源回款额当期归因到推荐关系的订单实付金额合计月
推荐来源回款占比推荐来源回款额 ÷ 当期总回款额月
积分 ROI推荐来源回款额 ÷（当期积分成本 + 当期推荐官运营投入）月/季
积分核销率（已抵充 + 已兑换）÷ 累计入账积分月
  1. 过程指标：推广链接生成数、推广页访问 UV、推广页注册转化率、推荐官人均产出、分级分布（L1/L2/L3 占比）
  2. 风险指标：待核查推荐关系数、命中风控规则的推荐官数、积分作废率（作废积分 ÷ 累计入账积分）

5. 看板与周期报表

Section titled “5. 看板与周期报表”
  1. 运营驾驶舱（运营端工作台，日更新）：租户总数与有效付费租户数、当月回款额与完成率、待实施积压量、本月到期租户数、活跃租户率、推荐来源占比
  2. 推荐官看板（周更新）：推荐官总数与分级分布、本周新增有效推荐与付费租户、本周积分入账与核销、TOP 推荐官排行、待核查风险事件
  3. 交付看板（日更新）：待实施/实施中/待验收任务数、平均交付时长、超期任务清单
  4. 财务看板（月更新）：新签与续费回款、应收账龄、发票开具情况、积分成本与 ROI
  5. 周期报表（定时推送至运营群，沿用《saas运营管理详细设计》的提醒规则）：
    1. 每日 9:00：昨日新增注册数、新增认证数、新增订单数、收款金额
    2. 每周一 9:00：上周新增租户数、订单数、成交金额、待实施数，附本周到期租户清单
    3. 每月 1 日 9:00：上月新增租户数、成交金额、到期续费率，附本月到期租户清单（租户、@租户管理员、到期时间、续费金额）
  6. 推送内容须同时给出环比与同比，异常指标标注警示色

6. 指标治理与异常处理

Section titled “6. 指标治理与异常处理”
  1. 指标字典：每个指标登记名称、口径、公式、数据源、统计周期、责任人、上线时间与变更记录，是口径的唯一来源
  2. 口径变更：变更须经运维与财务共同评审，评审通过后留痕并公告；变更后历史数据不回溯重算，仅在新周期生效，确需回溯的须专项说明
  3. 统计时点：指标以 T+1 离线计算为正式口径，实时数据仅用于监控与告警，两者不一致时以离线为准
  4. 异常排查流程：
    1. 第一步核对事件量：检查埋点上报量是否异常（缺失、重复、激增）
    2. 第二步核对去重结果：按 event_id 去重后与业务单据数比对
    3. 第三步核对业务库：直接查询订单、租户、积分表，确认是否为业务真实变化
    4. 三步结论不一致时，判定为数据质量问题并登记缺陷，由数据责任人跟进修复
  5. 数据质量告警：核心指标上报量环比波动超过 30%、关键事件缺失或必填属性为空率达到 1% 时触发告警

3. 系统埋点监测

Section titled “3. 系统埋点监测”

1. 埋点分层与原则

Section titled “1. 埋点分层与原则”
  1. 分层：
层级覆盖范围实现方式用途
前端埋点官网、应用市场、租户端后台、运营端的页面浏览、点击与曝光Web SDK 自动采集 + 元素埋点路径分析、转化分析、功能使用度
服务端埋点注册、认证、订单、支付、实施、积分等业务结果事件业务服务在事务提交后上报指标计算、漏斗分析（权威口径）
定时补数无法改造或历史遗留数据定时任务从业务库抽取兜底与回溯
  1. 原则：
    1. 结果事件以服务端为准：注册成功、认证通过、支付成功、积分入账等一律由服务端上报，前端同名事件仅作路径补充，不参与指标计算
    2. 前端只采集行为，不采集业务明细：禁止上报租户业务数据明细，与「运营端不可查看租户业务数据明细」的隔离要求保持一致
    3. 埋点不影响主流程：上报失败不得阻塞业务，采用异步上报 + 本地队列 + 失败重试
    4. 一次设计、长期使用：事件与属性一经上线纳入版本管理，变更须登记
  2. 技术选型（建议方案）：
    1. 轻量方案：事件直接落 tabSaasEventTrack 明细表，定时任务聚合为日/周/月指标表，供看板查询；适用于早期数据量较小阶段
    2. 标准方案：采集网关 → 消息队列 → 实时计算（监控告警）与离线数仓（ODS → DWD → DWS → ADS）并行；适用于数据量与实时性要求较高阶段
    3. 建议先按轻量方案落地 P0 事件，预留向标准方案演进的接口与字段

2. 事件命名规范

Section titled “2. 事件命名规范”
  1. 命名格式：{端}_{模块}_{对象}_{动作}，全部小写、以下划线分隔，如 web_market_app_view、srv_order_pay_success
  2. 端标识：web（官网与租户端）、portal（运营端）、app（移动端）、srv（服务端）
  3. 动作枚举：view（页面浏览）、click（点击）、expose（曝光）、submit（提交）、success（成功）、fail（失败）、start（开始）、finish（完成）
  4. 命名禁止项：
    1. 事件名中不得携带变量（禁止 click_button_1，应写作 click + 属性 button_id）
    2. 不得使用拼音缩写或无语义代号
    3. 同一业务含义只允许一个事件名，禁止重复命名

3. 公共属性

Section titled “3. 公共属性”
  1. 所有事件均须携带以下公共属性：
属性说明
event_id事件唯一标识（UUID），用于幂等去重
event_name事件名
event_time事件发生时间（客户端，毫秒时间戳）
server_time服务端接收时间（毫秒时间戳）
user_id平台账号 ID，未登录为空
tenant_id当前租户 ID，未登录或未归属租户为空
anonymous_id匿名标识（Cookie 或设备标识），用于未登录路径串联
session_id会话 ID，30 分钟无操作重新生成
ref推荐码，落地页携带并写入 Cookie，用于推荐归因
page_url / page_title当前页面地址与标题
referrer来源页面地址
ua / device_type / os / browser客户端环境
ip客户端 IP，入库前做属地化处理
env环境标识（#开发/#测试/#生产）
app_version前端版本号
  1. 业务属性：随事件自定义，须明确类型与是否必填；枚举值采用白名单校验，未登记的值计入异常

4. 关键事件清单

Section titled “4. 关键事件清单”

1. 获客与注册

事件名触发时机关键属性
web_landing_view推广落地页浏览ref、channel、utm_source
web_register_start打开注册页ref、channel
web_register_submit点击注册提交phone_filled（是否填写手机号，不采集号码明文）
srv_register_success注册成功user_id、tenant_id、ref、ref_source、result（#归因成功/#无推荐码）
srv_tenant_create_success创建租户成功tenant_id、org_name_hash、is_duplicate

2. 企业认证

事件名触发时机关键属性
web_cert_guide_view查看认证指引tenant_id
srv_cert_submit提交认证资料tenant_id、cert_type
srv_cert_approve认证审核完成tenant_id、result（#已通过/#已驳回）、duration_hours

3. 应用与试用

事件名触发时机关键属性
web_market_view浏览应用市场tenant_id
web_app_detail_view查看应用详情app_code、app_type
web_app_expose应用卡片曝光app_code、position
srv_trial_apply_submit提交试用申请tenant_id、app_code
srv_app_open_success应用开通成功tenant_id、order_id、app_code

4. 订单与支付

事件名触发时机关键属性
web_order_calc订单算价tenant_id、app_count、user_count、years、calc_amount
srv_order_submit订单提交结算order_id、amount、discount_amount、coupon_code、points_used
web_pay_channel_select选择支付方式order_id、pay_type
web_voucher_upload上传支付凭证order_id
srv_pay_success支付成功/确认收款order_id、pay_type、paid_amount、pay_duration_hours
srv_order_expire订单超时失效order_id
srv_order_refund_success退款成功order_id、refund_amount、is_partial

5. 推荐官

事件名触发时机关键属性
web_recommender_join_submit提交成为推荐官申请user_id
srv_recommender_join_success成为推荐官成功user_id、referral_code、level
web_promote_link_copy复制推广链接user_id、referral_code、scene
web_promote_qr_scan推广二维码被扫码referral_code、device_type
srv_point_accrue积分入账user_id、referral_code、order_id、stage、point、level
srv_point_expire待入账积分失效（超归因有效期）user_id、referral_code、stage、point
srv_point_clear积分到期清零（超积分有效期）user_id、point、batch
srv_point_deduct积分抵充订单user_id、order_id、point、deduct_amount
srv_point_exchange积分商场兑换商品user_id、point、goods_id、exchange_id
srv_point_reverse积分扣回user_id、order_id、point、reason
srv_recommender_risk_event命中风控规则user_id、rule_code、handle_result

6. 实施交付与租户使用

事件名触发时机关键属性
srv_implement_assign实施任务指派task_id、tenant_id、implementer
srv_implement_online租户系统上线task_id、tenant_id、duration_days
srv_implement_accept验收完成task_id、result（#已完成/#验收驳回）、duration_days
srv_tenant_login租户成员登录user_id、tenant_id、is_first_login_of_day
srv_app_use访问已开通应用user_id、tenant_id、app_code
srv_tenant_active租户日活聚合（定时任务）tenant_id、active_users、used_apps

7. 续费与流失

事件名触发时机关键属性
srv_renew_remind_send发送续费预警tenant_id、order_id、days_before
srv_renew_order_submit提交续费订单tenant_id、order_id、amount、is_upgrade
srv_tenant_freeze租户冻结tenant_id、reason
srv_tenant_unfreeze租户解冻tenant_id
srv_tenant_churn租户注销tenant_id、retention_days

5. 数据链路

Section titled “5. 数据链路”
  1. 采集 → 网关 → 存储 → 计算 → 应用 的五段式链路，各段职责单一、可独立扩容
  2. 网关职责：鉴权、必填与枚举校验、公共属性补全（IP 属地、UA 解析、server_time）、脱敏、按 event_id 幂等去重
  3. 失败处理：校验失败的事件进入死信队列并告警；可重试失败按指数退避重试，重试上限 3 次
  4. 补数机制：支持按时间区间重跑，重跑结果按 event_id 覆盖，保证可重复执行且结果一致
flowchart LR
    subgraph 采集端
        F["前端 SDK\n页面/点击/曝光"]
        S["服务端事件\n业务事务提交后上报"]
        L["定时补数\n存量与遗留数据"]
    end
    F --> G["采集网关\n校验/补全/脱敏/幂等"]
    S --> G
    L --> G
    G --> Q["事件队列"]
    Q --> RT["实时计算\n监控与大屏"]
    Q --> ODS["事件明细\ntabSaasEventTrack"]
    ODS --> DWS["离线聚合\n日/周/月指标"]
    DWS --> BI["运营驾驶舱 / BI 看板"]
    RT --> BI
    DWS --> RP["周期报表\n日/周/月推送"]
    G -.-> DL["死信队列\n校验失败告警"]

6. 埋点质量保障

Section titled “6. 埋点质量保障”
  1. 设计阶段：新增埋点须提交事件名、触发时机、属性清单与用途说明，评审通过后方可开发
  2. 测试阶段：
    1. 每条埋点须有对应的测试用例，明确触发场景与断言（事件上报、属性取值、上报次数）
    2. 提测时在测试环境触发并核对上报内容，未通过校验的埋点不予上线
  3. 上线后：
    1. 上线后 7 日内每日核对上报量与业务单据量的一致性
    2. 上报量环比波动超过 30% 触发告警，由数据责任人在 1 个工作日内给出结论
    3. 必填属性缺失率超过 1% 触发告警并回溯修复
  4. 变更管理：
    1. 埋点变更分为新增、属性变更与废弃三类，均须在埋点字典中登记版本与生效日期
    2. 已废弃埋点保留采集至少 6 个月后方可下线，避免历史分析断档
    3. 禁止在未登记的情况下直接修改事件语义

7. 权限、隐私与合规

Section titled “7. 权限、隐私与合规”
  1. 数据权限：
角色可见范围
运营端运维全量行为与指标数据（不含租户业务明细）
运营端财务收入、回款、发票与积分相关指标
租户管理员本租户的活跃与使用指标
推荐官本人的推广数据与积分流水
  1. 禁止采集：密码、身份证号、银行卡号、支付凭证影像、营业执照影像，以及任何租户业务数据明细
  2. 采集告知：首次访问时通过 Cookie 提示告知采集范围与用途，提供关闭非必要采集的入口
  3. 存储与脱敏：IP 入库前做属地化处理，用户标识在分析层以哈希值关联；手机号、邮箱等仅采集脱敏后的标识位
  4. 保留期限：事件明细默认保留 24 个月，聚合指标长期保留；超期数据按策略清理
  5. 与业务隔离要求一致：运营端仅可查看开通与计费所需信息，埋点数据不得用于还原租户业务内容

8. 实施分期与优先级

Section titled “8. 实施分期与优先级”
  1. P0（支撑核心漏斗与积分结算，优先落地）：
    1. 服务端结果事件：注册归因、认证通过、订单提交、支付成功、退款、续费、租户冻结/解冻
    2. 推荐官全链路事件：成为推荐官、推广扫码、积分入账/失效/抵充/兑换/到期清零/扣回、风控事件
    3. 落地页 ref 参数与 Cookie 归因写入
  2. P1（支撑转化与留存分析）：前端页面浏览与点击埋点、应用市场曝光与详情浏览、租户登录与应用使用、实施交付事件
  3. P2（支撑精细化运营）：内容素材埋点、消息与通知触达效果、自定义看板与自助分析

待确认事项

Section titled “待确认事项”
  1. 推荐官分级阈值与积分系数是否采用建议值（3 / 10，系数 1.0 / 1.1 / 1.2）
  2. 四阶段积分值的具体积分数，以及是否对内部销售及代理商启用比例型积分
  3. 单笔积分封顶比例（建议 20%）与单笔抵充上限比例（建议 30%）
  4. 归因窗口（建议 30 天）与归因有效期（建议 90 天）
  5. 积分有效期（建议 24 个月）与到期前提醒时机
  6. 积分商场的建设排期、商品标价规则与退货退积分规则
  7. 积分抵充在财务上的科目归属（销售折扣 vs 促销费用）需与财务口径确认
  8. 埋点技术选型：轻量方案（明细表 + 定时聚合）还是标准方案（消息队列 + 数仓）
  9. 指标字典与埋点字典的载体与维护责任人

文件版本记录

Section titled “文件版本记录”

20260904-V1.0.0

Section titled “20260904-V1.0.0”

初始版本：按《saas运营管理详细设计》的业务规则进行运营设计

  • 推荐官政策（准入分级、归因、积分发放、抵充与兑换、推广规范、风控违规、参数与数据模型扩展）
  • 运营指标设计（分层体系、生命周期漏斗、五类核心指标口径、推荐官专项指标、看板与周期报表、指标治理）
  • 系统埋点监测（分层原则、命名规范、公共属性、关键事件清单、数据链路、质量保障、权限与合规、实施分期）。

20260904-V1.1.0

Section titled “20260904-V1.1.0”

为规避财税风险，推荐官激励由佣金全面改为积分：积分按 100 积分 = 1 元折算，仅可用于订单抵充与积分商场兑换（待建设），不可提现、不可兑现、不可转让；移除提现流程、收款账户核验与个人所得税代扣代缴；明确积分抵充按销售折扣、商场兑换按促销费用的财务处理；补充积分有效期、积分套现与异常兑换风控、最小抵充单位；埋点事件由 srv_commission_* 更名为 srv_point_*，新增积分商场兑换与积分到期清零事件，移除提现相关事件。