lyAd

概述

聚合广告的用途：

app广告是app收益的重要组成部分，而聚合广告能集多家广告公司的资源，来保证收益最大化。

广告插件引入流程（lyAd.zip是已经写好的自定义插件）

模块接口示例

初始化sdk

// 定义广告对象
var lyAd = api.require('lyAd');
// 设定传参：appkey传入对应的appkey（可联系相关人员获取相应参数）
// 345a20d3863f8911为测试使用的appkey
var param = { appKey: "345a20d3863f8911" };
// 调用初始化代码
lyAd.init(param, function (ret, err) {

});

展示开屏广告

var lyAd = api.require('lyAd');
var frameName=api.frameName;
// param说明：
// id：广告位id
// x:插入广告距离窗口左部的距离（px值）建议传0
// y:插入广告距离窗口顶部的距离（px值）建议传0
// width：插入广告的宽度（px值）建议传入屏幕宽度
// height：插入广告的高度（px值），最低为屏幕高度的80%
// frameName：窗口名
var param = {id:"f531cf0880e84a92",x:0,y:0,width:api.screenWidth,height:api.screenHeight,frameName:frameName};
lyAd.showSplash(param, function(ret){
    if(ret.method=="onShow"){
        alert("开屏展示成功");
    }else if(ret.method=="onClose"){
        alert("开屏广告关闭");
    }
});

拉取插屏广告

var lyAd = api.require('lyAd');
//f531cf0880e84a92为测试使用的插屏广告位id
var param = { id: "fd666428f0326ff4" };
lyAd.loadInterstitial(param, function (ret, err) {
    if (ret.method == "onLoad") {
        isLoadInterstitial = true;
        alert("插屏广告拉取成功");
    } else if (ret.method == "onClose") {
        alert("插屏广告关闭");
    }
});

展示插屏广告（需要再拉取成功后执行）

var lyAd = api.require('lyAd');
//判断是否插屏广告加载成功
if (isLoadInterstitial == false) {
    return;
}
isLoadInterstitial = false;//要展示插屏了，加载成功状态重置
lyAd.showInterstitial("", function (ret, err) {

});

拉取激励视频广告（预加载）

var lyAd = api.require('lyAd');
// 61bf850b1c1463a8为测试使用的激励视频广告位id
// userId:要求传入app内的用户唯一标识（手机号或者userid都可以）
var param = { id: "61bf850b1c1463a8", userId: "", extend: "no" };
// 加载激励视频广告（app内调用一次就可以，调用一次后面会预加载）
lyAd.preLoadRewardVideo(param, function (ret, err) {
});

展示激励视频广告（先调用了预加载）

var lyAd = api.require('lyAd');
var param = {userId: "app内的用户id，也可以是手机号", extend: "no" };
//在需要展示广告的时候调用此方法，需要注意广告是否加载成功
lyAd.showRewardVideo(param, function (ret, err) {

});

加载并展示激励视频广告（单次的加载并展示，不用调用预加载）

var param = {id:"61bf850b1c1463a8",userId:"1231",extend:"no"};
lyAd.loadAndShowRewardVideo(param, function(ret){
    if(ret.method=="onLoad"){
  //不用做展示广告处理，会自动展示
        alert("激励广告拉取成功");
    }else if(ret.method=="onError"){
        //广告加载失败，需要重新加载，或者让用户等1分钟后重试
        //ret.code：错误码
        //ret.msg：广告加载失败错误说明
        alert("激励广告加载失败-code："+ret.code+"-msg:"+ret.msg);
    }else if(ret.method=="onReward"){
        //发放奖励
    }
});

展示信息流广告

var lyAd = api.require('lyAd');
var frameName=api.frameName;
//param说明：
//id：广告位id
//tag:传入每次展示广告的标识（每次不可传入相同的标识，自己生成一个需要的标识就可以）
//x:插入广告距离窗口左部的距离（px值）
//y:插入广告距离窗口顶部的距离（px值）
//width：插入广告的宽度（px值）
//height：插入广告的高度（px值）
//frameName：窗口名
var param = {id:"f0cfee409b1e1e3a",tag:"tag标识",x:40,y:900,width:1000,height:500,frameName:frameName};
lyAd.loadNativeExpress(param, function(ret){
    if(ret.method=="onLoad"){
    }else if(ret.method=="onError"){
        //广告加载失败，需要重新加载，或者让用户等1分钟后重试
        //ret.code：错误码
        //ret.msg：广告加载失败错误说明
        alert("信息流广告加载失败-code："+ret.code+"-msg:"+ret.msg);
    }else if(ret.method=="onShow"){
        alert("信息流广告展示成功,width:"+ret.width+"--height:"+ret.height);
    }else if(ret.method=="onClose"){
        alert("信息流广告关闭");
    }
});

关闭信息流广告

//param说明：
//tag：tag不传入则关闭所有banner/信息流广告，tag传入，则关闭加载广告时传入的相对应的tag的广告
var param = {tag:"tag标识"};
lyAd.closeNativeExpress(param, function(ret){
});

展示banner广告

var lyAd = api.require('lyAd');
var frameName=api.frameName;
//param说明：
//id：广告位id
//tag:传入每次展示广告的标识（每次不可传入相同的标识，自己生成一个需要的标识就可以）
//x:插入广告距离窗口左部的距离（px值）
//y:插入广告距离窗口顶部的距离（px值）
//width：插入广告的宽度（px值）
//height：插入广告的高度（px值）
//frameName：窗口名
var param = {id:"a495d657f01c41bd",tag:"tag标识",x:60,y:6080,width:960,height:150,frameName:frameName};
lyAd.loadBanner(param, function(ret){
    alert("监听："+ret.method);
    if(ret.method=="onLoad"){
    }else if(ret.method=="onError"){
        //广告加载失败，需要重新加载，或者让用户等1分钟后重试
        //ret.code：错误码
        //ret.msg：广告加载失败错误说明
        alert("banner广告加载失败-code："+ret.code+"-msg:"+ret.msg);
    }else if(ret.method=="onShow"){
        alert("banner广告展示成功");
    }else if(ret.method=="onClose"){
        alert("banner广告关闭");
    }
});

关闭banner广告

//param说明：
//tag：tag不传入则关闭所有banner/信息流广告，tag传入，则关闭加载广告时传入的相对应的tag的广告
var param = {tag:"tag标识"};
lyAd.closeBanner(param, function(ret){
});

回调参数说明：

  • ret.adType:为广告类型

    取值说明：interstitial、rewardVideo

  • ret.method:为回调方法 取值说明： onLoad:已经返回广告素材，可以进行加载 onError:广告加载失败，暂无填充，也可联系运营详细查看具体原因 onShow:广告展示成功 onClick:用户点击广告素材 onClose:用户关闭广告 onVideoEnd:视频类广告播放完成 onVideoStart:视频类广告开始播放 onReward:激励视频广告可以发放奖励

是否仍需要帮助？ 请保持联络！
最后更新于 2025/02/11