此页面由 Cloud Translation API 翻译。

“广告选择”图标和叠加层

所有展示由 Google 托管的个性化广告的应用都必须实现 AdChoices图标和叠加层（如果由 Google 提供）。广告选项（也称为“为什么显示该广告？”）是一项透明度功能，用于向用户说明为什么向其展示并提供有关如何保护其隐私的信息。

有关详情，请参阅为什么您会看到广告。

本指南介绍了如何提取必要信息，从广告的 VAST XML 响应或 DAI 视频流的元数据响应。

“广告选择”呈现要求

为了遵守 Google 关于呈现“广告选择”图标的要求，您的应用或网站必须符合以下标准：

“广告选择”图标必须显示在任何具有该图标的广告上提供
“广告选择”图标必须显示在标有“X”的位置位置”和“Y 轴位置”属性，在尺寸由宽度和高度属性定义，与密度无关像素 (DP)。
“广告选择”图标不得被其他广告信息叠加窗口或界面遮挡元素。
在支持点击或等效功能（例如触摸或远程选择）的平台上： “广告选项”图标必须是可点击的
在支持浏览器的平台上，点击“广告选项”图标必须打开一个带有“ClickThrough”中指定的网址的浏览器标签页或窗口或 “click_data”属性。
在不支持浏览器的平台上，点击“广告选项”图标必须打开一个模态叠加层，用于显示 "IconClickFallbackImage"或“click_fallback_images”属性。
在不支持浏览器的平台上，后备图片必须显示在以下位置：使用“IconClickFallbackImage”参数中指定的尺寸。或 “click_fallback_images”属性。

解析 VAST XML 响应中的“广告选择”

处理 XML 广告响应时，只有 VAST 支持“广告选择” 版本 3.0 及更高版本。“广告选择”是以 VAST 图标的形式实现的。

VAST 4.2

如果您的 XML 广告响应符合 VAST 4.2 标准， “广告选择”以 VAST 图标的形式投放。如果您的应用或网站完全支持 VAST 4.2 图标（VAST 4.2 标准的第 3.11 节），“广告选择”支持无需您执行进一步的操作。

如果您的应用不支持 VAST 4.2 图标，则需要手动解析图标计划名称为“GoogleWhyThisAd”从您的 VAST 响应发出标准。您可以使用此示例 VAST 4.2 XML 以便在您的应用中进行额外测试

VAST 4.2 响应示例

<?xml version="1.0" encoding="UTF-8"?>
<VAST version="4.2">
  <Ad id="20011">
    <Wrapper>
      ...
      <Creatives>
        ...
        <Creative id="5480" sequence="1">
          ...
          <Linear>
            ...
            <Icons>
              ...
              <Icon program="GoogleWhyThisAd" width="40" height="30" xPosition="left" yPosition="100" duration="00:00:10" offset="00:00:00" apiFramework="VAST" altText="AdChoices icon">
                <StaticResource creativeType="image/png">
                  <![CDATA[ https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png ]]>
                </StaticResource>
                <IconClicks>
                  <IconClickThrough>
                    <![CDATA[ https://g.co/adsettings ]]>
                  </IconClickThrough>
                  <IconClickFallbackImages>
                    <IconClickFallbackImage width="950" height="600">
                      <AltText>
                        <![CDATA[ This ad was shown to you based on: * Google's estimation of your interests, based on your activity on Google on this device (for example, your searches) * the information on the website you were viewing. ]]>
                      </AltText>
                      <StaticResource creativeType="image/png">
                        <![CDATA[ https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices_fallback_image.png ]]>
                      </StaticResource>
                    </IconClickFallbackImage>
                    ...
                  </IconClickFallbackImages>
                </IconClicks>
              </Icon>
              ...
            </Icons>
            ...
          </Linear>
          ...
        </Creative>
        ...
      </Creatives>
      ...
    </Wrapper>
    ...
  </Ad>
</VAST>

VAST 3.0

如果您的 XML 广告响应符合 VAST 3.0 “广告选择” 作为 VAST 图标和自定义 VAST 扩展元素的组合进行投放。如果您的应用或网站完全支持 VAST 3.0 图标标准，并且相应平台能够导航到并显示图标点击后到达网址，“广告选项”支持无需您执行进一步的操作。

如果您的平台无法导航到或显示点击网址 - 这主要适用于未集成网络的设备您必须实现对“IconFallbackImages”。此扩展程序包含一组“IconFallbackImages”标记中属性与 VAST 中包含的图标相匹配。

为了全面支持“广告选项”，使用包含计划名称的 IconFallbackImages 代码 “GoogleWhyThisAd”必须与包含计划名称的图标相关联 “GoogleWhyThisAd”，让当用户与图标互动时，相关联的后备图片。

为支持将来可能对“广告选择”标准做出更改，我们强烈建议建议为所有 VAST 图标添加后备图片支持，可用。您可以使用此示例 VAST 3.0 xml 以便在您的应用中进行额外测试

IconFallbackImages 扩展结构

标记	属性	说明
扩展程序	type	对于此扩展程序，类型始终包含值 `IconClickFallbackImages`。
-IconClickFallbackImages	节目	此属性始终与相关联的 VAST 的计划属性相匹配 3.0 图标。
-IconClickFallbackImages		此节点的结构符合 IconClickFallbackImages（但添加了 `program`）属性。
--IconClickFallbackImage	宽度	用于显示图片的首选宽度。
--IconClickFallbackImage	高度	用于显示图片的首选高度。
---AltText		图片的可访问说明。
---StaticResource	creativeType	后备图片的 MIME 类型。
---StaticResource		包含后备图片网址的 CDATA 值。

VAST 3.0 响应示例

<?xml version="1.0" encoding="UTF-8"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
 <Ad id="123456">
  <InLine>
   ...
   <Creatives>
    ...
    <Creative id="7891011" AdID="ABCD123456EF" sequence="1">
     ...
     <Linear>
      ...
      <Icons>
       ...
       <Icon program="GoogleWhyThisAd" width="50" height="50" xPosition="20" yPosition="bottom" duration="00:00:10" offset="00:00:00" apiFramework="VAST" altText="Why This Ad?">
        <StaticResource creativeType="image/png">
         <![CDATA[https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png]]>
        </StaticResource>
        <IconClicks>
         ...
         <IconClickThrough><![CDATA[https://g.co/adsettings]]></IconClickThrough>
        </IconClicks>
       </Icon>
       ...
      </Icons>
     ...
     </Linear>
     ...
    </Creative>
    ...
   </Creatives>
   <Extensions>
    ...
    <Extension type="IconClickFallbackImages">
     ...
     <IconClickFallbackImages program="GoogleWhyThisAd">
      <IconClickFallbackImage width="400" height="150">
       <AltText>Alt icon fallback</AltText>
       <StaticResource creativeType="image/png"><![CDATA[https://storage.googleapis.com/gvabox/nickchavez/media/png/wta_dialog.png]]></StaticResource>
      </IconClickFallbackImage>
      ...
     </IconClickFallbackImages>
     ...
    </Extension>
    ...
   </Extensions>
   ...
  </InLine>
  ...
 </Ad>
</VAST>

从 DAI API 元数据 JSON 中解析“广告选择”

在使用 DAI 时， API 中所述，“广告选择”详情通过对元数据的请求返回的 JSON 对象进行传递，网址。

Metadata JSON 对象包含由 adID 键控的广告列表。在每个是一个图标数组。如果相关广告使用了“广告选项”， “广告选择”图标包含在该数组中。

JSON 图标格式

JSON 图标格式是从 VAST 4.2 图标标准（第 3.11 节）。但是，为了支持格式，则会根据需要更改某些属性的名称。

图标 JSON 格式

节目	对于“广告选择”图标，此值始终包含字符串“GoogleWhyThisAd”。
x_position	图标左上角相对于相对于视频广告素材的左上角（以像素为单位）。此字段还接受自适应位置值“right”或“左”。
y_position	图标左上角相对于（以像素为单位）。此字段还接受自适应位置值“顶部”或“bottom”。
宽度	图标的宽度（以像素为单位）。
高度	图标的高度（以像素为单位）。
creative_type	为图标提供的图片的 MIME 类型。默认为“image/png”。
资源	用于检索“广告选择”图标的网址。
alt_text	要为“广告选择”图标显示的替代文本。
click_data	一个包含 `click_data.url` 属性的对象，该属性代表的是，如果观看者点击页面上的“广告选择”图标，一个支持网络浏览的平台
click_fallback_images	向点击“广告选项”的观看者显示的一系列图片对象图标。

后备图片 JSON 格式

宽度	后备图片的宽度（以像素为单位）。
高度	后备图片的高度（以像素为单位）。
creative_type	后备图片的 MIME 类型。默认为“image/png”。
资源	用于检索后备图片的网址。
alt_text	要为后备图片呈现的替代文本。

元数据 JSON 示例

{
  ...
  "ads": {
    ...
    "0002640412_ad1": {
      ...
      "icons": [
        ...
        {
          "alt_text": "AdChoices icon",
          "click_data": {
            "url": "https://g.co/adsettings"
          },
          "click_fallback_images": [
            {
              "alt_text": "This ad was shown to you based on: * Google's
estimation of your interests, based on your activity on Google on this device
(for example, your searches) * the information on the website you were
viewing.",
              "creative_type": "image/jpg",
              "height": 600,
              "resource": "https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices_fallback_image.png",
              "width": 950
            }
          ],
          "creative_type": "image/png",
          "height": 30,
          "program": "AdChoices",
          "resource": "https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png",
          "type": "static",
          "width": 40,
          "x_position": "0",
          "y_position": "100"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}