Proto 参考数据

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

原型

文件 说明 版本 上次更新时间
cookie-Bulk-upload.proto 使用此消息批量上传用户定位数据。 v.24 2024 年 3 月 27 日
openrtb.proto Google 支持使用 JSON 或 Protobuf 编码的 OpenRTB 协议。如果您使用 OpenRTB/Protobuf，则需要使用此 proto。此外，它还包含有关支持的字段及其到 Google 原生协议的映射的文档。 2.6 2024 年 5 月 22 日
openrtb-adx.proto Google 的 OpenRTB 协议包含一些扩展，通过单独的 proto 提供。 v.174 2024 年 5 月 21 日
publisher-settings.proto 针对实时出价工具广告联盟的一组发布商设置。 v.13 2024 年 2 月 5 日
realtime-bidding.proto Google Authorized Buyers 实时出价协议。这是 Google 用于请求出价的消息。BidRequest 包含来自一次展示的广告位。 v.328 2024 年 5 月 21 日

公开 Beta 版 Proto

文件 说明 版本 上次更新时间
openrtb-adx.proto Google 的 OpenRTB 协议包含一些扩展，通过单独的 proto 提供。 v.179 2024 年 5 月 24 日
realtime-bidding.proto Google Authorized Buyers 实时出价协议。这是 Google 用于请求出价的消息。BidRequest 包含来自一次展示的广告位。 v.338 2024 年 5 月 24 日

引用数据

字典（点击即可下载 .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 字段中使用。此字段会列出发布商可以指定哪些 Rich Media 供应商，如 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 字段来指明是否强制执行 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 日