采用自适应横幅广告，您可以指定广告宽度，从而为每台设备确定最理想的广告尺寸。与锚定自适应横幅广告不同，内嵌自适应横幅广告的尺寸更大、高度更高，并且采用的并非固定高度。内嵌自适应横幅广告的高度可变。这些横幅广告既可以铺满整个屏幕，也可以限制在您指定的最高高度之内。
本指南介绍了如何创建内嵌自适应横幅广告以及如何设置横幅广告尺寸。
下图展示了内嵌自适应横幅广告在滚动内容中的呈现效果：
准备工作
在继续操作之前，请确保您已设置横幅广告。
如需查看完整的内嵌自适应横幅广告示例，请下载以下示例应用：
植入内嵌自适应横幅广告
若要实现内嵌自适应横幅广告，您需要设置广告尺寸、创建广告请求并加载广告。
如需调整内嵌自适应横幅广告的尺寸，请确定广告宽度。常见方法包括：
- 使用全屏宽度。
- 使用包含广告的父布局的宽度。
- 调整宽度以考虑设备安全区域。
创建广告尺寸对象时，请使用此计算出的宽度。
以下示例设置了广告尺寸、创建了广告请求并加载了广告：
Kotlin
private fun loadAd() {
// Create an inline adaptive ad size. 320 is a placeholder value.
// Replace 320 with your banner container width.
val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)
// Step 1 - Create a BannerAdRequest object with ad unit ID and size.
val adRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize).build()
// Step 2 - Load the ad.
BannerAd.load(
adRequest,
object : AdLoadCallback<BannerAd> {
override fun onAdLoaded(ad: BannerAd) {
// Assign the loaded ad to the BannerAd object.
bannerAd = ad
// Step 3 - Call BannerAd.getView() to get the View and add it
// to view hierarchy on the UI thread.
activity?.runOnUiThread {
binding.bannerViewContainer.addView(ad.getView(requireActivity()))
}
}
override fun onAdFailedToLoad(loadAdError: LoadAdError) {
bannerAd = null
}
}
)
}
Java
private void loadAd() {
// Create an inline adaptive ad size. 320 is a placeholder value.
// Replace 320 with your banner container width.
AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);
// Step 1 - Create a BannerAdRequest object with ad unit ID and size.
BannerAdRequest adRequest = new BannerAdRequest.Builder("AD_UNIT_ID",
adSize).build();
// Step 2 - Load the ad.
BannerAd.load(
adRequest,
new AdLoadCallback<BannerAd>() {
@Override
public void onAdLoaded(@NonNull BannerAd ad) {
// Assign the loaded ad to the BannerAd object.
bannerAd = ad;
// Step 3 - Call BannerAd.getView() to get the View and add it
// to view hierarchy on the UI thread.
if (getActivity() != null) {
getActivity()
.runOnUiThread(() ->
binding.bannerViewContainer.addView(ad.getView(getActivity())));
}
}
@Override
public void onAdFailedToLoad(@NonNull LoadAdError adError) {
bannerAd = null;
}
});
}
如果您需要更新或创建订单项才能使用自适应横幅广告，请参阅为自适应横幅广告设置订单项。
设置内嵌自适应横幅广告版式
若要以特定版式预加载内嵌自适应横幅广告，请使用以下方法：
AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)
如果您的应用同时支持纵向和横向视图，且您希望按照当前版式预加载自适应横幅广告，请使用 AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) 方法。此方法会在当前布局中加载广告。
限制内嵌自适应横幅广告的高度
默认情况下，如果内嵌自适应横幅广告在创建时未指定 maxHeight，其最大高度会等于设备高度。若要限制内嵌自适应横幅广告的高度，请使用 AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) 方法。