Proto 参考数据

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

原生

文件 说明 版本 上次更新时间
cookie-bulk-upload.proto 使用此消息可以批量上传用户定位数据。 v.23 2024 年 1 月 12 日
openrtb.proto Google 支持采用 JSON 或 Protobuf 编码的 OpenRTB 协议。如果您使用 OpenRTB/Protobuf,则必须使用此 proto。以及有关支持的字段及其到 Google 原生协议的映射的文档。 2.6 2024 年 3 月 23 日
openrtb-adx.proto Google 的 OpenRTB 协议包含一些扩展,这些扩展以单独的 proto 提供。 v.169 2024 年 3 月 23 日
publisher-settings.proto 针对实时出价工具网络的一组发布商设置。 v.13 2024 年 2 月 5 日
realtime-bidding.proto Google 的 Authorized Buyers 实时出价协议。这是 Google 用于请求出价的消息。BidRequest 包含单次展示中的广告位。 v.322 2024 年 3 月 13 日

公开 Beta 版 Protos

文件 说明 版本 上次更新时间
openrtb-adx.proto Google 的 OpenRTB 协议包含一些扩展,这些扩展以单独的 proto 提供。 v.172 2024 年 3 月 23 日
realtime-bidding.proto Google 的 Authorized Buyers 实时出价协议。这是 Google 用于请求出价的消息。BidRequest 包含单次展示中的广告位。 v.329 2024 年 3 月 14 日

引用数据

字典(点击即可下载 .txt 文件)

广告产品类别 用在 BidRequestexcluded_product_category 字段中。此字段用于说明发布商不允许的产品和服务类别,例如,如果发布商不想托管与网上银行相关的广告。
广告受限类别 用于 BidRequestallowed_restricted_category 字段和 BidResponserestricted_category 字段。allowed_restricted_category 字段用于描述通常受限,但发布商明确声明为允许的类别,例如,包含酒精饮料相关内容的广告。
广告敏感类别 用于 BidRequestexcluded_sensitive_category 字段和 BidResponsecategory 字段。excluded_sensitive_category 字段用于描述发布商不允许使用的敏感类别,例如,如果发布商不想托管与政治有关的广告。
广告客户 在 SnippetStatusItem 的 advertiser_id 字段中使用。此字段用于指定由与代码段关联的广告素材所代表的广告客户。此列表反映的是整个广告交易平台上的广告客户,并不包括任何单个买方代表的广告客户。
品牌 在 Client Access API 中使用的品牌列表。
买方可声明的广告素材属性 用于 BidResponse 中的 attribute 字段。此字段用于描述广告素材的买方声明属性,这些属性不得出现在 BidRequestexcluded_attribute 中。
宣传信息状态代码 performancereport 方法调用返回的状态代码。
内容标签 用于 BidRequestdetected_content_labels 字段。
Cookie 匹配器状态代码 用于 RTB 协议效果报告的 cookieMatcherStatusRate 字段。Cookie 匹配指南中介绍了可用的代码。
广告素材状态代码

用于

实时反馈中返回了 creative_status_code
托管的匹配状态代码 用于 RTB 协议效果报告的 hostedMatchStatusRate 字段。
无出价原因 要在 Authorized Buyers 出价协议的 BidResponse.no_bid_reason 字段中提供的标准无出价原因值。
可预定位的广告素材属性 用于 Buyer REST API 提供的 PretargetingConfig 资源的 supportedCreativeAttribute 字段。此字段用于说明与单一预定位配置对应的所有广告素材应该包含的广告素材属性。
发布商可排除的广告素材属性 用在 BidRequestexcluded_attribute 字段中。此字段用于说明发布商不允许使用的广告素材类型。例如,它们可能会指定是否允许使用 Cookie,或者是否允许投放媒体和/或文字广告。
发布商行业 用在 BidRequestdetected_vertical 字段中。此字段用于指定要在其上展示广告的网页的行业类别(与关键字类似)。Google 通过抓取网页并确定其中用到了哪些行业来生成此字段。
卖方广告联盟 ID 用在 BidRequestseller_network_id 字段中。此字段用于指定发布商所属的卖方广告联盟。此文件的内容根据卖方广告联盟 ID 的值按升序排列。
供应商 用在 BidRequestallowed_vendor_type 字段中。此字段会列出发布商指定的广告素材允许哪些 Rich Media 供应商(如 Campaign Monitor 和 VoiceFive)。

包含已弃用的 gdn-vendors.txt 字典文件中的供应商。

参考表(点击即可下载 CSV 文件)

Android 移动应用 可定位的 Android 移动应用及其应用 ID、类别 ID 和人类可读的应用名称的列表。
地理位置表格 用于解码 BidRequestgeo_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 日