隨播廣告

本指南適用於想為影片新增隨播廣告的廣告客戶 導入 Android IMA

必要條件

  • 已整合 IMA SDK 的 Android 應用程式。如果您符合以下情況，請參閱 BasicExample 尚未有整合 SDK 的應用程式。
  • 設定為傳回隨播廣告的廣告代碼。

有幫助的入門資源

如果您需要在應用程式中導入 IMA SDK，請參閱取得 入門指南。

在應用程式中新增隨播廣告

建立 ViewGroup 以顯示隨播廣告素材

提出隨播廣告請求之前，您必須先在 版面配置。在版面配置 XML 中加入 ViewGroup 元素。本 範例使用的是 LinearLayout。在後續步驟中 ，將此元素參照至您的 AdDisplayContainer。 如果您是 整合至 BasicExample 應用程式，請將這段程式碼加進 com.google.android.exoplayer2.ui.PlayerView 下方的 activity_my.xml。

activity_my.xml

<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 會取得隨播廣告版位清單，讓您 同時顯示多個隨播廣告。您需要建立 ImaSdkFactory 可建立 CompanionAdSlot。 

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

為您打算在應用程式中顯示的隨播廣告大小建立隨播廣告版位。 IMA SDK 會將來自 VAST 回應的任何隨播廣告填入隨播廣告版位 設定符合檢視畫面高度和寬度的尺寸。此外，IMA SDK 也支援 自動調整大小的隨播廣告。 建立 companionAdSlots 後，請將所需項目 AdsLoader。下列範例說明如何根據您是否 使用的是 IMA Android BasicExample 使用 Exoplayer-IMA 擴充功能 或其他不使用擴充功能的 IMA 導入程序。

BasicExample

adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();

其他實作資訊

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

這就是所有訣竅了！您的應用程式現在顯示了 廣告。

顯示自動調整隨播廣告

IMA 現在支援自動調整隨播廣告。這些隨播廣告可調整大小以符合廣告大小 。這類廣告會填滿上層檢視畫面的 100%，然後配合隨播廣告的高度調整高度 內容。是在 Ad Manager 中使用 Fluid 隨播廣告大小進行設定。詳情請參閱 下方圖片來設定這個值。

顯示 Ad Manager 隨播廣告設定的圖片。醒目顯示隨播廣告大小選項。

更新 Android 應用程式以使用流體隨播

您可以更新自動調整隨播廣告版位中的 CompanionAdSlot.setSize()敬上 取得 CompanionAdSlot.FLUID_SIZE 的方法 做為兩個參數 

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

常見問題

我已按照指南操作，卻沒有看到隨播廣告。該怎麼辦？
首先，請確認你的代碼確實傳回隨播廣告。待辦 請在網路瀏覽器中開啟代碼，然後找出 CompanionAds 代碼。如果看到 就必須確認傳回的隨播廣告大小 大小與您傳入 CompanionAdSlot 的尺寸相同 物件。
遵循本指南後，我的隨播廣告版位看起來會是什麼樣子？
下方圖片是自 BasicExample ，同時播放上方內容影片，以及下方隨播廣告。

IMA Android 隨播廣告範例圖片。