原生广告

原生广告的格式会与周围内容和视觉设计浑然一体，因此这类广告更有望被用户看到和点击。原生广告资源适用于移动应用以及桌面版和移动版网站。如需详细了解原生广告，请参阅原生广告简介。

Authorized Buyers 和公开出价均支持原生广告。

以下是原生广告的工作流程：

1. 向 Google 发出原生广告调用请求，该调用指定以下一种或两种原生广告模板，每种模板都指定了首选的原生字段。
2. Google 向买方发送 RTB 出价请求，其中包含所请求的字段列表。
3. 感兴趣的买方回应所请求的字段。
4. Google 开展竞价以选择获胜出价，然后将相应买方提供的广告素材资源发送给发布商。
5. 发布商将这些素材资源整合到一个原生广告中，并调整它们的样式以契合该网站的设计风格。

消息格式

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 返回了摘要或视频广告，但声明没有 click_through_url，系统将不会舍弃该 BidResponse。仅在设置了 html_snippet、video_url 或 native_ad 时设置此字段。此数据用作目标网址声明，例如用于对发布商屏蔽的网址进行后续过滤或对广告进行分类。使用原生广告时，请参阅 NativeAd.click_link_url。 对于非原生广告，此网址不会用于点击跟踪或任何其他广告功能；它仅用作目标网址声明。 对于原生广告，如果未设置 NativeAd.click_link_url，系统会使用 click_through_url 的第一个值将用户定向到着陆页。此外，所有值都用作目标网址声明（与非原生情况类似）。
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），但所有这些信号都打包在一起。

注意：在 OpenRTB 中，BidRequest.imp.native.request_native.assets.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 进行描述。这些消息会提供有关原生广告资源的以下详细信息：

• 必填字段或建议填写的字段。
• 图片、徽标和应用图标的尺寸。
• 广告呈现样式的规范。

注意：对于 style_layout_type 字段，PIXEL 表示原生单元采用固定大小，而 FLUID 表示它会缩放以填充封闭列的宽度，并调整高度以保持宽高比。指定 FLUID 后，高度和宽度可能会显示为 1x1。

OpenRTB 资产 ID

OpenRTB 会在出价请求中传递一组素材资源，这些素材资源描述了您应在响应中返回的原生广告的结构。请求中的每个素材资源都将有一个 ID，必须在响应中为相应的素材资源指定该 ID。如需查看请求和响应中这些 ID 之间的对应关系示例，请参阅原生出价请求示例和原生出价响应示例。

出价响应中原生广告的表示

对原生广告资源出价时，买方必须填充出价请求中标识的必填字段。在 OpenRTB 中，如果使用 Protobuf，您可以使用 BidResponse.seatbid.bid.adm_native 来实现此目的；如果使用 JSON，则可以使用 BidResponse.seatbid.bid.adm。对于已废弃的 Google 协议，您可以使用 BidResponse.ad.native_ad 字段来实现此目的。

出价请求示例

注意：如需了解响应中哪些是必需字段，哪些是可选字段，请参阅出价请求中的原生广告模板。对于 OpenRTB，您可以在 BidRequest.imp.native 中找到此字段。对于已废弃的 Google 协议，您可以在 BidRequest.adslot.native_ad_template 中找到此信息。

非视频出价请求

OpenRTB Protobuf

显示示例

序列化请求

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
}

OpenRTB JSON

显示示例

{
  "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
  }
}

Google

显示示例

序列化请求

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
}

出价响应示例

非视频广告出价响应

OpenRTB Protobuf

显示示例

序列化响应

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"

OpenRTB JSON

显示示例

{
  "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"
}

Google

显示示例

序列化响应

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/"
    }
  }
}