Engineering Handoff
广告接入研发交接规格
本文件只描述本次广告接入的页面规则、状态、埋点、验收和技术待签项；阶段二原型用于演示当前设计值，正式版本按本文配置契约开发。
SSOT: tx-ad-center-prototype.html ｜ 需求追溯: PRD_新TX_广告中心接入_v1.0.html ｜ 组件契约参考: delivery-prd-builder/references/legacy-claude-skill.md
§0.1 文档说明 · 变更日志
怎么读
| 读者 | 先看 | 用途 |
|---|---|---|
| 客户端／前端 | §0.5–§0.8、C-01–C-06、O-01 | 页面插入、状态、事件和验收。 |
| 技术中心／广告中心／服务端 | §0.6、§0.8、A-00 | 广告实例、可用性、素材与统一埋点标准映射。 |
| 测试／产品／设计 | X-1、X-2 | 逻辑决议、视觉回归和最终签字。 |
| 版本 | 日期 | 变更 |
|---|---|---|
| v1.0 | 2026-07-27 | [C-01–C-06/O-01/A-00] 由最终阶段二原型逆向形成首版研发交接规格。 |
| v1.0 修订 | 2026-07-27 | [全局/X-1/X-2] 增加返回阶段二原型入口；橙色描边仅用于阶段二原型评审识别，正式版本不实现。 |
| v1.0 修订 2 | 2026-07-27 | [§0.8/A-00/X-1/X-2] 埋点开发统一按技术中心／广告中心标准执行；EP-201–EP-205 仅保留为产品追踪编号。 |
| v1.0 修订 3 | 2026-07-30 | [全局/C-01/C-06/O-01/A-00/X-1/X-2] 全部广告均不可关闭；删除用户关闭交互及对应关闭事件。 |
| v1.0 修订 4 | 2026-07-30 | [§0.5/§0.6/C-01/C-02/A-00/X-1/X-2] 首页具体插入位置调整为设计演示值，正式版本由后台配置；Feed 卡片广告增加两种后台可配置展示形态。 |
活文档纪律原型中的首页位置仅用于演示；后台配置值变化不要求重做原型。页面结构、素材形态、比例或关闭策略变化时，仍须更新原型并验收，再同步对应功能卡与变更日志。
§0.2 交付方法
| 层级 | 权威源 | 处理原则 |
|---|---|---|
| 交互与页面状态 | tx-ad-center-prototype.html | 原型为 SSOT，不用本文推翻已验证行为。 |
| 需求意图与编号 | PRD_新TX_广告中心接入_v1.0.html | 本文引用 REQ-201–REQ-209，不复制阶段一背景分析。 |
| 广告枚举与中文含义 | 广告规范 PDF | 只使用已确认枚举；创作者主页复用 profile.inline.banner。 |
| 埋点命名与上报口径 | 技术中心／广告中心现行标准 | 产品 EP 编号只做追溯映射，不另建事件名、公共字段或上报链路。 |
| 产品未确定的技术 how | 技术评审 | 标记“待技术签字”，不在本文预设接口名或实现框架。 |
§0.3 范围 · 目标指标
| 项 | 交付口径 |
|---|---|
| 页面范围 | 首页推荐、首页其他分类、个人中心、创作者主页、内容详情、全屏播放。 |
| 广告形态 | 顶部 Banner、中插 Banner、底部 Banner、Feed 卡片广告、全屏广告。 |
| 验收指标 | 页面／位置／比例／关闭策略符合率 100%；阻断级布局回归为 0。 |
| 业务指标 | 无历史基线，不设目标值；上线后按 §0.8 采集并回填。 |
| 范围外 | 素材生产、落地页业务、投放后台 UI、竞价策略、定向算法、收益承诺。 |
§0.4 信息架构 · 路由总览
六个已保留广告相关视图
当前页面？
首页 → 推荐／其他分类序列
主页 → 个人／创作者 7:2
详情 → 内容 8:1／全屏 9:16
素材可用性判断 → 展示或无痕收起
曝光／点击／不可用事件闭环
§0.5 全局规则 · 合规边界
广告容器规则 7
R-201Banner、Feed 卡片与全屏广告是三类独立容器，禁止仅按枚举名复用错误布局。
R-202阶段二原型用 2px 橙色内描边标识广告位，便于评审识别；正式版本不实现该描边。
R-203全部广告均不可关闭，不向用户提供关闭入口。
R-204广告主体点击只进入落地链路；素材不可用时由系统无痕收起。
R-205素材不可用时整个广告实例无痕收起，不保留边框、空白或计数占位。
R-206首页具体插入位置仅为当前设计与原型演示值；正式版本由后台配置，客户端不得写死自然作品序号。
R-207Feed 卡片广告支持两种后台可配置形态：封面广告图＋底部广告描述，或整卡 9:16 广告素材。
§0.6 广告位 · 素材比例 · 后台配置
配置边界下表首页具体插入位置仅为当前设计与原型演示值；正式版本由后台配置启用状态、目标频道、插入位置／间隔、排序及 Feed 展示形态，客户端不得写死第 7、15、23 条或第 8、16 条等自然作品序号。
| 页面／频道 | 当前设计演示位置 | 生产配置口径 | 类型 | 展示／比例 | 关闭 |
|---|---|---|---|---|---|
| 首页推荐 | 第 7、15 条自然作品后 | 后台配置位置／间隔与排序 | 中插 Banner 1／2 | 7:2 | 不可关闭 |
| 首页推荐 | 第 23 条自然作品后 | 后台配置位置及 Feed 展示形态 | Feed 卡片广告 | A：封面区域展示广告图片，底部文字区域展示广告描述；B：整体占据原自然作品封面与文字标题区域，展示 9:16 广告素材 | 不可关闭 |
| 首页其他分类 | 筛选区后、首个作品前 | 后台配置位置与排序 | 顶部 Banner 1 | 7:3 | 不可关闭 |
| 首页其他分类 | 第 8 条自然作品后 | 后台配置位置／间隔与排序 | 中插 Banner 2 | 7:2 | 不可关闭 |
| 首页其他分类 | 第 16 条自然作品后 | 后台配置位置及 Feed 展示形态 | Feed 卡片广告 | A：封面区域展示广告图片，底部文字区域展示广告描述；B：整体占据原自然作品封面与文字标题区域，展示 9:16 广告素材 | 不可关闭 |
| 个人／创作者主页 | 已确认内容段之间 | 沿用本版本已确认位置 | 中插 Banner | 7:2 | 不可关闭 |
| 内容详情 | 正文操作区后、评论区前 | 沿用本版本已确认位置 | 底部 Banner | 8:1 | 不可关闭 |
| 全屏播放 | 播放器首屏之后 | 沿用本版本已确认位置 | 全屏广告 | 9:16 | 不可关闭 |
§0.7 通用 8 态边界异常规范
| 状态 | 全局触发 | 统一产品表现 |
|---|---|---|
| 加载中 | 广告请求未完成 | 不显示虚假素材；是否预留防抖高度待技术签字。 |
| 空数据 | 无可投素材 | 当前广告实例无痕收起。 |
| 断网 | 离线或请求不可达 | 保持自然内容流，不出现广告空白。 |
| 错误 | 素材或落地参数错误 | 素材错误时收起；落地未接入时使用 O-01 提示。 |
| 重连 | 网络恢复 | 允许重新请求当前实例，不重复计曝光。 |
| 超限 | 频控或无投放资格 | 不展示该实例，页面计数按自然作品口径继续。 |
| 登录态 | 登录／游客 | 广告展示不强制登录；落地页权限由落地业务负责。 |
| 审核拦截 | 素材不可投 | 不向用户展示被拦截素材。 |
§0.8 全局埋点总览
统一口径埋点开发统一按技术中心／广告中心标准执行。EP-201–EP-203、EP-205 仅作为本需求的产品追踪编号，用于需求追溯与验收映射；正式事件名、公共字段、身份与时间口径、上报通道、去重、补报和环境字段以两中心现行标准为准，不得另建并行口径。
| 产品编号 | 业务动作 | 产品触发 | 广告域业务字段 | 标准映射 |
|---|---|---|---|---|
| EP-201 | 广告请求 | 请求广告实例 | ad_key、instance_id、page、category、ratio | 映射技术中心／广告中心请求事件 |
| EP-202 | 有效曝光 | 50% 可见且持续 1 秒 | ad_key、instance_id、placement、ratio | 映射技术中心／广告中心曝光事件 |
| EP-203 | 广告点击 | 广告主体点击 | ad_key、instance_id、landing_status | 映射技术中心／广告中心点击事件 |
| EP-205 | 广告不可用 | 广告无痕收起 | ad_key、instance_id、reason_code | 映射技术中心／广告中心异常事件 |
待联合签字表中字段只描述广告域所需业务语义；最终字段名、类型、必填性、枚举、事件映射与验收查询口径由技术中心／广告中心评审确认后开发。
C-01首页推荐频道P0
后台配置推荐频道的广告插入位置、间隔与排序；当前原型以第 7、15、23 条自然作品后作为设计演示值。
需求追溯
REQ-201、REQ-203、REQ-208、REQ-209
触发入口
首页“发现”页签的“推荐”频道。
接口
广告请求适配层；接口名、超时和缓存策略待技术签字。
运行流程图 · C01 推荐频道
进入推荐频道
读取后台下发的频道、位置／间隔、排序与 Feed 展示形态
在配置位置插入 Banner 1／2 · 7:2
当前原型演示：第 7、15 条后
当前原型演示：第 7、15 条后
Feed 展示形态？
A 封面广告图＋底部广告描述
B 整卡占位展示 9:16 素材
在后台配置位置插入 Feed 广告
当前原型演示：第 23 条后
当前原型演示：第 23 条后
页面图 · C01 推荐频道
真实页面截图
推荐频道中插 Banner 从交互原型实地访问截取（非示意）
推荐频道规则 5
C01-R1只按自然作品计数；Banner 和 Feed 广告自身不计入下一插入点。
C01-R2Banner 占据双列完整一行，插入点前后不得出现单侧空白。
C01-R3Feed 形态 A 在原封面区域展示广告图片，底部文字区域展示广告描述；形态 B 整体占据原自然作品封面与文字标题区域，展示 9:16 广告素材。
C01-R4阶段二原型保留 2px 橙色内描边作为评审标识；正式版本不实现。
C01-R5第 7、15、23 条仅为当前设计演示值；正式版本按后台配置渲染，客户端不得写死。
| 操作 | 目标 | 结果 |
|---|---|---|
| 点击 Banner | 广告主体 | 触发 EP-203；落地未接入时打开 O-01。 |
| 浏览 Feed 广告 | Feed 广告 | 无关闭入口；仅主体点击进入落地链路。 |
| 状态 | 触发 | 本页表现 |
|---|---|---|
| 加载中 | 实例请求中 | 不展示虚假海报；防抖高度待技术签字。 |
| 空数据 | 某插入点无素材 | 该实例收起，后续自然作品继续成对铺满。 |
| 断网 | 请求不可达 | 不留全宽空行或单卡缺位。 |
| 错误 | 素材错误 | 收起当前实例并触发 EP-205。 |
| 重连 | 网络恢复 | 可重新请求当前实例，不重复计曝光。 |
| 超限 | 频控 | 该插入点不展示广告。 |
| 登录态 | 游客／登录用户 | 展示规则一致，不强制登录。 |
| 审核拦截 | 素材不可投 | 无痕收起。 |
AC-C01-1 · 推荐频道配置序列
Given后台下发一组可用的推荐频道位置、排序和 Feed 展示形态配置；联调示例为第 7、15、23 条后
When用户连续浏览作品流
Then客户端按配置渲染两条 7:2 Banner 与一条 Feed 广告，Feed 符合 A／B 形态且双列无缺位
闭环校验后台配置、全宽布局、Feed 两种形态、关闭权限与事件均可验收。
C-02首页其他分类P0
后台按分类配置顶部 Banner、中插 Banner 与 Feed 卡片广告的位置和排序；当前原型位置只作为设计演示。
需求追溯
REQ-202、REQ-203、REQ-208、REQ-209
触发入口
首页“发现”页签的非推荐二级分类。
实例隔离
每个分类独立生成广告实例和曝光去重身份。
运行流程图 · C02 其他分类
进入非推荐分类
读取后台下发的分类、位置／间隔、排序与 Feed 展示形态
在配置位置插入顶部 7:3 与中插 7:2 Banner
当前原型演示：筛选区后、第 8 条后
当前原型演示：筛选区后、第 8 条后
Feed 展示形态？
A 封面广告图＋底部广告描述
B 整卡占位展示 9:16 素材
在后台配置位置插入 Feed 广告
当前原型演示：第 16 条后
当前原型演示：第 16 条后
页面图 · C02 其他分类
真实页面截图
美妆分类顶部 Banner 从交互原型实地访问截取（非示意）
其他分类规则 5
C02-R1筛选区后、首个作品前仅为当前原型的顶部 Banner 演示位置；正式位置由后台按分类配置。
C02-R2第 8、16 条仅为当前原型的中插 Banner 与 Feed 广告演示位置；正式版本按后台配置渲染，客户端不得写死。
C02-R3顶部 Banner 为 7:3，中插 Banner 为 7:2，禁止互换。
C02-R4切换分类后以新分类实例重新计算曝光，不复用上一分类曝光状态。
C02-R5Feed 形态 A 使用封面广告图＋底部广告描述；形态 B 使用整卡 9:16 广告素材，具体形态由后台配置。
| 操作 | 目标 | 结果 |
|---|---|---|
| 切换分类 | 美妆／美食／旅行／其他 | 重新渲染该分类的三类广告实例。 |
| 切换筛选 | 排序／收费状态 | 按当前分类的后台配置重新渲染广告位置，不写死筛选区后的固定插入点。 |
| 状态 | 触发 | 本页表现 |
|---|---|---|
| 加载中 | 分类广告请求中 | 不显示虚假素材；防抖高度待技术签字。 |
| 空数据 | 某分类无素材 | 对应实例收起，作品上移填满。 |
| 断网 | 请求不可达 | 自然作品保持完整双列。 |
| 错误 | 比例或素材错误 | 收起当前实例并记 EP-205。 |
| 重连 | 网络恢复 | 按当前分类重新请求。 |
| 超限 | 分类频控 | 不展示该分类实例。 |
| 登录态 | 游客／登录用户 | 分类广告规则一致。 |
| 审核拦截 | 素材不可投 | 无痕收起。 |
AC-C02-1 · 其他分类配置序列
Given后台下发当前分类的位置、排序和 Feed 展示形态配置；联调示例为筛选区后、第 8、16 条后
When页面加载并继续浏览自然作品
Then客户端按配置渲染 7:3 顶部 Banner、7:2 中插 Banner 与 A／B 形态 Feed 广告
闭环校验分类切换、后台位置配置、三类实例、Feed 两种形态与比例均有可验收口径。
C-03个人中心P0
在 AI 娱乐入口之后、资产功能菜单之前接入 profile.inline.banner，标准容器 7:2。
需求追溯
REQ-204、REQ-208、REQ-209
广告枚举
profile.inline.banner
关闭策略
Banner 不可关闭。
运行流程图 · C03 个人中心
进入个人中心
展示资料与 AI 娱乐入口
展示 7:2 中插 Banner
继续资产功能菜单
页面图 · C03 个人中心
真实页面截图
个人中心中插 Banner 从交互原型实地访问截取（非示意）
个人中心规则 3
C03-R1广告容器位于两个存量内容段之间，只影响之后的自然纵向流。
C03-R27:2 比例自适应宽度，不换算固定像素高度。
C03-R3上下各 6px并继承现有圆角；阶段二原型显示 2px 橙色内描边，正式版本不实现。
| 操作 | 目标 | 结果 |
|---|---|---|
| 点击 Banner | 广告主体 | 触发 EP-203；落地未接入时显示 O-01。 |
| 页面返回 | 原导航 | 不改变既有返回栈。 |
| 状态 | 触发 | 本页表现 |
|---|---|---|
| 加载中 | 请求中 | 不展示虚假海报；防抖高度待技术签字。 |
| 空数据 | 无素材 | 广告收起，资产菜单自然上移。 |
| 断网 | 请求不可达 | 不保留空白。 |
| 错误 | 素材错误 | 收起并记 EP-205。 |
| 重连 | 网络恢复 | 可重新请求当前实例。 |
| 超限 | 频控 | 不展示。 |
| 登录态 | 当前登录态变化 | 广告规则不改变既有个人中心权限。 |
| 审核拦截 | 素材不可投 | 无痕收起。 |
AC-C03-1 · 个人中心插入点
Given个人中心广告实例可用
When用户进入个人中心
ThenAI 娱乐入口后、资产菜单前显示 7:2 Banner，原有入口和菜单位置关系不变
闭环校验位置、比例、间距、关闭策略与失败收起已覆盖。
C-04创作者主页P0
作者资料之后、作品列表之前插入 7:2 横幅，复用 profile.inline.banner，不新增广告枚举。
需求追溯
REQ-205、REQ-208、REQ-209
广告枚举
profile.inline.banner（复用）
影响范围
不改变创作者资料和作品网格原有间距。
运行流程图 · C04 创作者主页
进入创作者主页
展示作者资料
展示 7:2 中插 Banner
展示作品列表
页面图 · C04 创作者主页
真实页面截图
创作者主页中插 Banner 从交互原型实地访问截取（非示意）
创作者主页规则 3
C04-R1复用 profile.inline.banner，不为创作者主页虚构专属广告枚举。
C04-R2Banner 不得进入作品网格或占据单个作品单元。
C04-R3上下各 6px、7:2 自适应且不可关闭；2px 橙色内描边只用于阶段二原型，正式版本不实现。
| 操作 | 目标 | 结果 |
|---|---|---|
| 点击 Banner | 广告主体 | 触发 EP-203；落地未接入时显示 O-01。 |
| 滚动作品 | 作品列表 | Banner 随自然内容流离开视口，不吸顶。 |
| 状态 | 触发 | 本页表现 |
|---|---|---|
| 加载中 | 请求中 | 不展示虚假海报；防抖高度待技术签字。 |
| 空数据 | 无素材 | 作品列表紧随作者资料。 |
| 断网 | 请求不可达 | 不保留空白。 |
| 错误 | 素材错误 | 收起并记 EP-205。 |
| 重连 | 网络恢复 | 可重新请求当前实例。 |
| 超限 | 频控 | 不展示。 |
| 登录态 | 游客／登录用户 | 不改变作者页访问权限。 |
| 审核拦截 | 素材不可投 | 无痕收起。 |
AC-C04-1 · 创作者主页复用广告位
Given创作者主页广告实例可用
When用户查看作者资料和作品
Then资料与作品列表之间显示 7:2 Banner，作品网格结构不变
闭环校验枚举复用与页面插入点均已锁定。
C-05内容详情P0
正文操作区之后、评论区之前插入 article_detail.bottom.banner，标准容器 8:1。
需求追溯
REQ-206、REQ-208、REQ-209
广告枚举
article_detail.bottom.banner
阅读边界
广告不得覆盖正文、操作区或评论。
运行流程图 · C05 内容详情
进入内容详情
阅读正文并到达操作区
展示 8:1 底部 Banner
继续评论区
页面图 · C05 内容详情
真实页面截图
正文与评论之间的底部 Banner 从交互原型实地访问截取（非示意）
内容详情规则 3
C05-R1广告位只在正文操作区之后出现，不以浮层覆盖内容。
C05-R28:1 自适应，Banner 上下各 6px，不可关闭。
C05-R3广告收起后评论区自然上移，正文与评论间不残留空层。
| 操作 | 目标 | 结果 |
|---|---|---|
| 点击 Banner | 广告主体 | 触发 EP-203；落地未接入时显示 O-01。 |
| 评论／收藏／分享 | 存量功能 | 交互不受广告容器影响。 |
| 状态 | 触发 | 本页表现 |
|---|---|---|
| 加载中 | 请求中 | 不遮挡正文；防抖高度待技术签字。 |
| 空数据 | 无素材 | 评论区自然接续操作区。 |
| 断网 | 请求不可达 | 不显示空广告层。 |
| 错误 | 素材错误 | 收起并记 EP-205。 |
| 重连 | 网络恢复 | 可重新请求当前实例。 |
| 超限 | 频控 | 不展示。 |
| 登录态 | 游客／登录用户 | 广告不改变评论等存量权限。 |
| 审核拦截 | 素材不可投 | 无痕收起。 |
AC-C05-1 · 正文阅读不受遮挡
Given内容详情广告实例可用
When用户滚动到正文操作区之后
Then操作区与评论区之间显示 8:1 Banner，正文、操作和评论均无遮挡
闭环校验阅读顺序、容器比例与不可关闭规则一致。
C-06全屏播放P0
完整播放器首屏之后插入独立 9:16 广告容器；用户向下浏览后进入，不覆盖播放器。
需求追溯
REQ-207、REQ-208、REQ-209
广告枚举
video_detail.inline.banner
关闭策略
全部广告均不可关闭。
运行流程图 · C06 全屏播放
进入全屏播放器
首屏完整保留播放器
继续向下浏览？
否 → 保持播放
是 → 进入 9:16 广告
继续浏览后续内容
页面图 · C06 全屏播放
真实页面截图
播放器首屏之后的全屏广告 从交互原型实地访问截取（非示意）
全屏广告规则 4
C06-R19:16 是独立全屏广告容器比例，不是首页 Banner 比例。
C06-R2播放器首屏必须完整保留，广告不得以浮层覆盖播放内容和右侧操作列。
C06-R3全屏广告不提供用户关闭入口。
C06-R4素材不可用时由系统无痕收起，不影响播放器继续使用。
| 操作 | 目标 | 结果 |
|---|---|---|
| 向下浏览 | 播放器之后 | 进入独立 9:16 广告容器，无用户关闭入口。 |
| 点击广告主体 | 全屏广告 | 进入落地链路；落地未接入时打开 O-01。 |
| 状态 | 触发 | 本页表现 |
|---|---|---|
| 加载中 | 请求中 | 播放器首屏不受影响；广告区防抖待技术签字。 |
| 空数据 | 无素材 | 广告容器收起，播放器保持完整。 |
| 断网 | 请求不可达 | 不显示空广告页。 |
| 错误 | 素材错误 | 收起并记 EP-205。 |
| 重连 | 网络恢复 | 可重新请求，已曝光实例不重复记。 |
| 超限 | 频控 | 不展示。 |
| 登录态 | 游客／登录用户 | 广告不改变播放权限。 |
| 审核拦截 | 素材不可投 | 无痕收起。 |
AC-C06-1 · 播放器首屏与不可关闭
Given全屏广告实例可用
When用户向下浏览进入广告
Then看到独立 9:16 广告且无用户关闭入口；播放器和右侧操作均未被覆盖
闭环校验播放器隔离、全屏比例、不可关闭规则与点击事件均已覆盖。
O-01广告落地页待接入提示P0
原型没有真实广告与落地页时，点击广告主体只显示诚实提示，不伪造品牌、优惠、页面或跳转结果。
触发入口
任一广告主体点击。
提示文案
广告落地页待接入。
正式对接
landing_status 与跳转安全校验待技术签字。
运行流程图 · O01 落地提示
点击广告主体
落地页可用？
是 → 交给正式落地能力
否 → 显示诚实提示
记录 EP-203
页面图 · O01 落地提示
真实页面截图
广告点击提示 从交互原型实地访问截取（非示意）
提示规则 3
O01-R1提示只说明落地页未接入，不承诺跳转成功。
O01-R2提示不包含关闭广告能力；全部广告均不可关闭。
O01-R3用户只通过广告主体触发本提示，页面不提供广告关闭入口。
| 状态 | 触发 | 表现 |
|---|---|---|
| 加载中 | 落地状态校验中 | 按钮防重复触发策略待技术签字。 |
| 空数据 | 无落地地址 | 显示待接入提示。 |
| 断网 | 无法校验 | 不跳转，错误提示文案待技术签字。 |
| 错误 | 地址非法 | 不跳转并记录 landing_status。 |
| 重连 | 网络恢复 | 用户再次点击时重新校验。 |
| 超限 | 重复点击 | 不叠加多个提示。 |
| 登录态 | 落地页需登录 | 权限交由落地业务处理。 |
| 审核拦截 | 落地地址被拦截 | 禁止跳转。 |
AC-O01-1 · 诚实占位
Given广告实例可点击但没有真实落地页
When用户点击广告主体
Then页面显示“广告落地页待接入”，不产生伪造页面或成功结果
闭环校验真实落地能力接入后保留安全校验和 EP-203 字段，移除原型占位提示。
A-00 广告服务对接边界
范围声明本版本没有广告投放后台 UI 原型，因此不伪造后台页面或管理功能；以下只列客户端与现有广告服务的产品接口契约，全部技术 how 待签字。
首页广告位置与 Feed 展示形态配置
后台配置合同
位置／间隔／排序／Feed 形态
位置／间隔／排序／Feed 形态
- 首页具体插入位置仅为当前设计与原型演示值；正式版本由后台配置，客户端不得写死自然作品序号。
- 后台配置至少覆盖启用状态、目标频道／分类、插入位置或间隔、同页排序，以及 Feed 形态 A／B。
- Feed 形态 A：封面区域展示广告图片，底部文字区域展示广告描述；Feed 形态 B：整体占据原自然作品封面与文字标题区域，展示 9:16 广告素材。
- 配置字段名、类型、默认值、异常兜底、灰度及缓存策略待技术中心／广告中心签字。
广告请求与实例身份
接口契约视图
不是后台页面截图
不是后台页面截图
- 输入最小集合：ad_key、page、category、ratio、placement。
- 输出最小集合：instance_id、material_status、landing_status、reason_code。
- instance_id 生成方、有效期和缓存策略待技术签字。
素材可用性与失败收起
产品状态合同
可展示／不可用／审核拦截
可展示／不可用／审核拦截
- 只有可展示状态允许创建可见广告实例。
- 无素材、错误、频控、审核拦截均映射为前端无痕收起。
- reason_code 枚举、重试和超时策略待技术签字。
曝光与去重
曝光合同
50% 可见 · 1 秒 · 单实例去重
50% 可见 · 1 秒 · 单实例去重
- 曝光按 instance_id 去重，分类切换创建独立实例。
- 系统判定不可用并收起后不得继续累计可见时长。
- 多端一致性与离线补报策略待技术签字。
统一埋点映射与交付
埋点标准映射
产品 EP → 技术中心／广告中心
产品 EP → 技术中心／广告中心
- EP-201–EP-203、EP-205 只用于产品需求追踪，逐项映射两中心现行事件字典后开发。
- 事件命名、公共字段、用户身份、时间、环境和上报链路统一继承技术中心／广告中心标准。
- 广告域差异字段通过既有标准扩展机制登记并联合确认，不得另建并行事件或字段口径。
- 联调与验收使用两中心认可的查询工具和数据口径，产品编号用于回溯对应业务动作。
X-1 逻辑漏洞审查 · 已决议项
L-01 · Banner 与 Feed 两种形态分离 已决议
现象首页 Banner、Feed 卡片素材和全屏广告曾被混淆，Feed 也存在不同素材呈现诉求。
风险比例、交互权限、文字区占用和页面占位错误。
决议Banner 为全宽横幅；Feed 形态 A 为封面广告图＋底部广告描述，形态 B 为整卡占位展示 9:16 素材；全屏广告仍为独立 9:16 容器。
L-02 · 首页位置由后台配置 已决议
现象原型用第 7、15、23 条及筛选区后、第 8、16 条展示广告布局。
风险研发把演示序号写死后，运营无法按频道调整广告位置、间隔和排序。
决议上述序号只作为当前设计演示值；正式版本按后台配置渲染，客户端不得写死，并继续保证全宽 Banner 前后双列完整。
L-03 · 全部广告不可关闭 已决议
现象不同广告形态曾存在不一致的用户关闭能力。
风险关闭策略分裂会导致页面行为与最新产品口径不一致。
决议全部广告均不可关闭；Feed 卡片和全屏广告同样不提供用户关闭入口。
L-04 · 不可用状态无痕收起 已决议
现象广告失败可能残留空白和视觉边框。
风险页面出现无意义占位，影响内容阅读。
决议不可用时隐藏整个实例；隐藏状态不保留尺寸、描边或曝光观察。
L-05 · 橙色描边仅用于阶段二原型 已决议
现象阶段二原型需要醒目标识广告位，便于评审核对插入位置。
风险研发可能把评审标识误当作正式界面视觉要求。
决议2px 橙色内描边仅用于阶段二原型评审识别；正式版本不实现，也不纳入广告位视觉验收。
L-06 · 技术接口细节 待技术签字
现象原型没有正式广告服务接口、超时、缓存与 reason_code 真值。
风险产品文档直接指定技术 how 会造成伪契约。
决议A-00 只锁产品输入输出和状态；接口名、重试、缓存、离线补报在技术评审签字。
L-07 · 埋点统一标准 已决议
现象产品追踪编号和业务字段可能被误当作另一套正式事件规范。
风险产生并行命名、字段与统计口径，导致广告数据无法与既有体系对齐。
决议埋点开发统一按技术中心／广告中心标准执行；EP-201–EP-203、EP-205 仅做产品追溯映射，不得另建并行口径。
X-2 验收清单 · Definition of Done
| 编号 | 验收项 | 责任 | 状态 |
|---|---|---|---|
| DOD-01 | C-01 推荐频道按后台配置渲染两条 7:2 Banner 与 Feed 广告；联调可使用第 7、15、23 条后的当前设计演示值，但客户端代码不存在固定序号。 | 产品／客户端／测试 | 待签字 |
| DOD-02 | C-02 其他分类按后台配置渲染顶部 7:3、中插 7:2 与 Feed 广告；联调可使用筛选区后及第 8、16 条后的当前设计演示值，但客户端代码不存在固定序号。 | 产品／客户端／测试 | 待签字 |
| DOD-03 | C-03–C-06 四页面插入点和比例与原型一致。 | 产品／设计／测试 | 待签字 |
| DOD-04 | 全部广告均不可关闭；全部 Banner 全宽、上下各 6px。 | 设计／测试 | 待签字 |
| DOD-05 | Feed 形态 A 的封面区域展示广告图片且底部文字区域展示广告描述；形态 B 整体占据原自然作品封面与文字标题区域并展示 9:16 广告素材，两种形态均不拉伸。 | 设计／客户端／测试 | 待签字 |
| DOD-06 | Feed 卡片与全屏广告均无用户关闭入口，广告主体点击只进入落地链路。 | 客户端／测试 | 待签字 |
| DOD-07 | 素材不可用时无痕收起，不保留空白；阶段二原型的评审描边同步消失。 | 客户端／测试 | 待签字 |
| DOD-08 | 正式版本不显示橙色描边；阶段二原型中的 2px 橙色内描边只用于评审识别。 | 设计／测试 | 待签字 |
| DOD-09 | EP-201–EP-203、EP-205 已映射并按技术中心／广告中心标准完成埋点开发，曝光满足 50%／1 秒／单实例去重，且不存在并行事件名或字段口径。 | 技术中心／广告中心／数据／客户端／测试 | 待签字 |
| DOD-10 | 375×812 基准无横向溢出、文字重叠、正文遮挡或作品缺位。 | 设计／测试 | 待签字 |
| DOD-11 | A-00 中所有“待技术签字”项完成评审并记录结论。 | 技术负责人 | 待签字 |
| DOD-12 | 本文件与最终原型、阶段一 REQ 编号和广告规范枚举可相互追溯。 | 产品／测试 | 待签字 |
发布门禁DOD-01–DOD-12 未全部签字前，不把本文件标记为研发验收完成。