微信小程序API 插屏廣告組件

2020-07-23 14:35 更新

InterstitialAd

插屏廣告組件。插屏廣告組件是一個(gè)原生組件,層級比普通組件高。插屏廣告組件每次創(chuàng)建都會返回一個(gè)全新的實(shí)例(小程序端的插屏廣告實(shí)例不允許跨頁面使用),默認(rèn)是隱藏的,需要調(diào)用 InterstitialAd.show() 將其顯示。


方法:

InterstitialAd.destroy()

基礎(chǔ)庫 2.8.0 開始支持,低版本需做兼容處理。

銷毀插屏廣告實(shí)例。


Promise InterstitialAd.load()

基礎(chǔ)庫 2.8.0 開始支持,低版本需做兼容處理。

加載插屏廣告。

返回值

Promise

插屏廣告加載數(shù)據(jù)的結(jié)果


InterstitialAd.offClose(function callback)

取消監(jiān)聽插屏廣告關(guān)閉事件

參數(shù)

function callback

插屏廣告關(guān)閉事件的回調(diào)函數(shù)


InterstitialAd.offError(function callback)

取消監(jiān)聽插屏錯誤事件

參數(shù)

function callback

插屏錯誤事件的回調(diào)函數(shù)


InterstitialAd.offLoad(function callback)

取消監(jiān)聽插屏廣告加載事件

參數(shù)

function callback

插屏廣告加載事件的回調(diào)函數(shù)


InterstitialAd.onClose(function callback)

監(jiān)聽插屏廣告關(guān)閉事件。

參數(shù)

function callback

插屏廣告關(guān)閉事件的回調(diào)函數(shù)


InterstitialAd.onError(function callback)

監(jiān)聽插屏錯誤事件。

參數(shù)

function callback

插屏錯誤事件的回調(diào)函數(shù)

參數(shù)

Object res
屬性類型說明
errMsgstring錯誤信息
errCodenumber錯誤碼

errCode 的合法值

說明最低版本
1000后端接口調(diào)用失敗
1001參數(shù)錯誤
1002廣告單元無效
1003內(nèi)部錯誤
1004無合適的廣告
1005廣告組件審核中
1006廣告組件被駁回
1007廣告組件被封禁
1008廣告單元已關(guān)閉

錯誤碼信息與解決方案表

錯誤碼是通過onError獲取到的錯誤信息。調(diào)試期間,可以通過異常返回來捕獲信息。 在小程序發(fā)布上線之后,如果遇到異常問題,可以在“運(yùn)維中心“里面搜尋錯誤日志,還可以針對異常返回加上適當(dāng)?shù)谋O(jiān)控信息。

代碼異常情況理由解決方案
1000后端錯誤調(diào)用失敗該項(xiàng)錯誤不是開發(fā)者的異常情況一般情況下忽略一段時(shí)間即可恢復(fù)。
1001參數(shù)錯誤使用方法錯誤可以前往developers.weixin.qq.com確認(rèn)具體教程(小程序和小游戲分別有各自的教程,可以在頂部選項(xiàng)中,“設(shè)計(jì)”一欄的右側(cè)進(jìn)行切換。
1002廣告單元無效可能是拼寫錯誤、或者誤用了其他APP的廣告ID請重新前往mp.weixin.qq.com確認(rèn)廣告位ID。
1003內(nèi)部錯誤該項(xiàng)錯誤不是開發(fā)者的異常情況一般情況下忽略一段時(shí)間即可恢復(fù)。
1004無適合的廣告廣告不是每一次都會出現(xiàn),這次沒有出現(xiàn)可能是由于該用戶不適合瀏覽廣告屬于正常情況,且開發(fā)者需要針對這種情況做形態(tài)上的兼容。
1005廣告組件審核中你的廣告正在被審核,無法展現(xiàn)廣告請前往mp.weixin.qq.com確認(rèn)審核狀態(tài),且開發(fā)者需要針對這種情況做形態(tài)上的兼容。
1006廣告組件被駁回你的廣告審核失敗,無法展現(xiàn)廣告請前往mp.weixin.qq.com確認(rèn)審核狀態(tài),且開發(fā)者需要針對這種情況做形態(tài)上的兼容。
1007廣告組件被駁回你的廣告能力已經(jīng)被封禁,封禁期間無法展現(xiàn)廣告請前往mp.weixin.qq.com確認(rèn)小程序廣告封禁狀態(tài)。
1008廣告單元已關(guān)閉該廣告位的廣告能力已經(jīng)被關(guān)閉請前往mp.weixin.qq.com重新打開對應(yīng)廣告位的展現(xiàn)。


InterstitialAd.onLoad(function callback)

監(jiān)聽插屏廣告加載事件。

參數(shù)

function callback

插屏廣告加載事件的回調(diào)函數(shù)


Promise InterstitialAd.show()

顯示插屏廣告。

返回值

Promise

插屏廣告顯示操作的結(jié)果

錯誤碼信息表

如果插屏廣告顯示失敗,InterstitialAd.show() 方法會返回一個(gè)rejected Promise,開發(fā)者可以獲取到錯誤碼及對應(yīng)的錯誤信息。

代碼異常情況理由
2001觸發(fā)頻率限制小程序啟動一定時(shí)間內(nèi)不允許展示插屏廣告
2002觸發(fā)頻率限制距離小程序插屏廣告或者激勵視頻廣告上次播放時(shí)間間隔不足,不允許展示插屏廣告
2003觸發(fā)頻率限制當(dāng)前正在播放激勵視頻廣告或者插屏廣告,不允許再次展示插屏廣告
2004廣告渲染失敗該項(xiàng)錯誤不是開發(fā)者的異常情況,或因小程序頁面切換導(dǎo)致廣告渲染失敗
2005廣告調(diào)用異常插屏廣告實(shí)例不允許跨頁面調(diào)用


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號