查看或下载支持 RTB 协议的文件。
Protos
| 文件 | 说明 | 版本 | 上次更新时间 |
|---|---|---|---|
| cookie-bulk-upload.proto | 使用此消息批量上传用户定位数据。 | v.24 | 2024 年 3 月 27 日 |
| openrtb.proto | Google 支持使用 JSON 或 Protobuf 编码的 OpenRTB 协议。如果您使用 OpenRTB/Protobuf，则必须使用此 proto。它还包含对支持的字段及其与 Google 原生协议的映射关系的文档。 | 2.6 | 2025 年 8 月 11 日 |
| openrtb-adx.proto | Google 的 OpenRTB 协议包含一些扩展功能，这些功能在单独的 proto 中提供。 | v.192 | 2025 年 7 月 21 日 |
| publisher-settings.proto | 一组特定于实时出价方网络的发布商设置。 | v.14 | 2024 年 2 月 5 日 |
公开 Beta 版 Proto
| 文件 | 说明 | 版本 | 上次更新时间 |
|---|---|---|---|
| openrtb-adx.proto | Google 的 OpenRTB 协议包含一些扩展功能，这些功能在单独的 proto 中提供。 | v.200 | 2025 年 7 月 21 日 |
引用数据
字典（点击即可下载 .txt 文件） |
|
|---|---|
| 广告商品类别 | 用于 BidRequest 的 excluded_product_category 字段中。此字段用于描述发布商不允许的商品和服务类别，例如，如果发布商不想托管与网上银行相关的广告，则可在此字段中进行说明。 |
| 受限广告类别 | 用于 BidRequest 的 allowed_restricted_category 字段和 BidResponse 的 restricted_category 字段。allowed_restricted_category 字段用于描述通常受限但发布商明确声明为允许的类别，例如包含酒精饮料相关内容的广告。 |
| 广告敏感类别 | 用于 BidRequest 的 excluded_sensitive_category 字段和 BidResponse 的 category 字段。excluded_sensitive_category 字段用于描述发布商不允许的敏感类别，例如，如果发布商不想托管与政治相关的广告。 |
| 广告客户 | 用于 SnippetStatusItem 的 advertiser_id 字段中。此字段用于指定与代码段关联的广告素材所代表的广告客户。此列表反映了整个广告交易平台中的广告客户，而不反映任何一个买方所代表的广告客户。 |
| 品牌方 | 客户端访问 API 中使用的品牌列表。 |
| 买方可声明的广告素材属性 | 用于 BidResponse 中的 attribute 字段。
此字段描述了广告素材中买方可声明的属性，这些属性不得出现在 excluded_attribute 中的 BidRequest 中。 |
| 出价邀约状态代码 | performancereport 方法调用返回的状态代码。 |
| 内容标签 | 用于 BidRequest 的 detected_content_labels 字段中。 |
| Cookie 匹配器状态代码 | 用于实时出价协议效果报告的 cookieMatcherStatusRate 字段中。如需了解可用的代码，请参阅Cookie 匹配指南。 |
| 广告素材状态代码 | 用于 creative_status_code以实时反馈的形式发还。
|
| 托管匹配状态代码 | 用于实时出价协议效果报告的 hostedMatchStatusRate 字段中。 |
| 未出价原因 | 在 Authorized Buyers 出价协议的 BidResponse.no_bid_reason 字段中提供的标准“不出价”原因值。 |
| 可预先定位的广告素材属性 | 用于 Buyer REST API 中公开的 PretargetingConfig 资源的 supportedCreativeAttribute 字段。此字段描述了与单个预定位配置对应的所有广告素材中应包含的广告素材属性。 |
| 发布商可排除的广告素材属性 | 用于 BidRequest 的 excluded_attribute 字段中。此字段描述了发布商不允许使用的广告素材类型。例如，他们可能会指定有关是否允许使用 Cookie 或是否允许投放媒体广告和/或文字广告的限制。 |
| 发布商行业 | 用于 BidRequest 的 detected_vertical 字段中。此字段用于指定展示广告的网页的垂直行业（类似于关键字）。Google 会通过抓取网页并确定所使用的垂直行业来生成此字段。 |
| 供应商 | 用于 BidRequest 的 allowed_vendor_type 字段中。此字段列出了发布商允许投放的广告素材所使用的 Rich Media 供应商，例如 Campaign Monitor 和 VoiceFive。包括已弃用的 |
| 数据提供商 | 用于 BidRequest 的 SegmentData.id 字段中。此字段包含提供发布商提供的信号的实体的信息。 |
参考表格（点击即可下载 CSV 文件） |
|
| Android 移动应用 | 可定位的 Android 移动应用列表，其中包含应用 ID、类别 ID 和直观易懂的应用名称。 |
| 地理位置表 | 用于解码 BidRequest 的 geo_criteria_id 字段的表。如需了解详情，请参阅地理位置定位。 |
| LGPD 提供商 |
允许在 LGPD 流量中投放广告的广告个性化提供商的列表，其中包含提供商的 ID、人类可读的名称、隐私权网址以及可归因于该提供商的域名列表。在给定的出价请求中，系统会通过 Authorized Buyers 出价协议中的 BidRequest.adslot.regs_lgpd 字段和 OpenRTB 出价协议中的 BidRequest.regs.ext.lgpd 字段来指明 LGPD 强制执行情况。
|
| 移动运营商 | 移动运营商列表。 |
| 移动设备 | 移动设备列表。 |
| 移动操作系统 | 移动操作系统列表。 |
| 提供程序 | 将地图广告个性化提供商 ID 映射到人类可读的名称、隐私权政策网址以及可归因于提供商的网域列表。
目前，提供方用于 AdX 协议的 BidRequest.AdSlot.consented_providers_settings 字段和 OpenRTB 协议的 BidRequest.User.UserExt.consented_providers_settings 字段。在这些字段中，列出的提供商已获得发布商传递的用户意见征求结果，这些结果是针对欧洲经济区境内国家/地区的用户传递的。 |
发布商设置
向您的客户代表索取 publisher-settings.pb.gz 文件。
广告素材审核政策主题
您可以使用此文件中的政策主题，在 Real-time Bidding API 中 审核期间过滤广告素材
以 CSV 文件格式下载政策主题。上次更新时间：2022 年 4 月 18 日