查看或下载支持实时出价协议的文件。
Protos
| 文件 | 说明 | 版本 | 上次更新时间 |
|---|---|---|---|
| cookie-bulk-upload.proto | 使用此消息批量上传用户定位数据。 | v.24 | 2024 年 3 月 27 日 |
| openrtb.proto | Google 支持 OpenRTB 协议，并使用 JSON 或 Protobuf 编码。如果您使用 OpenRTB/Protobuf，则必须使用此 proto。它还包含对受支持字段及其与 Google 原生协议的映射的文档。 | 2.6 | 2026 年 6 月 2 日 |
| openrtb-adx.proto | Google 的 OpenRTB 协议包含一些扩展，这些扩展在单独的 proto 中提供。 | v.208 | 2026 年 6 月 9 日 |
| publisher-settings.proto | 一组特定于实时出价方网络的发布商设置。 | v.14 | 2024 年 2 月 5 日 |
公开 Beta 版 Protos
| 文件 | 说明 | 版本 | 上次更新时间 |
|---|---|---|---|
| openrtb-adx.proto | Google 的 OpenRTB 协议包含一些扩展，这些扩展在单独的 proto 中提供。 | v.217 | 2026 年 6 月 16 日 |
引用数据
字典（点击即可下载 .txt 文件） |
|
|---|---|
| 广告产品类别 | 在 excluded_product_category 字段的
BidRequest 中使用。此字段描述了发布商不允许的产品和服务类别，例如，如果发布商不希望托管与网上银行相关的广告。 |
| 广告受限类别 | 在allowed_restricted_category字段的
BidRequest和restricted_category字段的
BidResponse中使用。allowed_restricted_category
字段描述了通常受限但发布商明确声明为允许的类别，例如包含酒精饮料相关内容的广告。 |
| 广告敏感类别 | 在
BidRequest 的 excluded_sensitive_category 字段和
BidResponse 的 category 字段中使用。excluded_sensitive_category
字段描述了发布商不允许的敏感类别，
例如，如果发布商不希望托管与
政治相关的广告。 |
| 广告客户 | 在 SnippetStatusItem 的 advertiser_id 字段中使用。此
字段指定了与代码段关联的广告素材所代表的广告客户。此列表反映了整个交易平台中的广告客户，而不是任何一个买方所代表的广告客户。 |
| 品牌 | 品牌列表，在 Client Access API 中使用。 |
| 买方可声明的广告素材属性 | 用于 BidResponse 中的 attribute 字段。
此字段描述了广告素材上买方可声明的属性，这些属性不得出现在 excluded_attribute 中的BidRequest 中。 |
| 出价邀约状态代码 | `performancereport` 方法
调用返回的状态代码。 |
| 内容标签 | 在 detected_content_labels 字段的
BidRequest 中使用。 |
| Cookie 匹配器状态代码 | 在实时出价协议
效果报告的 cookieMatcherStatusRate 字段中使用。Cookie 匹配指南中介绍了可用代码。 |
| 广告素材状态代码 | 在 实时反馈中返回的creative_status_code 中使用。 |
| 托管匹配状态代码 | 在实时出价协议效果报告的 hostedMatchStatusRate 字段中使用。 |
| 未出价原因 | 在
Authorized Buyers 出价协议的 BidResponse.no_bid_reason 字段中给出的标准未出价原因值。 |
| 可预定位的广告素材属性 | 在买方 REST API 中公开的
PretargetingConfig 资源的 supportedCreativeAttribute 字段中使用。此字段
描述了与单个预定位配置对应的所有广告素材
中预计会存在的广告素材属性。 |
| 发布商可排除的广告素材属性 | 在 excluded_attribute 字段的
BidRequest 中使用。此字段描述了发布商不允许的广告素材类型。
例如，他们可能会指定
有关是否允许使用 Cookie 或是否允许使用媒体广告和/或文字
广告的限制。 |
| 供应商 | 在 allowed_vendor_type 字段的
BidRequest 中使用。此字段列出了发布商指定的允许投放的富媒体供应商（例如
Campaign Monitor 和 VoiceFive），
包括已停用的
|
| 数据提供商 | 在 SegmentData.id 字段的
BidRequest 中使用。此字段包含有关提供
发布商提供的信号的实体的信息。 |
参考表（点击即可下载 CSV 文件） |
|
| Android 移动应用 | 可定位的 Android 移动应用列表，其中包含应用 ID、类别 ID、 和人类可读的应用名称。 |
| 地理位置表 | 用于解码 BidRequest 的 geo_criteria_id 字段的表。如需了解详情，请参阅地理位置定位。 |
| LGPD 提供商 |
允许在 LGPD 流量上投放广告的广告个性化提供商列表，
其中包含提供商的 ID、人类可读的名称、隐私权网址以及可归因于该提供商的网域列表。在 Authorized Buyers 出价协议中，系统会通过 BidRequest.adslot.regs_lgpd 字段来指明给定的出价请求是否需要遵守 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 文件。
广告素材审核政策主题
您可以使用此文件中的政策主题，在 审核期间过滤广告素材，实时出价 API
以 CSV 文件格式下载政策主题。上次更新时间：2022 年 4 月 18 日