【FAQ】接入 HMS Core 广告服务中的常见问题总结和解决方法

2022 年 9 月 14 日
上海
本文字数：2483 字
阅读完需：约 8 分钟

HMS Core广告服务（Ads Kit）为开发者提供流量变现服务和广告标识服务，依托华为终端能力，整合资源，帮助开发者获取高质量的广告内容。同时提供转化跟踪参数服务，支持三方监测平台、广告主进行转化归因分析。下面我们分享一些开发者在接入广告服务中经常会碰到的问题，希望给遇到类似问题的开发者提供参考。

1. 手机由竖屏转换成横屏时 Banner 广告尺寸变大怎么办？

解决方案：

固定 BannerView 的宽度或高度。例如下方的代码中固定了 Banner 广告的高度：

<com.huawei.hms.ads.banner.BannerView    android:id="@+id/hw_banner_view"    android:layout_width="match_parent"    android:layout_height="45dp"    android:layout_alignParentBottom="true"    android:layout_centerHorizontal="true" />

复制代码

Banner 广告正常显示效果如下：

2. 使用示例代码测试时，原生广告不显示“为什么显示此广告”图标“i”和“不再显示此广告”图标“x”(即广告关闭按钮)怎么办？

原因分析：

为了符合本地合规的高要求，SDK 增加了“不再显示此广告”的能力，且默认显示“不再显示此广告”的图标“x”。此图标只有在非中国大陆区域发行的设备上才会显示，因此在中国大陆发行的设备上测试时，是看不到的。

参考建议：

如果 App 只在非中国大陆区域上线，是不影响使用的，可以使用非中国大陆区域发行的设备查看展示效果。

如果 App 只在中国大陆区域上线，需要用到关闭按钮时，建议在原生广告布局中自己实现。

如果 App 是全球上线，那么在自己实现关闭按钮的同时还需要注意，App 在非中国大陆区域上线后，与默认展示的关闭按钮是否会冲突。

补充：

“不再显示该广告”的功能是在原生广告设置选项NativeAdConfiguration.Builder中设置的，其提供的setRequestCustomDislikeThisAd()方法可以设置是否要自定义“不再显示该广告”的功能，默认为 false。表现的形式如下：

如果设置为 true，则会显示“为什么看到此广告”图标“i”，也就是下图所示：

当自己实现关闭按钮时，为了避免在非中国大陆区域上线的应用中出现两个关闭按钮，建议将其设置为 true。

其次，可以通过调用NativeAdConfiguration.Builder().setChoicesPosition(int choicesPosition)方法设置图标显示的位置。

广告选项的展示位置：

3. 如何一次请求多个原生广告？

原生广告提供了一次同时请求多个原生广告的方法 loadAds()。

loadAds()请求有两个参数，除AdParam外，maxAdsNum 是请求加载的最大广告数量，最大值为 5。SDK 返回的广告数量将会小于等于所请求的广告数量，并且返回的广告皆不相同。示例代码如下所示：

nativeAdLoader.loadAds(new AdParam.Builder().build(), 5);

复制代码

当加载广告成功后，SDK 会多次调用NativeAd.NativeAdLoadedListener监听器的 onNativeAdLoaded()方法分别返回一个NativeAd对象，在广告都返回后再调用AdListener监听器的 onAdLoaded 方法回调通知此次请求成功；当加载广告失败后，SDK 会调用AdListener监听器的 onAdFailed()方法。

示例代码如下所示，其中 testy63txaom86"为测试专用的广告位 ID，App 正式发布时需要改为正式的广告位 ID。

NativeAdLoader.Builder builder = new NativeAdLoader.Builder(this, "testy63txaom86");NativeAdLoader nativeAdLoader = builder.setNativeAdLoadedListener(new NativeAd.NativeAdLoadedListener() {    @Override    public void onNativeAdLoaded(NativeAd nativeAd) {        // 广告加载成功回调，多个广告对应多个回调        ...    }}).setAdListener(new AdListener() {    @Override    public void onAdLoaded() {        // 广告全部返回后回调，说明所有广告返回成功        ...    }    @Override    public void onAdFailed(int errorCode) {        // 广告加载失败回调        ...    }}).build();nativeAdLoader.loadAds(new AdParam.Builder().build(), 5);

复制代码

说明：再次使用 NativeAdLoader 加载广告前，请确保先前的请求已经完成。

4. 在应用内滚动播放贴片广告时，报错提示 onMediaError : -1

在第一次播放贴片广告完成后，再次播放时返回了错误码-1.

原因分析：

当前网络不可用。
贴片广告在播放完成后，没有释放，导致下次播放时返回了-1。

解决方案：

检查网络。在 targetSdkVersion 28 及以上的手机上允许 HTTP(S)网络请求，在“AndroidManifest.xml”做以下配置。

<application    ...    android:usesCleartextTraffic="true"    >    ...</application>

复制代码

在 InstreamMediaStateListener 中的 onMediaCompletion()回调方法中释放贴片广告, 每次播放完成后，都需要释放掉。

public void onMediaCompletion(int playTime) {    updateCountDown(playTime);    removeInstream();    playVideo();}private void removeInstream() {    if (null != instreamView) {        instreamView.onClose();        instreamView.destroy();        instreamContainer.removeView(instreamView);        instreamContainer.setVisibility(View.GONE);        instreamAds.clear();    }}