凡是顯示 Google 代管個人化廣告的應用程式,都必須導入 AdChoices 圖示和 重疊 (由 Google 提供)。AdChoices (也稱為「為什麼會顯示這則廣告?」) 是資訊公開功能,旨在向使用者 並提供隱私權保護方式的相關資訊。
詳情請參閱為什麼會出現 廣告。
本指南說明如何正確擷取必要資訊, 從廣告的 VAST XML 回應或 DAI 串流的 中繼資料回應
AdChoices 顯示規定
為遵守 Google 對 AdChoices 圖示的顯示規定,您的應用程式或 網站必須符合下列標準:
- AdChoices 圖示必須疊加在其所在的任何廣告上 已提供
- AdChoices 圖示必須顯示在「X」標示的位置 位置」以及「Y 位置」屬性中的屬性,以及 根據寬度和高度屬性定義的大小 (不受密度影響) 像素 (DP)。
- AdChoices 圖示不得遭到其他廣告重疊或介面遮蓋 元素。
- 在提供點擊支援或同等功能 (例如觸控或遠端選取) 的平台上, AdChoices 圖示必須可供點擊。
- 在支援瀏覽器的平台上,只有在使用者點選 AdChoices 圖示時, 瀏覽器分頁或視窗,其網址列在或 「點擊資料」資源。
- 在不支援瀏覽器的平台上,按一下 AdChoices 圖示必須開啟 強制回應式疊加層,顯示 "IconClickFallbackImage"或「click_fallback_images」資源。
- 在不支援瀏覽器的平台上,備用圖片必須顯示在 在「IconClickFallbackImage」內指定的大小或 「click_fallback_images」。
從 VAST XML 回應中剖析 AdChoices
使用 XML 廣告回應時,只有 VAST 支援 AdChoices 3.0 以上版本。AdChoices 是以 VAST 圖示的形式導入。
VAST 4.2
如果 XML 廣告回應跟 VAST 4.2 標準、 AdChoices 是以 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 標準,AdChoices 是 由 VAST 圖示和自訂 VAST 擴充功能搭配使用放送。如果您的 應用程式或網站完全支援 VAST 3.0 圖示標準 可瀏覽並顯示圖示到達網址、AdChoices 支援 不必採取進一步行動
如果您的平台無法前往並顯示點閱 網址:主要適用於沒有整合網路的裝置 ,您必須為「IconFallbackImages」提供支援。 這項擴充功能含有一組「IconFallbackImages」「程式」標記 屬性與 VAST 中包含的圖示相符。
為完整支援 AdChoices,圖示中的 IconFallbackImages 標記含有方案名稱 「Google 為什麼為什麼會顯示這則廣告?」必須與方案名稱的圖示建立關聯 「GoogleWhyThisAd」 因此只要使用者與圖示互動 以便顯示相關聯的備用圖片
為因應 AdChoices 標準日後可能出現異動,我們 建議您在隨播廣告版位中,為所有 VAST 圖示支援備用圖片 廣告。您可以將此範例 VAST 3.0 XML ,在您的應用程式中進行額外測試。
IconFallbackImages 擴充功能結構
標記 | 屬性 | 說明 |
---|---|---|
延伸 | 類型 | 針對這項擴充功能,類型一律包含值
IconClickFallbackImages 。
|
-IconClickFallbackImages | 節目 | 這個屬性一律符合相關 VAST 的 Program 屬性 3.0 圖示。 |
此節點的結構符合 VAST 4.2 標準的
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 剖析 AdChoices
使用 DAI 時 API、AdChoices 詳細資料 這個 JSON 物件會經由要求傳回的中繼資料,而該物件 網址。
中繼資料 JSON 物件包含廣告清單,並以 adID 做為索引鍵。每個 廣告物件是一個圖示陣列。如果有問題的廣告使用 AdChoices, AdChoices 圖示包含於該陣列中。
JSON 圖示格式
JSON 圖示格式是來自 VAST 4.2 圖示的 1:1 轉譯內容 標準 (第 3.11 節),盡可能提供。不過,為了支援更嚴格的 JSON 格式,某些屬性的名稱會在必要時變更。
圖示 JSON 格式
節目 | 就 AdChoices 圖示而言,這個值一律會包含「GoogleWhyThisAd」字串。 |
x_position | 圖示左上角的水平位置 (相對於 以像素為單位。這個欄位也接受 回應式位置值「右」或「左」 |
y_position | 圖示左上角的垂直位置 (相對於 以像素為單位。這個欄位也接受 回應式位置值「top」或「底部」 |
寬度 | 圖示的寬度,以像素為單位。 |
高度 | 圖示的高度,以像素為單位。 |
creative_type | 為圖示提供的圖片 MIME 類型。預設為「image/png」。 |
資源 | 用於擷取 AdChoices 圖示的網址。 |
alt_text | AdChoices 圖示的替代文字。 |
click_data | 包含 click_data.url 屬性的物件
代表觀眾按下 AdChoices 圖示時要導向的網址
平台。
|
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"
}
...
]
...
},
...
}
...
}