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