本頁面由 Cloud Translation API 翻譯而成。

AdChoices 圖示和重疊廣告

凡是顯示 Google 代管的個人化廣告的應用程式，都必須導入 Google 提供的 AdChoices 圖示和重疊。AdChoices (也稱為「為什麼會顯示這則廣告？」) 資訊公開功能，會向使用者說明系統放送特定廣告的原因，並提供隱私權保護方式的相關資訊。

詳情請參閱「系統向您顯示廣告的原因」一文。

本指南說明如何從廣告的 VAST XML 回應或 DAI 串流的中繼資料回應中，擷取必要資訊，以正確導入 AdChoices。

AdChoices 顯示規定

您的應用程式或網站必須符合下列標準，才能顯示 AdChoices 圖示：

AdChoices 圖示必須和提供該廣告的任何廣告重疊
AdChoices 圖示必須顯示在圖示資料中「X 位置」和「Y 位置」屬性所指定的位置，以及以密度獨立像素 (DP) 中寬度和高度屬性定義的大小。
AdChoices 圖示不得被其他廣告重疊或介面元素遮蓋。
在支援點擊支援或同等功能的平台上 (例如觸控或遠端選取) 上，AdChoices 圖示必須可供點擊。
在支援瀏覽器功能的平台上，按一下 AdChoices 圖示必須開啟瀏覽器分頁或視窗，其中包含「ClickThrough」或「click_data」屬性中指定的網址。
在不支援瀏覽器的平台上，按一下 AdChoices 圖示必須開啟強制回應重疊，並顯示「IconClickFallbackImage」或「click_fallback_images」屬性中指定的其中一種圖片。
在不支援瀏覽器的平台上，備用圖片必須以「IconClickFallbackImage」或「click_fallback_images」屬性中指定的大小顯示 (在密度獨立像素 (DP) 中)。

剖析 VAST XML 回應中的 AdChoices

處理 XML 廣告回應時，只有 VAST 3.0 以上版本支援 AdChoices。AdChoices 是以 VAST 圖示的形式導入。

VAST 4.2

如果您的 XML 廣告回應符合 VAST 4.2 標準，AdChoices 就會以 VAST 圖示的形式傳送。假如您的應用程式或網站完全支援 VAST 4.2 圖示 (VAST 4.2 標準第 3.11 節)，則 AdChoices 支援功能會直接正常運作。

如果您的應用程式不支援 VAST 4.2 圖示，您需要根據該標準，手動剖析 VAST 回應中程式名稱為「GoogleWhyThisAd」的圖示。如要在應用程式中進行其他測試，請使用這個 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」代碼，其中「program」屬性與 VAST 中所含的圖示相符。

為了完全支援 AdChoices，名為「GoogleWhyThisAd」的 IconFallbackImages 代碼必須與計畫名稱「GoogleWhyThisAd」相關聯，當使用者與圖示互動時，系統會顯示相關聯的備用圖片。

為了支援日後的 AdChoices 標準相關變更，強烈建議您為所有 VAST 圖示 (如果有的話) 加入備用圖片支援。您可以使用這個 VAST 3.0 XML 範例，在應用程式中進行其他測試。

IconFallbackImages 擴充功能結構

標記	屬性	說明
擴充功能	類型	針對這項擴充功能，類型一律包含 `IconClickFallbackImages` 值。
-IconClickFallbackImages	計畫	這項屬性一律與相關聯 VAST 3.0 圖示的程式屬性相符。
-IconClickFallbackImages		這個節點的結構與 IconClickFallbackImages 的 VAST 4.2 標準相符，但新增 `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 中剖析 AdChoices

使用 DAI API 時，AdChoices 詳細資料會透過 JSON 物件傳遞，該物件是透過要求傳送至中繼資料網址。

中繼資料 JSON 物件內含由 adID 索引鍵的廣告清單。每個廣告物件中都有一個圖示陣列，如果相關廣告使用 AdChoices，該陣列會包含 AdChoices 圖示。

JSON 圖示格式

JSON 圖示格式盡可能來自 VAST 4.2 圖示標準 (第 3.11 節) 的 1:1 轉譯。不過，為了支援更嚴格的 JSON 格式，有些屬性在必要時已變更名稱。

JSON 格式圖示

計畫	如果是 AdChoices 圖示，這個值一律會包含「GoogleWhyThisAd」字串。
x_position	圖示左上角相對於影片廣告素材左上角的水平位置，以像素為單位。這個欄位也接受回應式位置值「right」或「left」。
y_position	圖示左上角相對於影片廣告素材左上角的垂直位置，以像素為單位。這個欄位也接受「top」或「bottom」的回應式位置值。
寬度	圖示的寬度，以像素為單位。
高度	圖示的高度，以像素為單位。
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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}