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

2020-07-23 14:35 更新

InterstitialAd

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


方法:

InterstitialAd.destroy()

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

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


Promise InterstitialAd.load()

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

加載插屏廣告。

返回值

Promise

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


InterstitialAd.offClose(function callback)

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

參數(shù)

function callback

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


InterstitialAd.offError(function callback)

取消監(jiān)聽(tīng)插屏錯(cuò)誤事件

參數(shù)

function callback

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


InterstitialAd.offLoad(function callback)

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

參數(shù)

function callback

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


InterstitialAd.onClose(function callback)

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

參數(shù)

function callback

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


InterstitialAd.onError(function callback)

監(jiān)聽(tīng)插屏錯(cuò)誤事件。

參數(shù)

function callback

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

參數(shù)

Object res
屬性類型說(shuō)明
errMsgstring錯(cuò)誤信息
errCodenumber錯(cuò)誤碼

errCode 的合法值

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

錯(cuò)誤碼信息與解決方案表

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

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


InterstitialAd.onLoad(function callback)

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

參數(shù)

function callback

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


Promise InterstitialAd.show()

顯示插屏廣告。

返回值

Promise

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

錯(cuò)誤碼信息表

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

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


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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)