このページは Cloud Translation API によって翻訳されました。

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

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

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

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

AdChoices のレンダリングの要件

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

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

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

XML 広告レスポンスを使用する場合、AdChoices は VAST バージョン 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 アイコンをサポートしていない場合は、その標準に基づいて、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] 拡張機能のサポートを実装する必要があります。この拡張機能には、一連の「IconFallbackImages」タグが含まれています。ここで、「program」属性は VAST に含まれているアイコンと一致します。

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

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

IconFallbackImages 拡張機能の構造

タグ	属性	説明
拡張機能	type	この拡張機能の場合、type には常に値 `IconClickFallbackImages` が含まれます。
-IconClickFallbackImages	プログラム	この属性は、関連付けられた VAST 3.0 アイコンのプログラム属性と常に一致します。
-IconClickFallbackImages		このノードの構造は、`program` 属性が追加されていることを除き、IconClickFallbackImages の VAST 4.2 標準と一致します。
--IconClickFallbackImage	幅	画像を表示する推奨の幅。
--IconClickFallbackImage	高さ	画像を表示する推奨の高さ。
---AltText		画像のユーザー補助用の説明。
---StaticResource	creativeType	フォールバックイメージの mimetype。
---StaticResource		代替画像の 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 オブジェクトを介して渡されます。

Metadata 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」です。
resource	AdChoices アイコンを取得する URL。
alt_text	AdChoices アイコンに表示する代替テキスト。
click_data	ウェブブラウジングをサポートするプラットフォームで視聴者が AdChoices アイコンをクリックした場合に誘導する URL を表すプロパティ `click_data.url` を含むオブジェクト。
click_fallback_images	ウェブブラウジングをサポートしていないプラットフォームで AdChoices アイコンをクリックした視聴者に表示する画像オブジェクトの配列。

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

幅	フォールバック画像の幅（ピクセル単位）。
高さ	フォールバック画像の高さ（ピクセル単位）。
creative_type	フォールバックイメージの mimetype。デフォルトは「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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}