查看或下载支持实时出价协议的文件。
Protos
| 文件 | 说明 | 版本 | 上次更新时间 |
|---|---|---|---|
| cookie-bulk-upload.proto | 使用此消息可批量上传用户定位数据。 | v.25 | 2024 年 3 月 27 日 |
| openrtb.proto | Google 支持 OpenRTB 协议，该协议使用 JSON 或 Protobuf 编码。如果您使用 OpenRTB/Protobuf，则必须使用此 proto。还包括有关受支持字段及其与 Google 原生协议的映射的文档。 | 2.6 | 2026 年 10 月 15 日 |
| openrtb-adx.proto | Google 的 OpenRTB 协议包含一些扩展，这些扩展在单独的 proto 中提供。 | v.210 | 2026 年 8 月 4 日 |
| publisher-settings.proto | 一组特定于实时出价广告联盟的发布商设置。 | v.14 | 2024 年 2 月 5 日 |
公开 Beta 版原型
| 文件 | 说明 | 版本 | 上次更新时间 |
|---|---|---|---|
| openrtb-adx.proto | Google 的 OpenRTB 协议包含一些扩展字段，这些扩展字段在单独的 proto 中提供。 | v.220 | 2026 年 9 月 16 日 |
引用数据
字典（点击即可下载 .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 字段中使用。此字段指定与代码段关联的广告素材所代表的广告客户。此列表反映了整个广告交易平台中的广告客户，而非任何一个买方所代表的广告客户。 |
| 品牌 | 品牌列表，在 Client Access API 中使用。 |
| 买方可声明的广告素材属性 | 用于 BidResponse 中的 attribute 字段。
此字段描述了广告素材上买方可声明的属性，这些属性不得出现在 BidRequest 的 excluded_attribute 中。 |
| 内容标签 | 在 BidRequest 的 detected_content_labels 字段中使用。 |
| Cookie 匹配器状态代码 | 在实时出价协议效果报告的 cookieMatcherStatusRate 字段中使用。Cookie 匹配指南中介绍了可用的代码。 |
| 广告素材状态代码 | 用于 实时反馈中返回的creative_status_code。
|
| 托管匹配状态代码 | 在 RTB 协议效果报告的 hostedMatchStatusRate 字段中使用。 |
| 未出价原因 | Authorized Buyers 出价协议中的 BidResponse.no_bid_reason 字段中提供的标准不予出价原因值。 |
| 可预定位的广告素材属性 | 在 Buyer REST API 中公开的 PretargetingConfig 资源的 supportedCreativeAttribute 字段中使用。此字段描述了与单个预定位配置对应的所有广告素材中应存在的广告素材属性。 |
| 发布商可排除的广告素材属性 | 在 BidRequest 的 excluded_attribute 字段中使用。此字段描述了发布商不允许的广告素材类型。例如，他们可能会指定是否允许使用 Cookie，或者是否允许投放媒体广告和/或文字广告。 |
| 供应商 | 在 BidRequest 的 allowed_vendor_type 字段中使用。此字段列出了发布商指定的允许为所投放广告素材使用的富媒体供应商，例如 Campaign Monitor 和 VoiceFive。包含来自已停用的 |
| 数据提供商 | 在 BidRequest 的 SegmentData.id 字段中使用。此字段包含有关提供发布商提供的信号的实体的信息。 |
参考表（点击即可下载 CSV 文件） |
|
| Android 移动应用 | 可定位的 Android 移动应用列表，其中包含应用 ID、类别 ID 和人类可读的应用名称。 |
| 地理位置表 | 用于解码 BidRequest 的 geo_criteria_id 字段的表。如需了解详情，请参阅地理位置定位。 |
| LGPD 提供商 |
允许在 LGPD 流量中投放广告的广告个性化服务提供商列表，其中包含其 ID、人类可读的名称、隐私权网址以及可归因于该提供商的网域列表。LGPD 强制执行情况会在给定出价请求中通过 Authorized Buyers 出价协议中的 BidRequest.adslot.regs_lgpd 字段和 OpenRTB 出价协议中的 BidRequest.regs.ext.lgpd 字段进行指示。
|
| 移动运营商 | 移动运营商列表。 |
| 移动设备 | 移动设备列表。 |
| 移动操作系统 | 移动操作系统列表。 |
| 提供程序 | 将广告个性化服务提供商 ID 映射到人类可读名称、隐私权政策网址以及可归因于该提供商的网域列表。
目前，提供商在 AdX 协议的 BidRequest.AdSlot.consented_providers_settings 字段和 OpenRTB 协议的 BidRequest.User.UserExt.consented_providers_settings 字段中使用。在这些字段中，列出的提供商已获得发布商针对欧洲经济区 (EEA) 境内国家/地区的用户传递的用户同意。 |
发布商设置
向您的客户代表索取 publisher-settings.pb.gz 文件。
广告素材审核政策主题
您可以使用此文件中的政策主题，在 实时出价 API 中 审核广告素材时进行过滤
以 CSV 文件格式下载政策主题。上次更新日期：2022 年 4 月 18 日