| 项 | 内容 |
|---|---|
| 版本 | v1.0(定稿,待评审) |
| 日期 | 2026-11-12 |
| 作者 | Davanee |
| 读者 | 老板 / 项目经理 / 研发 |
| 状态 | 定稿,待评审 |
0. 决策摘要(给评审用)
| # | 决策 | 结论 | 一句话理由 |
|---|---|---|---|
| 1 | 归因 | 买 MMP,不自研 | 归因是信任问题,自建平台不认 |
| 2 | 执行工具 | 暂不采购,先用批量导入模板过渡(档 2);达阈值再评估 XMP | 3–5 人日即可顶替 80% 效率,不阻塞第一笔钱 |
| 3 | 交付形态 | Metabase + 只读库 | MVP 要「能看数」,不是「有产品」 |
| 4 | 数据粒度 | 渠道 / campaign / 剧级,不做素材级 | 素材级依赖生产端带 ID,现在做必然错 |
| 5 | 时效 | T+1,每日 06:00 前 | 平台 API 本身有延迟,准实时无收益 |
| 6 | 编号方案 | 单一 content_id 做版本主键,旧剧集编号废弃(2026-11-13 开发确认) | 只保留一个 ID,避免双轨 |
| 7 | 业务编码 | 沿用后台已有的作品级 work_code(如 new009),可改,不进投放链路 | 人按「作品」沟通,不按语言版本 |
| 8 | 收入口径 | 订单加 scene,剧级收入拆已归因/未归因两列 | 个人中心充值不带剧集编号 |
| 9 | 验收 | 四项过程指标,不考核 ROAS | 支付未上线,无收入口径 |
1. 一句话目标
在投放启动之前,建立「花出去的每一块钱都能被归因、被核算」的最小能力。
不做什么(本版明确排除):
- 不做投放执行系统(批量建计划、自动调价)
- 不做归因引擎(不自研,采买)
- 不做素材生产工具
- 不做变现聚合
2. 背景:三条事实
| # | 事实 | 推论 |
|---|---|---|
| 1 | 公司没有任何投放系统,只有一个运营后台(内容 + 用户钱包 + 运营位) | 买量侧从 0 开始,不存在”打通”问题,只有”新建”问题 |
| 2 | 支付与 IAA 均未上线,当前版本为提审版本 | 无法产出 ROAS 结论;MVP 只能考核过程指标 |
| 3 | 无 MMP、无归因、无渠道字段 | 一旦开始买量,钱会花得无法解释 |
结论:现在不是”优化投放效率”的时点,是”建立记账能力”的时点。这个窗口只有一次——第一笔投放消耗发生之前。
3. 范围
3.1 四个模块
| 模块 | 内容 | 买 / 建 | 责任方 |
|---|---|---|---|
| ① 归因层 | MMP SDK + 事件回传 + deeplink | 买 | 商务 + 客户端 |
| ② 执行层 | 批量导入模板(档 2)+ 账户总览只读 | 建(模板),操作台不自建 | 产品 + 投放 |
| ③ 数据层 | 只读从库 + Metabase + 对账脚本 | 建 | 数据 + 后端 |
| ④ 规范层 | content_id / 事件字典 / 命名规范 | 建 | 产品 |
MVP = ①②③④ 打通这一条竖线,其余一律不做。
3.2 数据粒度与时效
| 维度 | 本版范围 |
|---|---|
| 时间 | T+1,每日 06:00 前产出前一日数据 |
| 渠道 | ✅ Meta / TikTok / Google |
| 层级 | ✅ campaign / adset |
| 内容 | ✅ 剧级(content_id) |
| 素材 | ❌ 不做(依赖素材库与 ID 映射,放 P1) |
| 用户 | ❌ 不做(依赖 OneID,放 P2) |
3.3 明确不包含(含触发条件)
| 不做 | 什么时候做 |
|---|---|
| 素材自动裂变 / AI 生成 | 月消耗 > 30 万美元 |
| 自动调价 / 自动止损 | 有 30 天以上稳定数据 |
| 自建二次归因(助攻、伪新增) | MMP 数据跑满 3 个月 |
| 素材级 ROI | 素材生产端能自动产出 creative_id 时 |
| 多包矩阵管理 | 有第 2 个包在投 |
| LTV 预测 / Lookalike 反哺 | 有 90 天留存数据 |
| 自建聚合 / Bidding | IAA 上线后 |
| 自建广告操作台(API 批量创建 / 自动调价 / 素材上传) | 满足 3.4 的四条触发条件之一 |
| 自建广告操作台(API 批量创建 / 自动调价 / 素材上传) | 满足 3.4 的四条触发条件之一 |
3.4 执行层:自建范围界定
执行层不做”广告操作台”,只做两件事:生成批量导入模板 + 只读账户总览。
| 档 | 内容 | 结论 | 工作量 |
|---|---|---|---|
| 档 1 | 只读看板:拉平台报表 → 缝合收入 → 剧级 ROI | ✅ 自建(本 MVP 的 ③④ 层) | 1–2 周 |
| 档 2 | 半自动创建:按命名规范生成批量导入模板,人工上传平台 | ✅ 自建 | 3–5 人日 |
| 档 3 | 完整操作台:API 批量建计划、自动调价、素材上传、多账户管理 | ❌ 不自建 | 3 个月+ |
档 2 的具体载体(均为平台原生工具,不写 API):
- Meta:Ads Manager 批量导入表格
- Google:Google Ads Editor(免费桌面工具,离线批量改后一次推送)
- TikTok:后台批量导入
判断一个功能该不该自建的三个问题:
| 问题 | 答案 | 结论 |
|---|---|---|
| 需要写到广告平台吗? | 是 | ❌ 不自建(审核 + 写错烧钱) |
| 依赖归因数据吗? | 是 | ❌ 不自建(数据在 MMP 手里) |
| 是给人看数还是给人操作? | 看数 | ✅ 自建 |
重启 XMP 采购的触发条件(满足任一):
- 月消耗 > 10 万美元
- 优化师人均管理计划 > 200 条
- 在投平台 ≥ 2 个
- 建计划耗时 > 2 小时/人/天
触发后重新评估,不在本版范围。这样既不阻塞当前交付,也保留了”达阈值即采购”的路径。
4. 流程图
图 1:数据流(MVP 的一条竖线)
flowchart LR A["广告平台<br/>Meta / TikTok / Google"] -->|"点击"| B["应用商店"] B --> C["安装 / 首开"] C --> D["MMP SDK<br/>归因判定"] D -->|"事件回传"| A D -->|"install + click_id"| E[("只读从库")] A -->|"报表 API<br/>消耗 / 点击 / 展示"| E C -->|"业务库<br/>用户 / 订单"| E G["规范层<br/>content_id · 命名 · 事件字典"] -.->|"约束"| E E --> F["Metabase 看板"] F --> H["每日 T+1 报表"]
注意:归因数据(MMP)与成本数据(平台 API)是两条独立管道,只在只读库相遇。因此 MVP 的核心不是”接 API”,而是保证两条管道使用同一套键(
campaign_id/content_id)。这是规范层必须前置的原因。
图 2:里程碑依赖
flowchart TD P0["P0 规范定稿<br/>content_id / 事件字典 / 命名"] --> P1["P1 MMP 签约"] P1 --> P2["P2 SDK 接入"] P2 --> P3["P3 发版过审"] P3 --> P4["P4 归因数据入仓"] Q1["Q1 只读库开通"] --> P4 Q2["Q2 平台报表 API 拉取"] --> P5["P5 看板上线"] P4 --> P5 P0 --> Q2
关键路径只有一条:P0 规范 → P1 签约 → P2 SDK → P3 发版。其中 P3 不可压缩(App 审核周期),这是要资源的核心理由。
图 3:日对账流程
flowchart TD S1["06:00 任务触发"] --> S2["拉取三平台 T-1 消耗/点击"] S1 --> S3["拉取 MMP T-1 安装/事件"] S2 --> S4["按 campaign_id 关联"] S3 --> S4 S4 --> S5{"差异 < 5% ?"} S5 -->|"是"| S6["写入宽表 → 看板刷新"] S5 -->|"否"| S7["标红 + 通知 + 记录原因"] S7 --> S8["人工核查<br/>时区 / 归因窗口 / 重复回传"] S8 --> S6
5. 功能需求
5.0 M0 登录与账号
投放中台是独立系统、独立账号体系(与 Flickme 运营后台不同域、无关系)。
不接第三方登录、不开放公开注册——注册需经超管审批后才可登录。
5.0.1 状态机
stateDiagram-v2 [*] --> 待审核: 提交注册(含申请角色) 待审核 --> 已通过: 超管审批(可改角色) 待审核 --> 已驳回: 超管驳回(必填原因) 已驳回 --> 待审核: 修改后重新提交 已通过 --> 已停用: 离职 / 违规 已停用 --> 已通过: 重新启用 已通过 --> 已锁定: 连续 5 次密码错误(自动,15 分钟) 已锁定 --> 已通过: 到时自动解锁
| 状态 | 能否登录 | 页面表现 |
|---|---|---|
| 待审核 | ❌ | 显示「已提交,等待管理员审核」+ 申请详情 |
| 已通过 | ✅ | 按角色加载菜单与权限 |
| 已驳回 | ❌ | 显示驳回原因 + 「修改后重新提交」入口 |
| 已停用 | ❌ | 「账号已停用,请联系管理员」 |
| 已锁定 | ❌ | 显示剩余锁定时间,到时自动解锁 |
5.0.2 注册
| 字段 | 必填 | 说明 |
|---|---|---|
| 姓名 | ✅ | 用于超管核对身份 |
| 部门 | ✅ | 下拉或文本,便于判断岗位 |
| 邮箱 | ✅ | 登录账号,全局唯一 |
| 密码 | ✅ | ≥ 10 位,含字母与数字 |
| 申请角色 | ✅ | 只能从「管理层 / 投放 / 运营」中选,超管不可申请 |
| 工号 | ⬜ | 小公司多数没有,选填 |
| 申请理由 | ⬜ | 选填,不作为审批依据 |
规则:
- 同一邮箱只能有一条有效申请;被驳回后重新提交覆盖原申请,不产生多条
- 申请人选的角色只是申请意愿,最终以超管批准的角色为准
- 提交后不自动登录,进入「待审核」提示页
5.0.3 登录
| 项 | 规则 |
|---|---|
| 登录方式 | 邮箱 + 密码 |
| 失败锁定 | 连续 5 次错误锁定 15 分钟,提示剩余时间 |
| 登录态 | JWT + refresh,默认 7 天,可勾选「7 天内免登录」 |
| 停用生效 | 立即作废该用户全部 refresh token,现有会话下一次请求即失效 |
| 审计 | 登录成功 / 失败 / 锁定 / 注册 / 审批,全部写入操作日志 |
5.0.4 审批(超管)
| 项 | 规则 |
|---|---|
| 审批人 | 任一超管,单人审批(公司规模小,不做双人) |
| 审批动作 | 通过(可改角色)/ 驳回(必填原因) |
| 审批依据 | 姓名、部门、邮箱、申请角色、申请时间 |
| 通知 | 通过 / 驳回均发邮件;待审核超 3 天,每日给超管发一封汇总提醒 |
| 留痕 | 记录「申请角色 vs 批准角色」的差异 |
5.0.5 账号管理(超管)
| 功能 | 规则 |
|---|---|
| 账号列表 | 姓名、部门、邮箱、角色、状态、最后登录时间 |
| 停用 / 启用 | 停用立即踢下线;不能停用自己;不能停用最后一个超管 |
| 改角色 | 直接生效,写入日志 |
| 重置密码 | 超管触发 → 发重置邮件(或生成一次性密码),不做人工告知密码 |
| 释放邮箱 | 旧账号邮箱改为 archived+{id}@local,腾出原邮箱给新人 |
| 匿名化 | 停用满 6 个月,姓名/邮箱替换为「已注销用户#{id}」,保留 user_id 与全部日志 |
| 临时账号 | 可选字段 expire_at,到期自动停用并通知超管 |
账号交接原则:账号跟人走,不跟岗位走。离职 = 停用保留;交接 = 新建账号。不做账号所有权转移,否则历史操作日志会变成新人的。
5.0.6 权限模型(4 角色 × 三级)
三级定义:
| 级别 | 菜单 | 按钮 | 接口 |
|---|---|---|---|
| 可见可操作 | 显示 | 可点 | 允许 |
| 可见不可操作 | 显示 | 置灰 + tooltip「无权限」 | 拒绝 |
| 不可见不可操作 | 不显示 | 不显示 | 拒绝 |
核心规则:
- 接口层必须校验。只做菜单隐藏等于没有权限——直接敲 URL 或调接口照样能拿数据
- 超管不受矩阵约束:代码写死「超管拥有全部权限」,矩阵界面超管那一列只读置灰,防止误操作把所有人锁死
- 新功能点默认不可见(fail-closed),必须显式授权后才出现
- 行级权限 v1 不做,但鉴权必须收口到统一中间件,为下一版留口
5.0.7 权限矩阵
| 功能点 | 超管 | 管理层 | 投放 | 运营 |
|---|---|---|---|---|
| 查看全量收入 | 全部 | 可见可操作 | 可见不可操作 | 不可见 |
| 查看未归因收入 | 全部 | 可见可操作 | 不可见 | 不可见 |
| 剧集报表 | 全部 | 可操作 | 可操作 | 可见不可操作 |
| 素材报表 | 全部 | 可操作 | 可操作 | 不可见 |
| 导出明细 | 全部 | 可操作 | 可操作 | 不可见 |
| 改数据字典 / ROI 公式 | 全部 | 不可见 | 不可见 | 不可见 |
| 账号与角色管理 | 全部 | 不可见 | 不可见 | 不可见 |
| 操作日志 | 全部 | 可操作 | 不可见 | 不可见 |
矩阵维护规则:
- 仅超管可修改;超管列只读置灰
- 每次保存生成版本号,记录改前 / 改后 diff,支持一键回滚
- 改动写入操作日志(谁、何时、把哪个角色的哪项从什么改成什么)
5.0.8 验收
- 未登录访问任意页面 → 跳登录,登录后回到原页面
- 注册后无法登录,提示「等待审核」;管理员通过后可登录
- 驳回后登录能看到原因,修改重提不产生第二条申请
- 停用账号后,其已登录的会话在下一次请求即失效(不是等 7 天)
- 运营账号看不到「查看全量收入」的入口,且直接调接口返回 403
- 矩阵修改后,超管列无法被改动;改动可在日志中查到 diff
- 最后一个超管无法被停用或降级
5.1 ① 归因层(采买:MMP)
| 需求 | 说明 |
|---|---|
| SDK 接入 | iOS / Android,随发版进包 |
| 事件回传 | 至少 6 个事件入平台(见 5.3.2) |
| deeplink | 支持带 content_id / episode_no 直接落到指定剧集 |
| 数据导出 | 开通 Raw Data / Pull API,供只读库拉取 |
| postback 转发 | 回调可转发至自有服务器(为后续自建留口) |
5.2 ② 成本数据接入(平台报表 API)
| 平台 | 拉取内容 | 频率 |
|---|---|---|
| Meta | 消耗、展示、点击、安装(若平台侧有)、campaign/adset 维度 | 每日 |
| TikTok | 同上 | 每日 |
| 同上 | 每日 |
要求:统一字段名、统一币种(USD)、保留原始 JSON 以便回溯。
5.3 ③ 规范层(自建,本版最高优先级)
5.3.1 编号体系(三层)
mindmap root((作品 work_id WQPMZKAB)) content_id ABKQZPWM lang en 剧集 episode_no 1 剧集 episode_no 2 剧集 episode_no 3 content_id CDMNRTYX lang es-MX 剧集 episode_no 1 剧集 episode_no 2 content_id EFGHJKLM lang fr-FR 剧集 episode_no 1
图上每个分支都是一条独立的版本记录,由
content_id单独确定。lang是它的属性,不是复合主键的一部分——所以加日语只增加一条记录,不增加字段。
命名:一个字段一个名字
字段定义、类型、示例、外部映射,统一见 00 字段字典(跨版本,唯一事实源)。本节只保留三条硬规则:
- 投放主键是
content_id,全系统只有这一个名字。 不存在「第二个名字」,也不做「对内对外分别命名」。 - 与平台协议同名(TikTok
contents[].content_id、Metacontent_ids),回传时直接透传,不需要转换。 - 链接参数名与字段名一致:
content_id/episode_no/panel_type/campaign_id。
一句话:一部作品(work)按语种拆成多个版本(content),每个版本下挂分集(episode)。
| 层级 | 字段 | 作用 | 示例 | 数量关系 | 可变性 |
|---|---|---|---|---|---|
| 作品 | work_id | 作品级聚合键(跨语言/跨版本) | WQPMZKAB | 1 | 不可变,可后补 |
| 作品 | work_code | 人读业务编码(作品级,运营创建时填写) | new009 | 1 | 可改,不进投放链路 |
| 版本 | content_id | 投放主键(广告链路唯一键) | PBVXQEWU | 1..N | 永久不可变 |
| 版本 | lang | 语种属性(不参与唯一性) | en / zh-Hant | 1 | 创建时选定,不可编辑 |
| 分集 | episode_no | 集号,版本内唯一 | 1、2、3 | 1..M | 不可变 |
为什么需要两个 ID(不是新增一个编码):
work_code 是作品级的人读编码,运营在创建作品时填写(如 new009 / LOVE-001),可改,不参与投放链路。旧「剧集编号」(版本级,如 1001 / 1001-ES)已废弃。真正新增的只有 work_id 与 content_id。
content_id(机器) | work_code(人) | |
|---|---|---|
| 给谁用 | 广告平台、接口、报表 | 运营、客服、商务、口头沟通 |
| 格式 | 8 位大写字母,URL 安全 | 任意可读格式 |
| 可变性 | 永久不可变 | 可改(改名、合并、纠错) |
| 唯一性 | 全局唯一 | 全局唯一,但允许人工整理 |
一句话:content_id 是身份证号,work_code 是名字。人可以改名,身份证号不能动。
为什么不直接用现有编号当 content_id:现有编号是为人设计的——可改、可能不唯一、可能含中文或下划线、大小写不统一。把它塞进广告链接参数里,任何一次”顺手改个编号”都会让历史投放数据断链。这正是 6.3.3「B 方案」要付的代价。
版本的显示编码是派生的,不单独存储:work_code + 语种后缀,例如 LOVE-001-EN、LOVE-001-ES。运营看到就知道是哪部剧的哪个版本,不需要再维护第三个字段。
三个必须避开的坑:
- 不要按语种建字段。写成
content_eng_id/content_jp_id,字段会随语言数量无限增长。语种是属性(lang),不是字段名。 - 分集不需要独立 ID。
episode_no在版本内唯一即可;若要唯一标识一集,用复合键(content_id, episode_no),不要另发一套 ID。 - 业务编码挂作品级,不挂分集。挂在分集上意味着每集都要编业务码,运营无法维护。
已决策:
work_id本期即加(可空),不做跨语言汇总,但保留结构位- 沿用后台已有的作品级
work_code;版本级显示编码由work_code + 语种后缀派生(如new009-zh-Hant),不单独存储。旧「剧集编号」废弃 - 多包共享剧库,同一部剧在不同包复用同一
content_id(剧是主体,包是维度) content_id全自动生成,禁止人工输入
2026-11-13 更新:开发已确认旧「剧集编号」不保留,
work_code维持作品级,无需归并。
5.3.2 编号规则
| 项 | 规则 |
|---|---|
| 字符集 | 大写字母 A–Z,去掉 I、O(24 个) |
| 长度 | 8 位(理由见下) |
| 生成 | 服务端随机 + 唯一索引 + 冲突重试 |
| 校验 | 正则 ^[A-HJ-NP-Z]{8}$ |
| 不可变 | 前端置灰 + 后端拒绝更新 + 下架不复用 |
为什么是 8 位(按 1 万部设计,并预留语言版本倍数):
| 长度 | 空间 | 1 万条碰撞概率 | 5 万条 | 结论 |
|---|---|---|---|---|
| 3 | 13,824 | ≈100% | 不可用 | ❌ 装得下也撞死 |
| 4 | 331,776 | ≈100% | 不可用 | ❌ |
| 6 | 1.91 亿 | 23% | 99.9% | ⚠️ 需频繁重试 |
| 8 | 1,100 亿 | 0.045% | 1.1% | ✅ |
关键认知:短编号的问题不是容量,是随机碰撞。1 万条记录在 33 万空间里,按生日问题计算碰撞概率接近 100%。同时,8 位也能避免编号被枚举、剧库规模被外部推算。
记录数 = 作品数 × 语言版本数。1 万部 × 3 语言 = 3 万条
content_id,8 位下碰撞概率约 0.4%,配合唯一索引重试可完全无感。
5.3.3 迁移与存储路径
2026-11-13 变更:开发确认旧「剧集编号」不再保留,全系统只有
content_id一个版本级主键;原 A/B 双轨方案与映射表作废。
存量数据结论:无迁移工作。
- 改版前的历史数据尚未处理
- 昨天之前的数据都是测试环境,不会给真实用户
- 因此不存在“生产数据迁移”问题,
content_id从第一条真实记录起就是唯一主键
| 步 | 动作 | 风险 |
|---|---|---|
| 1 | 加字段:content_id / work_id 可空 + 唯一索引 | 低 |
| 2 | 回填:脚本为测试数据生成 content_id(可选,测试库可直接清空) | 无 |
| 3 | 冻结:禁止修改 content_id(数据库拒 UPDATE + 前端置灰) | 无 |
| 4 | 验收:唯一性 100%、格式 100%、抽样 10 条播放与投放链路可还原 | 无 |
5.3.3.1 存储路径规则(已确认)
https://{域名}/{前缀}/video/{series_id}/{分集主键ID}/{24位随机字符串}.{扩展名}
| 段 | 含义 | 说明 |
|---|---|---|
| 版本主键 | content_id | 开发答复中该段写作 {series_id},待确认是笔误还是代码变量 |
{分集主键ID} | 分集内部 ID | 对应字段字典的 episode_id,非集号 episode_no |
{24位随机字符串} | 防猜测 / 防覆盖 | 不可解析,不承载业务含义 |
由此产生的两条约束:
content_id不可变是硬约束:它已进入存储路径,改一次就会让视频 404、投放数据断链。数据库层拒绝 UPDATE,前端置灰。- 占位符名称待确认:开发答复中路径示例写作
{series_id}。按统一口径应为{content_id};若只是消息里的笔误则无需处理,若是代码变量名则建议改名(字符串替换,成本极低)。
5.3.4 与投放链路的衔接
进链接的字段:content_id、episode_no、panel_type、campaign_id
不进链接的字段:work_code、work_id、lang
理由:work_code 人读且可改;work_id 是内部聚合键;lang 由 content_id 隐含(一条记录 = 一个语种版),重复传入会导致口径冲突。
验收:任取一条投放链接,能仅凭参数还原到”哪部剧的第几集、该展示哪种付费墙”。
5.3.5 事件字典 v1
| 事件 | 触发时机 | 关键参数 | 本期状态 |
|---|---|---|---|
install | 首开 | click_id、campaign_id | 本期可用 |
register | 注册/绑定 | user_id、registered_days | 本期可用 |
first_play | 首次播放 | content_id、episode_no | 本期可用 |
episode_3_complete | 第 3 集完播 | content_id | 本期可用 |
paywall_view | 付费墙曝光 | content_id、panel_type | 本期可用 |
purchase | 支付成功 | amount_net、order_id | 占位,支付上线后启用 |
ad_revenue | 广告收入回传 | ad_unit、revenue | 占位,IAA 上线后启用 |
口径约定:amount_net = 实付 × (1 − 渠道抽成) − 税 − 退款;event_id 全局唯一用于去重;自然量归因标记 organic。
5.3.6 收入归因缺口(订单场景)
事实(研发答复 2026-11-12):订单只有在剧集内充值时才携带剧集编号;个人中心充值不携带。
影响:剧级 ROI 的收入侧天然缺一块。若不处理,会出现「各剧收入之和 < 总收入」,且缺的那部分往往是最优质的充值——用户主动去个人中心充,通常金额更大、复购更高。
| 方案 | 做法 | 精度 | 成本 | 建议 |
|---|---|---|---|---|
| 场景标记 | 订单表加 scene(in_drama / profile),content_id 可空 | 剧集内 100%,个人中心 0% | 1 字段 | ✅ 本期必做 |
| 最近观看补偿 | 个人中心订单按「最近观看剧」归属,标记 inferred | 约 60–80%(待验证) | 中 | ⬜ P1 可选 |
| 收入分摊 | 按观看时长把平台级收入摊到各剧 | 总量对,单剧不准 | 高 | ❌ 不做 |
报表口径要求:
- 剧级收入拆两列:
revenue_attributed(有content_id)与revenue_unattributed(无) - 剧级 ROAS 只用
revenue_attributed计算,并在看板上标注口径 - 平台级 ROAS 用全量收入,不受影响
- 每次给老板看剧级 ROI 时,必须同时给出
unattributed占比——否则会被质疑「账对不上」
5.3.7 已决策:传集号 episode_no
| 选项 | 结论 | 理由 |
|---|---|---|
集号(episode_no) | ✅ 采用 | 可读、deeplink 简单、与内容顺序一致 |
| 分集 ID | ❌ 不采用 | 把广告参数绑到存储键,违反 6.3.3 的解耦原则 |
配套约束(需写进内容生产规范):
- 分集只追加、不重排;如需插入新集,只能接在最大集号之后
- 若未来确需重排,先在投放侧评估影响,并保留旧集号的历史映射
- 投放链接中的
episode_no为空时,落到该剧第 1 集(不是首页)
5.4 ④ 数据层(自建)
| 需求 | 说明 |
|---|---|
| 只读从库 | 业务库只读账号,禁止写入 |
| 宽表 | 日期 × 渠道 × campaign × adset × content_id × 消耗 × 安装 × 首充 × 收入 |
| 看板 | Metabase,3 个视图:渠道总览 / 剧级表现 / 对账差异 |
| 对账脚本 | 每日比对平台后台与自建表,差异 > 5% 标红 |
明确不自建前端页面:MVP 阶段用 Metabase,需求稳定后再评估是否嵌入运营后台。
5.5 页面结构(MVP 范围)
mindmap root((投放中台 MVP)) M0 登录与账号 登录 自助注册 待审核 驳回重提 M1 数据概览 核心指标卡 分渠道汇总 消耗与收入趋势 异常提示 M2 数据报表 渠道报表 剧集报表 对账差异 素材报表 P1占位 M3 内容资产 剧集列表 M4 投放概览 账户总览只读 跳转外部工具 M5 系统 角色与权限 账号管理 数据字典 操作日志
| 模块 | 页面 | 核心内容 | 数据来源 | 优先级 | 原型 |
|---|---|---|---|---|---|
| M0 | 登录与注册 | 登录 / 自助注册(申请角色)/ 待审核 / 驳回重提 / 连续失败锁定 | 用户表 | P0 | ✅ 已原型化 |
| M1 | 数据概览 | 消耗 / 收入 / ROI / 回本进度指标卡;分渠道汇总;近 30 天趋势;异常提示 | 宽表 | P0 | ✅ 已原型化 |
| M2 | 渠道报表 | campaign / adset 维度,按日 | 平台报表 API | P0 | ✅ 已原型化 |
| M2 | 剧集报表 | content_id 维度:消耗 / 安装 / 收入 / ROI | 宽表 | P0 | ✅ 已原型化 |
| M2 | 对账差异 | 平台后台 vs 自建表,差异 > 5% 标红 | 双源比对 | P0 | ✅ 已原型化 |
| M2 | 素材报表 | 素材级 ROI | 需 creative_id | P1(占位) | ✅ 已原型化(标注 P1 预览) |
| M3 | 剧集列表 | content_id / work_code / lang 只读 | 运营后台同步 | P0 | ✅ 已原型化 |
| M4 | 投放概览 | 账户消耗总览 + 跳转 XMP / 平台后台 | 平台报表 API | P1 | ✅ 已原型化(含跳转边界) |
| M5 | 角色与权限 | 4 角色 × 三级矩阵;超管可改、超管列只读;版本化 + 回滚 | 权限表 | P0 | ✅ 已原型化 |
| M5 | 账号管理 | 待授权列表 / 审批 / 停用启用 / 改角色 / 重置密码 / 匿名化 | 用户表 | P0 | ✅ 已原型化 |
| M5 | 数据字典 | 事件口径、命名规范、ROI 公式 | 文档 | P0 | ✅ 已原型化 |
| M5 | 操作日志 | 谁改了口径 / 谁导出了数据 | 只读库 | P2 | ✅ 已原型化(标注 P2) |
本表 12 个页面均已原型化(P1/P2 页面在原型中标注为预览)。原型用于验证信息结构与口径,不替代开发排期;交互逻辑以本表「核心内容」列为准。
两条边界(写死,防止范围蔓延):
- M4 是”投放概览”,不是”广告投放”。点进去只有只读汇总与跳转链接,不提供任何创建、修改、调价能力。
- M3 只读。内容的新增与编辑仍在运营后台,本系统不提供内容编辑能力。
5.5.1 线框示例:M1 数据概览
┌────────────────────────────────────────────────────────────────┐
│ 投放中台 [近 7 天 ▾] [Davanee ▾] │
├────────────────────────────────────────────────────────────────┤
│ 消耗 $12,480 ↑8% │ 收入 $9,120 ↑12% │ ROI 0.73 │ 回本进度 62% │
├────────────────────────────────────────────────────────────────┤
│ 分渠道汇总 │
│ 渠道 消耗 安装 CPI 收入 ROAS │
│ Meta $8,200 4,100 $2.00 $6,300 0.77 │
│ TikTok $3,100 2,050 $1.51 $2,100 0.68 │
│ Google $1,180 620 $1.90 $720 0.61 │
│ 合计 $12,480 6,770 $1.84 $9,120 0.73 │
├────────────────────────────────────────────────────────────────┤
│ 消耗与收入趋势(近 30 天) │ 剧级 TOP 5(按消耗) │
│ ▁▂▃▅▆▇█ │ 1. ABKQZPWM $2,100 ROAS 0.91 │
│ ▁▂▃▅▆▇█ │ 2. CDMNRTYX $1,800 ROAS 0.74 │
├────────────────────────────────────────────────────────────────┤
│ ⚠ 对账差异 6.2%(TikTok) ⚠ 归因覆盖率 87% │
└────────────────────────────────────────────────────────────────┘说明:ROI 与回本进度在支付上线前显示为”—“,并附「支付未上线」提示。剧级 ROAS 旁必须标
revenue_unattributed占比(见 5.3.6)。
5.6 页面交付形态
| 形态 | 用途 | 说明 |
|---|---|---|
| A. 线框图 | 进需求文档 | Markdown 代码块 + 表格,低保真,随文档评审 |
| C. HTML 单页原型 | 给老板演示 | 单文件、无后端、双击可开,静态假数据 |
原型文件:投放中台-演示原型.html
- 双击用浏览器打开(Chrome / Safari 均可),无需联网、无需后端
- 11 个页面全部可点:
#login登录 /#m1概览 /#channel渠道 /#drama剧集 /#recon对账 /#creative素材 /#series剧集列表 /#overview投放 /#rbac权限 /#accounts账号 /#dict字典 /#log日志 - 数据为静态假数据,仅供演示信息结构与口径,不代表真实业务
预览图:登录页 · 数据概览 · 渠道报表 · 剧集报表 · 对账差异 · 剧集列表 · 投放概览 · 角色权限 · 账号管理 · 数据字典
不在 md 中嵌入真实界面截图:可读性差且一改就过时;需要看图时打开上面的预览图或原型。
6. 采买清单与论证
6.1 采买项
| 采买项 | 解决什么问题 | 不买的后果(用钱说) | 决策窗口 | 预算 |
|---|---|---|---|---|
| MMP(AppsFlyer / Adjust,二选一) | 归因、事件回传、deeplink、防作弊、平台白名单 | 钱花出去不知道从哪来;平台收不到转化信号,算法学不会,CPI 持续走高 | 本周启动(SDK 跟发版,不可压缩) | 待报价(按安装量阶梯) |
| XMP 或同类(暂不采购) | 批量建计划、跨账户素材复用、自动盯盘 | 优化师人效撑不住,但不影响第一笔钱花出去 | 达阈值后评估(见 3.4) | 待报价(按消耗比例或月费) |
| 广告账户代开 / 充值 | 开户与结算 | 无法投放 | 随 MMP | 按消耗 |
| Metabase | 看板 | — | 不采买,自建 | 开源免费 |
6.2 为什么不能自己开发
| # | 论证 | 一句话版本 |
|---|---|---|
| 1 | 归因不是软件问题,是信任问题 | 自己给自己发证书,广告平台不认 |
| 2 | 投放执行不是技术问题,是变更速率问题 | 平台 API 每季度变,自建等于养一个永远追版本的团队 |
| 3 | 聚合变现不是功能问题,是议价问题 | eCPM 靠流量规模谈,不靠代码写 |
| 4 | 人力成本算得过来,机会成本算不过来 | 自研归因 3 人 × 6 个月,这 6 个月本可以跑 20 个素材方向 |
反向边界(重要):凡是”读数据、定标准、算自己的账”必须自建;凡是”跟平台打交道、要平台信任、要外部议价”必须买。主动划界,采买申请才可信。
6.3 合同必争三条
- Raw Data / 原始数据导出权 —— 否则无法自建剧级宽表
- Postback 转发权 —— 回调可转发自有服务器,为后续自建留口
- 计费口径 —— 是否含自然量、是否含再归因/再营销、是否含重复安装
6.4 MMP 选型对比(AppsFlyer vs Adjust)
价格以 2026-11 公开信息为准,最终以商务报价为准。
6.4.1 价格结构
| 维度 | AppsFlyer | Adjust |
|---|---|---|
| 计价方式 | 按归因转化计费(非自然量) | 按量分档,具体单价不公开,需报价 |
| 公开单价 | $0.07 / 归因转化(Growth) | 不公开 |
| 免费额度 | 首年 12,000 次归因转化(Welcome Package) | 无公开信息,需谈 |
| 档位 | Zero(免费,仅自有媒体)/ Growth(按量)/ Enterprise(定制) | Base(≤1.8 万)/ Core(≤25 万)/ Enterprise(250 万+),单位以官方为准 |
| 附加模块 | Protect360(防作弊)、Data Locker(原始数据)、ROI360、Audiences 均单独计费 | 防作弊、Audience Builder 等,是否含在套餐需确认 |
| Raw Data | Data Locker + Push/Pull API 在 Enterprise 档;Growth 的 Raw Data API 有行数上限 | Raw Data 导出通常含在套餐内,需确认导出方式(S3/CSV) |
| 最低消费 / 年框 | Enterprise 定制,通常年框 | 通常年框 + 最低消费 |
关键差异:AppsFlyer 公开单价,可估算;Adjust 不公开,必须询价。 这意味着前者容易做预算,后者容易谈到更低的价格(因为不透明)。
6.4.2 成本估算(按我们的场景)
短剧的特点是 CPI 低、安装量大,而 MMP 按安装计费——这会让 MMP 成本占消耗的比例显著上升。
| 月消耗 | CPI | 月归因安装 | AppsFlyer 估算月费 | 占消耗比 |
|---|---|---|---|---|
| $100,000 | $2.0(北美) | 50,000 | ≈ $3,500 | 3.5% |
| $100,000 | $0.9(亚太) | 111,000 | ≈ $7,800 | 7.8% |
| $100,000 | $0.34(拉美) | 294,000 | ≈ $20,600 | 20.6% |
这是本节最重要的结论:如果主投低 CPI 市场(拉美/东南亚),MMP 成本可能吃掉消耗的 15–20%。
而这个成本在”买 MMP”的讨论里几乎从不被提起——大家只看到”几千美金一个月”,没算过它和 CPI 的关系。应对:合同必须谈阶梯价 + 封顶;或按市场拆分 App(不同包分别计费,避免低价市场拉高整体档位)。
6.4.3 能力对比
| 能力 | AppsFlyer | Adjust | 对我们的影响 |
|---|---|---|---|
| Deep link | OneLink(成熟,行业标准) | 有 deep link,但生态弱于 OneLink | 若做 W2A,OneLink 更省事 |
| Raw data | Data Locker(S3/GCS/BigQuery),Enterprise 档 | Raw Data 导出(S3/CSV) | 决定能否自建剧级宽表 |
| 防作弊 | Protect360(单独付费) | FraudSuite | 短剧刷量常见,需要但不一定第一年买 |
| W2A 支持 | 强(Web SDK + Pixel + OneLink) | 强 | 未来做 H5 时相关 |
| SKAN / iOS | 成熟,聚合建模 | 成熟 | 两家差距不大 |
| 平台对接 | 对接平台最多 | 略少 | 三平台场景两家都够 |
| 数据延迟 | 实时回调 + 小时级报表 | 同类 | 无实质差异 |
6.4.4 服务对比(以合同为准,此处为行业普遍情况)
| 维度 | AppsFlyer | Adjust |
|---|---|---|
| 中文支持 | 有,国内团队熟悉 | 有,但团队规模小于前者 |
| 响应时效 | 工单 + 客户成功,Enterprise 有专属 | 工单 + 客户成功 |
| 实施支持 | SDK 接入文档完善,社区资料多 | 文档完善 |
| 迁移成本 | 高(生态绑定深) | 中 |
| 国内短剧客户密度 | 高(案例多,同行参考多) | 中 |
服务这块不要在文档里下结论,让商务去问三个具体问题:售后响应 SLA 是多少小时?有没有中文客户成功?出问题找谁(工单还是群)?
6.4.5 建议
现阶段倾向 AppsFlyer Growth,三个理由:
- 单价公开($0.07/转化),预算可算,不用等报价
- OneLink 是行业标准,以后做 W2A 不用换工具
- 国内短剧客户密度高,出问题同行能问
但必须同时做两件事:
- 让 Adjust 报价——不透明的报价往往能谈到更低,用它压 AppsFlyer 的价格
- 确认 Data Locker 是否含在合同里——如果要做剧级宽表,这一项不能是”以后再加”
6.4.6 谈判必问清单(8 条)
- 计费口径:按归因安装还是归因转化?自然量算不算?
- 再营销 / 再归因是否单独计费?
- 阶梯价怎么分档?有没有封顶(月/年)?
- Data Locker / raw data 是否含在套餐内?导出量有没有上限?超了怎么算?
- 最低月费 / 年框金额是多少?
- 超出套餐后的单价是多少?
- 合同期多长?提前退出的条款是什么?
- 数据所有权:合同终止后,历史数据能否完整导出?
7. 非功能需求
| 项 | 要求 |
|---|---|
| 时区 | 成本归属日 = 广告账户时区;看板统一按 Asia/Shanghai 展示 |
| 币种 | 统一 USD,汇率按日抓取 |
| 权限 | Metabase 分三组:管理层(全量)/ 投放(渠道+剧级)/ 运营(剧级只读) |
| 数据保留 | 明细 13 个月,聚合永久 |
| 刷新时点 | 每日 06:00 前完成 T-1 |
| 安全 | 只读账号;禁止在报表中出现用户手机号/邮箱 |
8. 验收标准
| 指标 | 目标 | 说明 |
|---|---|---|
| 归因覆盖率 | ≥ 90% | 有渠道来源的安装占比;其余为自然量与 ATT 损耗 |
| 场景还原成功率 | ≥ 70% | iOS 指纹匹配为概率性 |
| 成本对账差异 | < 5% | 平台后台 vs 自建表,按日 |
| 剧级覆盖率 | ≥ 95% | 消耗能落到 content_id 的比例 |
| ROAS | 本阶段不考核 | 支付未上线,无收入口径 |
该条为免责条款:支付上线前,本系统不产出 ROAS 结论。验收以过程指标为准。
9. 排期与依赖
| 周 | 交付 | 负责 | 依赖 |
|---|---|---|---|
| W1 | 规范定稿(编号 / 事件字典 / 命名) | 产品 | 无 |
| W1 | MMP 比价 + POC 启动 | 产品 + 商务 | 无 |
| W1 | 用户表加 channel / campaign_id / click_id | 后端 | 规范定稿 |
| W2 | MMP 合同流程 | 商务 | 比价完成 |
| W2 | 只读库开通 | 后端 / DBA | 无 |
| W2 | 事件字典 v1 | 产品 | 无 |
| W3 | MMP SDK 接入 | 客户端 | 合同签署 |
| W3 | Metabase 部署 + 对账脚本 v1 | 数据 | 只读库 |
| W4 | 发版过审 | 客户端 | SDK 接入 |
| W4 | 回传链路联调(用平台测试工具,不花钱) | 客户端 + 数据 | 发版 |
| W5 | 宽表 v1 + 看板 | 数据 | 回传数据入仓 |
| W6 | 验收:四项指标出数 | 产品 | 全部 |
卡点升级机制:任一步骤延期 > 3 个工作日,产品直接升级至项目负责人,不在周会里等待。
10. 风险与开放问题
| # | 问题 | 影响 | 处理 |
|---|---|---|---|
| 1 | 存储路径用哪个 ID | 已确认(11-13):路径模板为 video/{series_id}/{分集主键ID}/{random},存的是 content_id 的值;无存量生产数据,无需迁移 | 见 5.3.3;注意模板变量名需统一为 content_id |
| 2 | 剧集编号是否被用作外键 | 已确认:分集、解锁关联;订单仅剧集内充值关联 | 收入侧缺口,见 5.3.6 |
| 3 | MMP 未签约 | 无法交付完整版,走降级方案 | 见下 |
| 4 | 生产后台为 HTTP 明文、IP 直连 | 凭据裸奔 | 独立风险项,建议同期处理 |
| 5 | 多包是否共享剧库 | 决定 content_id 是否可跨包复用 | 已确认为共享;若发现某包独立引剧,该包内容需并入共享剧库后再上架,不另建 ID |
降级方案(MMP 未签约时)
只交付 ③ 数据层 + ④ 规范层:
- 平台报表 API → 只读库 → 看板
- 可回答:“钱花在哪个渠道 / 计划”,以及剧级内容表现
- 不可回答:“这个安装算谁的”
- 周期:2 周,且不依赖任何签字
11. 变更记录
| 版本 | 日期 | 变更 |
|---|---|---|
| v0.1 | 2026-11-11 | 初稿,待评审 |
| v1.0 | 2026-11-12 | 定稿:编号方案收敛为 A(旁路 ID);补收入归因缺口与 episode 决策;关闭两项开放问题 |
| v1.1 | 2026-11-13 | 旧剧集编号废弃,改为单一 content_id;删除映射表与「编号映射」页(13→12 页) |
| v1.0 修订 | 2026-11-12 | 执行层由「买 XMP」改为「批量导入模板 + 只读概览」;新增 3.4 自建范围界定、5.5 页面结构、5.6 交付形态 |
| v1.0 修订 | 2026-11-12 | 执行层由「买 XMP」改为「批量导入模板 + 只读概览」;新增 3.4 自建范围界定、5.5 页面结构、5.6 交付形态 |