Proto 参考数据

查看或下载支持实时出价协议的文件。

Protos

文件 说明 版本 上次更新时间
cookie-bulk-upload.proto 使用此消息可批量上传用户定位数据。 v.24 2024 年 3 月 27 日
openrtb.proto Google 支持使用 JSON 或 Protobuf 编码的 OpenRTB 协议。如果您使用 OpenRTB/Protobuf，则必须使用此 proto。其中还包含有关支持的字段及其与 Google 原生协议的映射的文档。 2.6 2024 年 10 月 31 日
openrtb-adx.proto Google 的 OpenRTB 协议包含一些扩展程序，这些扩展程序在单独的 proto 中提供。 v.180 2024 年 11 月 1 日
publisher-settings.proto 一组特定于实时出价方广告联盟的发布商设置。 v.13 2024 年 2 月 5 日
realtime-bidding.proto Google 的 Authorized Buyers RTB 协议。这是 Google 用于请求出价的消息。BidRequest 包含单次展示中的广告位。 v.331 2024 年 11 月 1 日

公开 Beta 版原型

文件 说明 版本 上次更新时间
openrtb-adx.proto Google 的 OpenRTB 协议包含一些扩展程序，这些扩展程序在单独的 proto 中提供。 v.186 2024 年 11 月 1 日
realtime-bidding.proto Google 的 Authorized Buyers RTB 协议。这是 Google 用于请求出价的消息。BidRequest 包含单次展示中的广告位。 v.342 2024 年 10 月 31 日

引用数据

字典（点击即可下载 .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 中。
出价邀约状态代码 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 字段中使用。此字段列出了发布商指定的允许投放广告素材的富媒体供应商（例如 Campaign Monitor 和 VoiceFive）。

包含已弃用的 gdn-vendors.txt 字典文件中的供应商。
数据提供程序 用于 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 字段指明是否强制执行《巴西通用数据保护法》。
移动运营商 移动运营商列表。
移动设备 移动设备列表。
移动操作系统 移动操作系统列表。
提供程序 将广告个性化提供商 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 日