本指南適用於想為影片新增隨播廣告的廣告客戶 導入 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 隨播廣告設定的圖片。醒目顯示隨播廣告大小選項。](https://developers.google.cn/static/interactive-media-ads/images/ad_manager_fluid_companion.png?authuser=0000&hl=zh-tw)
更新 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
,同時播放上方內容影片,以及下方隨播廣告。