原生广告的格式会与周围内容和视觉设计浑然一体,因此这类广告更有望被用户看到和点击。原生广告资源适用于移动应用以及桌面版和移动版网站。如需详细了解原生广告,请参阅原生广告简介。
Authorized Buyers 和公开出价均支持原生广告。
以下是原生广告的工作流程:
- 向 Google 发出原生广告调用请求,该调用指定以下一种或两种原生广告模板,每种模板都指定了首选的原生字段。
- Google 向买方发送 RTB 出价请求,其中包含所请求的字段列表。
- 感兴趣的买方回应所请求的字段。
- Google 开展竞价以选择获胜出价,然后将相应买方提供的广告素材资源发送给发布商。
- 发布商将这些素材资源整合到一个原生广告中,并调整它们的样式以契合该网站的设计风格。
消息格式
Google 同时支持 JSON 和 Protobuf 中的 OpenRTB 规范。
对于 OpenRTB Protobuf 原生广告,以下字段与规范不同:
JSON | JSON 类型 | Protobuf | Protobuf 类型 |
---|---|---|---|
BidRequest.imp[].native.request |
string |
BidRequest.imp[].native.request_native |
NativeRequest |
BidResponse.seatbid[].bid[].adm |
string |
BidResponse.seatbid[].bid[].adm_native |
NativeResponse |
OpenRTB Protobuf 字段是 Protobuf 消息,而不是字符串。
如果您使用 OpenRTB Protobuf 实现,您的端点会收到包含 BidRequest.imp.native.request_native
而非 BidRequest.imp.native.request
的出价请求。此外,您的端点必须返回填充 BidResponse.seatbid.bid.adm_native
而非 BidResponse.seatbid.bid.adm
的出价响应,否则将从竞价中滤除。
如果您使用买方 SDK 呈现原生广告,则在提交广告素材资源以供审核时,必须在 declared_ad
中添加图片 type
。
原生广告模板
原生广告模板用于描述原生广告的组成部分,并确定出价请求中 OpenRTB 的 NativeRequest
或已废弃的 Google RTB 协议的 NativeAdTemplate
的内容和结构。Google 支持两种最常见的非视频原生广告和视频原生广告模板:
- 应用安装广告模板 - 宣传应用并提高移动应用安装量。
- 内容广告模板 - 适用于品牌广告或网站广告的更通用的文字和图片组合。
- 视频应用安装广告模板
- 视频内容广告模板
除此之外还有其他模板,且可能对字段、维度和尺寸有不同要求。
应用安装广告模板

必填字段和建议填写的字段
下表显示了标记为必填或建议的字段。以下规则适用:
- 标记为必填的字段是出价方必填的字段。
- 标记为推荐的字段不是出价方必需提供的,如果提供,发布商可以选择是否显示这些字段(例如,星级评分)。
- 号召性用语 (CTA) 始终标记为推荐,因为如果出价方未发送号召性用语,系统会分配默认号召性用语,但如果出价方发送了号召性用语,系统将始终显示该号召性用语。
下表列出了应用安装广告模板的字段。 移动应用会使用这些字段来制作原生应用安装广告。
字段 | 说明 | 是必需还是推荐? | 是否始终显示? | 建议的图片大小/字符数上限 | 示例 |
---|---|---|---|---|---|
标题 | 应用名称 | 必填 | 是 | 25 个字符 | Flood-It! |
图片 | 该应用的屏幕截图或其他相关图片 | 必填 | 否 | 1,200 像素 x 627 像素或 600 像素 x 600 像素,具体取决于发布商要求的宽高比。 | <游戏“Flood-It!”的屏幕截图> |
正文 | 应用的主要文字 | 必填 | 否 | 90 个字符 | 看似简单但极具挑战性 = 令人上瘾! |
应用图标 | 应用图标 | 必填 | 否 | 128 x 128 像素 | <Flood-it! 应用图标> |
号召性用语 | 首选用户操作 | 推荐 | 是 | 15 个字符 | 安装 |
星级 | 表示应用在应用商店中的评分的星级数(0-5) | 推荐 | 否 | 0 - 5 | 4.5 |
价格 | 应用的费用 | 推荐 | 否 | 15 个字符 | 免费 |
关于文字长度的注意事项
如果买方发送的文字素材资源(例如正文)超出了建议的字符数上限,Google 或发布商可能会截去超出上限的部分并代之以省略号。请注意,对中文、日语和韩语而言,截断限制减半。例如,标题上限对英语来说是 90 个字符,对中文来说则是 45 个字符。
关于图片大小的注意事项
发布商可以:
- 对称剪裁主图片,但只能在一个维度(高度或宽度)上最多剪裁 20% 的尺寸。
- 在不更改宽高比的情况下缩放图片。
- 如果图片的宽高比与高度和宽度暗示的宽高比有很大不同,系统可能会将其滤除。
内容广告模板

下表列出了内容广告模板的字段。发布商使用这些字段来制作原生内容广告。
字段 | 说明 | 是必需还是推荐? | 是否始终显示? | 建议的图片大小/字符数上限 * | 示例 |
---|---|---|---|---|---|
标题 | 广告标题 | 必填 | 是 | 25 个字符 | 最低的抵押贷款利率 |
图片 | 广告的主要图片 | 必填 | 否 | 1,200 像素 x 627 像素或 600 像素 x 600 像素,具体取决于发布商要求的宽高比。 | <广告的主要图片> |
正文 | 广告内容 | 必填 | 否 | 90 个字符 | 在布鲁克林买房,比您想象的更便宜、更快捷! |
徽标 | 广告客户的徽标或其他相关的小图片 | 推荐 | 否 | 128 x 128 像素 | <NY Mortgage Inc.'s logo> |
号召性用语 | 用户的首选操作 | 推荐 | 否 | 15 个字符 | 获取报价 |
广告客户 | 标识广告客户或品牌的文字 | 必填 | 否 | 25 个字符 | NY Mortgage Inc. |
应用安装视频广告模板
字段 | 说明 | 是必需还是推荐? | 是否始终显示? | 建议的图片大小/字符数上限 * | 示例 |
---|---|---|---|---|---|
视频 | 视频 VAST 响应,其中包含播放视频广告所必需的全部素材资源。 | 必需 | 否 | - | 包含 Flood-It! 的 VAST XML 的网址视频广告 |
标题 | 应用名称 | 必需 | 是 | 25 个字符 | Flood-It! |
图片 | 在用户点击视频广告之前或视频广告加载时显示在播放器中的图片(缩略图)。 | 必需 | 否 | 此类图片的宽高比应与视频的宽高比匹配(例如:如果视频的宽高比为 16x9,相应图片的宽高比应为 1280x720;如果视频的宽高比为 4: 3,相应图片的宽高比则应为 640x480)。 | Flood-It! 游戏的屏幕截图。或在视频中 |
正文 | 应用的主要文字 | 必需 | 否 | 90 个字符 | 看似简单但极具挑战性 = 令人上瘾! |
应用图标 | 应用图标 | 必需 | 否 | 128 x 128 像素 | Flood-it! 应用图标 |
号召性用语 | 首选用户操作 | 必需 | 是 | 15 个字符 | 安装 |
星级 | 表示应用在应用商店中的评分的星级数(0-5) | 推荐 | 否 | 0 - 5 | 4.5 |
价格 | 应用的费用 | 推荐 | 否 | 15 个字符 | 免费 |
限制
视频:所有视频都必须采用 VAST 网址或 VAST 代码的形式。不能指定 WebM、MP4 等原始视频文件。
文本长度:如果买方在响应中指定了文本素材资源(例如
body
),Google 或发布商可能会截去超出上限的部分并代之以省略号。请注意,对中文、日语和韩语而言,截断限制减半。例如,标题上限对英语来说是 90 个字符,对中文来说则是 45 个字符。图片大小:发布商可以:
- 对称剪裁主图片,但只能在一个维度(高度或宽度)上最多剪裁 20% 的尺寸。
- 在不更改宽高比的情况下缩放图片。
应用安装广告示例

视频内容广告模板
字段 | 说明 | 是必需还是推荐? | 是否始终显示? | 建议的图片大小/字符数上限 * | 示例 |
---|---|---|---|---|---|
视频 | 视频 VAST 响应,其中包含播放视频广告所必需的全部素材资源。 | 必需 | 是 | - | 包含 Flood-It! 的 VAST XML 的网址视频广告 |
标题 | 广告标题 | 必需 | 是 | 25 个字符 | 最低的抵押贷款利率 |
图片 | 在用户点击视频广告之前或视频广告加载时显示在播放器中的图片(缩略图)。 | 必需 | 否 | 此类图片的宽高比应与视频的宽高比匹配(例如:如果视频的宽高比为 16x9,相应图片的宽高比应为 1280x720;如果视频的宽高比为 4: 3,相应图片的宽高比则应为 640x480)。 | 视频的屏幕截图 |
正文 | 广告内容 | 必需 | 否 | 90 个字符 | 比您想象的更便宜、更快捷地拥有布鲁克林的温馨住宅! |
徽标 | 广告客户的徽标或其他相关的小图片 | 推荐 | 否 | 128 x 128 像素 | NY Mortgage Inc. 的徽标 |
号召性用语 | 用户的首选操作 | 必需 | 否 | 15 个字符 | 获取报价 |
广告客户 | 标识广告客户或品牌的文字 | 必需 | 否 | 25 个字符 | NY Mortgage Inc. |
元字段
以下元数据字段适用于所有受支持的广告模板:
Google RTB 协议 | OpenRTB 等效项 | 说明 |
---|---|---|
NativeAd.click_link_url |
Link.url |
浏览器在用户点击广告时会调用的网址。
可以是最终指向着陆页的重定向链的第一步。对于原生广告,我们建议使用 click_link_url 字段来设置用户最终会到达的目的地。对于动态着陆页,必须使用此字段。 |
Ad.click_through_url |
Bid.adomain |
如果出价方打算出价,则必须设置此参数。这是代码段的一组目标网址,包括用户点击所展示广告后会跳转到的网址,以及呈现的广告中显示的所有网址。请勿添加与最终着陆页无关的中间广告服务器调用。如果 BidResponse 返回了摘要或视频广告,但声明没有 对于非原生广告,此网址不会用于点击跟踪或任何其他广告功能;它仅用作目标网址声明。 对于原生广告,如果未设置 |
NativeAd.click_tracking_urls |
Link.clicktrackers |
可选。广告客户用来跟踪用户对广告的点击情况的其他网址。 |
Ad.ad_choices_destination_url |
BidExt.ad_choices_destination_url |
链接到广告偏好设置或停用页面。如果存在,原生广告素材中将会添加一个标准的“广告选项”图标,并且该图标将链接到此网址。原生广告支持此属性,但它不是出价响应中原生广告消息的一部分。 |
Ad.impression_tracking_url |
NativeResponse.imptrackers |
应使用 Authorized Buyers 实时出价协议中的 impression_tracking_url 或 OpenRTB 中的原生广告展示跟踪器来跟踪原生广告展示。 |
Google RTB 协议的必填字段和建议字段
required_fields
和 recommended_fields
由发布商指定。我们将介绍如何转换这些位字段,以确定字段是必需字段还是推荐字段。
位字段使用二进制值的每个位来存储 true 或 false 语句,这相当于发送许多布尔信号(例如 is_logo_required
或 is_header_required
),但所有这些信号都打包在一起。
示例
在此示例中,我们将使用 required_fields
值 1085
。
首先,找到等效的二进制值:10000111101
获得二进制值后,您可以检查位,以了解字段是必需字段 (1) 还是非必需字段 (0)。
下表将字段映射到二进制值中的位置。从右到左读取二进制数,其中 1 位对应于二进制值中最右侧的位置。
字段 | 二进制值放置(从右到左) |
---|---|
HEADLINE |
1 |
BODY |
2 |
CALL_TO_ACTION |
4 |
ADVERTISER |
8 |
IMAGE |
16 |
LOGO |
32 |
APP_ICON |
64 |
STAR_RATING |
128 |
PRICE |
256 |
STORE |
512 |
VIDEO |
1024 |
查看二进制值 10000111101
示例,1 位(最右)为 1
,表示必需的值。根据表格,1 位对应于 HEADLINE
。
2 位(从右侧数起的第二个值)为 0
,表示非必需。2 位对应于 BODY
。
以下是示例中所有经过解释的必填字段:
值 | 说明 | 是否必需? |
---|---|---|
1 |
VIDEO |
是 |
0 |
STORE |
否 |
0 |
PRICE |
否 |
0 |
STAR_RATING |
否 |
0 |
APP_ICON |
否 |
1 |
LOGO |
是 |
1 |
IMAGE |
是 |
1 |
ADVERTISER |
是 |
1 |
CALL_TO_ACTION |
是 |
0 |
BODY |
否 |
1 |
HEADLINE |
是 |
出价请求中原生广告模板的表示
收到包含原生广告资源的出价请求时,该请求将包含不同形式的原生广告模板,具体取决于所使用的协议。我们建议您使用 OpenRTB,因为 Google 协议已被弃用。
在 OpenRTB 中,原生广告模板使用 NativeRequest 消息进行描述。在 Google RTB 协议中,它使用 NativeAdTemplate 进行描述。这些消息会提供有关原生广告资源的以下详细信息:
- 必填字段或建议填写的字段。
- 图片、徽标和应用图标的尺寸。
- 广告呈现样式的规范。
OpenRTB 资产 ID
OpenRTB 会在出价请求中传递一组素材资源,这些素材资源描述了您应在响应中返回的原生广告的结构。请求中的每个素材资源都将有一个 ID,必须在响应中为相应的素材资源指定该 ID。如需查看请求和响应中这些 ID 之间的对应关系示例,请参阅原生出价请求示例和原生出价响应示例。
出价响应中原生广告的表示
对原生广告资源出价时,买方必须填充出价请求中标识的必填字段。在 OpenRTB 中,如果使用 Protobuf,您可以使用 BidResponse.seatbid.bid.adm_native 来实现此目的;如果使用 JSON,则可以使用 BidResponse.seatbid.bid.adm
。对于已废弃的 Google 协议,您可以使用 BidResponse.ad.native_ad 字段来实现此目的。
出价请求示例
非视频出价请求
显示示例
序列化请求id: "l6210s8bS8Uc726V81B821" imp { id: "1" tagid: "3019814809" bidfloor: 0.06 bidfloorcur: "USD" secure: true native { ver: "1.2" request_native { ver: "1.2" assets { id: 1 required: true title { len: 25 } } assets { id: 2 required: true data { type: DESC len: 90 } } assets { id: 3 data { type: CTATEXT len: 15 } } assets { id: 4 required: true img { type: MAIN wmin: 1200 hmin: 627 } } assets { id: 5 img { type: LOGO wmin: 100 hmin: 100 } } eventtrackers { event: IMPRESSION methods: IMG } privacy: true [com.google.doubleclick.native_ext] { style_id: 497439 style_height: 1 style_width: 1 style_layout_type: FLUID } } } exp: 3600 metric { type: "click_through_rate" value: 0.0006697923527099192 vendor: "EXCHANGE" } metric { type: "viewability" value: 0.05 vendor: "EXCHANGE" } [com.google.doubleclick.imp] { billing_id: 50577321529 dfp_ad_unit_code: "/3711494/google/test" ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED buyer_generated_request_data { data: "Test Data" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } open_bidding { is_open_bidding: true } creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN } auction_environment: SERVER_SIDE_AUCTION ae: SERVER_SIDE_AUCTION } } site { page: "https://www.google.com" publisher { id: "pub-1111111111111111" [com.google.doubleclick.publisher] { country: "FR" } } content { livestream: false language: "fr" } [com.google.doubleclick.site] { amp: DIALECT_HTML page_visibility: VISIBILITY_STATE_VISIBLE inventorypartnerdomain: "" ntype: NAVIGATION_TYPE_NAVIGATE } } device { ua: "OMITTED" geo { lat: 0.0 lon: 0.0 country: "FRA" region: "FR-C" zip: "63120" type: IP utcoffset: 120 accuracy: 6948 [com.google.doubleclick.geo] { geo_criteria_id: 9112278 } } ipv6: "2a01:cb14:8183::" os: "Windows" devicetype: PERSONAL_COMPUTER lmt: false pxratio: 1.0 sua { browsers { brand: "Chromium" version: "130" version: "0" } browsers { brand: "Microsoft Edge" version: "130" version: "0" } platform { brand: "Windows" version: "15" version: "0" } mobile: false architecture: "x86" bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } } user { [com.google.doubleclick.user] { consented_providers_settings { consented_providers: 1712 consented_providers: 2316 additional_consent: "OMITTED" } consent: "OMITTED" eids { source: "OMITTED" uids { id: "12JD92JD8078S8J29SDOAKC0EF230337" } } } } at: FIRST_PRICE tmax: 350 cur: "USD" regs { gpp: "OMITTED" [com.google.doubleclick.regs] { gdpr: true } } source { schain { complete: true nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: true } ver: "1.0" } [com.google.doubleclick.source] { schain { complete: 1 nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: 1 } ver: "1.0" } } } [com.google.doubleclick.bid_request] { google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v" fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE }
显示示例
{ "id": "l6210s8bS8Uc726V81B821", "imp": [ { "id": "1", "tagid": "3019814809", "bidfloor": 0.06, "bidfloorcur": "USD", "secure": 1, "native": { "ver": "1.2", "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}" }, "exp": 3600, "metric": [ { "type": "click_through_rate", "value": 0.0006697923527099192, "vendor": "EXCHANGE" }, { "type": "viewability", "value": 0.05, "vendor": "EXCHANGE" } ], "ext": { "billing_id": [ "50577321529" ], "dfp_ad_unit_code": "/3711494/google/test", "ampad": 3, "buyer_generated_request_data": [ { "data": "Test Data" } ], "excluded_creatives": [ { "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID" }, { "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID" } ], "open_bidding": { "is_open_bidding": 1 }, "creative_enforcement_settings": { "policy_enforcement": 1, "publisher_blocks_enforcement": 2 }, "auction_environment": 0, "ae": 0 } } ], "site": { "page": "https://www.google.com", "publisher": { "id": "pub-1111111111111111", "ext": { "country": "FR" } }, "content": { "livestream": 0, "language": "fr" }, "ext": { "amp": 0, "page_visibility": 1, "inventorypartnerdomain": "OMITTED", "ntype": 1 } }, "device": { "ua": "OMITTED", "geo": { "lat": 0.0, "lon": 0.0, "country": "FRA", "region": "FR-C", "zip": "63120", "type": 2, "utcoffset": 120, "accuracy": 6948, "ext": { "geo_criteria_id": 9112278 } }, "ipv6": "2a01:cb14:8183::", "os": "Windows", "devicetype": 2, "lmt": 0, "pxratio": 1.0, "sua": { "browsers": [ { "brand": "Chromium", "version": [ "130", "0" ] }, { "brand": "Microsoft Edge", "version": [ "130", "0" ] } ], "platform": { "brand": "Windows", "version": [ "15", "0" ] }, "mobile": 0, "architecture": "x86", "bitness": "64", "source": 2 } }, "user": { "ext": { "consented_providers_settings": { "consented_providers": [ "1712", "2316" ], "additional_consent": "OMITTED" }, "consent": "OMITTED", "eids": [ { "source": "OMITTED", "uids": [ { "id": "12JD92JD8078S8J29SDOAKC0EF230337" } ] } ] } }, "at": 1, "tmax": 350, "cur": [ "USD" ], "regs": { "gpp": "OMITTED", "ext": { "gdpr": 1 } }, "source": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" }, "ext": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" } } }, "ext": { "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v", "fcap_scope": 1 } }
显示示例
序列化请求id: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx" ip: "\300\250" user_agent: "OMITTED" url: "https://www.google.com" detected_language: "it" adslot { id: 1 excluded_attribute: 14 excluded_attribute: 32 allowed_vendor_type: 42 allowed_vendor_type: 144 excluded_sensitive_category: 36 excluded_sensitive_category: 19 matching_ad_data { billing_id: 74792558829 billing_id: 11204117851 minimum_cpm_micros: 390000 } matching_ad_data { billing_id: 44428418146 billing_id: 91112044263 minimum_cpm_micros: 110000 } slot_visibility: BELOW_THE_FOLD excluded_product_category: 10366 excluded_product_category: 11504 ad_block_key: 8767661977 publisher_settings_list_id: 7807286827624818876 publisher_settings_list_id: 8186380472781289268 allowed_restricted_category: 32 allowed_restricted_category: 33 excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } iframing_state: UNKNOWN_IFRAME_STATE viewability: 6 allowed_restricted_category_for_deals: 32 allowed_restricted_category_for_deals: 33 click_through_rate: 0.0010397299 allowed_ad_types: ALLOWED_AD_TYPE_NATIVE is_amp_page: DIALECT_HTML amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED secure_signals { data: "Test Data: bw44G12BFZ" source: "OMITTED" } consented_providers_settings { tcf_consent_string: "OMITTED" additional_consent_string: "OMITTED" } regs_gdpr: true native_ad_template { required_fields: 17 recommended_fields: 0 headline_max_safe_length: 90 body_max_safe_length: 90 call_to_action_max_safe_length: 15 advertiser_max_safe_length: 25 image_width: 1200 image_height: 627 style_id: 749853 style_layout_type: FLUID style_height: 1 style_width: 1 } creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES } auction_environment: SERVER_SIDE_AUCTION impression_expiration_seconds: 3600 supported_auction_environment: SERVER_SIDE_AUCTION } is_test: false timezone_offset: 120 geo_criteria_id: 1008463 bid_response_feedback { request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301" creative_status_code: 1 event_notification_token: "token" buyer_creative_id: "test_creative_id_744913" minimum_bid_to_win: 220000 feedback_type: BID_FEEDBACK } bid_response_feedback { request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G" creative_status_code: 80 event_notification_token: "token" buyer_creative_id: "test_creative_id_744913" minimum_bid_to_win: 3450000 feedback_type: BID_FEEDBACK } publisher_type: PUBLISHER_OWNED_AND_OPERATED device { device_type: PERSONAL_COMPUTER platform: "Windows" screen_pixel_ratio_millis: 1000 limit_ad_tracking: false } publisher_country: "IT" publisher_id: "pub-1111111111111111" response_deadline_ms: 350 google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6" auction_type: FIRST_PRICE geo { lat: 0.0 lon: 0.0 country: "ITA" region: "IT-MI" city: "Milan" utcoffset: 120 accuracy: 6821 } user_agent_data { platform { brand: "Windows" version: "10" version: "0" } mobile: false architecture: "x86" browsers { brand: "Chromium" version: "128" version: "0" } browsers { brand: "Not;A=Brand" version: "24" version: "0" } bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } page_visibility: VISIBILITY_STATE_VISIBLE supply_chain { complete: true nodes { advertising_system_identifier: "testdomain.com" seller_identifier: "pub-1111111111111111" handles_payment: true } version: "1.0" } frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE privacy_treatments { allow_user_data_collection: true } inventory_partner_domain: "OMITTED"
视频出价请求
{ id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123", ip: "\0338\355", google_user_id: "CAESEJ1ur2l94_8ruuu", cookie_version: 1, cookie_age_seconds: 5184000, hosted_match_data: "W9ABDAAAAGR67nl0", user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36", publisher_country: "IN", geo_criteria_id: 1007796, timezone_offset: 330, publisher_id: "pub-2230723027927371", seller_network_id: 989, url: "https://m.example.com", detected_language: [en], google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q", auction_type: "SECOND_PRICE", device: { device_type: "HIGHEND_PHONE", platform: "android", brand: "coolpad", model: "cp8298_i00", os_version: { major: 5, minor: 1 }, carrier_id: 70210, screen_width: 360, screen_height: 640, screen_pixel_ratio_millis: 2000 }, mobile: { is_app: false, is_mobile_web_optimized: true, DEPRECATED_platform: "android", DEPRECATED_mobile_device_type: "HIGHEND_PHONE", DEPRECATED_brand: "coolpad", DEPRECATED_model: "cp8298_i00", DEPRECATED_os_version: { os_version_major: 5, os_version_minor: 1 }, DEPRECATED_screen_width: 360, DEPRECATED_screen_height: 640, DEPRECATED_carrier_id: 70210, DEPRECATED_device_pixel_ratio_millis: 2000 }, publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED", adslot: [{ id: 1, ad_block_key: 2882274820, width: [300,250], height: [250,250], excluded_attribute: [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22], allowed_vendor_type: [42,144,575,698,704,743,776,785,793,797,808,828,832,885], excluded_sensitive_category: [36,27,19,4,23,30,10,3,31,5,8,37,18], excluded_product_category: [10031,11669,13423,13525,13566,13589,13612,13740], excluded_creatives: [{ buyer_creative_id: "1234567.1234567890-ssl" }], matching_ad_data: [{ billing_id: [6629616415,51386650457], minimum_cpm_micros: 1380000, direct_deal: [{ direct_deal_id: 410401, fixed_cpm_micros: 1360000, deal_type: "PREFERRED_DEAL", publisher_blocks_overridden: true },{ direct_deal_id: 240644, fixed_cpm_micros: 1500000, deal_type: "PREFERRED_DEAL", publisher_blocks_overridden: true }] },{ billing_id: [1234567890], minimum_cpm_micros: 1380000 }], publisher_settings_list_id: [12109930661871909476,11138951146123409010], slot_visibility: "BELOW_THE_FOLD", viewability: 30, click_through_rate: 0.0010072842, iframing_state: "UNKNOWN_IFRAME_STATE", native_ad_template: [{ required_fields: 1065, recommended_fields: 4, headline_max_safe_length: 25, body_max_safe_length: 90, call_to_action_max_safe_length: 15, advertiser_max_safe_length: 25, logo_width: 100, logo_height: 100, style_id: 199892, style_height: 250, style_width: 300 }], sticky_settings: { }, renderer: "GOOGLE", is_amp_page: "DIALECT_HTML", amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED", allowed_ad_types: [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE], session_depth: 1, internal_data: { } }], response_deadline_ms: 122, is_test: false }
出价响应示例
非视频广告出价响应
显示示例
序列化响应id: "22i22S9494PQl819H7Ld5K" seatbid { bid { id: "2GTnPXOn76gg1C6574T" impid: "1" price: 0.24 adid: "test_creative_id_713312" adomain: "google.com" crid: "test_creative_id_713312" exp: 300 language: "xx" adm_native { ver: "1.2" assets { id: 1 title { text: "Luxury Mars Cruises" } } assets { id: 2 data { value: "Visit the planet in a luxury spaceship." } } assets { id: 3 data { value: "Book today" } } assets { id: 4 img { url: "https://native.test.com/image?id=123456" w: 1200 h: 627 } } assets { id: 5 img { url: "https://native.test.com/logo?id=123456" w: 1200 h: 1200 } } link { url: "https://www.google.com" clicktrackers: "https://native.test.com/click?id=123456" } eventtrackers { event: IMPRESSION method: IMG url: "https://test.com/event?id=123456" } eventtrackers { event: IMPRESSION method: IMG url: "https://test.com/event?id=123456" } privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED" } [com.google.doubleclick.bid] { event_notification_token { payload: "token" } billing_id: 50577321529 third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7" } } seat: "5249:9218:332606" } cur: "USD"
显示示例
{ "id": "22i22S9494PQl819H7Ld5K", "seatbid": [ { "bid": [ { "id": "2GTnPXOn76gg1C6574T", "impid": "1", "price": 0.24, "adid": "test_creative_id_713312", "adomain": [ "google.com" ], "crid": "test_creative_id_713312", "exp": 300, "language": "xx", "ext": { "event_notification_token": { "payload": "token" }, "billing_id": "50577321529", "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7" }, "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\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}" } ], "seat": "5249:9218:332606" } ], "cur": "USD" }
显示示例
序列化响应ad { adslot { id: 1 max_cpm_micros: 110734 min_cpm_micros: 0 billing_id: 74792558829 deal_id: 0 } click_through_url: "google.com" attribute: 47 attribute: 8 buyer_creative_id: "test_creative_id_907643" 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: 800 height: 800 } logo { url: "https://native.test.com/logo?id=123456" width: 200 height: 200 } price: "\342\202\254 225" 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" ad_choices_destination_url: "https://test.com/preferences" event_notification_token: "token" dsa_transparency { buyer_render: true } } processing_time_ms: 27
视频出价响应
bid_response { ad { ... click_through_url: "https://www.exampleDomain.com" impression_tracking_url: "https://my_impression_tracking_url.com/" ad_choices_destination_url: "https://my_ad_choices_destination_url.com/" ... native_ad { headline: "Lowest mortgage rates" video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast" call_to_action: "Get a quote" advertiser: "NY Mortgage Inc." image { url: "https://www.example.net/mypromoimage.png" width: 1200 height: 700 } logo { url: "https://www.example.net/mylogo.png" width: 200 height: 200 } click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1" click_tracking_urls: "https://my_click_tracking_url.com/" } } }