廣告組件

2020-02-11 18:37 更新

ad

基礎(chǔ)庫(kù) 1.19.0 開(kāi)始支持本組件。

廣告組件。


屬性說(shuō)明

屬性類(lèi)型默認(rèn)值必填說(shuō)明最低支持版本
unit-idstring廣告位 id,必填。需要預(yù)先在「小程序管理后臺(tái) > 流量主模塊」配置生成。1.19.0
bindloadeventhandle廣告加載成功的回調(diào)方法1.19.0
binderroreventhandle廣告加載失敗的回調(diào)方法,具體的錯(cuò)誤信息可以參考下方的廣告錯(cuò)誤碼說(shuō)明1.26.2
bindcloseeventhandle廣告關(guān)閉的回調(diào)方法1.31.0
ad-intervalsnumber廣告自動(dòng)刷新的間隔時(shí)間,只對(duì) banner 型廣告生效。單位為秒,參數(shù)值必須大于等于 30(該參數(shù)不傳入時(shí) banner 廣告不會(huì)自動(dòng)刷新)1.32.1
fixedboolean廣告是否在屏幕中固定展示1.34.0
typestring"banner"廣告的類(lèi)型,具體類(lèi)型有:banner、video(視頻)、large(大圖)、lImg(左圖右文)、rImg(右圖左文),默認(rèn)值為 banner1.41.0
scalenumber100廣告的縮放比例,100 為標(biāo)準(zhǔn)尺寸1.41.0


詳細(xì)說(shuō)明

廣告組件具備展示多種類(lèi)型廣告的能力,并支持通過(guò)指定 scale 控制組件的顯示大小。

下方的表格將說(shuō)明廣告類(lèi)型(type)與縮放比例(scale)的關(guān)系。

類(lèi)型(type)縮放比例(scale)有效范圍說(shuō)明
banner無(wú)該類(lèi)型廣告寬度由 CSS 樣式?jīng)Q定,寬度范圍是屏幕寬度的80%-100%
video90-100 110視頻廣告,該類(lèi)型廣告寬度是屏幕寬度的 100%,100 為標(biāo)準(zhǔn)樣式,110 為通屏樣式
large90-100大圖廣告,該類(lèi)型廣告寬度是屏幕寬度的 100%,100 為標(biāo)準(zhǔn)樣式,90 為最小樣式
lImg100-150左圖右文廣告,該類(lèi)型廣告寬度是屏幕寬度的 100%,100 為標(biāo)準(zhǔn)樣式,150 為最大樣式。容易看錯(cuò),首字母是 l(L)
rImg100-150右圖左文廣告,該類(lèi)型廣告寬度是屏幕寬度的 100%,100 為標(biāo)準(zhǔn)樣式,150 為最大樣式

簡(jiǎn)言之:

  • banner 型廣告的寬度受 css 樣式影響
  • video、large、lImg、rImg 型廣告寬度始終等于手機(jī)屏幕寬度,只能通過(guò)設(shè)置 scale 屬性控制顯示大小。

另外,廣告組件的 type 屬性允許傳入多個(gè)類(lèi)型值,以便字節(jié)跳動(dòng)平臺(tái)為你的小程序提供最適合的廣告類(lèi)型。

<!--多類(lèi)型示例--->
<ad type="video large lImg rImg" scale="110 90 150 130"></ad>


廣告錯(cuò)誤碼說(shuō)明

若發(fā)現(xiàn)廣告組件未展示,可以通過(guò) binderror 屬性查看廣告加載的錯(cuò)誤碼,以便定位具體原因。

下方表格是對(duì)廣告錯(cuò)誤碼的詳細(xì)說(shuō)明。

異常說(shuō)明解決方案
1000后端錯(cuò)誤調(diào)用失敗該項(xiàng)錯(cuò)誤不是開(kāi)發(fā)者的異常情況一般情況下忽略一段時(shí)間即可恢復(fù)
1001參數(shù)錯(cuò)誤使用方法錯(cuò)誤查看 ad 組件文檔
1002廣告單元無(wú)效可能是拼寫(xiě)錯(cuò)誤、或者誤用了其他 APP 的廣告 ID
1003內(nèi)部錯(cuò)誤該項(xiàng)錯(cuò)誤不是開(kāi)發(fā)者的異常情況一般情況下忽略一段時(shí)間即可恢復(fù)
1004無(wú)適合的廣告廣告不是每一次都會(huì)出現(xiàn),這次沒(méi)有出現(xiàn)可能是由于該用戶(hù)不適合瀏覽廣告屬于正常情況,且開(kāi)發(fā)者需要針對(duì)這種情況做形態(tài)上的兼容
1005廣告組件審核中廣告正在被審核,無(wú)法展現(xiàn)廣告
1006廣告組件被駁回廣告審核失敗,無(wú)法展現(xiàn)廣告
1007廣告能力被禁用廣告能力已經(jīng)被封禁,封禁期間無(wú)法展現(xiàn)廣告
1008廣告單元已關(guān)閉該廣告位的廣告能力已經(jīng)被關(guān)閉


效果示例

banner 型廣告

banner 廣告的效果圖。

video 型廣告

視頻廣告的效果圖。

large 型廣告

大圖廣告的效果圖。

lImg 型廣告

左圖右文廣告效果圖。

rImg 型廣告

右圖左文廣告效果圖。


代碼示例

<!--基礎(chǔ)示例-->
<view>
  <ad
    unit-id="371e6m5eo89h576679"
    bindload="adloadhandler"
    binderror="aderrorhandler"
    bindclose="adclosehandler"
  ></ad>
</view>


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

掃描二維碼

下載編程獅App

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

編程獅公眾號(hào)