Engineering Handoff

广告接入研发交接规格

本文件只描述本次广告接入的页面规则、状态、埋点、验收和技术待签项；最终行为以已验证阶段二原型为准。

P0v1.02026-07-27H5 基准 375×812
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.02026-07-27[C-01–C-06/O-01/A-00] 由最终阶段二原型逆向形成首版研发交接规格。
v1.0 修订2026-07-27[全局/X-1/X-2] 增加返回阶段二原型入口；橙色描边仅用于阶段二原型评审识别，正式版本不实现。
v1.0 修订 22026-07-27[§0.8/A-00/X-1/X-2] 埋点开发统一按技术中心／广告中心标准执行；EP-201–EP-205 仅保留为产品追踪编号。
v1.0 修订 32026-07-30[全局/C-01/C-06/O-01/A-00/X-1/X-2] 全部广告均不可关闭；删除用户关闭交互及对应关闭事件。
活文档纪律页面位置、比例、间隔或关闭策略发生变化时，先更新原型并验收，再同步修改对应卡与变更日志。

§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 全局规则 · 合规边界

广告容器规则 5
R-201

Banner、Feed 卡片与全屏广告是三类独立容器，禁止仅按枚举名复用错误布局。

R-202

阶段二原型用 2px 橙色内描边标识广告位，便于评审识别；正式版本不实现该描边。

R-203

全部广告均不可关闭，不向用户提供关闭入口。

R-204

广告主体点击只进入落地链路；素材不可用时由系统无痕收起。

R-205

素材不可用时整个广告实例无痕收起，不保留边框、空白或计数占位。

§0.6 广告位 · 素材比例 · 插入序列

页面／频道位置类型标准容器关闭
首页推荐第 7、15 条自然作品后中插 Banner 1／27:2不可关闭
首页推荐第 23 条自然作品后Feed 卡片广告外层 3:4；内部 9:16不可关闭
首页其他分类筛选区后、首个作品前顶部 Banner 17:3不可关闭
首页其他分类第 8 条自然作品后中插 Banner 27:2不可关闭
首页其他分类第 16 条自然作品后Feed 卡片广告外层 3:4；内部 9:16不可关闭
个人／创作者主页已确认内容段之间中插 Banner7:2不可关闭
内容详情正文操作区后、评论区前底部 Banner8: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映射技术中心／广告中心异常事件
待联合签字表中字段只描述广告域所需业务语义；最终字段名、类型、必填性、枚举、事件映射与验收查询口径由技术中心／广告中心评审确认后开发。
用户端 / 首页 /C01 推荐频道广告序列
C-01首页推荐频道P0

按自然作品计数插入两条全宽 7:2 Banner，再插入一条与作品对齐的 Feed 卡片广告。

需求追溯
REQ-201、REQ-203、REQ-208、REQ-209
触发入口
首页“发现”页签的“推荐”频道。
接口
广告请求适配层；接口名、超时和缓存策略待技术签字。
运行流程图 · C01 推荐频道
进入推荐频道
自然作品 1–7
插入 Banner 1 · 7:2
自然作品 8–15
插入 Banner 2 · 7:2
自然作品 16–23
插入 Feed 卡片广告 · 内部 9:16
页面图 · C01 推荐频道
真实页面截图
推荐频道中插 Banner 真实截图
推荐频道中插 Banner 从交互原型实地访问截取（非示意）
推荐频道规则 4
C01-R1

只按自然作品计数；Banner 和 Feed 广告自身不计入下一插入点。

C01-R2

Banner 占据双列完整一行，插入点前后不得出现单侧空白。

C01-R3

Feed 广告外层与普通作品的封面、文字区和总高度对齐。

C01-R4

阶段二原型保留 2px 橙色内描边作为评审标识；正式版本不实现。

操作目标结果
点击 Banner广告主体触发 EP-203；落地未接入时打开 O-01。
浏览 Feed 广告Feed 广告无关闭入口；仅主体点击进入落地链路。
状态触发本页表现
加载中实例请求中不展示虚假海报；防抖高度待技术签字。
空数据某插入点无素材该实例收起，后续自然作品继续成对铺满。
断网请求不可达不留全宽空行或单卡缺位。
错误素材错误收起当前实例并触发 EP-205。
重连网络恢复可重新请求当前实例，不重复计曝光。
超限频控该插入点不展示广告。
登录态游客／登录用户展示规则一致，不强制登录。
审核拦截素材不可投无痕收起。
AC-C01-1 · 推荐频道序列
Given推荐频道至少有 23 条自然作品且广告实例可用
When用户连续浏览作品流
Then第 7、15、23 条自然作品后依次出现 7:2 Banner、7:2 Banner、Feed 广告，双列无缺位
闭环校验插入序列、全宽布局、Feed 对齐、关闭权限与事件均可验收。
用户端 / 首页 /C02 其他分类广告序列
C-02首页其他分类P0

美妆、美食、旅行、其他分类首屏顶部展示 7:3 Banner，并按自然作品计数插入 7:2 Banner 与 Feed 卡片广告。

需求追溯
REQ-202、REQ-203、REQ-208、REQ-209
触发入口
首页“发现”页签的非推荐二级分类。
实例隔离
每个分类独立生成广告实例和曝光去重身份。
运行流程图 · C02 其他分类
进入非推荐分类
筛选区之后插入顶部 Banner · 7:3
自然作品 1–8
插入中插 Banner · 7:2
自然作品 9–16
插入 Feed 卡片广告 · 内部 9:16
页面图 · C02 其他分类
真实页面截图
其他分类顶部 Banner 真实截图
美妆分类顶部 Banner 从交互原型实地访问截取（非示意）
其他分类规则 4
C02-R1

顶部 Banner 位于筛选区下方、首个作品之前，不属于自然作品计数。

C02-R2

第 8、16 条自然作品分别决定中插 Banner 和 Feed 广告位置。

C02-R3

顶部 Banner 为 7:3，中插 Banner 为 7:2，禁止互换。

C02-R4

切换分类后以新分类实例重新计算曝光，不复用上一分类曝光状态。

操作目标结果
切换分类美妆／美食／旅行／其他重新渲染该分类的三类广告实例。
切换筛选排序／收费状态顶部 Banner 仍固定在筛选区与作品之间。
状态触发本页表现
加载中分类广告请求中不显示虚假素材；防抖高度待技术签字。
空数据某分类无素材对应实例收起，作品上移填满。
断网请求不可达自然作品保持完整双列。
错误比例或素材错误收起当前实例并记 EP-205。
重连网络恢复按当前分类重新请求。
超限分类频控不展示该分类实例。
登录态游客／登录用户分类广告规则一致。
审核拦截素材不可投无痕收起。
AC-C02-1 · 其他分类顶部与中插
Given用户进入任一非推荐分类且广告可用
When页面首屏加载并继续浏览 16 条自然作品
Then筛选区后显示 7:3 顶部 Banner，第 8 条后显示 7:2 中插 Banner，第 16 条后显示 Feed 广告
闭环校验分类切换、筛选位置、三类实例与各自比例均有唯一口径。
用户端 / 个人中心 /C03 中插 Banner
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 真实截图
个人中心中插 Banner 从交互原型实地访问截取（非示意）
个人中心规则 3
C03-R1

广告容器位于两个存量内容段之间，只影响之后的自然纵向流。

C03-R2

7:2 比例自适应宽度，不换算固定像素高度。

C03-R3

上下各 6px并继承现有圆角；阶段二原型显示 2px 橙色内描边，正式版本不实现。

操作目标结果
点击 Banner广告主体触发 EP-203；落地未接入时显示 O-01。
页面返回原导航不改变既有返回栈。
状态触发本页表现
加载中请求中不展示虚假海报；防抖高度待技术签字。
空数据无素材广告收起，资产菜单自然上移。
断网请求不可达不保留空白。
错误素材错误收起并记 EP-205。
重连网络恢复可重新请求当前实例。
超限频控不展示。
登录态当前登录态变化广告规则不改变既有个人中心权限。
审核拦截素材不可投无痕收起。
AC-C03-1 · 个人中心插入点
Given个人中心广告实例可用
When用户进入个人中心
ThenAI 娱乐入口后、资产菜单前显示 7:2 Banner，原有入口和菜单位置关系不变
闭环校验位置、比例、间距、关闭策略与失败收起已覆盖。
用户端 / 创作者主页 /C04 中插 Banner
C-04创作者主页P0

作者资料之后、作品列表之前插入 7:2 横幅，复用 profile.inline.banner，不新增广告枚举。

需求追溯
REQ-205、REQ-208、REQ-209
广告枚举
profile.inline.banner（复用）
影响范围
不改变创作者资料和作品网格原有间距。
运行流程图 · C04 创作者主页
进入创作者主页
展示作者资料
展示 7:2 中插 Banner
展示作品列表
页面图 · C04 创作者主页
真实页面截图
创作者主页中插 Banner 真实截图
创作者主页中插 Banner 从交互原型实地访问截取（非示意）
创作者主页规则 3
C04-R1

复用 profile.inline.banner，不为创作者主页虚构专属广告枚举。

C04-R2

Banner 不得进入作品网格或占据单个作品单元。

C04-R3

上下各 6px、7:2 自适应且不可关闭；2px 橙色内描边只用于阶段二原型，正式版本不实现。

操作目标结果
点击 Banner广告主体触发 EP-203；落地未接入时显示 O-01。
滚动作品作品列表Banner 随自然内容流离开视口，不吸顶。
状态触发本页表现
加载中请求中不展示虚假海报；防抖高度待技术签字。
空数据无素材作品列表紧随作者资料。
断网请求不可达不保留空白。
错误素材错误收起并记 EP-205。
重连网络恢复可重新请求当前实例。
超限频控不展示。
登录态游客／登录用户不改变作者页访问权限。
审核拦截素材不可投无痕收起。
AC-C04-1 · 创作者主页复用广告位
Given创作者主页广告实例可用
When用户查看作者资料和作品
Then资料与作品列表之间显示 7:2 Banner，作品网格结构不变
闭环校验枚举复用与页面插入点均已锁定。
用户端 / 内容详情 /C05 底部 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 真实截图
正文与评论之间的底部 Banner 从交互原型实地访问截取（非示意）
内容详情规则 3
C05-R1

广告位只在正文操作区之后出现，不以浮层覆盖内容。

C05-R2

8:1 自适应，Banner 上下各 6px，不可关闭。

C05-R3

广告收起后评论区自然上移，正文与评论间不残留空层。

操作目标结果
点击 Banner广告主体触发 EP-203；落地未接入时显示 O-01。
评论／收藏／分享存量功能交互不受广告容器影响。
状态触发本页表现
加载中请求中不遮挡正文；防抖高度待技术签字。
空数据无素材评论区自然接续操作区。
断网请求不可达不显示空广告层。
错误素材错误收起并记 EP-205。
重连网络恢复可重新请求当前实例。
超限频控不展示。
登录态游客／登录用户广告不改变评论等存量权限。
审核拦截素材不可投无痕收起。
AC-C05-1 · 正文阅读不受遮挡
Given内容详情广告实例可用
When用户滚动到正文操作区之后
Then操作区与评论区之间显示 8:1 Banner，正文、操作和评论均无遮挡
闭环校验阅读顺序、容器比例与不可关闭规则一致。
用户端 / 全屏播放 /C06 独立全屏广告
C-06全屏播放P0

完整播放器首屏之后插入独立 9:16 广告容器；用户向下浏览后进入，不覆盖播放器。

需求追溯
REQ-207、REQ-208、REQ-209
广告枚举
video_detail.inline.banner
关闭策略
全部广告均不可关闭。
运行流程图 · C06 全屏播放
进入全屏播放器
首屏完整保留播放器
继续向下浏览？
否 → 保持播放
是 → 进入 9:16 广告
继续浏览后续内容
页面图 · C06 全屏播放
真实页面截图
全屏播放广告真实截图
播放器首屏之后的全屏广告 从交互原型实地访问截取（非示意）
全屏广告规则 4
C06-R1

9:16 是独立全屏广告容器比例，不是首页 Banner 比例。

C06-R2

播放器首屏必须完整保留，广告不得以浮层覆盖播放内容和右侧操作列。

C06-R3

全屏广告不提供用户关闭入口。

C06-R4

素材不可用时由系统无痕收起，不影响播放器继续使用。

操作目标结果
向下浏览播放器之后进入独立 9:16 广告容器，无用户关闭入口。
点击广告主体全屏广告进入落地链路；落地未接入时打开 O-01。
状态触发本页表现
加载中请求中播放器首屏不受影响；广告区防抖待技术签字。
空数据无素材广告容器收起，播放器保持完整。
断网请求不可达不显示空广告页。
错误素材错误收起并记 EP-205。
重连网络恢复可重新请求，已曝光实例不重复记。
超限频控不展示。
登录态游客／登录用户广告不改变播放权限。
审核拦截素材不可投无痕收起。
AC-C06-1 · 播放器首屏与不可关闭
Given全屏广告实例可用
When用户向下浏览进入广告
Then看到独立 9:16 广告且无用户关闭入口；播放器和右侧操作均未被覆盖
闭环校验播放器隔离、全屏比例、不可关闭规则与点击事件均已覆盖。
全局反馈 /O01 广告落地提示
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 待签字。
广告请求与实例身份
接口契约视图
不是后台页面截图
  • 输入最小集合：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 逻辑漏洞审查 · 已决议项

L-01 · Banner 与 9:16 容器分离 已决议
现象

首页 Banner、Feed 卡片内部素材与全屏广告曾被混淆。

风险

比例、交互权限和页面占位错误。

决议

Banner 为全宽横幅；Feed 外层按作品卡片、内部 9:16；全屏广告为独立 9:16 容器。

L-02 · 首页计数与双列配对 已决议
现象

全宽 Banner 前后可能出现单侧空白。

风险

内容流断层，作品卡片没有填满。

决议

只按自然作品计数，并选择第 7、15、23 条后的确定插入点保持双列完整。

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-01C-01 推荐频道第 7、15、23 条后的三类广告位置正确。产品／测试待签字
DOD-02C-02 其他分类顶部 7:3、第 8 条 7:2、第 16 条 Feed 广告正确。产品／测试待签字
DOD-03C-03–C-06 四页面插入点和比例与原型一致。产品／设计／测试待签字
DOD-04全部广告均不可关闭；全部 Banner 全宽、上下各 6px。设计／测试待签字
DOD-05Feed 外层与作品对齐，内部 9:16 不拉伸。设计／测试待签字
DOD-06Feed 卡片与全屏广告均无用户关闭入口，广告主体点击只进入落地链路。客户端／测试待签字
DOD-07素材不可用时无痕收起，不保留空白；阶段二原型的评审描边同步消失。客户端／测试待签字
DOD-08正式版本不显示橙色描边；阶段二原型中的 2px 橙色内描边只用于评审识别。设计／测试待签字
DOD-09EP-201–EP-203、EP-205 已映射并按技术中心／广告中心标准完成埋点开发，曝光满足 50%／1 秒／单实例去重，且不存在并行事件名或字段口径。技术中心／广告中心／数据／客户端／测试待签字
DOD-10375×812 基准无横向溢出、文字重叠、正文遮挡或作品缺位。设计／测试待签字
DOD-11A-00 中所有“待技术签字”项完成评审并记录结论。技术负责人待签字
DOD-12本文件与最终原型、阶段一 REQ 编号和广告规范枚举可相互追溯。产品／测试待签字
发布门禁DOD-01–DOD-12 未全部签字前，不把本文件标记为研发验收完成。