微信小程序 廣告·激勵(lì)視頻廣告

微信小程序廣告激勵(lì)視頻廣告是一款由客戶端原生的圖片、文本和視頻控件組成的高層級(jí)組件，它覆蓋在普通組件之上。開(kāi)發(fā)者可以使用wx.createRewardedVideoAd方法創(chuàng)建激勵(lì)視頻廣告組件實(shí)例，該實(shí)例僅對(duì)當(dāng)前頁(yè)面有效且不允許跨頁(yè)面使用。

1. 廣告創(chuàng)建

激勵(lì)視頻廣告組件默認(rèn)處于隱藏狀態(tài)，因此可以在小程序頁(yè)面的onLoad事件回調(diào)中提前創(chuàng)建廣告實(shí)例以預(yù)先初始化組件，并在該頁(yè)面的生命周期內(nèi)重復(fù)調(diào)用該廣告實(shí)例。建議在展示廣告按鈕前先判斷廣告是否拉取成功以避免濫用廣告資源。

2. 顯示/隱藏

激勵(lì)視頻廣告組件默認(rèn)狀態(tài)下處于隱藏狀態(tài)，在用戶主動(dòng)觸發(fā)廣告后，開(kāi)發(fā)者需要通過(guò)RewardedVideoAd.show()方法顯示廣告。廣告僅會(huì)在用戶點(diǎn)擊關(guān)閉廣告按鈕時(shí)關(guān)閉，開(kāi)發(fā)者無(wú)法手動(dòng)控制廣告的隱藏與顯示。

3. 廣告拉取成功與失敗

激勵(lì)視頻廣告組件將自動(dòng)更新并自動(dòng)拉取廣告。如果拉取成功，則可以通過(guò)RewardedVideoAd.onLoad()注冊(cè)的回調(diào)函數(shù)或RewardedVideoAd.show()返回的Promise來(lái)判斷廣告是否成功拉取。如果拉取失敗，則可以通過(guò)RewardedVideoAd.onError()注冊(cè)的回調(diào)函數(shù)或catch方法返回的rejected Promise來(lái)判斷廣告是否拉取失敗。

4. 拉取失敗后重新拉取

如果組件某次自動(dòng)拉取失敗，則之后再調(diào)用show()將被reject。此時(shí)，可以調(diào)用RewardedVideoAd.load()方法手動(dòng)重新拉取廣告并使用try-catch語(yǔ)句來(lái)避免出現(xiàn)異常請(qǐng)求。如果組件的自動(dòng)拉取是成功的，則調(diào)用load()方法會(huì)直接返回一個(gè)resolved Promise而不需要再拉取廣告。

5. 監(jiān)聽(tīng)用戶關(guān)閉廣告

激勵(lì)視頻廣告組件僅在用戶點(diǎn)擊關(guān)閉廣告按鈕時(shí)關(guān)閉廣告。開(kāi)發(fā)者可以使用RewardedVideoAd.onClose()來(lái)監(jiān)聽(tīng)此事件，并根據(jù)res.isEnded來(lái)判斷廣告是否已播放完畢以及向用戶下發(fā)是否獎(jiǎng)勵(lì)。

6. 注意事項(xiàng)

多次調(diào)用RewardedVideoAd.onLoad()、RewardedVideoAd.onError()、RewardedVideoAd.onClose()等方法來(lái)監(jiān)聽(tīng)廣告事件會(huì)產(chǎn)生多次事件回調(diào)。建議在創(chuàng)建廣告后只監(jiān)聽(tīng)一次廣告事件，或先取消原有的監(jiān)聽(tīng)事件再重新監(jiān)聽(tīng)。

<本文由himall原創(chuàng)，商業(yè)轉(zhuǎn)載請(qǐng)聯(lián)系作者獲得授權(quán)，非商業(yè)轉(zhuǎn)載請(qǐng)標(biāo)明：himall原創(chuàng)>