【FAQ】接入HMS Core廣告服務中的常見問題總結和解決方法-有解無憂

HMS Core廣告服務（Ads Kit）為開發者提供流量變現服務和廣告標識服務，依托華為終端能力，整合資源，幫助開發者獲取高質量的廣告內容，同時提供轉化跟蹤引數服務，支持三方監測平臺、廣告主進行轉化歸因分析，下面我們分享一些開發者在接入廣告服務中經常會碰到的問題，希望給遇到類似問題的開發者提供參考，

解決方案：

固定BannerView的寬度或高度，例如下方的代碼中固定了Banner廣告的高度：

<com.huawei.hms.ads.banner.BannerView
    android:id="@+id/hw_banner_view"
    android:layout_
    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();
    }
}