AdChoices アイコンとオーバーレイ

Google がホストするパーソナライズド広告を表示するすべてのアプリは、Google から提供された場合は、AdChoices アイコンとオーバーレイを実装する必要があります。AdChoices（「広告の表示について」とも呼ばれます）は、個別の広告が表示されている理由をユーザーに説明し、ユーザーのプライバシーが保護される仕組みについての情報を提供する透明性を確保するための機能です。

詳しくは、広告が表示される理由をご覧ください。

このガイドでは、広告の VAST XML レスポンスまたは DAI ストリームのメタデータ レスポンスから、AdChoices を適切に実装するために必要な情報を抽出する方法について説明します。

AdChoices のレンダリングに関する要件

AdChoices アイコンのレンダリングに関する Google の要件に準拠するには、アプリまたはウェブサイトが次の基準を満たしている必要があります。

  1. AdChoices アイコンは、提供された広告の上に重ねて表示する必要があります。
  2. AdChoices アイコンは、アイコンデータに含まれる「X location」プロパティと「Y location」プロパティで示される位置に、幅と高さのプロパティで定義されるサイズで（密度非依存ピクセル（DP）単位で）表示する必要があります。
  3. AdChoices アイコンは、他の広告オーバーレイやインターフェース要素で隠れないようにする必要があります。
  4. クリック サポートまたは同等の機能（タッチやリモコン選択など）を備えたプラットフォームでは、AdChoices アイコンをクリック可能にする必要があります。
  5. ブラウザをサポートするプラットフォームでは、AdChoices アイコンをクリックすると、[ClickThrough] プロパティまたは [click_data] プロパティで指定された URL を含むブラウザタブまたはウィンドウが開く必要があります。
  6. ブラウザをサポートしていないプラットフォームでは、AdChoices アイコンのクリック時にモーダル オーバーレイを開き、「IconClickFallbackImage」または「click_fallback_images」プロパティで指定された画像のいずれかを表示する必要があります。
  7. ブラウザをサポートしていないプラットフォームでは、代替画像は「IconClickFallbackImage」または「click_fallback_images」プロパティで指定されたサイズ（密度非依存ピクセル（DP））で表示する必要があります。

VAST XML レスポンスから AdChoices を解析する

XML 広告レスポンスを使用する場合、AdChoices は VAST バージョン 3.0 以降でのみサポートされます。AdChoices は VAST の Icon として実装されます。

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 アイコン標準を完全にサポートしており、プラットフォームがアイコンのリンク先 URL に移動して表示できる場合、AdChoices のサポートにこれ以上の作業は必要ありません。

プラットフォームでクリックスルー URL に移動して表示できない場合（主にウェブ ブラウザが統合されていないデバイスに該当します）、IconFallbackImages 拡張機能のサポートを実装する必要があります。この拡張機能には、VAST に含まれるアイコンと一致する「program」属性を持つ「IconFallbackImages」タグのセットが含まれています。

AdChoices を完全にサポートするには、プログラム名「GoogleWhyThisAd」の IconFallbackImages タグを、プログラム名「GoogleWhyThisAd」の Icon に関連付ける必要があります。これにより、ユーザーがアイコンを操作したときに、関連付けられた代替画像が表示されます。

AdChoices 標準の将来的な変更に対応するため、可能な場合は、すべての VAST アイコンにフォールバック画像サポートを組み込むことを強くおすすめします。このサンプル VAST 3.0 XML を使用して、アプリで追加のテストを行うことができます。

IconFallbackImages 拡張機能の構造

タグ 属性 説明
拡張機能 type この拡張機能の場合、型には常に値 IconClickFallbackImages が含まれます。
-IconClickFallbackImages プログラム この属性は、関連付けられた VAST 3.0 アイコンのプログラム属性と常に一致します。
このノードの構造は、program 属性が追加されている点を除き、IconClickFallbackImages の VAST 4.2 標準に準拠しています。
--IconClickFallbackImage width 画像を表示する際の推奨される幅。
height 画像を表示する際の推奨される高さ。
---AltText 画像の説明（ユーザー補助対応）。
---StaticResource creativeType フォールバック イメージの MIME タイプ。
代替画像の URL を含む 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 の詳細は、メタデータ URL へのリクエストによって返される 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」も使用できます。
width アイコンの幅（ピクセル単位）。
height アイコンの高さ（ピクセル単位）。
creative_type アイコン用に提供された画像の MIME タイプ。デフォルトは「image/png」です。
resource AdChoices アイコンを取得するための URL。
alt_text AdChoices アイコンに表示する代替テキスト。
click_data ウェブ閲覧をサポートするプラットフォームで視聴者が AdChoices アイコンをクリックした場合に、視聴者を誘導する URL を表すプロパティ click_data.url を含むオブジェクト。
click_fallback_images ウェブ閲覧をサポートしていないプラットフォームで AdChoices アイコンをクリックしたユーザーに表示する画像オブジェクトの配列。

フォールバック画像の JSON 形式

width フォールバック画像の幅（ピクセル単位）。
height フォールバック画像の高さ（ピクセル単位）。
creative_type フォールバック イメージの MIME タイプ。デフォルトは「image/png」です。
resource 代替画像を取得するための URL。
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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}