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

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

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

詳しくは、広告。

このガイドでは、Google Cloud Storage バケットなどの広告の VAST XML レスポンスまたは DAI ストリームの示されます。

AdChoices レンダリングの要件

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

AdChoices アイコンは、対象となるすべての広告の上に重ねて表示する必要があります。提供
AdChoices アイコンは、「X」で示される位置に表示する必要があります。 location「Y location」アイコンデータに含まれるプロパティと、幅と高さのプロパティで定義されるサイズ（密度非依存）ピクセル（DP）。
AdChoices アイコンは、他の広告オーバーレイやインターフェースによって隠れてはなりませんあります。
クリックに対応している、または同等の機能（タップ操作、リモート選択など）を利用できるプラットフォームの場合: AdChoices アイコンはクリック可能でなければなりません。
ブラウザがサポートされているプラットフォームでは、AdChoices アイコンをクリックすると、「ClickThrough」で指定された URL が設定されたブラウザタブまたはウィンドウまたは「click_data」プロパティです。
ブラウザに対応していないプラットフォームでは、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 アイコンをサポートしていない場合は、アイコンを手動で解析する必要があります。プログラム名が「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 Standard の場合、AdChoices は VAST アイコンとカスタムの VAST 拡張機能の組み合わせとして配信されます。お使いのアプリやウェブサイトが VAST 3.0 アイコン標準に完全に対応していて、プラットフォームがアイコンのリンク先 URL に移動して表示できる、AdChoices サポート特に作業は必要ありません。

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

AdChoices を完全にサポートするには、IconFallbackImages タグをプログラム名で指定します。「GoogleWhyThisAd」アイコンとプログラム名を関連付ける必要がある "GoogleWhyThisAd": ユーザーがアイコンを操作すると、表示されます。

AdChoices 標準が今後変更される可能性もあるため、Google ではすべての VAST アイコンに代替画像のサポートを組み込むことを推奨できます。こちらの VAST 3.0 XML テストすることをおすすめします

IconFallbackImages 拡張機能の構造

タグ	属性	説明
内線番号	type	この拡張機能の場合、タイプには常に値が含まれます。 `IconClickFallbackImages`。
-IconClickFallbackImages	プログラム	この属性は常に、関連付けられている VAST のプログラム属性と一致します 3.0 アイコン。
-IconClickFallbackImages		このノードの構造は IconClickFallbackImages（`program` の追加を除く）属性です。
--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 の詳細は、リクエストによって返される JSON オブジェクトを介してメタデータに URL。

Metadata JSON オブジェクトには、adID をキーとする広告のリストが含まれます。各広告オブジェクトは icon 配列です。問題の広告で 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}