Proto 参考数据

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

Protos

文件 说明 版本 上次更新时间
cookie-bulk-upload.proto 使用此消息可批量上传用户定位数据。 v.24 2024 年 3 月 27 日
openrtb.proto Google 支持使用 JSON 或 Protobuf 编码的 OpenRTB 协议。如果您使用 OpenRTB/Protobuf,则必须使用此 proto。其中还包含有关支持的字段及其与 Google 原生协议的映射的文档。 2.6 2024 年 11 月 18 日
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 文件)

广告产品类别 用于 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 字段。 此字段用于描述广告素材的买方可声明属性,这些属性不得出现在 BidRequest 中的 excluded_attribute 中。
出价邀约状态代码 performancereport 方法调用返回的状态代码。
内容标签 用于 BidRequestdetected_content_labels 字段。
Cookie 匹配器状态代码 用于实时出价协议效果报告的 cookieMatcherStatusRate 字段。Cookie 匹配指南介绍了可用的代码。
广告素材状态代码

用于

实时反馈中返回的 creative_status_code
托管匹配状态代码 用于实时出价协议效果报告的 hostedMatchStatusRate 字段。
未出价原因 要在 Authorized Buyers 出价协议的 BidResponse.no_bid_reason 字段中提供的标准不出价原因值。
可预定位的广告素材属性 用于 Buyer REST API 中公开的 PretargetingConfig 资源的 supportedCreativeAttribute 字段。此字段用于描述与单个预定位配置对应的所有广告素材中应包含的广告素材属性。
发布商可排除的广告素材属性 用于 BidRequestexcluded_attribute 字段。此字段用于说明发布商不允许的广告素材类型。例如,它们可能会指定是否允许使用 Cookie,或是否允许投放媒体广告和/或文字广告。
发布商行业 用于 BidRequestdetected_vertical 字段。此字段用于指定将展示广告的网页的行业(类似于关键字)。Google 会通过抓取网页并确定使用的行业来生成此字段。
供应商 用于 BidRequestallowed_vendor_type 字段。此字段列出了发布商指定的允许投放广告素材的富媒体供应商(例如 Campaign Monitor 和 VoiceFive)。

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

数据提供方 用于 BidRequestSegmentData.id 字段。此字段包含提供发布商提供的信号的实体的信息。

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

Android 移动应用 可定位到的 Android 移动应用的列表,其中包含应用 ID、类别 ID 和直观易懂的应用名称。
地理表 用于解码 BidRequestgeo_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 日