コンパニオン広告のサポートを追加

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

このガイドは、Android IMA 実装にコンパニオン広告を追加することに関心があるパブリッシャー様を対象としています。

前提条件

  • IMA SDK が統合された Android アプリ。SDK が統合されたアプリがまだない場合は、BasicExample をご覧ください。アプリに IMA SDK を実装する際にサポートが必要な場合は、IMA SDK を設定するをご覧ください。
  • コンパニオン広告を返すように設定された広告タグ。サンプルが必要な場合は、よくある質問をご覧ください。

アプリにコンパニオン広告を追加する

コンパニオン広告スロットを追加して、アプリにコンパニオン広告を表示する手順は次のとおりです。

コンパニオンを表示する ViewGroup を作成する

コンパニオンをリクエストする前に、レイアウトにコンパニオン用のスペースを作成する必要があります。レイアウト XML に ViewGroup 要素を追加します。この例では LinearLayout を使用しています。後のステップで、この要素への参照を AdDisplayContainer に渡します。

BasicExample アプリに統合する場合は、activity_my.xml ファイルの videoPlayerContainer の下に追加します。

<LinearLayout
    android:id="@+id/companionAdSlot"
    android:layout_width="match_parent"
    android:layout_height="250dp"
    android:layout_gravity="center_horizontal"
    android:gravity="center"
    android:orientation="vertical"
    android:textAlignment="center" />

CompanionAdSlot を作成する

次のステップでは、CompanionAdSlot オブジェクトを作成し、ArrayList<CompanionAdSlot> インスタンスに追加します。AdDisplayContainer インターフェースはコンパニオン広告スロットのリストを受け取るため、複数のコンパニオン広告を一度に表示できます。CompanionAdSlot オブジェクトを作成するには、ImaSdkFactory クラスのインスタンスを作成する必要があります。

public void createCompanionAdSlot(ViewGroup companionViewGroup) {
  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);
}

アプリに表示するコンパニオンのサイズごとに、コンパニオン広告スロットを作成します。IMA SDK は、VAST レスポンスから、ビューの高さと幅に一致するサイズのコンパニオンをコンパニオン広告スロットに挿入します。IMA SDK は、Fluid サイズのコンパニオンの使用にも対応しています。companionAdSlots を作成したら、AdsLoader に追加します。次の例は、Exoplayer-IMA 拡張機能を使用している場合と、この拡張機能を使用しない他の IMA 実装を使用している場合で、この処理を行う方法を示しています。

Exoplayer-IMA 拡張機能

public void setCompanionAdSlotExoPlayer(
    Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
  ImaAdsLoader adsLoader =
      new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}

その他の実装

public void setCompanionAdSlot(
    AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
  adDisplayContainer.setCompanionSlots(companionAdSlots);
}

これで操作は完了です。これで、アプリにコンパニオン広告が表示されるようになりました。

Fluid コンパニオン広告を表示する

IMA は、Fluid サイズのコンパニオン広告に対応しています。これらのコンパニオン広告は、広告スロットのサイズに合わせてサイズを変更できます。親ビューの幅の 100% を占め、コンパニオンのコンテンツに合わせて高さが変更されます。これらは、アド マネージャーで Fluid コンパニオン サイズを使用して設定されます。この値を設定する場所については、次の画像をご覧ください。

アド マネージャーのコンパニオン広告の設定を示す画像。コンパニオン サイズのオプションをハイライト表示します。

流動的なコンパニオン向けに Android アプリを更新する

流動コンパニオン スロットを宣言するには、CompanionAdSlot.setSize() メソッドを更新して、両方のパラメータとして CompanionAdSlot.FLUID_SIZE を受け取るようにします。

companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);

よくある質問

ガイドに沿って操作しましたが、コンパニオン広告が表示されません。どうすればよいですか?
まず、タグが実際にコンパニオンを返していることを確認します。これを行うには、ウェブブラウザでタグを開き、<CompanionAds> タグを探します。この場合は、返されるコンパニオンのサイズが、CompanionAdSlot オブジェクトに渡すサイズと同じであることを確認してください。
このガイドに沿って設定すると、コンパニオン広告スロットはどのように表示されますか?

次の画像は BasicExample から作成されたもので、上部でコンテンツ動画が再生され、下部にコンパニオン広告が表示されています。

IMA Android コンパニオン広告のサンプル画像。