项内容
版本v1.0(定稿,待评审)
日期2026-11-12
作者Davanee
读者老板 / 项目经理 / 研发
状态定稿,待评审

0. 决策摘要(给评审用)

#决策结论一句话理由
1归因买 MMP,不自研归因是信任问题,自建平台不认
2执行工具暂不采购,先用批量导入模板过渡(档 2);达阈值再评估 XMP3–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 天留存数据
自建聚合 / BiddingIAA 上线后
自建广告操作台(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 采购的触发条件(满足任一):

  1. 月消耗 > 10 万美元
  2. 优化师人均管理计划 > 200 条
  3. 在投平台 ≥ 2 个
  4. 建计划耗时 > 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 位,含字母与数字
申请角色✅只能从「管理层 / 投放 / 运营」中选,超管不可申请
工号⬜小公司多数没有,选填
申请理由⬜选填,不作为审批依据

规则:

  1. 同一邮箱只能有一条有效申请;被驳回后重新提交覆盖原申请,不产生多条
  2. 申请人选的角色只是申请意愿,最终以超管批准的角色为准
  3. 提交后不自动登录,进入「待审核」提示页

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「无权限」拒绝
不可见不可操作不显示不显示拒绝

核心规则:

  1. 接口层必须校验。只做菜单隐藏等于没有权限——直接敲 URL 或调接口照样能拿数据
  2. 超管不受矩阵约束:代码写死「超管拥有全部权限」,矩阵界面超管那一列只读置灰,防止误操作把所有人锁死
  3. 新功能点默认不可见(fail-closed),必须显式授权后才出现
  4. 行级权限 v1 不做,但鉴权必须收口到统一中间件,为下一版留口

5.0.7 权限矩阵

功能点超管管理层投放运营
查看全量收入全部可见可操作可见不可操作不可见
查看未归因收入全部可见可操作不可见不可见
剧集报表全部可操作可操作可见不可操作
素材报表全部可操作可操作不可见
导出明细全部可操作可操作不可见
改数据字典 / ROI 公式全部不可见不可见不可见
账号与角色管理全部不可见不可见不可见
操作日志全部可操作不可见不可见

矩阵维护规则:

  1. 仅超管可修改;超管列只读置灰
  2. 每次保存生成版本号,记录改前 / 改后 diff,支持一键回滚
  3. 改动写入操作日志(谁、何时、把哪个角色的哪项从什么改成什么)

5.0.8 验收

  1. 未登录访问任意页面 → 跳登录,登录后回到原页面
  2. 注册后无法登录,提示「等待审核」;管理员通过后可登录
  3. 驳回后登录能看到原因,修改重提不产生第二条申请
  4. 停用账号后,其已登录的会话在下一次请求即失效(不是等 7 天)
  5. 运营账号看不到「查看全量收入」的入口,且直接调接口返回 403
  6. 矩阵修改后,超管列无法被改动;改动可在日志中查到 diff
  7. 最后一个超管无法被停用或降级

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同上每日
Google同上每日

要求:统一字段名、统一币种(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 字段字典(跨版本,唯一事实源)。本节只保留三条硬规则:

  1. 投放主键是 content_id,全系统只有这一个名字。 不存在「第二个名字」,也不做「对内对外分别命名」。
  2. 与平台协议同名(TikTok contents[].content_id、Meta content_ids),回传时直接透传,不需要转换。
  3. 链接参数名与字段名一致:content_id / episode_no / panel_type / campaign_id。

一句话:一部作品(work)按语种拆成多个版本(content),每个版本下挂分集(episode)。

层级字段作用示例数量关系可变性
作品work_id作品级聚合键(跨语言/跨版本)WQPMZKAB1不可变,可后补
作品work_code人读业务编码(作品级,运营创建时填写)new0091可改,不进投放链路
版本content_id投放主键(广告链路唯一键)PBVXQEWU1..N永久不可变
版本lang语种属性(不参与唯一性)en / zh-Hant1创建时选定,不可编辑
分集episode_no集号,版本内唯一1、2、31..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。运营看到就知道是哪部剧的哪个版本,不需要再维护第三个字段。

三个必须避开的坑:

  1. 不要按语种建字段。写成 content_eng_id / content_jp_id,字段会随语言数量无限增长。语种是属性(lang),不是字段名。
  2. 分集不需要独立 ID。episode_no 在版本内唯一即可;若要唯一标识一集,用复合键 (content_id, episode_no),不要另发一套 ID。
  3. 业务编码挂作品级,不挂分集。挂在分集上意味着每集都要编业务码,运营无法维护。

已决策:

  1. work_id 本期即加(可空),不做跨语言汇总,但保留结构位
  2. 沿用后台已有的作品级 work_code;版本级显示编码由 work_code + 语种后缀 派生(如 new009-zh-Hant),不单独存储。旧「剧集编号」废弃
  3. 多包共享剧库,同一部剧在不同包复用同一 content_id(剧是主体,包是维度)
  4. 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 万条结论
313,824≈100%不可用❌ 装得下也撞死
4331,776≈100%不可用❌
61.91 亿23%99.9%⚠️ 需频繁重试
81,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位随机字符串}防猜测 / 防覆盖不可解析,不承载业务含义

由此产生的两条约束:

  1. content_id 不可变是硬约束:它已进入存储路径,改一次就会让视频 404、投放数据断链。数据库层拒绝 UPDATE,前端置灰。
  2. 占位符名称待确认:开发答复中路径示例写作 {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 可选
收入分摊按观看时长把平台级收入摊到各剧总量对,单剧不准高❌ 不做

报表口径要求:

  1. 剧级收入拆两列:revenue_attributed(有 content_id)与 revenue_unattributed(无)
  2. 剧级 ROAS 只用 revenue_attributed 计算,并在看板上标注口径
  3. 平台级 ROAS 用全量收入,不受影响
  4. 每次给老板看剧级 ROI 时,必须同时给出 unattributed 占比——否则会被质疑「账对不上」

5.3.7 已决策:传集号 episode_no

选项结论理由
集号(episode_no)✅ 采用可读、deeplink 简单、与内容顺序一致
分集 ID❌ 不采用把广告参数绑到存储键,违反 6.3.3 的解耦原则

配套约束(需写进内容生产规范):

  1. 分集只追加、不重排;如需插入新集,只能接在最大集号之后
  2. 若未来确需重排,先在投放侧评估影响,并保留旧集号的历史映射
  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 维度,按日平台报表 APIP0✅ 已原型化
M2剧集报表content_id 维度:消耗 / 安装 / 收入 / ROI宽表P0✅ 已原型化
M2对账差异平台后台 vs 自建表,差异 > 5% 标红双源比对P0✅ 已原型化
M2素材报表素材级 ROI需 creative_idP1(占位)✅ 已原型化(标注 P1 预览)
M3剧集列表content_id / work_code / lang 只读运营后台同步P0✅ 已原型化
M4投放概览账户消耗总览 + 跳转 XMP / 平台后台平台报表 APIP1✅ 已原型化(含跳转边界)
M5角色与权限4 角色 × 三级矩阵;超管可改、超管列只读;版本化 + 回滚权限表P0✅ 已原型化
M5账号管理待授权列表 / 审批 / 停用启用 / 改角色 / 重置密码 / 匿名化用户表P0✅ 已原型化
M5数据字典事件口径、命名规范、ROI 公式文档P0✅ 已原型化
M5操作日志谁改了口径 / 谁导出了数据只读库P2✅ 已原型化(标注 P2)

本表 12 个页面均已原型化(P1/P2 页面在原型中标注为预览)。原型用于验证信息结构与口径,不替代开发排期;交互逻辑以本表「核心内容」列为准。

两条边界(写死,防止范围蔓延):

  1. M4 是”投放概览”,不是”广告投放”。点进去只有只读汇总与跳转链接,不提供任何创建、修改、调价能力。
  2. 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 合同必争三条

  1. Raw Data / 原始数据导出权 —— 否则无法自建剧级宽表
  2. Postback 转发权 —— 回调可转发自有服务器,为后续自建留口
  3. 计费口径 —— 是否含自然量、是否含再归因/再营销、是否含重复安装

6.4 MMP 选型对比(AppsFlyer vs Adjust)

价格以 2026-11 公开信息为准,最终以商务报价为准。

6.4.1 价格结构

维度AppsFlyerAdjust
计价方式按归因转化计费(非自然量)按量分档,具体单价不公开,需报价
公开单价$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 DataData 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,5003.5%
$100,000$0.9(亚太)111,000≈ $7,8007.8%
$100,000$0.34(拉美)294,000≈ $20,60020.6%

这是本节最重要的结论:如果主投低 CPI 市场(拉美/东南亚),MMP 成本可能吃掉消耗的 15–20%。
而这个成本在”买 MMP”的讨论里几乎从不被提起——大家只看到”几千美金一个月”,没算过它和 CPI 的关系。

应对:合同必须谈阶梯价 + 封顶;或按市场拆分 App(不同包分别计费,避免低价市场拉高整体档位)。

6.4.3 能力对比

能力AppsFlyerAdjust对我们的影响
Deep linkOneLink(成熟,行业标准)有 deep link,但生态弱于 OneLink若做 W2A,OneLink 更省事
Raw dataData Locker(S3/GCS/BigQuery),Enterprise 档Raw Data 导出(S3/CSV)决定能否自建剧级宽表
防作弊Protect360(单独付费)FraudSuite短剧刷量常见,需要但不一定第一年买
W2A 支持强(Web SDK + Pixel + OneLink)强未来做 H5 时相关
SKAN / iOS成熟,聚合建模成熟两家差距不大
平台对接对接平台最多略少三平台场景两家都够
数据延迟实时回调 + 小时级报表同类无实质差异

6.4.4 服务对比(以合同为准,此处为行业普遍情况)

维度AppsFlyerAdjust
中文支持有,国内团队熟悉有,但团队规模小于前者
响应时效工单 + 客户成功,Enterprise 有专属工单 + 客户成功
实施支持SDK 接入文档完善,社区资料多文档完善
迁移成本高(生态绑定深)中
国内短剧客户密度高(案例多,同行参考多)中

服务这块不要在文档里下结论,让商务去问三个具体问题:售后响应 SLA 是多少小时?有没有中文客户成功?出问题找谁(工单还是群)?

6.4.5 建议

现阶段倾向 AppsFlyer Growth,三个理由:

  1. 单价公开($0.07/转化),预算可算,不用等报价
  2. OneLink 是行业标准,以后做 W2A 不用换工具
  3. 国内短剧客户密度高,出问题同行能问

但必须同时做两件事:

  1. 让 Adjust 报价——不透明的报价往往能谈到更低,用它压 AppsFlyer 的价格
  2. 确认 Data Locker 是否含在合同里——如果要做剧级宽表,这一项不能是”以后再加”

6.4.6 谈判必问清单(8 条)

  1. 计费口径:按归因安装还是归因转化?自然量算不算?
  2. 再营销 / 再归因是否单独计费?
  3. 阶梯价怎么分档?有没有封顶(月/年)?
  4. Data Locker / raw data 是否含在套餐内?导出量有没有上限?超了怎么算?
  5. 最低月费 / 年框金额是多少?
  6. 超出套餐后的单价是多少?
  7. 合同期多长?提前退出的条款是什么?
  8. 数据所有权:合同终止后,历史数据能否完整导出?

7. 非功能需求

项要求
时区成本归属日 = 广告账户时区;看板统一按 Asia/Shanghai 展示
币种统一 USD,汇率按日抓取
权限Metabase 分三组:管理层(全量)/ 投放(渠道+剧级)/ 运营(剧级只读)
数据保留明细 13 个月,聚合永久
刷新时点每日 06:00 前完成 T-1
安全只读账号;禁止在报表中出现用户手机号/邮箱

8. 验收标准

指标目标说明
归因覆盖率≥ 90%有渠道来源的安装占比;其余为自然量与 ATT 损耗
场景还原成功率≥ 70%iOS 指纹匹配为概率性
成本对账差异< 5%平台后台 vs 自建表,按日
剧级覆盖率≥ 95%消耗能落到 content_id 的比例
ROAS本阶段不考核支付未上线,无收入口径

该条为免责条款:支付上线前,本系统不产出 ROAS 结论。验收以过程指标为准。


9. 排期与依赖

周交付负责依赖
W1规范定稿(编号 / 事件字典 / 命名)产品无
W1MMP 比价 + POC 启动产品 + 商务无
W1用户表加 channel / campaign_id / click_id后端规范定稿
W2MMP 合同流程商务比价完成
W2只读库开通后端 / DBA无
W2事件字典 v1产品无
W3MMP SDK 接入客户端合同签署
W3Metabase 部署 + 对账脚本 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
3MMP 未签约无法交付完整版,走降级方案见下
4生产后台为 HTTP 明文、IP 直连凭据裸奔独立风险项,建议同期处理
5多包是否共享剧库决定 content_id 是否可跨包复用已确认为共享;若发现某包独立引剧,该包内容需并入共享剧库后再上架,不另建 ID

降级方案(MMP 未签约时)

只交付 ③ 数据层 + ④ 规范层:

  • 平台报表 API → 只读库 → 看板
  • 可回答:“钱花在哪个渠道 / 计划”,以及剧级内容表现
  • 不可回答:“这个安装算谁的”
  • 周期:2 周,且不依赖任何签字

11. 变更记录

版本日期变更
v0.12026-11-11初稿,待评审
v1.02026-11-12定稿:编号方案收敛为 A(旁路 ID);补收入归因缺口与 episode 决策;关闭两项开放问题
v1.12026-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 交付形态