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 アイコンをクリックすると、 指定された画像の 1 つを "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 アイコンをサポートしていない場合は、アイコンを手動で解析する必要があります。 プログラム名が「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」タグが含まれています。ここで、「program」属性は VAST に含まれているアイコンと一致します。
AdChoices を完全にサポートするには、IconFallbackImages タグをプログラム名で指定します。 「GoogleWhyThisAd」アイコンとプログラム名を関連付ける必要がある "GoogleWhyThisAd": ユーザーがアイコンを操作すると、 表示されます。
今後の AdChoices 標準の変更に対応するため、利用可能な場合は、すべての VAST アイコンに代替画像のサポートを組み込むことを強くおすすめします。こちらの VAST 3.0 xml テストすることをおすすめします
IconFallbackImages 拡張機能の構造
タグ | 属性 | 説明 |
---|---|---|
内線番号 | type | この拡張機能の場合、type には常に値 IconClickFallbackImages が含まれます。 |
-IconClickFallbackImages | プログラム | この属性は、関連付けられた VAST 3.0 アイコンのプログラム属性と常に一致します。 |
このノードの構造は、program 属性が追加されていることを除き、IconClickFallbackImages の VAST 4.2 標準と一致します。 |
||
--IconClickFallbackImage | 幅 | 画像を表示する推奨の幅。 |
高さ | 画像を表示する推奨される高さ。 | |
---AltText | 画像のユーザー補助用の説明。 | |
---StaticResource | creativeType | 代替画像の MIME タイプ。 |
代替画像の 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)してください。ただし、より厳密な JSON をサポートするには、 形式のため、一部の属性名が必要に応じて変更されています。
JSON 形式のアイコン
プログラム | AdChoices アイコンの場合、この値には常に「GoogleWhyThisAd」という文字列が含まれます。 |
x_position | アイコンの左上隅の水平方向の位置(次の基準を基準とする) 動画クリエイティブの左上隅(ピクセル単位)です。このフィールドには、レスポンシブ ポジションの値「right」または「left」も指定できます。 |
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 | フォールバック イメージの 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"
}
...
]
...
},
...
}
...
}