このページは 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 アイコンをクリックすると、指定された画像の 1 つを "IconClickFallbackImage"または「click_fallback_images」プロパティです。
ブラウザがサポートされていないプラットフォームでは、代替画像は「IconClickFallbackImage」または「click_fallback_images」プロパティで指定されたサイズ（密度非依存ピクセル（DP）単位）で表示する必要があります。

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

XML 広告レスポンスを使用する場合、AdChoices は VAST でのみサポートされます。使用できます。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 の詳細は、メタデータに対するリクエストによって返される JSON オブジェクトを介して URL。

Metadata JSON オブジェクトには、adID をキーとする広告のリストが含まれています。各広告オブジェクトには、アイコンの配列があります。問題の広告で AdChoices が使用されている場合は、 AdChoices アイコンはこの配列に含まれています。

JSON アイコン形式

JSON アイコン形式は、VAST 4.2 アイコン標準（セクション 3.11）してください。ただし、より厳格な JSON 形式をサポートするために、一部の属性の名前が変更されています。

アイコンの JSON 形式

プログラム	AdChoices アイコンの場合、この値には常に文字列「GoogleWhyThisAd」が含まれます。
x_position	動画クリエイティブの左上隅を基準とした、アイコンの左上隅の水平位置（ピクセル単位）。このフィールドにはレスポンシブな位置の値「right」クリックします。
y_position	アイコンの左上隅の垂直位置（動画クリエイティブの左上隅（ピクセル単位）です。このフィールドにはレスポンシブな位置の値「top」示されます
幅	アイコンの幅（ピクセル単位）。
高さ	アイコンの高さ（ピクセル単位）。
creative_type	アイコンに指定した画像の MIME タイプ。デフォルトは「image/png」です。
resource	AdChoices アイコンを取得するための URL。
alt_text	AdChoices アイコン用にレンダリングする代替テキスト。
click_data	プロパティ `click_data.url` を含むオブジェクト。は、ユーザーが AdChoices アイコンをクリックした場合にユーザーに表示される URL を表します。ウェブブラウジングをサポートするプラットフォームです。
click_fallback_images	ウェブブラウジングをサポートしていないプラットフォームで AdChoices アイコンをクリックした視聴者に表示する画像オブジェクトの配列。

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

幅	代替画像の幅（ピクセル単位）。
身長	代替画像の高さ（ピクセル単位）。
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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}