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

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

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

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

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

AdChoices のレンダリングの要件

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

AdChoices アイコンは、提供されている広告にオーバーレイとして表示する必要があります。
AdChoices アイコンは、「X」で示される位置に表示する必要があります。 location「Y location」アイコンデータに含まれるプロパティと、幅と高さのプロパティで定義されたサイズ（密度非依存）ピクセル（DP）。
AdChoices アイコンは、他の広告オーバーレイやインターフェースによって隠れてはなりませんあります。
クリックまたは同等の操作（タップやリモコンによる選択など）がサポートされているプラットフォームでは、AdChoices アイコンがクリック可能である必要があります。
ブラウザがサポートされているプラットフォームでは、AdChoices アイコンをクリックすると、「ClickThrough」で指定された URL が設定されたブラウザタブまたはウィンドウまたは "click_data"プロパティです。
ブラウザがサポートされていないプラットフォームでは、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 をキーとする広告のリストが含まれています。各広告オブジェクトは icon 配列です。該当する広告で 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	プロパティ `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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}