配置公开出价集成

通过公开出价,广告交易平台和其他买方可以利用 Google 的实时出价基础架构对 Google Ad Manager 和 AdMob 广告资源出价。

若要参与公开出价,请配置针对您的公开出价用例自定义的实时出价集成,并将出价工具端点发送给您的 Google 客户经理进行测试,以验证集成是否能够正常运行。这个过程只需执行一次。

仅限部分发布商集成

在您准备好接受来自任何发布商的请求之前,您的公开出价集成可保持“不公开模式”。在不公开模式下,您可以与您的客户支持团队合作,与选定的发布商联系并保持此状态,直到您准备好进行扩展。退出无痕模式后,您的账号将对所有发布商可见。

支持的协议和编码

我们建议使用 Google 的 OpenRTB 实现。Google RTB 协议已被弃用。 了解详情

Google OpenRTB 实施

Google 的 OpenRTB 实现不支持 OpenRTB 规范中的所有功能,并且添加了 Authorized Buyers 扩展程序和公开出价专用功能。要详细了解 Google 的 OpenRTB 实现及其与专有的 Authorized Buyers 实时出价协议的关系,请参阅 OpenRTB 指南

处理传入的出价请求

公开出价使用与 Authorized Buyers 相同的 BidRequest 结构,但某些字段专门发送给公开出价参与者。如需详细了解出价请求中发送的公开出价专用字段,请参阅请求指南

回复出价

公开出价还使用与 Authorized Buyers 类似的 BidResponse 结构,但包含一些发送给公开出价参与者的专有字段。如需详细了解您可以用来响应的公开出价专用字段,请参阅响应指南

响应结构可能会因您出价所用的首选广告格式而异。请查看以下指南,了解如何配置出价工具应用,以便针对常见广告格式提供出价响应:

跟踪展示次数以减少差异

强烈建议您使用可选的 impression_tracking_url 字段来检索展示机会层级的数据,了解 Google 何时记录了将向您收取费用的可计费事件。对于 OpenRTB,这在 Google 协议中以 BidResponse.seatbid[].bid[].ext.impression_tracking_url 的形式公开,而在 Google 协议中则以 BidResponse.ad[].impression_tracking_url 的形式公开。

Google 需求差异解决方案(Beta 版)

此功能旨在确保广告交易平台结算的展示次数与通过 Google Display & Video 360 (DV360) 支付的展示次数保持一致。

通过准确识别通过公开出价功能投放的 DV360 展示,Google 可以针对垃圾广告和可结算事件的差异进行调整,以确保您无需为未付费的展示付费。

在出价请求中传播 google_query_id

为了确保 Google 需求来源中的有效展示次数一致,必须按原样google_query_id 从公开出价请求传播到 Google 需求平台。这是解决公开出价差异问题的先决条件。google_query_id 的当前预期长度约为 64 个字节。

在出价响应中传播 third_party_buyer_token

如果 Google 需求平台在广告交易平台的内部竞价中胜出,则必须在出价响应中按原样通过公开出价展示传回 third_party_buyer_token 字段。这样一来,Google 发布商平台便可以确定,来自公开出价合作伙伴的胜出出价是代表 Google 需求对同一展示机会的出价。此字段的当前最大长度预计为 150 个字节。

按原样在出价响应中传递 Google 广告素材标记

为了确保差异解决方案适用于来自 Google 需求来源的出价,广告交易平台必须在不使用任何封装容器(脚本代码、iframe 或 VAST 封装容器)的情况下传播 Google 广告素材标记。由于差异解决方案,Google 可能会使 Google 需求平台未计入的公开出价展示机会失效,并且不会开具账单。Google 会定期检查广告素材标记,以确认带有 third_party_buyer_token 的出价是代表 Google 需求来源提交的,而非任何其他买方。

HTML5 广告素材

广告交易平台必须按原样提交 Google HTML 标记,其中包含通常适用的广告交易平台专属宏扩展,以及(可选)广告交易平台通常添加的额外跟踪器像素或脚本。

如果广告交易平台将 Google HTML 广告素材封装到随后加载或呈现 Google HTML 代码的代码(scriptiframe 或其他技术),Google 便无法应用差异解决方案。

VAST 视频广告素材

为了符合差异解决方案的条件,广告交易平台必须使用以下方法之一在 VAST XML 响应中填充 VASTTagURI

  1. 广告交易平台可以按原样VASTTagURI 元素的值作为 Google 在 adm 字段中返回的 VAST XML 文档的一部分保留,并采用通常适用的广告交易平台专用宏扩展。
  2. DV360 可以在针对广告交易平台的出价响应中使用 VAST 文档网址填充 nurl 字段。然后,广告交易平台可以在 VASTTagURI 代码中传递 Google (DV360) 响应的 nurl 的值,并根据需要正常扩展广告交易平台专用宏。

如有必要,广告交易平台可以在 VAST XML 文档中指定其他 VAST 事件和错误跟踪器。

特惠

参与公开出价的广告交易平台可以将首选交易 (PD)、私下竞价 (PA) 与公开出价功能结合使用。必须按如下方式指定交易 ID 和类型:

字段 说明
OpenRTB 协议
BidResponse.seatbid[].bid[].dealid

Google 协议
BidResponse.ad[].adslot[].exchange_deal_id
与出价相关联并向发布商报告的广告交易平台命名空间中的交易 ID。 这是任意的 UTF8 文本,不得超过 64 个字节。
OpenRTB 协议
BidResponse.seatbid[].bid[].ext.exchange_deal_type

Google 协议
BidResponse.ad[].adslot[].exchange_deal_type
用于指定交易类型的枚举。系统会向发布商报告此信息,此信息会影响交易在竞价中的处理方式。可能的值包括:
OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;

以下是针对首选交易/私下竞价的 OpenRTB 出价响应示例。

id: "ECHO_BIDREQUEST_ID"
seatbid {
  bid {
    id: "BID_ID"
    impid: "1"
    price: 1.23
    adm: "AD_TAG"
    adomain: "DECLARED_LANDING_PAGE_URL"
    cid: "BILLING_ID"
    crid: "CREATIVE_ID"
    dealid: "DEAL_ID"
    w: 300
    h: 250
    [com.google.doubleclick.bid] {
      impression_tracking_url: "IMPRESSION_TRACKING_URL"
      exchange_deal_type: "DEAL_TYPE"
    }
  }
}

为了填充 Google 托管的匹配表,公开出价参与者可以使用以下任一最符合其需求的选项:

  • Cookie 匹配:买方或广告交易平台发起的匹配 了解详情
  • 像素匹配:Google 发起的匹配 了解详情
  • Cookie Match Assist:广告交易平台与其出价方启动的匹配 了解详情

管理延迟时间

您应根据对等互连指南中的交易地点来估算您的出价工具端点在响应传入的出价请求时的延迟时间。

收到大量出价请求的大型广告交易平台应考虑与 Google 建立对等互连协议,以减少延迟时间和延迟时间的波动。详细了解对等互连

Click 宏

我们建议您实现 Click 宏。这样,您就可以针对您的帐号以及与您合作的发布商生成包含点击次数和点击派生指标的报告。了解详情

API

公开出价客户可以使用 Authorized Buyers REST API 访问可能有助于排查问题的数据。目前只能访问以下 API 资源:

您可以与技术支持客户经理联系,配置您的账号以访问这些 API,并检索进行 API 调用所需的账号 ID。如需有关使用这些 API 的技术支持,您可以联系 adxbuyerapi-support@google.com 支持团队。

其他资源

出价请求和响应示例

您可以在请求响应指南中找到所有受支持协议的出价请求和响应示例。