広告の終わりでコンテンツの終了を通知する
コンテンツの終了の通知は、動画が終わったときだけのものです。IMA が広告にも同じプレーヤーを使うことがあるため、広告の終わりで通知すると SDK が混乱します。
導入ガイド
Mid-roll video ads
コンテンツの途中に、CM のように入る動画広告です。終わると、動画は止まったところから再開します。
1分でわかる
テレビのサッカー中継を思い浮かべてください。ハーフタイムにコマーシャルが入り、そのあと試合が再開します。ミッドロールは、サイトの動画のコマーシャル休憩です。動画は決めた場所で止まり、同じプレーヤー内で広告が1つ以上流れ、止まったところからそのまま再開します。広告が続けて何本か入るとき、Google はこのまとまりを広告ポッド(英語で ad pod)と呼びます。コマーシャルのひとかたまりのことです。
ブレークの時間は誰が決めるのでしょうか。Ad Manager では、動画広告ルール(ad rules)で決めます。広告が動画のどこで、どのように表示されるかを指定するものです。60秒、120秒、180秒のように決まった時間を選んだり、一定の秒数ごとの間隔を指定したりできます。キューポイントも使えます。これは動画の中に付ける小さな印で、シーンの終わりなど、停止するのに最適な場所を示します。プレーヤーはこの計画を VMAP レスポンスで受け取ります。これはブレークの番組表のようなもので、IMA SDK が各ブレークを適切なタイミングで再生します。
重要な注意点がいくつかあります。動画広告ルールは、高度な動画契約がある Google Ad Manager 360 にしかありません。ミッドロールを動かすには、Ad Manager が動画の長さと停止ポイントの位置を知っている必要があります。動画を Ad Manager に登録(コンテンツのインジェストといいます)して、タグで cmsid と vid のコードを送る方法があります。登録しない場合は、動画の長さを秒単位(vid_d)で、停止ポイントの一覧をミリ秒単位(allcues)で送ることもできます。ミッドロールを使うには、長さを送る必要があると Google は説明しています。
IMA は、動画が何秒目にいるかも知る必要があります。そのため、動画要素そのものを IMA に渡し、コンテンツが始まる前に広告マネージャーを起動します。IMA はそこから時間を数え始めるからです。ミッドロールは、視聴者が長く見続ける動画に向いています。見る人のことを常に考えましょう。Ad Manager では、各中断枠に入る広告数、各広告の最大長、中断枠ごと・動画ごと、またはその両方のフリークエンシー キャップを制限できます。
手順
実装例
<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<script>
// Vídeo de 10 minutos (vid_d=600)
// com intervalos em 2 e 5 minutos (allcues em ms)
var adsRequest = new google.ima.AdsRequest();
adsRequest.adTagUrl = 'https://pubads.g.doubleclick.net/gampad/ads?' +
'iu=/1234567/exemplo&sz=640x480&env=vp&gdfp_req=1' +
'&ad_rule=1&output=vmap&vid_d=600&allcues=120000,300000' +
'&unviewed_position_start=1&vpa=click&vpmute=0&plcmt=1' +
'&description_url=https%3A%2F%2Fwww.exemplo.com%2Fvideo&correlator=';
adsRequest.linearAdSlotWidth = 640;
adsRequest.linearAdSlotHeight = 400;
adsLoader.requestAds(adsRequest);
adsLoader.addEventListener(
google.ima.AdsManagerLoadedEvent.Type.ADS_MANAGER_LOADED,
function (e) {
// O próprio <video> informa o tempo atual (currentTime) ao IMA
adsManager = e.getAdsManager(video);
adsManager.addEventListener(
google.ima.AdEvent.Type.CONTENT_PAUSE_REQUESTED,
function () { video.pause(); });
adsManager.addEventListener(
google.ima.AdEvent.Type.CONTENT_RESUME_REQUESTED,
function () { video.play(); });
});
// No clique de play: init() antes de tocar o conteúdo
// adDisplayContainer.initialize();
// adsManager.init(640, 360, google.ima.ViewMode.NORMAL);
// adsManager.start();
</script>Googleのガイダンス
ヒント
注意
コンテンツの終了の通知は、動画が終わったときだけのものです。IMA が広告にも同じプレーヤーを使うことがあるため、広告の終わりで通知すると SDK が混乱します。
IMA が時間の追跡を始めるのは、広告マネージャーが初期化されたときです。そのため Google は、コンテンツを再生する前に必ず初期化するよう案内しています。
お使いのプレーヤーがバーのドラッグ中に時間を更新する場合は、正しい時間を知らせる独自のオブジェクトを IMA に渡すことを Google は推奨しています。
動画広告ルールは、高度な動画契約のある Google Ad Manager 360 だけの機能です。通常のアカウントには、このオプションは表示されません。
いいえ。広告ルールを使うミッドロールでは、コンテンツのインジェストは必須ではないと Google は説明しています。登録しない場合は、タグで長さ(vid_d)と停止ポイント(allcues)を送ります。
動画の途中にある小さな印で、そこにブレークを入れられることを示します。タグでは、キューポイントをミリ秒単位でカンマ区切りにして、10000,20000 のように指定します。
Google によると、Ad Manager がミッドロールを返すには広告ルールが必要で、これは Ad Manager 360 の機能です。動画の長さ(vid_d)も送る必要があります。
広告ポッドの「最大広告数」で決めます。「最大数なし」は「最適化されたポッド」にしかなく、こちらでは中断枠全体の長さも制限できます。
ライブラリ
このページの内容はすべて Google の公式ドキュメントに基づいています。原文で直接確認できます。
監査は、何もクリックせずに訪問者としてサイトを読み取り、修正すべき点を表示します。