Prebid.js 广告单元配置生成器
构建一个含 banner、video 和 native 媒体类型以及 bidder params 的 Prebid.js 广告单元配置,然后复制一段现成的 pbjs.addAdUnits() 代码片段——全部在你的浏览器中完成。
Prebid 广告单元生成器完全在你的浏览器中运行。你的广告单元 code、bidder 名称和 placement params 仅用于在本地构建配置,绝不会上传到 ArrayKit。
打开 OpenRTB 竞价请求生成器
关于 Prebid 广告单元生成器
Prebid 广告单元生成器把一个简单表单变成一个有效的 Prebid.js 广告单元配置和一段可复制粘贴的 pbjs.addAdUnits() 代码片段。设置广告单元 code、切换 banner、video 或 native 媒体类型、添加如 300x250 和 728x90 的 banner 尺寸、选择 instream 或 outstream 的 video context 及 player size,并挂接一个或多个 bidder 及其 params——appnexus placementId、rubicon accountId/siteId/zoneId 等等。它为正在接线新广告位、又想要一个干净起点对象而无需手改 JSON 的 ad-ops 工程师和 header-bidding 开发者打造。一切都在你的设备上生成:任何广告标签、bidder id 或 placement params 都绝不会上传,因此你可以在不泄露设置的情况下原型化真实的生产单元。
功能特性
- 构建一个含 mediaTypes.banner、video 和 native 的 Prebid.js 广告单元
- 把如 300x250、728x90 的 banner 尺寸解析为 Prebid 期望的 [[w,h]] 形态
- 带 player size 和默认 mimes 的 instream / outstream video context
- 添加无限个 bidder,每个含任意数量的 key/value params
- 自动把数字 params(placementId、siteId)强制为数字,把带前导零的 id 保留为字符串
- 复制完整的 pbjs.addAdUnits() 片段或原始 adUnit 对象
- 内联警告标出空 code、缺失尺寸或无 params 的 bidder
- 完全在你的浏览器中运行——没有 bidder params 离开你的设备
如何使用 Prebid 广告单元生成器
- 输入广告单元 code(你的 GPT div id 或 slot 名称)
- 切换 banner、video 或 native,并填入尺寸或 context
- 添加每个 bidder 及其 params(例如 appnexus placementId)
- 把 pbjs.addAdUnits() 片段或原始 adUnit 对象复制到你的 wrapper 中
示例
输入
code: div-gpt-ad-1
banner: 300x250, 728x90
bidder: appnexus placementId: 13144370
输出
pbjs.addAdUnits([{ code: 'div-gpt-ad-1', mediaTypes: { banner: { sizes: [[300,250],[728,90]] } }, bids: [{ bidder: 'appnexus', params: { placementId: 13144370 } }] }]);
一个带单个 AppNexus 竞价的 banner 广告单元,可用于你的 Prebid.js wrapper。
常见错误与故障排除
- Prebid 忽略该广告单元,或为它记录「No bids」。 — 请检查广告单元 code 是否与你传给 pbjs 的 GPT slot / div id 完全匹配,且每个 bidder 名称是真实的 Prebid 适配器代码(例如 appnexus,而非 AppNexus)。
- banner 尺寸以错误的尺寸渲染。 — 尺寸必须是如 300x250、728x90 的 WxH 对。生成器会把它们解析为 [[300,250],[728,90]]——请去掉任何多余文本,使每个尺寸都是有效的对。
- 如 placementId 的数字 param 以字符串发送,竞价失败。 — 生成器会自动把纯整数强制为数字。若你的 id 带前导零,它会有意保留为字符串——请确认适配器在那里确实期望字符串。
- video 广告单元不发起请求。 — video 需要一个 context(instream 或 outstream)和一个 player size(如 640x480)。instream 单元通常还需要本工具之外的广告服务器 video 配置。
常见问题
- Prebid 广告单元生成器输出什么?
- 它输出两样东西:一段包在 pbjs.que.push 中、可复制粘贴的 pbjs.addAdUnits() 片段,以及原始 adUnit 对象。两者都包含你的广告单元 code、已启用的 mediaTypes(banner/video/native),以及一个含每个 bidder 及其 params 的 bids 数组。
- 我如何向一个广告单元添加多个 bidder?
- 为每个需求方点击「Add bidder」,输入适配器代码(appnexus、rubicon 等),然后以 key/value 行添加其 params。每个 bidder 都成为该广告单元 bids 数组中的一个条目。
- 它能处理 video 和 native 媒体类型吗?
- 可以。切换 Video 以设置 instream 或 outstream context 加一个 player size,切换 Native 以添加一个含 title、image 和 sponsoredBy 资产的入门 native 模板,你可以在输出中细化它。
- 为什么我的 placementId 显示为数字而非字符串?
- 大多数 Prebid 适配器期望数字 id,因此纯整数会被强制为数字。带前导零或非数字字符的值会保留为字符串,好让 '007' 或广告服务器路径之类的 id 不被破坏。
- 我的 bidder id 和 placement params 会被上传到任何地方吗?
- 不会。生成器完全在你的浏览器中运行。你输入的广告单元 code、bidder 名称和 params 绝不会发送到服务器,因此你可以私密地构建真实的生产单元。
相关工具
- OpenRTB 竞价请求生成器 — 从表单构建符合规范的 OpenRTB 2.5 与 2.6 竞价请求并复制 JSON。
- schain 生成器 — 为 OpenRTB 构建并校验 IAB SupplyChain 对象,导出 JSON 与序列化字符串。
- IAB 广告尺寸参考 — 查询 IAB 与常见程序化广告单元尺寸,含名称、尺寸与宽高比,可搜索。
- OpenRTB 枚举参考 — 查询每个 OpenRTB 2.x 枚举列表,含整数码、含义与属性路径,可搜索。
- CPM 计算器 — 用 CPM = 成本 / 展示量 x 1000 从任意两个值求解 CPM、成本或展示量。
- sellers.json 校验器 — 对照 IAB 规范校验 sellers.json 的 version、唯一 seller_id 与 seller_type。
全部 ArrayKit 工具