接入指南 API 工具 其他

原生模板广告

为了方便开发者接入,联盟共建了统一 SDK,开发者接入 sdk 后能更快的实现登录、支付与广告功能,建议采用统一 SDK 方式接入。

qg.createCustomAd(Object object)

创建原生模板广告组件。每次调用该方法创建原生模板广告都会返回一个全新的实例。

参数

Object object

属性类型默认值必填说明
adUnitIdString广告单元 id
adIntervalsNumber广告自动刷新的间隔时间,单位为秒,参数值必须大于等于 30(仅对支持自动刷新的模板生效)
styleObject原生模板广告组件的样式
style(原生模板广告组件的样式)
结构属性类型默认值必填说明
leftNumber原生模板广告组件的左上角横坐标,单位 px。
topNumber原生模板广告组件的左上角纵坐标 ,单位 px。
widthNumber原生模板广告组件的宽度,单位 px。(仅在某些模板生效,如矩阵格子)

返回值 CustomAd

原生模板广告组件

属性

Object style

原生模板广告组件的样式

属性类型说明
leftNumber原生模板广告组件的左上角横坐标,单位 px。
topNumber原生模板广告组件的左上角纵坐标,单位 px。
fixedBoolean原生模板广告组件是否固定屏幕位置(不跟随屏幕滚动)

方法

CustomAd.show()

显示原生模板广告。

返回值 Promise

原生模板广告显示操作的结果

CustomAd.hide()

隐藏原生模板广告。(某些模板广告无法隐藏)

返回值 Promise

原生模板广告隐藏操作的结果

customAd.onShow(Function listener)

customAd 设置成功展示回调

customAd.onShow(() => {
  console.log("customAd广告显示");
});

customAd.offShow(Function listener)

customAd 移除 customAd 成功回调

备注:如果传入的 listener 为 null 或者 undefined,则所有的 onShow 回调都会被移除

customAd.offShow();

CustomAd.onLoad(Function listener)

监听原生模板广告加载事件。

参数 listener

原生模板广告加载事件的监听函数

CustomAd.offLoad(Function listener)

移除原生模板广告加载事件的监听函数

参数 listener

onLoad 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

CustomAd.onLoad(listener);
CustomAd.offLoad(listener); // 需传入与监听时同一个的函数对象

CustomAd.onHide(Function listener)

监听原生模板广告隐藏事件,某些模板如矩阵格子模板用户点击关闭时也会触发该事件。

参数 listener

原生模板广告隐藏事件的监听函数

CustomAd.offHide(Function listener)

移除原生模板广告隐藏事件的监听函数

参数 listener

onHide 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

CustomAd.onHide(listener);
CustomAd.offHide(listener); // 需传入与监听时同一个的函数对象

CustomAd.onError(Function listener)

监听原生模板广告错误事件。

参数 listener(Object res)

原生模板广告错误事件的监听函数

属性类型说明
errMsgString错误信息
errCodeNumber错误码

CustomAd.offError(Function listener)

移除原生模板广告错误事件的监听函数

参数 listener

onError 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

CustomAd.onError(listener);
CustomAd.offError(listener); // 需传入与监听时同一个的函数对象

CustomAd.destroy()

销毁原生模板广告。

CustomAd.isShow()

查询原生模板广告展示状态。

返回值 Boolean

原生模板广告是否正在展示

CustomAd.onClose(Function listener)

监听原生模板广告关闭事件。

参数 listener

原生模板广告关闭事件的监听函数

CustomAd.offClose(Function listener)

移除原生模板广告关闭事件的监听函数

参数 listener

onClose 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

CustomAd.onClose(listener);
CustomAd.offClose(listener); // 需传入与监听时同一个的函数对象

customAd.onClick(Function listener)

设置 customAd 成功展示后,点击回调

customAd.onClick(obj => {
  console.log(`开启原生模板广告点击回调: code: ${obj.code},msg: '${obj.msg}'`);
});

customAd.offClick(Function listener)

移除点击回调

customAd.offClick();

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容