您的应用处理来自 Google 的出价请求后,必须构建并发送响应。本指南介绍了如何对应用进行编码以构建响应。
创建出价响应消息
Authorized Buyers 将 BidRequest
作为 HTTP POST
的消息正文发送出去。应用发送的响应必须将 Content-Type
标头设置为 application/octet-stream
,并且消息正文必须由序列化协议缓冲区组成。协议缓冲区是 realtime-bidding.proto
中定义的 BidResponse
消息。您的应用必须返回一个可解析的 BidResponse
来响应每个 BidRequest
。无法解析的超时和响应会被视为错误,Google 会对错误率较高的出价工具加以限制。
如果您不想对展示机会出价,可以单独设置 processing_time_ms
字段,并将其他所有字段留空。您可以从参考数据 页面获取 realtime-bidding.proto
。
广告素材 ID
您的 BidResponse
通过 buyer_creative_id
字段(上限为 64 字节)指定广告素材。即使是类似的广告素材,只要任何显著的特征(包括但不限于:尺寸、声明的网址、广告素材属性和供应商类型)不同,就必须为 buyer_creative_id
提供唯一的值。换言之,只要任意两个广告符合以下情况,您就必须为其指定不同的广告素材 ID:
外观或行为方式有所不同。
渲染到不同的图片。
采用不同的呈现方式(例如,一个广告包含图片,另一个广告包含 Flash)。
在设计应用时,您应该确定一种系统化方式来生成对您计划提交的各类广告素材有意义的标识符。
广告属性
您必须在 BidResponse.Ad.attribute
中声明可充分说明广告特征及其定位条件的广告素材属性。必须声明的属性如下(另请参阅 buyer-declarable-creative-attributes.txt 中支持的属性的完整列表):
7 Tagging: IsTagged
广告包含一个像素(又称网络信标),以便为后续再营销创建一个 Cookie ID 列表。
8 Remarketing: IsRemarketing
广告根据用户的 Cookie ID 或设备 ID 来定位他们,此处的 Cookie ID 或设备 ID 列表表示之前曾经与买方拥有或代表的网站进行过互动的一组消费者。
9 UserInterestTargeting: IsUserInterestTargeted
广告会根据消费者的 Cookie ID 或设备 ID 来定位他们,此处的 Cookie ID 或设备 ID 列表代表了被买家定义为常见兴趣群体的一组消费者。
30 InstreamVastVideoType: Vpaid
该广告需要支持 VPAID 才能呈现。
32 MraidType: MRAID
广告需要使用 MRAID API 才能呈现。
此外,以下属性受支持,但无需进行声明,因为 Authorized Buyers 会自动检测这些属性,并根据检测到的值(而不是您的声明)屏蔽(或允许)您的广告素材。请参阅 Creatives API ,了解如何获取有关检测到的广告素材属性的反馈。
公开出价字段
参与公开出价的广告交易平台和广告联盟出价方发送的出价响应类似于参与标准实时出价的 Authorized Buyers 买方发送的出价响应。参与公开出价的客户可以指定少量其他字段,一些现有字段可能有替代用途。其中包括:
OpenRTB
Authorized Buyers
具体说明
BidResponse.imp[].pmp.deals[].id
BidResponse.ad[].adslot[].exchange_deal_id
广告交易平台命名空间中的交易 ID,此 ID 与此出价相关联并报告给发布商。
注意 :此字段目前仅发送给封闭式 Beta 版参与者。
BidResponse.seatbid[].bid[].ext.exchange_deal_type
BidResponse.ad[].adslot[].exchange_deal_type
向发布商报告的交易类型,会影响交易在竞价中的处理方式。
注意 :此字段目前仅发送给封闭式 Beta 版参与者。
BidResponse.seatbid[].bid[].ext.third_party_buyer_token
BidResponse.ad[].adslot[].third_party_buyer_token
令牌用于在交易平台作为公开出价方是中间方时用于标识最终第三方买方信息。这是从第三方买方获取的,必须在出价响应中原封不动地传递给 Google。
建议
出价响应示例
以下示例表示人类可读的 Protobuf 和 JSON 请求示例。
Google
显示示例
ad {
html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
adslot {
id: 1
max_cpm_micros: 6496
billing_id: 25059430769
deal_id: 30183930
}
click_through_url: "google.com"
attribute: 47
buyer_creative_id: "test_creative_id_244584"
advertiser_name: "Google"
width: 300
height: 50
impression_tracking_url: "https://test.com/imp?id=123456"
event_notification_token: "token"
}
processing_time_ms: 6
OpenRTB JSON
显示示例
{
"id": "KO9b4i49863AW26d1Tl9q6",
"seatbid": [
{
"bid": [
{
"id": "Zc2MS8m162f920x7944",
"impid": "1",
"price": 0.133555,
"adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
"adomain": [
"google.com"
],
"w": 300,
"h": 250,
"crid": "test_creative_id_410013",
"creativeType": "DISPLAY",
"burl": "https://test.com/imp?id=123456",
"cid": "37092002186",
"adid": "test_creative_id_410013"
}
],
"seat": "8333:6953:689419"
}
],
"ext": {
"pixels": "<script type='text/javascript'>var adContent = '';\nadContent += '<scr' + 'ipt type=\"text/javascript\" src=\"https://service.idsync.analytics.yahoo.com/sp/v0/pixels?pixelIds=58292,58301,58294&referrer=&limit=12&us_privacy=null&js=1&_origin=1&gdpr=0&euconsent=\"></scr' + 'ipt>' + '\\n';\ndocument.write(adContent);</script>"
}
}
OpenRTB 协议缓冲区
显示示例
id: "kMr24Q2iIW45X66r58005i"
seatbid {
bid {
id: "ne1hrjHUhQ53A1rC721"
impid: "1"
price: 0.05813896656036377
adid: "test_creative_id_744028"
adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
adomain: "google.com"
cid: "53026323592"
crid: "test_creative_id_744028"
w: 320
h: 50
[com.google.doubleclick.bid] {
impression_tracking_url: "https://test.com/impression?id=123456"
billing_id: 53026323592
}
}
seat: "7524:3385:491205"
}
bidid: "6T5lR3ZI-U4xrqc15-Q6RK-426A53024Mf4"
cur: "USD"
重要提示 :示例中所述的 Protobuf 消息在此处表示为人类可读的文本。不过,这不是通过网络发送消息的方式。使用 Google 或 OpenRTB Protobuf 格式时,系统只接受序列化的 BidResponse 消息。
您可以使用以下 C++ 代码创建并序列化 BidResponse
消息:
BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
// respond to the POST with post_response as the content
} else {
// return an error to the POST
}
指定广告素材
出价响应会指定在出价胜出后要投放的广告素材。您的出价必须包含某种受支持的广告格式(AMP、视频广告、原生广告)。在此示例中,我们使用 html_snippet
字段指定广告素材。
或者,您也可以根据广告格式使用以下其中一个 字段指定广告素材:
SDK 呈现的广告
BidResponse.Ad.sdk_rendered_ad
AMP
BidResponse.Ad.amp_ad_url
视频
BidResponse.Ad.video_url
或
BidResponse.Ad.video_vast_xml
原生广告
在 BidResponse
的 html_snippet
字段中使用 HTML 代码段指定托管在您自己的服务器上的广告。该代码段位于插入网页的 iframe 中,以便系统在网页加载时检索并呈现广告。您必须精心制作 HTML 代码段,以使广告(横幅广告或插页式广告)在 iframe 内正确呈现,并以适合您出价的广告位的尺寸呈现。
此外,在以下情况下,出价响应中声明的广告尺寸必须与出价请求中的其中一个尺寸组合完全匹配:
广告是常规横幅广告(而非视频广告、原生广告或插页式广告)。
出价方已在出价响应中声明了尺寸。如果请求中存在多个尺寸,则必须声明尺寸。
插页式广告例外。对于插页式广告,其宽度必须至少为屏幕宽度的 50%,高度必须至少为屏幕高度的 40%。
html_snippet
字段支持可正确呈现的任何有效 HTML 代码,但请注意,在 Create BidResponse message 部分中指定 buyer_creative_id
字段的相关限制。这样做的一个用途是将额外的信息添加到在呈现广告的过程中从服务器提取的网址的参数中。这样,您就可以将与展示有关的任意数据传回您自己的服务器。
对于在出价响应中返回的 HTML 代码段,其适用的政策大多与第三方广告的政策相同。如需了解详情,请参阅 Authorized Buyers 计划指南 、第三方广告投放要求 和在广告中声明点击后到达网址 。
指定宏
用于定义广告素材的 HTML 代码段可包含一个或多个特殊结构,这些特殊结构称为“宏”。在投放广告时,系统会使用这些值替代宏。例如,您的客户端出价应用可以使用 WINNING_PRICE
宏来确定为广告支付的费用(如果在竞价中胜出)。如需解析此宏,您需要实现一个用于解密价格确认的应用。如需了解详情,请参阅解密价格确认 页面。
以 %%MACRO%%
格式将宏指定为 HTML 代码段的一部分,其中 MACRO
是下表中列出的受支持宏之一。
注意 :对于 AMP 广告出价响应 (amp_ad_url
),仅支持 WINNING_PRICE
和 WINNING_PRICE_ESC
宏。
Google 要求您在第三方投放的广告的广告素材中使用 CLICK_URL_UNESC
或 CLICK_URL_ESC
宏。Google 会使用 CLICK_URL
宏来跟踪点击情况。
如需使用宏,请将其添加到广告中,以便在用户点击它时获取网址。提取的返回值是指向您附加到 CLICK_URL
的另一个网址的重定向值。
注意 :除了这些 DoubleClick 宏之外,我们还支持 OpenRTB 宏。如需详细了解 OpenRTB 宏,请参阅 OpenRTB 规范 。
宏
说明
ADVERTISING_IDENTIFIER
让买方能够在广告展示时收到 iOS IDFA 或 Android 广告 ID。
如需了解详情,请参阅解密广告客户标识符 。
CACHEBUSTER
一个无符号的四字节随机整数字符串。
CLICK_URL_UNESC
广告的非转义点击跟踪网址。在代码段中,第三方点击网址的转义版本应直接跟在宏后面。
例如,如果第三方点击跟踪网址为 http://my.adserver.com/some/path/handleclick?click=clk
,则在调用宏之后,可以将以下代码与第三方点击跟踪网址的单次转义版本搭配使用:
<a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>
在投放广告时,上述代码将会扩展为:
<a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>
该网址会先向 Google 注册该点击,然后再重定向到第三方点击跟踪网址。
CLICK_URL_ESC
广告的转义点击跟踪网址。如果您需要先通过另一个随后会返回重定向的服务器传递值,请使用此字符串而不是 CLICK_URL_UNESC
。
例如,您可以在 HTML 代码段中使用以下代码:
<a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a>
在投放广告时,上述代码将会扩展为:
<a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a>
这会向 my.adserver.com
注册点击,然后 my.adserver.com
会负责重定向到 google_click_url
参数中传递的网址。这假设 my.adserver.com
反转义 google_click_url
参数。
您可以在 %%CLICK_URL_ESC%%
后附加一个双重转义网址。在 my.adserver.com
执行取消转义操作后,系统会留下一个附加到 google_click_url
的网址的单次转义版本。获取 google_click_url
时,它会再一次取消转义,然后重定向。
CLICK_URL_ESC_ESC
广告的两次转义网址。如果您需要先通过另一个随后会返回重定向的服务器传递值,请使用此字符串而不是 CLICK_URL_UNESC
。
例如,您可以在 HTML 代码段中使用以下代码:
<a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a>
在投放广告时,上述代码将会扩展为:
<a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
SCHEME
如果出价请求不需要 SSL,则扩展为 http:
;如果出价请求需要 SSL,则扩展为 https:
。
SITE
内容网址经过网址转义的域或匿名广告资源的匿名 ID。
SITE_URL
已弃用。已被提供相同功能的 SITE 宏所取代。
TZ_OFFSET
时区偏移量。
VERIFICATION
用于生产环境的不同值以及在验证流水线中扫描广告素材的时间。格式为 %%?VERIFICATION:true-val:false-val%%
,其中除宏以外的任何值均可用于 true-val
和 false-val
,包括空字符串。对于公开出价,我们建议广告交易平台使用此宏;一旦开始使用,需求方平台便无需做出更改。
例如,如果某个广告素材要包含 %%?VERIFICATION:-1:5000%%
,则替换文字会在投放时为 5000
,而在验证流水线中则为 -1
。这有助于区分这两组 ping。
WINNING_PRICE
经过编码的展示费用(即 CPI,而不是 CPM),以帐号币种的微单位表示。例如,5 美元的胜出 CPM 相当于 5,000,000 微单位 CPM,或 5,000 微单位 CPI。在这种情况下,WINNING_PRICE
的解码值为 5,000。
胜出价格以每次安装费用的形式指定。
WINNING_PRICE_ESC
经过网址转义的 WINNING_PRICE
。
宏中的网址转义采用以下方案:
空格字符会被替换为加号 (+
)。
字母数字字符(0-9、a-z、A-Z)以及 !()*,-./:_~ 集合中的字符保持不变。
所有其他字符都会被 %XX
替换,其中 XX
是表示字符的十六进制数字。
发布商限制
发布商使用 BidRequest
传递有关允许哪些广告的限制。您必须强制执行以下字段中的限制:
allowed_vendor_type
excluded_attribute
excluded_sensitive_category
一个字段指定允许使用的广告功能,另一个指定禁用的功能。切勿返回包含禁用功能的广告。对于允许的功能(例如供应商类型),仅当广告的供应商类型位于 BidRequest
的 allowed_vendor_type
列表中时,才返回广告。如需了解详情,请参阅 BidRequest
协议缓冲区定义中针对这些字段的注释。
如果 BidResponse
中返回了 HTML 代码段,您必须在 BidResponse
中准确设置 attribute
、category
和 click_through_url
字段。如果广告的这些字段有多个适用的值,您必须添加每个值。如需了解详情,请参阅 BidResponse
协议缓冲区定义中这些字段的注释。未设置这些字段的响应会被舍弃。
BidRequest.excluded_attribute
可能的值如下(请参阅 publisher-excludable-creative-attributes.txt ):
7 Tagging: IsTagged
如果广告中包含用于为后续再营销创建 Cookie ID 列表的像素或网络信标,就禁止投放。
8 CookieTargeting: IsCookieTargeted
如果广告是根据消费者的 Cookie ID 来定位消费者,其中 Cookie ID 列表表示之前曾与买家拥有或代表的网站进行过互动的一组消费者。
9 UserInterestTargeting: IsUserInterestTargeted
如果广告根据消费者的 Cookie ID 来定位消费者,则禁止投放广告,此处的 Cookie ID 列表表示被买家定义为常见兴趣群体的一组消费者。
21 CreativeType: Html
不允许广告使用 BidResponse.Ad
中的 html_snippet
或 snippet_template
字段。
22 CreativeType: VastVideo
不允许广告使用 BidResponse.Ad
中的 video_url
字段。
30 InstreamVastVideoType: Vpaid
不允许广告要求支持 VPAID 才能呈现。
32 MraidType: MRAID
不允许要求使用 MRAID API 才能呈现广告。
34 RichMediaCapabilityType: RichMediaCapabilityFlash
广告不得要求支持 Flash 才能呈现。
39 RichMediaCapabilityType: RichMediaCapabilityHTML5
不允许广告需要 HTML5 功能才能呈现。
48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
广告不得发出非 SSL 请求。
因此,如果 excluded_attribute
字段包含值 7,您不应返回使用像素或网络信标创建列表的广告。请注意,如果广告执行此操作,则必须在 BidResponse
的属性字段中设置值 7。同样,如果 excluded_attribute
字段包含值 48,则您应仅返回可在 SSL 页面上呈现的广告(并相应地声明属性 47 RichMediaCapabilityType: RichMediaCapabilitySSL)。
此外,BidRequest
中的 excluded_sensitive_category
字段使用引用数据 页面上提供的 ad-sensitive-categories.txt
文件中的代码。以下是对其中一些代码的进一步说明:
3 Politics
包括政治问题或争议性的社会问题;不包括整体来说不涉及任何党派观点的新闻组织的广告。
4 Dating
包括约会服务和在线约会社区。
5 Religion
包括宗教广告以及倡导或反对宗教观点的广告;不包括占星术或非宗派精神类广告。
7 Video Games (Casual & Online)
包括视频游戏、在线游戏以及可下载的游戏;不包括视频游戏机。
8 Ringtones & Downloadables
铃声等手机内容以及其他可下载的内容,例如适用于台式机的屏保和壁纸以及适用于社交网络的个人资料布局和图片。
10 Get Rich Quick
承诺快速赚钱的方案。
18 Weight Loss
包括减肥、节食及相关产品和计划;不包括健康饮食或一般性健身广告。
19 Cosmetic Procedures & Body Modification
包括整容、吸脂、激光、脱毛、植发、文身和身体修形。
23 Drugs & Supplements:
包括医用药品、维生素、补充剂及相关零售商;不包括提供普通药品信息的资源。
24 Sexual & Reproductive Health
包括性功能和生殖类广告;不包括与怀孕相关的一般性资源。
35 Social Casino Games
包括没有机会赢得任何有价物品(例如现金或奖品)的模拟赌博游戏(包括但不限于:扑克、老虎机、宾果、彩票、体育博彩、比赛博彩以及其他纸牌游戏和赌场游戏)。
36 Significant Skin Exposure
广告图片中展示的是人体任何部位(从胸骨到大腿中部)均无衣物覆盖,或者全身仅穿了内衣、泳装、内衣或其他透明衣物或非衣物,例如毛巾或床单。
37 Sensationalism
广告通常采用包含夸张语言或图片的宣传语,通过激发用户的好奇心来吸引用户点击。包括以耸人听闻的主题(例如名人被捕、死亡或离婚)为主或旨在制造震惊效果的广告。
开放式衡量
借助 Open Measurement,您可以指定第三方供应商,这些供应商可以为在移动应用环境中投放的广告提供独立的衡量和验证服务。
目前支持的广告格式包括视频广告、横幅广告和插页式广告。如需详细了解如何在包含这些格式的出价响应中使用 Open Measurement,请参阅 Open Measurement SDK 帮助中心文章。
出价响应示例
以下各部分显示了不同广告类型的出价响应示例。
应用横幅广告
Google
显示示例
ad {
html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
adslot {
id: 1
max_cpm_micros: 68101
billing_id: 86124453824
}
click_through_url: "google.com"
attribute: 47
attribute: 105
buyer_creative_id: "test_creative_id_450011"
width: 390
height: 61
impression_tracking_url: "https://test.com/imp?id=123456"
event_notification_token: "token"
}
processing_time_ms: 23
OpenRTB JSON
显示示例
{
"id": "4735YiDtCstD1Y445YHstT",
"cur": "USD",
"seatbid": [
{
"seat": "6670:8027:659779",
"bid": [
{
"ext": {
"third_party_buyer_token": "7Njk3e2s21E6Url23a30w4d4621Qh57u4w2L9uy4xq864V6lMf348aC72L767592sIPdJ84U2E2aU00jjVGF3wbjl25L019c7Z43eKVb09Sk5fRX72B33Q92f359l40M0t6jAseiJVp8"
},
"crid": "test_creative_id_109447",
"exp": 900,
"id": "M9mAq8768Nr7W048E6G",
"price": 0.025286061000000002,
"adomain": [
"google.com"
],
"w": 320,
"impid": "1",
"h": 50,
"burl": "https://test.com/imp?id=123456",
"adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
"cid": "48666909902"
}
]
}
]
}
OpenRTB 协议缓冲区
显示示例
id: "AA1796z4iC270863f4w9n0"
seatbid {
bid {
id: "9hJvWOk2f3GF6Z0qIR6"
impid: "1"
price: 0.917419
adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
adomain: "google.com"
cid: "38676986454"
crid: "test_creative_id_589316"
w: 320
h: 50
[com.google.doubleclick.bid] {
impression_tracking_url: "https://test.com/impression?id=123456"
billing_id: 38676986454
}
}
seat: "5890:4144:786042"
}
bidid: "3L6xM6aN-2c492E7J-IxrR-gA80g0xJb980"
cur: "USD"
应用插页式广告
Google
显示示例
ad {
html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
adslot {
id: 1
max_cpm_micros: 7510304
billing_id: 70362152071
}
click_through_url: "google.com"
attribute: 47
attribute: 8
buyer_creative_id: "test_creative_id_775966"
advertiser_name: "Google"
width: 344
height: 566
impression_tracking_url: "https://test.com/imp?id=123456"
event_notification_token: "token"
}
processing_time_ms: 16
OpenRTB JSON
显示示例
{
"id": "I61Sxs7d484326p4D83O5f",
"seatbid": [
{
"bid": [
{
"id": "9T39T8KnUivM9518KnH",
"impid": "1",
"price": 0.6353,
"adid": "test_creative_id_288773",
"adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
"adomain": [
"google.com"
],
"cid": "42824952399",
"crid": "test_creative_id_288773",
"w": 414,
"h": 816,
"ext": {
"skadn": {
"version": "3.0",
"network": "QyYKoxm0",
"campaign": "87661657",
"itunesitem": "434836425",
"sourceapp": "240782188",
"fidelities": [
{
"fidelity": 1,
"nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
"signature": "j3kdO5nT3kl4X9488yr6h7N8I83Ck3n0fRQ1tidNAy13q29QBC67917Dw44w99BRx70a6z5i565lc64979x9G1a83d3gjiA0",
"timestamp": "1674986741687"
},
{
"fidelity": 0,
"nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
"signature": "H6opG1lxBHNi921C65Yq6972239i01goGrQb53xtq38Dlm9M0wU4256868fwy509762N5po8Ou2x3vb0JJX7432yLTv2X021",
"timestamp": "1674986741687"
}
]
},
"impression_tracking_url": [
"https://test.com/impression?id=123456",
"https://test.com/impression?id=123456"
]
}
}
],
"seat": "6447:7558:568680"
}
],
"bidid": "4Jol9v45-xp0442M7-268b-9Ix24W30Q298"
}
OpenRTB 协议缓冲区
显示示例
id: "82WW59EKX928i315ws8Vf6"
seatbid {
bid {
id: "GzqINzH96g3ZX8g67FO"
impid: "1"
price: 0.011380645260214805
adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
adomain: "google.com"
cid: "43834715105"
crid: "test_creative_id_772436"
cat: "IAB14"
w: 360
h: 640
[com.google.doubleclick.bid] {
impression_tracking_url: "https://test.com/impression?id=123456"
event_notification_token {
payload: "token"
}
billing_id: 43834715105
}
}
seat: "1184:9545:274689"
}
cur: "USD"
应用插页式视频广告
Google
显示示例
ad {
adslot {
id: 1
max_cpm_micros: 830000
billing_id: 45806415189
buyer_reporting_id: "T7f433l"
}
click_through_url: "google.com"
attribute: 47
video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
buyer_creative_id: "test_creative_id_596030"
width: 640
height: 360
event_notification_token: "token"
}
processing_time_ms: 9
OpenRTB 协议缓冲区
显示示例
id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
bid {
id: "99862J52T2r9f8n6hzY"
impid: "1"
price: 0.2873480215418293
adid: "test_creative_id_958969"
adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
adomain: "google.com"
cid: "80831705186"
crid: "test_creative_id_958969"
w: 480
h: 854
}
seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"
应用原生
Google
显示示例
ad {
adslot {
id: 1
max_cpm_micros: 80000
billing_id: 52511964331
deal_id: 1
}
click_through_url: "google.com"
attribute: 70
buyer_creative_id: "test_creative_id_287513"
advertiser_name: "Google"
native_ad {
headline: "Luxury Mars Cruises"
body: "Visit the planet in a luxury spaceship."
call_to_action: "Book today"
advertiser: "Galactic Luxury Cruises"
image {
url: "https://native.test.com/image?id=123456"
width: 1200
height: 627
}
app_icon {
url: "https://native.test.com/icon?id=123456"
width: 100
height: 100
}
star_rating: 4.800000190734863
click_link_url: "https://www.google.com"
}
impression_tracking_url: "https://test.com/imp?id=123456"
impression_tracking_url: "https://test.com/imp?id=123456"
event_notification_token: "token"
skadn {
version: "3.0"
network: "Ft98iS7c"
campaign: 31947859
itunesitem: "305656909"
sourceapp: "531025541"
fidelities {
fidelity_type: STOREKIT_RENDERED_ADS
nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
timestamp: 1675328391911
signature: "9bGR391q8KEUGg0N8aI5Vg90fgX731q67y2xtXH09k27A5UccmE83YT9833q4g72P3t01759F15J9ZVSx0984q9A2eHnM5fn"
}
fidelities {
fidelity_type: VIEW_THROUGH_ADS
nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
timestamp: 1675328391911
signature: "Hxr3FdOR2298951684ztq85X3GgF0gI1O3K7CuhAb6tC9g06fsvU1N1Uo7h7Ts38755801rVSB63o50cfk6q80N66vHr1u59"
}
}
click_tracking_urls: "https://google.com/rtb/click?imp_id=4a4cb2c0-4012-4434-b37e-ed08095a1bc8"
advertised_app_id: "APP_ID_OMITTED"
}
processing_time_ms: 57
OpenRTB JSON
显示示例
{
"id": "w68lr2H3Q9S8mAc18QP2wp",
"seatbid": [
{
"bid": [
{
"id": "4VF8803Y5b4314j072f",
"impid": "1",
"price": 0.01575,
"adm": "{\"ver\": \"1.2\", \"assets\": [{\"id\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\"}}, {\"id\": 4, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"w\": 100, \"h\": 100}}, {\"id\": 5, \"img\": {\"url\": \"https://native.test.com/icon?id=123456\", \"w\": 200, \"h\": 200}}, {\"id\": 7, \"data\": {\"value\": \"\\uc804\\uc124\\uc758 \\ub9cc\\ub819 \\uc2ac\\ub77c\\uc784\\uc774 \\ub418\\uc5b4\\ubcf4\\uae30\"}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
"adid": "test_creative_id_546056",
"adomain": [
"google.com"
],
"cid": "19851733647",
"crid": "test_creative_id_546056",
"cat": [
"IAB9-25"
],
"w": 1200,
"h": 627,
"ext": {
"event_notification_token": {
"payload": "token"
}
}
}
],
"seat": "7859:5415:609992"
}
],
"bidid": "58nBZSP4-e3LCgFS8-C2Pz-01O0337Vr56A",
"cur": "USD"
}
OpenRTB 协议缓冲区
显示示例
id: "a504l3y62599Xv09173V2Z"
seatbid {
bid {
id: "jP1Ok7b46T9p789v6R2"
impid: "1"
price: 0.1680304792439826
adid: "test_creative_id_620230"
adomain: "google.com"
cid: "74994669337"
crid: "test_creative_id_620230"
w: 1200
h: 627
adm_native {
assets {
id: 1
required: true
title {
text: "Luxury Mars Cruises"
}
}
assets {
id: 2
required: true
data {
value: "Visit the planet in a luxury spaceship."
}
}
assets {
id: 3
data {
value: "Book today"
}
}
assets {
id: 4
required: true
img {
url: "https://native.test.com/image?id=123456"
w: 1200
h: 627
}
}
assets {
id: 5
required: true
img {
url: "https://native.test.com/icon?id=123456"
w: 128
h: 128
}
}
assets {
id: 6
data {
value: "5"
}
}
link {
url: "https://www.google.com"
clicktrackers: "https://native.test.com/click?id=123456"
}
imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
}
[com.google.doubleclick.bid] {
impression_tracking_url: "https://test.com/impression?id=123456"
billing_id: 74994669337
skadn {
version: "3.0"
network: "46L6RQ79"
campaign: "17432314"
itunesitem: "782565581"
nonce: "ecfc7b9a-f328-4719-bba5-fa14c0233615"
sourceapp: "187789793"
timestamp: ""
signature: "169L03hq0qtDeIoj19lL880oO96P24du405y60U08H71302C5d5r315jus940016d208o6kFt2G14x4YK530KI683wI41bR4"
fidelities {
fidelity: VIEW_THROUGH_ADS
nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
timestamp: "1675346267364"
signature: "12g8675BqX3x8jJ60Zt9LwlNQwfe20s6M6n4zwtJ4H5170DU991wfwi9hn108rX53bU872L60u2io288755x0RS9bsvAg68b"
}
fidelities {
fidelity: STOREKIT_RENDERED_ADS
nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
timestamp: "1675346267364"
signature: "qAF324j0597P58JrYins8Lz01v7p41zfJ8JK6l2hoZ36z6RS1GE7FT0r8bAn6B93s77tv04k59fr4J173W992Wa3Ev40489R"
}
}
}
}
seat: "6989:4819:604522"
}
bidid: "15ds1647-89y8715T-V0AX-6DL468ks81Q5"
cur: "USD"
网络视频
Google
显示示例
ad {
adslot {
id: 1
max_cpm_micros: 16000000
billing_id: 34223090460
deal_id: 17775265
}
click_through_url: "google.com"
attribute: 47
attribute: 8
video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
buyer_creative_id: "test_creative_id_551392"
advertiser_name: "Google"
event_notification_token: "token"
}
processing_time_ms: 7
广告交易平台出价工具的移动网站横幅
OpenRTB 协议缓冲区
显示示例
id: "q39213i4x083QS49D4334b"
seatbid {
bid {
id: "T55L5u7y56cBy4x484B"
impid: "1"
price: 0.35
adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
adomain: "google.com"
cid: "11573735693"
crid: "test_creative_id_591839"
w: 300
h: 600
[com.google.doubleclick.bid] {
impression_tracking_url: "https://test.com/impression?id=123456"
event_notification_token {
payload: "token"
}
billing_id: 11573735693
third_party_buyer_token: "w7KR11S30AAE1345q5aG7tz46OkB8u911zbR7HVMwk0E6zUx7Y0uo4cxz32kwa3bZ320H00QT5yYifRxY8z96r74bLedPf6Fb25Z4y0U7T3i3j9k587N2iFlZ5Kl20Z5vou8M5zFWAwa"
}
}
seat: "8020:4047:162759"
}
bidid: "DQd2WoG7-96j6H89H-4uCI-1303QT599c50"
[com.google.doubleclick.bid_response] {
processing_time_ms: 170
}