广告管理
横幅、图标、浮窗、视频卡片、播放器片头、短视频、HTML、iframe、广告代码与弹出式广告的配置方法。
「广告管理」共 11 个页面。先用下表选对广告形态,再按各节配置素材,最后在「广告配置」里统一排序和控制视频广告插入策略。
步骤章节(点击跳转)
横幅、图标、浮窗、视频、播放器、短视频、HTML、iframe、广告代码与弹出式广告的配置,以及广告配置里的排序与插入策略。
| 页面 | 路由 | 形态 | 素材 |
|---|---|---|---|
| 广告配置 | /ads/config |
全局规则 | 广告类型排序、视频广告插入策略 |
| 横幅广告 | /ads/banner |
头部 Banner 图 | 图片 + 链接 + 到期 + 展示数量 |
| 图标广告 | /ads/icon |
图标宫格入口 | 图标 + 标题 + 链接 |
| 浮窗广告 | /ads/float |
固定在页面边缘的悬浮 HTML | HTML + 位置 |
| 视频广告 | /ads/video |
混在视频列表里的广告卡片 | 封面 + 标题 + 链接 + 比例 |
| 播放器广告 | /ads/playerAd |
正片前的片头广告(需订阅) | MP4/外部视频 |
| 短视频广告 | /ads/shortVideoAd |
短视频流/短剧里的全屏广告(需订阅) | MP4/外部视频 |
| HTML 广告 | /ads/html |
头部广告区域的一段 HTML | 单个 HTML |
| iframe 广告 | /ads/iframe |
头部广告区域嵌入第三方页面 | 名称 + URL + 高度 + sandbox |
| 广告代码 | /ads/code |
所有正常前台页面底部执行的 HTML/JS | 代码 |
| 弹出式广告 | /ads/popup |
点击时打开新窗口的广告 | 页面地址 + 触发规则 |
订阅
播放器广告、短视频广告、弹出式广告等高级广告属于订阅功能(见角色与权限),未订阅时无法保存或启用。
所有列表型广告都是**「改完统一保存」**:新增、编辑、排序、启停、删除先保留在当前页面,点击「保存配置」才正式生效;「重新加载」会放弃未保存的修改。
广告配置

广告类型排序
拖拽「横幅 / 图标 / HTML / iframe」四种类型,决定前台头部广告区域中它们的先后顺序。
- 排序只影响类型之间的顺序,不改变每种类型内部素材的顺序;
- 某类型没有可展示内容时前台自动跳过;已过期的横幅、图标、iframe 广告不展示;
- HTML 广告需在其模块里启用并填写内容后才展示;
- 保存后,前台重新加载初始化数据才能看到新顺序。
视频广告插入策略
控制「视频广告(卡片)」在首页视频区块、视频列表页等位置的展示:
| 配置项 | 说明 |
|---|---|
| 插入位置 | 头部插入(排在列表最前)或随机插入(随机分布) |
| 最大插入数 | 每个视频列表最多插入多少条,范围 1-20;建议内容优先的站点 1-2,常规运营 3-5 |
| 随机模式行为 | 仅随机插入时生效:插入模式(列表总卡片增加)或替换模式(随机替换已有卡片,总数不变) |
布局对卡片数量敏感时用替换模式;更看重内容完整展示时用插入模式。实际数量还受可用素材数量和卡片比例影响。
横幅广告与图标广告

| 配置项 | 横幅 | 图标 | 说明 |
|---|---|---|---|
| 图片 | 必填 | 必填 | 图片库选择、上传或手动输入地址。图标建议正方形 |
| 标题 | — | 必填 | 显示在图标下方,过长会被截断,建议 2-6 个字 |
| 链接模式 | 超链接(完整 URL)或路由(站内路径如 /video/123) |
||
| 链接地址 | 必填 | 必填 | 按链接模式填写 |
| 打开方式 / Rel | 超链接可配 | 超链接可配 | 新窗口/当前窗口;外部链接建议新窗口并保留 noopener noreferrer |
| 到期时间 | 不设置表示长期展示,到期后前台自动过滤 | ||
| 展示数量 | 1-10 |
1-10 |
同一素材在前台按次数展开:数量 3 就占 3 个位置,用来提高曝光占比,普通展示保持 1 |

路由模式指向自定义页面时,需先在页面配置里创建并启用该页面。图标广告以宫格展示,按页面宽度自动分列;部分区块开启了「隐藏未满最后一排」时,最后一行不足一整行的图标可能不显示。
浮窗广告

| 配置项 | 说明 |
|---|---|
| 广告标题 | 必填,仅后台识别 |
| HTML 内容 | 必填,浮窗实际内容;点击跳转需自己写在 HTML 里;浮窗最大宽度约 280px |
| 展示位置 | 左上 / 左 / 左下 / 右上 / 右 / 右下 |
| 启用状态 | 关闭则前台不展示 |
| 允许关闭 | 开启后浮窗右上角显示关闭按钮 |
要在 HTML 内部放自己的关闭按钮,给任意元素加 data-action="close" 即可:
<a to="/me/vip" style="display:block;padding:12px;border-radius:12px;background:#0891b2;color:#fff;text-align:center">
限时会员 8 折 →
</a>
<span data-action="close" style="position:absolute;top:4px;right:8px;cursor:pointer">×</span>多个浮窗选同一位置会叠在相近区域,应避免;选位置时避开导航、底部菜单和播放器按钮,手机端尤其要小心遮挡。
视频广告(视频卡片广告)

伪装成视频卡片混在列表里的广告。字段:封面图片、标题、链接模式/地址/打开方式/Rel、到期时间、卡片比例。
卡片比例必须与目标列表匹配:横版广告只进横版卡片列表,竖版只进竖版列表。广告没有出现时,先检查该列表是横版还是竖版,再检查插入策略(最大插入数、是否过期)。
播放器广告(正片前片头)

推荐流程:新增至少一条素材 → 确认启用和顺序 → 选播放策略 → 设置跳过 → 设置会员免广告 → 打开「播放器广告」总开关 → 保存 → 前台播放一集验收。
| 配置项 | 说明 |
|---|---|
| 播放器广告(总开关) | 开启后,启用状态的广告才在正片前播放 |
| 播放策略 | 顺序播放(按列表顺序播全部启用广告)/ 随机排列后全部播放 / 随机抽取指定条数(不重复;数量大于启用数时播全部) |
| 允许跳过广告 | 开启后用户等待达到时间即可跳过整个广告队列;等待时间 1-60 秒,按实际播放时间累计,暂停不计 |
| 会员免广告 + 最低会员等级 | 达到该等级及以上的有效会员直接进入正片;必须选择当前可用的会员等级 |
| 引导用户开通会员 | 依赖会员免广告:未达标用户在广告等待期间看到「开通会员免广告」入口 |
素材字段:
| 配置项 | 要求 |
|---|---|
| 广告名称 | 必填,最多 80 字符 |
| 广告时长(秒) | 必填,大于 0 的整数,建议与素材实际时长一致(用于剩余时间展示) |
| 视频来源 | 上传 MP4(仅 .mp4,不超过 20 MiB)或外部地址(HTTP/HTTPS,路径以 .mp4 或 .m3u8 结尾,可带查询参数) |
| 点击链接 | 选填,完整 HTTP/HTTPS 地址,不支持 /video/1 这样的站内路径 |
| 启用广告 | 关闭则保留素材但不投放 |
列表操作:编辑、预览(检查视频能否加载)、删除、上移/下移、切换状态。随机策略会改变顺序;需要固定顺序请选「顺序播放」。
| 推荐 | 配置 |
|---|---|
| 体验优先 | 随机抽取 1 条,允许跳过,等待 3-5 秒 |
| 曝光优先 | 顺序或随机全部播放,跳过等待 5-10 秒,时长与素材一致 |
验收:正片前出现片头广告、数量和顺序符合策略、倒计时与跳过正确、点击链接可打开,并分别用普通用户/未达标会员/达标会员验证免广告。
短视频广告

在短视频推荐流和多集短剧中插入全屏视频广告(需先在短视频管理启用模块并有内容,另需订阅)。「视频流投放」和「短剧投放」两个场景使用相同的配置项但独立生效。
| 配置项 | 说明 |
|---|---|
| 短视频广告总开关 | 关闭时两个场景都不投放 |
| 场景开关 | 视频流 / 短剧分别开关 |
| 间隔方式 | 固定间隔(每浏览 N 条正常内容后插入一条,N>0)或随机间隔(最小-最大之间随机;最小大于最大时保存会自动按从小到大规范化) |
| 素材选择策略 | 随机抽取一条 / 按列表顺序轮播 |
| 可滑过等待时间 | 0-60 秒;0 表示可立即滑过 |
| 会员免广告 + 最低会员等级 | 两个场景分别设置 |
计数规则:广告本身不计入正常内容数;视频流按首次浏览的短视频计数,返回重复查看不增加;短剧按连续播放进度计数,到达间隔后在进入下一集前展示广告。关闭场景、没有匹配素材、会员免广告满足时都不插入。
素材字段:广告名称(≤80)、广告描述(选填,≤100)、素材类型(全部 / 视频流 / 短剧)、视频来源与地址(规则同播放器广告)、点击链接、启用。只有启用且素材类型匹配当前场景的广告进入候选。
HTML 广告、iframe 广告、广告代码

- HTML 广告:全局单个配置(不是列表),字段只有「启用状态」和「HTML 代码」。没有标题、图片库、到期时间,全部写在 HTML 里;站内跳转可用
to="/path",外部链接用完整 URL 并加target="_blank" rel="noopener noreferrer";图片请设置自适应宽度。短期活动结束后需手动关闭或替换。 - iframe 广告(
/ads/iframe):字段为广告名称、iframe URL、高度(默认250px)、Sandbox 安全策略(完全沙箱最安全 / 允许脚本 / 允许同源 / 允许脚本+同源 / 无限制)、到期时间。默认是「允许脚本」,除非第三方广告必须,尽量不要放宽。 - 广告代码(
/ads/code):在所有正常前台页面底部执行的 HTML 与 JavaScript,页面会提示「执行风险提示」。只粘贴来源可信、已核实的代码(统计脚本、第三方广告联盟代码),否则存在脚本注入风险。

弹出式广告

用户点击视频或链接时,按规则打开新窗口广告。
| 配置项 | 说明 |
|---|---|
| 打开策略 | 原链接优先(原目标正常执行,同时打开广告窗口)/ 广告优先(先开广告窗口,原目标延后处理)/ 仅打开广告(只开广告页,不继续原点击目标) |
| 触发方式 | 全屏触发(点击页面任意位置判定)/ 路由触发(点击站内路由跳转时判定) |
| 触发概率 | 每次命中来源点击时,以设定百分比概率进入广告触发流程 |
| 每日上限 / 会话上限 | 控制频次,避免骚扰用户 |
| 页面地址 | 广告页面列表,可新增、编辑、删除 |
体验与合规
弹出式广告和「仅打开广告」会明显影响用户体验,浏览器也可能拦截弹窗。请控制触发概率和每日上限,先用较保守的配置观察。