動画向け AdSense やゲーム向け AdSense で使用するタグの構造は、コンテンツ向け AdSense と大きく異なります。動画向け AdSense とゲーム向け AdSense では Interactive Media Ads（IMA）タグが必要となり、Google IMA SDK の統合に対応した動画プレーヤーやゲーム ランチャー、あるいは VAST および VPAID に準拠している動画プレーヤーやゲーム ランチャー（IMA アダプタなど）から呼び出された場合のみ広告が返されます。
IMA 広告タグを作成する場合は、通常は動画向け AdSense のタグ作成ツールを使用します。IMA 広告タグで設定できる条件については、下記のリストをご覧ください。動画向け AdSense の広告タグの必須パラメータは多くありませんが、チャネル ID や最大 / 最小の広告再生時間、言語などのオプション パラメータを追加すれば目的の広告レスポンスを得ることができます。
| IMA 広告タグのパラメータ | 必須パラメータ |
|---|---|
| ad_type | ○ |
| client | ○ |
| description_url | ○（エンコードされた URL） |
| channel | ×（該当する場合は推奨） |
| adsafe | ×（推奨） |
| videoad_start_delay | ×（推奨） |
| hl | ×（推奨） |
| max_ad_duration | ×（推奨） |
| min_ad_duration | ×（推奨） |
| sdmax | ×（推奨） |
| adtest | × |
| cust_age | × |
| cust_gender | × |
| host | × |
| h_ch | × |
| overlay | × |
基本 URL
下記の URL は、次に示すすべてのクエリ パラメータの基本 URL となります。
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
（文字列）広告の種類を指定します。アンダースコア（_）で連結する必要があります。
値
- video: すべての動画広告。standardvideo_skippablevideo_bumpervideo に相当します。
- skippablevideo: スキップ可能な動画広告のみ。スキップ可能な広告を受け取るには、サイト運営者様からの追加の許可が必要になる場合があります。
- bumpervideo: スキップ不可能な 6 秒間の動画広告を許可。
- standardvideo: スキップ不可能な動画広告のみ。
- image: 指定したノンリニア スロットのサイズ内に収まるイメージ広告を許可。
- text: テキスト広告を許可。
例
- &ad_type=video_text_image
- すべてのフォーマットが許可。
- &ad_type=video_text
- 動画フォーマットとテキスト広告が許可されます。
- &ad_type=standardvideo_image
- スキップ不可の標準の動画広告とイメージ広告のみ許可されます。
client
（文字列）サイト運営者様のウェブ プロパティ ID です。
例: &client=ca-video-afvtest
description_url
（文字列）動画について記述した HTML ページのフル URL（URL エンコード済）です。description_url 値は、サーバー側のプログラミング言語を使用して動的に、またはオンライン URL エンコード ツールを使用して手動で作成できます。
例: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
URL の例
次の URL は、最低限必要なパラメータで構成される URL の一例です。 https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2
サイト運営者「ca-video-afvtest」の動画広告をリクエストします。動画広告の descriptionURL は「http:// myurl.com/page?key=value&key2=value2」になります。
channel
（文字列）AdSense のターゲット設定やレポート作成に使用するチャネルをプラス記号で区切って指定します。1 回の広告リクエストで最大 5 つのチャネルを渡すことができます。
例: &channel=mychannel+otherchannel+targetingchannel
adsafe
（文字列）表示する広告のフィルタリング設定を指定します。デフォルト値は「high」です。
値:
- high --（デフォルト値）一般向けの広告が配信されます。成人向け広告や、アダルト コンテンツを含む広告は配信されません。
- medium -- 一般向け広告と成人向け広告（ギャンブルや処方薬に関連する広告など）が配信されます。アダルト コンテンツを含む広告は配信されません。
例: &adsafe=high
adtest
（文字列）テスト実装であるかどうかを指定します。値は「on」または「off」となり、「on」に設定すると、表示回数やクリック数は AFV アカウントに記録されません。テスト中はこのパラメータを使用する必要があります。あえて設定しなければ、デフォルト値は「off」になります。
値:
- off --（デフォルト値）すべての広告が通常どおり記録されます。実際の配信ではこの設定を使用する必要があります。
- on -- この設定では、テスト中に使用した広告の表示回数やクリック数は記録されません。
例: &adtest=on
videoad_start_delay
（整数）動画のどの時点で広告を再生するかを示すミリ秒数です。デフォルトはミッドロール値（具体的には「1」）です。
値:
- -1 -- コンテンツの最後にポストロール広告を再生します。
- 0 -- コンテンツが再生される前にプレロール広告を再生します。
- 任意の正の整数 -- コンテンツの再生から指定のミリ秒数後にミッドロール広告を再生します。
例:
- &videoad_start_delay=-1 -- ポストロール広告を再生します。
- &videoad_start_delay=15000 -- コンテンツが再生されてから 15 秒後に広告を再生します。
cust_age
（整数）ユーザーの年齢を指定します。正確な年齢だけでなく、com.google.ads.ima.api.Demographics クラスで定義される年齢層もサポートされています。
例:
- &cust_age=1001 -- 18～24 歳
- &cust_age=38 -- 38 歳のみ
cust_gender
（整数）com.google.ads.ima.api.Demographics クラスの定義に従ってユーザーの性別を指定します。
値:
- 1 -- 男性
- 2 -- 女性
例:
- &cust_gender=1 -- 男性
- &cust_gender=2 -- 女性
host
（文字列）三者間の収益分配に使用するホスト ID です。
例: &host=ca-host-test -- 収益をこのホストに分配します。
h_ch
（文字列）ホストの AdSense ターゲット設定 / レポート作成用チャネル ID をプラス記号で区切って指定します。
例: &h_ch=channel1+channel2+channel3 -- ホスト用のこれらのチャネルを追加でレポート、ターゲット設定します。
ht_id
（数字）サイト運営者様とホストの間での収益分配レベルを指定する階層 ID です。
例: &ht_id=2 -- 階層 2 のホスト。
hl
（文字列）広告のリクエストに使用する言語コードです。ISO 639-1（2 文字）または ISO 639-2（3 文字）のコードを使用できます。有効なコードのリストをご覧ください。
例:
- &hl=en -- 英語
- &hl=es -- スペイン語
max_ad_duration
（整数）動画の最大再生時間をミリ秒で指定します。設定しない場合、デフォルト値は 100 秒になります。
例: &max_ad_duration=30000 -- スキップ不可の広告の最大再生時間は 30 秒になります。
min_ad_duration
（整数）動画の最小再生時間をミリ秒で指定します。設定しない場合、デフォルト値は 0 秒になります。
例:
- &min_ad_duration=15000 -- スキップ不可能な広告の再生時間は 15 秒以上になります。
- &min_ad_duration=0 -- 再生時間は max_ad_duration の値によってのみ制限されます。
sdmax
（整数）スキップ可能な動画の最大再生時間をミリ秒で指定します。設定しない場合、デフォルトでは制限されません。
例: &sdmax=120000 -- スキップ可能な広告の最大再生時間は 2 分になります。
overlay
（整数）リクエストされるオーバーレイのサイズを、ノンリニアで下部 3 分の 1 の範囲に表示されるオーバーレイのみに制限するために使用します。デフォルトでは制限は設定されません。
例:
- &overlay=1 -- 下部 3 分の 1 の範囲に表示されるオーバーレイのサイズのみが、広告リクエストで有効になります。フルスロットのオーバーレイはリクエストされなくなります。
- &overlay=0 -- デフォルト値です。オーバーレイのサイズの制限は設定されません。オーバーレイのサイズは adsRequest.nonLinearAdSlotWidth と adsRequest.nonLinearAdSlotHeight に基づいて決定されます。
