Android 用 IMA SDK には、
Interactive Advertising Bureau(IAB)が開発した業界標準の
Open Measurement(OM)SDKが含まれています。これにより、サードパーティの
視認性と検証の測定が可能になります。Android 用 IMA SDK を使用すると、含まれている OM SDK が VAST 広告タグ内の <AdVerifications> タグを自動的に解析し、OMID API を使用して指定された測定ベンダーに視認性データを送信します。IMA SDK は、OM SDK v1.6、VAST 2 以降の GAM
AdVerifications 拡張機能、VAST 4 以降の AdVerifications ノードをサポートしています。Open
Measurement を活用するには、次の点に注意してください。
Open Measurement を使用するには、Android 用 IMA SDK のバージョン 3.11.0 以降が必要です。 ただし、このガイドのサンプルは SDK の最新バージョン向けに設計されており、バージョン 3.16.5 で導入された API が含まれています。
AdDisplayContainerをオーバーレイ(透明または不透明)で覆わないでください。これらは OM SDK によって障害物としてフラグが立てられ、視認性が低下します。
前提条件
- 広告がアド マネージャーで配信される場合は、アド マネージャー ネットワークで視認性データの提供元を 設定し、 その視認性データの提供元を広告申込情報に割り当てます。
テスト
IMA SDK を使用して Open Measurement をテストするには、OM SDK をサポートする IMA のバージョンと テスト広告タグを使用します。
VAST レスポンスに <AdVerifications> が返されます。
動画コントロールのオーバーレイの障害物を登録する
一時停止ボタンやプログレスバーなどの動画コントロールは、ユーザーに重要な再生情報と操作を提供します。モバイルでは、タップの精度が低いことやユーザーの期待に応えるために、メディア要素の上にタッチしやすい大きなコントロールをレンダリングすることが一般的になっています。これらのコントロールは通常、ユーザーがタップするとフェードイン / フェードアウトし、再生時間の大部分では表示されません。
動画コントロールをオーバーレイする例については、YouTube アプリのレンダリング コントロールの次の画像をご覧ください。

IMA SDK を使用する場合、ほとんどのパブリッシャーは、広告表示コンテナの上にほとんど透明なビューを追加して、これらのコントロールを実装しています。通常、コントロールは、基盤となる動画プレーヤーを完全に覆うこのビューの子要素です。この透明なオーバーレイは、タップ イベントをキャプチャし、タップ時にコントロールをユーザーにレンダリングするために使用されます。
Open Measurement 測定 SDK を使用して広告の視認性が計算されると、メディア要素をオーバーレイするすべてのビューが障害物と見なされ、視認可能率が低下します。透明なタップ オーバーレイが広告表示コンテナ全体の上にある場合、広告枠が完全に視認できないと宣言される可能性があります。
Open Measurement SDK では、動画コントロールは、ユーザー エクスペリエンスに不可欠な「フレンドリー」な障害物と見なされます。フレンドリーとして登録されると、これらのコントロールは広告の視認性測定から除外されます。
IAB と MRC のサポートにより、IMA SDK には、これらのオーバーレイを Open Measurement 測定 SDK に登録するための API が導入されています。これらのコントロールは、完全に透明なオーバーレイまたは小さなボタンである必要があります。動画コントロールに関連しない他のビューは登録しないでください。
| 登録する | 登録しない |
|---|---|
|
|
次のサンプルコードは、広告表示コンテナに動画コントロールのオーバーレイを登録する方法を示しています。
myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);
myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the
// elements you want to register as video controls overlays.
// Make sure to register before ad playback starts.
overlayObstruction = ImaSdkFactory.createFriendlyObstruction(
myTransparentTapOverlay,
FriendlyObstructionPurpose.NOT_VISIBLE,
"This overlay is transparent"
);
pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(
myPauseButton,
FriendlyObstructionPurpose.VIDEO_CONTROLS,
"This is the video player pause button"
);
displayContainer.registerFriendlyObstruction(overlayObstruction);
displayContainer.registerFriendlyObstruction(pauseButtonObstruction);
これらの障害物は、次のメソッドを呼び出すことで削除できます。
displayContainer.unregisterAllFriendlyObstructions();