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

-Advertisement-

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

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

解決方案：

固定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();
    }
}

5. 如何在國內測試非中國大陸區域的廣告投放？

隨著國內開發者在非中國大陸區域進行廣告變現的需求越來越多，而開發者缺乏海外測試環境，導致在國內使用正式廣告位ID測試時，出現請求不到廣告的情況。

解決方法(應用上架需要超過12小時)：

方法一：使用海外版本的華為手機，連接非中國大陸區域的VPN網路（非美國），將手機中的國家區域設置為非中國大陸且確保應用已在該區域上架，進行測試。

方法二：註冊成為海外開發者，使用HMS ToolKit提供的Cloud Debugging功能，即遠程真機進行測試。

方法三：藉助“媒體服務平臺”中的“廣告測試服務”進行測試。詳情請查看：變現測試

註意：華為廣告在全球有四個投放站點：中國，亞非拉，歐洲，俄羅斯。不同的站點廣告不支持跨區域請求獲取廣告【如需跨站點請求廣告需使用對應國家的網路（可使用vpn代理），和對應國家的手機設備】。各個站點對應的國家詳情可參考文檔

瞭解更多詳情>>

訪問華為開發者聯盟官網
獲取開髮指導文檔
華為移動服務開源倉庫地址：GitHub、Gitee

關註我們，第一時間瞭解 HMS Core 最新技術資訊~

您的分享是我們最大的動力!