Open Measurement を有効にする

プラットフォームを選択: HTML5 Android iOS

Android 用 IMA SDK には、 Interactive Advertising Bureau（IAB）が開発した業界標準の Open Measurement（OM）SDKが含まれています。この 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 が含まれています。

  • VAST 4.1 以降を使用する場合は、 VAST 4.1 仕様 に従って VAST で <AdVerifications> を配信するように広告を設定する必要があります。それ以外の場合は、<Extension type="AdVerifications"> を使用してください。

  • 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 が導入されています。これらのコントロールは、完全に透明なオーバーレイまたは小さなボタンである必要があります。動画コントロールに関連しない他のビューは登録しないでください。

登録する 登録しない
  • ユーザーのタップをキャプチャする透明なオーバーレイ
  • 一時的なボタン
    • 一時停止
    • Google Play
    • 全画面表示
    • キャスト/AirPlay
    • 閉じる
    • 進行状況/シーク
    • 再生に関連するその他の操作
  • ウォーターマーク
  • ポップアップ
  • ダイアログ
  • 一時的でないボタン
  • その他の不明瞭なビュー

次のサンプルコードは、広告表示コンテナに動画コントロールのオーバーレイを登録する方法を示しています。 

private void registerFriendlyObstructions(
    AdDisplayContainer adDisplayContainer, View transparentTapOverlay, View pauseButton) {
  ImaSdkFactory imaSdkFactory = ImaSdkFactory.getInstance();
  // Make sure to register all friendly obstructions before ad playback starts.
  FriendlyObstruction overlayObstruction =
      imaSdkFactory.createFriendlyObstruction(
          transparentTapOverlay,
          FriendlyObstructionPurpose.NOT_VISIBLE,
          "This overlay is transparent");
  FriendlyObstruction pauseButtonObstruction =
      imaSdkFactory.createFriendlyObstruction(
          pauseButton,
          FriendlyObstructionPurpose.VIDEO_CONTROLS,
          "This is the video player pause button");

  adDisplayContainer.registerFriendlyObstruction(overlayObstruction);
  adDisplayContainer.registerFriendlyObstruction(pauseButtonObstruction);
}

OpenMeasurementSnippets.java

これらの障害物は、次のメソッドを呼び出すことで削除できます。 

private void unregisterFriendlyObstructions(AdDisplayContainer adDisplayContainer) {
  adDisplayContainer.unregisterAllFriendlyObstructions();
}
OpenMeasurementSnippets.java