此页面由 Cloud Translation API 翻译。

原生广告

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

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。

原生广告模板

原生广告模板用于描述原生广告的组成部分，并确定出价请求中的 NativeRequest 的内容和结构。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.

元字段

所有受支持的广告模板均共用以下元数据字段：

字段	说明
`BidResponse.seatbid.bid.{adm/adm_native}.link.url`	用户点击广告后会被引导到的最终着陆页的网址。对于动态着陆页，必须使用此字段。
`BidResponse.seatbid.bid.{adm/adm_native}.link.clicktrackers`	可选。广告客户用来跟踪用户对广告的点击情况的其他网址。
`BidResponse.seatbid.bid.{adm/adm_native}.privacy`	链接到广告偏好设置或停用页面。如果存在，原生广告素材中将会添加一个标准的“广告选项”图标，并且该图标将链接到此网址。
`BidResponse.seatbid.bid.{adm/adm_native}.eventtrackers`	您可以通过在原生响应中添加 `eventtrackers` 来执行展示跟踪，其中 `event` 设置为 `IMPRESSION`。

出价请求中原生广告模板的表示

收到包含原生广告资源的出价请求时，该请求将包含使用 OpenRTB 的 NativeRequest 消息表示的原生广告模板。它会提供有关原生广告资源的以下信息：

可选或必需的素材资源。
图片、徽标和应用图标的尺寸。
广告呈现样式的规范。

注意：对于 BidRequest.imp.native.{request/request_native}.ext.style_layout_type，PIXEL 表示原生单元大小固定，而 FLUID 表示它会缩放以填充封闭列的宽度，并调整高度以保持宽高比。指定 FLUID 后，高度和宽度可能会显示为 1x1。

可选和必需的素材资源

您可以在 BidRequest.imp.native.{request/request_native}.assets 中找到原生广告展示的选填和必需素材资源。此属性用于描述原生广告的组件，例如标题、正文或徽标。请求中包含的每个素材资源都有一个不同的 id，并且对于必须包含在出价响应中的素材资源，将 required 填充为 True。

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

对原生广告资源出价时，您必须添加一个填充了出价请求中指明的必需素材资源的 NativeResponse，还可以添加指定的任何可选素材资源。您可以使用 BidResponse.seatbid.bid.{adm/adm_native}.assets 在出价响应中添加这些信息。在响应中填充 assets 时，每个 assets 都必须包含与出价请求中的相应素材资源对应的 id。

出价请求示例

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

出价响应示例

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

原生广告 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

消息格式

原生广告模板

应用安装广告模板

必填字段和建议填写的字段

关于文字长度的注意事项

关于图片大小的注意事项

内容广告模板

应用安装视频广告模板

限制

应用安装广告示例

视频内容广告模板

元字段

出价请求中原生广告模板的表示

可选和必需的素材资源

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

出价请求示例

OpenRTB Protobuf

显示示例

OpenRTB JSON

显示示例

出价响应示例

OpenRTB Protobuf

显示示例

OpenRTB JSON

显示示例

原生广告