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

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

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

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

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

AdChoices レンダリングの要件

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

AdChoices アイコンは、アイコンが表示されているすべての広告に重ねて表示する必要があります。
AdChoices アイコンは、アイコンデータに含まれる「X 位置」プロパティと「Y 位置」プロパティで指定される位置、および幅と高さのプロパティで定義されたサイズで、密度非依存ピクセル（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	この拡張機能では、タイプには常に値 `IconClickFallbackImages` が含まれます。
-IconClickFallbackImages	プログラム	この属性は、関連する VAST 3.0 アイコンのプログラム属性と常に一致します。
-IconClickFallbackImages		このノードの構造は、`program` 属性の追加を除き、IconClickFallbackImages の VAST 4.2 標準と同じです。
--IconClickFallbackImage	幅	画像を表示する推奨の幅。
--IconClickFallbackImage	高さ	画像を表示する推奨の高さ。
---AltText		画像のアクセス可能な説明。
---StaticResource	creativeType	代替画像の MIME タイプ。
---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 オブジェクトを通じて渡されます。

メタデータ 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 アイコンを取得するための URL。
alt_text	AdChoices アイコン用にレンダリングする代替テキスト。
click_data	プロパティ `click_data.url` を含むオブジェクト。このプロパティは、ウェブブラウジングをサポートするプラットフォームで AdChoices アイコンをクリックした閲覧者の誘導先となる URL を表します。
click_fallback_images	ウェブブラウジングに対応していないプラットフォームで AdChoices アイコンをクリックする視聴者に表示する画像オブジェクトの配列。

代替画像の JSON 形式

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