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

AdChoices 圖示和重疊廣告

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

詳情請參閱為什麼會出現廣告。

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

AdChoices 算繪規定

為遵守 Google 的 AdChoices 圖示算繪規定，您的應用程式或網站必須符合下列標準：

AdChoices 圖示必須疊加在其所在的任何廣告上已提供
AdChoices 圖示必須顯示在「X」標示的位置位置」以及「Y 位置」屬性中的屬性，以及根據寬度和高度屬性定義的大小 (不受密度影響) 像素 (DP)。
AdChoices 圖示不得遭到其他廣告重疊或介面遮蓋元素。
在支援點擊或類似操作 (例如觸控或遙控器選取) 的平台上，AdChoices 圖示必須可點選。
在支援瀏覽器的平台上，點選 AdChoices 圖示時，必須開啟瀏覽器分頁或視窗，並載入「ClickThrough」或「click_data」屬性中指定的網址。
在未支援瀏覽器的平台上，點選 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」標記，其中的「program」屬性與 VAST 中所附加的圖示相符。

為完整支援 AdChoices，圖示中的 IconFallbackImages 標記含有方案名稱「Google 為什麼為什麼會顯示這則廣告？」必須與方案名稱的圖示建立關聯「GoogleWhyThisAd」因此只要使用者與圖示互動以便顯示相關聯的備用圖片

為支援日後 AdChoices 標準可能的變更，我們強烈建議您在可用時，為所有 VAST 圖示納入備用圖片支援功能。您可以使用這個 VAST 3.0 xml 範例，在應用程式中進行額外測試。

IconFallbackImages 擴充功能結構

標記	屬性	說明
延伸	類型	針對這項擴充功能，類型一律包含值 `IconClickFallbackImages`。
-IconClickFallbackImages	節目	這個屬性一律符合相關 VAST 的 Program 屬性 3.0 圖示。
-IconClickFallbackImages		此節點的結構符合 VAST 4.2 標準的 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 剖析 AdChoices

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

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

JSON 圖示格式

JSON 圖示格式是來自 VAST 4.2 圖示的 1:1 轉譯內容標準 (第 3.11 節)，盡可能提供。不過，為了支援更嚴格的 JSON 格式，我們在必要時會變更部分屬性的名稱。

圖示 JSON 格式

節目	對於 AdChoices 圖示，這個值一律會包含「GoogleWhyThisAd」字串。
x_position	圖示左上角的水平位置 (相對於以像素為單位。這個欄位也接受回應式位置值「右」或「左」。
y_position	圖示左上角的垂直位置，相對於影片廣告素材的左上角，以像素為單位。這個欄位也接受回應式位置值「頂端」或「底部」。
寬度	圖示的寬度，以像素為單位。
身高	圖示的高度，以像素為單位。
creative_type	圖示所提供圖片的 mimetype。預設為「image/png」。
資源	用於擷取 AdChoices 圖示的網址。
alt_text	AdChoices 圖示的替代文字。
click_data	包含 `click_data.url` 屬性的物件代表觀眾點選 YouTube 網站中的 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}