原生广告

旧文档请查看:原生广告旧 API

原生广告是 cp 通过封装好的接口获取广告数据,根据实际场景自由选择绘制和展示方式的广告,更加灵活。 需要注意的是,每个原生广告组件对象只有一次有效曝光,一次有效点击。 同一个 adUnitId,如果已经创建,并且未 destroy,会复用之前的对象。

qg.createNativeAd(object)

以下所有 API 需支持最低平台版本号'1051' (minPlatformVersion>='1051')

参数

object

属性 类型 是否必填 说明
adUnitId string 原生广告位标识,需在 OPPO 联盟后台申请

代码示例:

var nativeAd = qg.createNativeAd({
  adUnitId: 'xxx'
})

nativeAd.load()

获取广告数据,成功回调 onLoad,失败回调 onError

返回值

Promise

原生广告加载数据的结果

nativeAd.reportAdShow(object)

上报广告曝光,一个广告只有一次上报有效,adId 为 load 方法获取的广告数据的 adId 字段

属性 类型 是否必填 说明
adId string 广告信息标识,由 onLoad 接口返回

代码示例:

nativeAd.reportAdShow({
  adId: 'xxx'
})

nativeAd.reportAdClick(object)

上报广告点击,一个广告只有一次上报有效,adId 为 load 方法获取的广告数据的 adId 字段

属性 类型 是否必填 说明
adId string 广告信息标识,由 onLoad 接口返回

代码示例:

nativeAd.reportAdClick({
  adId: 'xxx'
})

nativeAd.onLoad(function callback)

设置广告加载成功回调

代码示例:

nativeAd.onLoad(function(res) {
  console.log('原生广告加载', res.adList)
})
属性 类型 是否必填 说明
adList Array 广告详细信息

返回广告数据 adList 是一个 Array 对象,其中 item 数据格式为:

属性 类型 说明
adId string 广告标识,用来上报曝光与点击
title string 广告标题
desc string 广告描述
icon string 推广应用的 Icon 图标
imgUrlList Array 广告图片
logoUrl string “广告”标签图片
clickBtnTxt string 点击按钮文本描述
creativeType number 获取广告类型,取值说明:
0:无
1:纯文字
2:图片
3:图文混合
4:视频
6. 640x320 大小图文混合
7. 320x210 大小图文单图
8. 320x210 大小图文多图
interactionType number 获取广告点击之后的交互类型,取值说明:
0:无
1:浏览类
2:下载类
3:浏览器(下载中间页广告)
4:打开应用首页
5:打开应用详情页

nativeAd.offLoad(function callback)

移除广告加载成功回调

nativeAd.onError(function callback)

设置出错回调

代码示例:

nativeAd.onError(function(err) {
  console.log(err)
})

nativeAd.offError(function callback)

移除出错回调

nativeAd.destroy()

销毁广告组件,释放资源

© 2020 OPPO. All rights reserved.

results matching ""

    No results matching ""