所有展示由 Google 托管的个性化广告的应用都必须实现 AdChoices图标和 叠加层(如果由 Google 提供)。“广告选项”(也称为“为什么显示该广告?”)是一项透明度功能,旨在向用户说明系统为何向其展示特定广告,并提供相关信息以便用户了解其隐私会受到怎样的保护。
如需了解详情,请参阅为什么您会看到某个广告。
本指南介绍了如何从广告的 VAST XML 响应或 DAI 串流的元数据响应中提取必要信息,以便正确实现 AdChoices。
对 AdChoices 呈现的要求
为了遵守 Google 关于呈现“广告选择”图标的要求,您的应用或 网站必须符合以下标准:
- “广告选择”图标必须叠加在提供该图标的任何广告上显示
- “广告选择”图标必须显示在图标数据中包含的“X 位置”和“Y 位置”属性所指示的位置,并且显示的尺寸(以密度无关像素 [DP] 为单位)由宽度和高度属性定义。
- “广告选项”图标不得被其他广告叠加层或界面元素遮挡。
- 在支持点击或等效操作(例如轻触或遥控器选择)的平台上,广告选项图标必须可点击。
- 在支持浏览器的平台上,点击“广告选择”图标必须能打开一个浏览器标签页或窗口,其中包含“点击后到达网址”或“click_data”属性中指定的网址。
- 在不支持浏览器的平台上,点击“广告选择”图标必须能打开模态叠加层,并显示“IconClickFallbackImage”或“click_fallback_images”属性中指定的图片之一。
- 在未受浏览器支持的平台上,后备图片必须以“IconClickFallbackImage”或“click_fallback_images”属性中指定的大小(以与密度无关的像素 [DP] 为单位)显示。
解析 VAST XML 响应中的 AdChoices
使用 XML 广告响应时,只有 VAST 3.0 及更高版本支持 AdChoices。“广告选择”是作为 VAST 图标实现的。
VAST 4.2
如果您的 XML 广告响应遵循 VAST 4.2 标准,则“广告选择”将作为 VAST 图标传送。如果您的应用或网站完全支持 VAST 4.2 图标(VAST 4.2 标准的第 3.11 节),则无需执行任何其他操作即可支持 AdChoices。
如果您的应用不支持 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 图标标准,并且平台能够导航到并显示图标点击链接,则无需执行进一步操作即可支持 AdChoices。
如果您的平台无法导航到或显示点击 网址 - 这主要适用于未集成网络的设备 您必须实现对“IconFallbackImages”。 此扩展程序包含一组“IconFallbackImages”标记,其中“program”属性与 VAST 中包含的图标匹配。
如需全面支持“广告选择”,必须将名称为“GoogleWhyThisAd”的 IconFallbackImages 标记与名称为“GoogleWhyThisAd”的图标相关联,以便在用户与图标互动时,系统会显示关联的后备图片。
为方便日后对“广告选择”标准做出更改,我们强烈建议 建议您为所有 VAST 图标添加后备图片支持, 可用。您可以使用此 VAST 3.0 xml 示例在应用中进行进一步测试。
IconFallbackImages 扩展程序结构
标记 | 属性 | 说明 |
---|---|---|
附加信息 | type | 对于此扩展程序,类型始终包含值
IconClickFallbackImages 。
|
-IconClickFallbackImages | 节目 | 此属性始终与关联的 VAST 3.0 图标的 program 属性匹配。 |
此节点的结构符合
IconClickFallbackImages(添加了 program 除外)
属性。
|
||
--IconClickFallbackImage | 宽度 | 用于显示图片的首选宽度。 |
身高 | 用于显示图片的首选高度。 | |
---AltText | 图片的可访问说明。 | |
---StaticResource | creativeType | 后备图片的 MIME 类型。 |
包含后备图片网址的 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 时,AdChoices 详细信息会通过对元数据网址的请求返回的 JSON 对象传递。
Metadata JSON 对象包含广告列表,按广告 ID 键控。每个广告对象中都包含一个图标数组。如果相关广告使用了“广告选项”, “广告选择”图标包含在该数组中。
JSON 图标格式
JSON 图标格式是从 VAST 4.2 图标 标准 (第 3.11 节)。但是,为了支持 格式,则会根据需要更改某些属性的名称。
图标 JSON 格式
节目 | 对于“广告选择”图标,此值始终包含字符串“GoogleWhyThisAd”。 |
x_position | 图标左上角相对于相对于 视频广告素材的左上角(以像素为单位)。此字段还接受响应式位置值“right”或“left”。 |
y_position | 图标左上角相对于视频广告素材左上角的垂直位置(以像素为单位)。此字段还接受 自适应位置值“顶部”或“bottom”。 |
宽度 | 图标的宽度(以像素为单位)。 |
高度 | 图标的高度(以像素为单位)。 |
creative_type | 为图标提供的图片的 MIME 类型。默认为“image/png”。 |
资源 | 用于检索“广告选择”图标的网址。 |
alt_text | 要为“广告选择”图标显示的替代文本。 |
click_data | 一个包含属性 click_data.url 的对象,表示在支持网络浏览的平台上,如果观看者点击“广告选项”图标,系统会将其定向到的网址。
|
click_fallback_images | 一个图片对象数组,用于向在不支持网页浏览的平台上点击 AdChoices 图标的观看者显示。 |
后备图片 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"
}
...
]
...
},
...
}
...
}