1200+原生广告2.0是对原有原生广告的优化和升级,使用原生广告2.0的API,开发者可深度地定制广告样式。
在快应用环境下,支持通过调用 ad.preloadAd 接口,提前加载广告数据,在后续创建对应广告标签 ad 时,会自动使用预加载的广告数据,省去创建广告标签时拉取广告的耗时。该方法会异步回调结果。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| adUnitId | String | 是 | 广告位标识 |
| type | String | 是 | 广告单元所属广告位类型 native:原生广告2.0 |
| adCount | Number | 否 | 预期返回的广告条数 |
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| adList | Object | 否 | 广告详细信息的对象,请求原生广告2.0成功时返回,数据格式如下表 |
返回广告数据adList 是一个 Array 对象,其中数据对象格式为:
| 参数 | 类型 | 说明 |
|---|---|---|
| adId | String | 广告数据id,用于标识不同广告数据 |
| title | String | 广告标题 |
| desc | String | 广告描述 |
| icon | String | 推广应用的Icon图标 |
| imgUrlList | Array | 广告图片列表 |
| clickBtnTxt | String | 点击按钮文本描述 |
| materialType | Number | 广告素材类型,取值详见各厂商支持明细 |
| hasPrivacy | Boolean | 是否具备隐私交互组件能力 |
| appInfo | Object | 应用下载类广告的落地页应用信息,非应用下载类广告该信息可能为空 |
| 参数 | 类型 | 说明 |
|---|---|---|
| appName | String | 应用名称 |
| appVersion | String | 应用版本 |
| appSize | Float | 应用大小,单位KB |
| developer | String | 开发者名称 |
let adParams = {
adUnitId: this.adUnitId, // 原生广告2.0广告位id
type: 'native', // 原生广告2.0广告类型
adCount: 2, // 原生广告2.0广告预期返回广告条数
}
ad.preloadAd({
...adParams,
success: (data) => {
this.adList = data.adList
prompt.showToast({
message: `success! data=${JSON.stringify(data)}`
})
}, fail: (data, code) => {
console.log(data, code)
prompt.showToast({
message: `fail! data=${JSON.stringify(data)}, code=${code}`
})
}
})
广告组件。
支持。
除了支持通用属性以外,还支持如下属性。
| 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| adid | String | - | 是 | 填入preloadAd方法获取的广告数据中的 adId 字段, 通过该属性将组件指定为 ad 接口返回的对应原生广告2.0素材的展示容器 |
支持通用属性。
不支持通用事件,支持如下事件:
| 名称 | 参数 | 描述 |
|---|---|---|
| adclick | - | 广告组件内可响应广告点击动作区域被点击 |
| adshow | - | 广告组件曝光回调 |
| error | { errCode: Number, errMsg: String} | 广告加载失败时触发 |
ad 组件子组件,用于展示广告的可点击区域。
type 为 click时支持子组件,type 为 button、video、privacy时,不支持子组件。
支持通用属性。
| 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| type | click | button | video | privacy | click | 否 | 组件类型 click:图文素材点击区域,支持子组件,点击后跳转至相应的落地页; button:创意按钮点击区域,不支持子组件,点击后会执行对应的广告交互操作; video:视频素材展示区域,不支持子组件,不响应点击动作; privacy:应用要素信息组件,涵盖隐私、权限、简介,不支持子组件,点击后唤起弹窗展示完整信息; |
注:
支持通用样式。
当type 为 click 时:
支持div样式。
当type为button时:
| 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| width | <length> | 90px | 否 | 组件宽度。仅支持px单位,不允许小于90px。 |
| height | <length> | 30px | 否 | 组件高度。仅支持px单位,只允许设置范围:30px - 180px。 |
| font-size | <length> | 15px | 否 | 文本尺寸。仅支持px单位,只允许设置范围:15px - 113px。 |
| opacity | <number> | 1 | 否 | 组件透明度。设置无效,不允许设置为透明。 |
| color | <color> | #FFFFFF | 否 | 文本颜色。当color和background-color值过于相似时,这两个字段设置的值无效。 |
| background-color | <color> | #456FFF | 否 | 背景颜色。当color和background-color值过于相似时,这两个字段设置的值无效。 |
不支持。
更详细的原生广告2.0接入api,请参考各厂商接入指引明细。
| 厂商 | 支持 | 文档 |
|---|---|---|
| 小米 | 1103+ | 原生广告2.0 |
| 中兴 | no | - |
| 华为 | no | - |
| 金立 | no | - |
| 联想 | no | - |
| 魅族 | no | - |
| 努比亚 | no | - |
| OPPO | 1091+ | 原生广告信息流2.0 |
| vivo | 1094+ | 原生广告2.0 |
| 一加 | no | - |
| 预览版 | no | 预览版不提供广告接口 |