查看或下载支持实时出价协议的文件。
原型
| 文件 | 说明 | 版本 | 上次更新时间 |
|---|---|---|---|
| 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.175 | 2024 年 7 月 15 日 |
| 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.180 | 2024 年 7 月 15 日 |
| realtime-bidding.proto | Google Authorized Buyers 实时出价协议。这是 Google 使用的消息
来请求出价。BidRequest包含来自
。 |
v.338 | 2024 年 5 月 21 日 |
引用数据
字典（点击即可下载 .txt 文件） |
|
|---|---|
| 广告产品类别 | 用于以下对象的 excluded_product_category 字段：
BidRequest.此字段用于说明产品类别，
例如，如果发布商
不希望托管与网上银行相关的广告。 |
| 广告受限类别 | 用于以下对象的 allowed_restricted_category 字段：
BidRequest 和 restricted_category 字段的
BidResponse。allowed_restricted_category
字段描述了通常受限，但明确
例如，包含
与酒精饮料相关的内容。 |
| 广告敏感类别 | 用于以下对象的 excluded_sensitive_category 字段：
BidRequest 和 category 字段的
BidResponse。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 字段中使用
效果报告 |
| 无出价原因 | 在 BidResponse.no_bid_reason 字段中给出的
Authorized Buyers 出价协议。
|
| 可预定位的广告素材属性 | 用于supportedCreativeAttribute
买方 REST API 中公开的 PretargetingConfig 资源。此字段
描述了预期在所有广告素材中出现的广告素材属性
与一项预定位配置相对应 |
| 发布商排除的广告素材属性 | 用于以下对象的 excluded_attribute 字段：
BidRequest.此字段说明了
不允许出现以下情况：例如，他们可能会指定
对是否允许使用 Cookie 或是否允许使用媒体和/或文字
允许展示广告。 |
| 发布商行业 | 用于以下对象的 detected_vertical 字段：
BidRequest.此字段用于指定行业（类似于
关键字）。Google 生成
字段。 |
| 供应商 | 用于以下对象的 allowed_vendor_type 字段：
BidRequest.此字段列出了哪些富媒体供应商（如
Campaign Monitor 和 VoiceFive，可用于投放的广告素材
所有广告资源尺寸包括已废弃的
|
| 数据提供程序 | 用于以下对象的 SegmentData.id 字段：
BidRequest.此字段包含有关提供
发布商提供的信号。 |
参考表格（点击即可下载 CSV 文件） |
|
| Android 移动应用 | 可定位的 Android 移动应用及其应用 ID、类别 ID 以及简单易懂的应用名称 |
| 地理位置表格 | 用于解码实例的 geo_criteria_id 字段的表
BidRequest.如需了解详情，请参阅地理位置定位
信息。 |
| LGPD 提供方 |
允许针对 LGPD 流量投放广告的广告个性化服务提供商列表。
及其 ID、直观易懂的名称、隐私权网址和网域列表
这可归因于该提供商LGPD 的强制执行会在
指定的出价请求（通过BidRequest.adslot.regs_lgpd）
字段和
BidRequest.regs.ext.lgpd 字段。
|
| 移动运营商 | 移动运营商列表。 |
| 移动设备 | 移动设备列表。 |
| 移动操作系统 | 移动操作系统列表。 |
| 提供程序 | 将广告个性化提供商 ID 映射到直观易懂的名称，以保护用户隐私
政策网址以及可归因于该提供商的网域列表。
目前，在
AdX 的 BidRequest.AdSlot.consented_providers_settings 字段
协议和
BidRequest.User.UserExt.consented_providers_settings（对于 OpenRTB）
协议。在这些字段中，所列提供商已征得用户同意，并已通过
为欧洲经济区内国家/地区的用户展示广告。 |
发布商设置
通过您的账号请求 publisher-settings.pb.gz 文件
代表。
广告素材审核政策主题
您可以使用此文件中的政策主题 <ph type="x-smartling-placeholder"></ph> 实时出价 API
下载 政策主题。上次更新日期：2022 年 4 月 18 日