本指南适用于有兴趣在其 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 接口会获取随播广告位列表，以便您一次展示多个随播广告。您需要创建 ImaSdkFactory 类的实例，才能创建 CompanionAdSlot 对象。
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 还支持使用自适应尺寸的随播广告。创建 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);
}
这就是全部内容！您的应用现在可以展示随播广告了。
展示自适应随播广告
IMA 支持自适应随播广告。这些随播广告可以调整大小，以匹配广告位的尺寸。它们会填满父级视图 100% 的宽度，然后调整其高度以适应随播广告的内容。它们是通过在 Ad Manager 中使用 Fluid 随播广告尺寸来设置的。请参阅下图，了解在哪里设置此值。
更新 Android 应用，打造流畅的配套体验
您可以声明自适应随播广告位，方法是将 CompanionAdSlot.setSize() 方法更新为将 CompanionAdSlot.FLUID_SIZE 作为两个参数。
companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
常见问题解答
- 我按照指南操作了，但没有看到随播广告。该怎么做？
- 首先，请检查并确保您的代码确实会返回随播广告。为此，请在网络浏览器中打开该代码，然后查找
<CompanionAds>代码。如果看到这种情况，请检查并确保返回的随播广告尺寸与您传递到CompanionAdSlot对象的尺寸相同。 - 按照本指南操作后，我的随播广告位会是什么样子？
下图是根据 BasicExample 创建的，其中内容视频在顶部播放，随播广告在底部展示。
