ModuleYYAds 聚合了众多知名广告联盟,并且插件囊括了开屏、插屏、信息流、全屏视频、激励视屏、Draw、横幅等当下热门的广告样式,使用前需前往注册开发者账号并创建应用获取应用AppId和相应的广告位AdId。
在集成广告插件前需要先配置config.xml文件,配置通过云端编译生效,配置方法如下: 名称: moduleYYAds 参数: 应用ID
<feature name="moduleYYAds">
<param name="appId" value="请填写注册应用成功后从游易官网获取的应用ID"/>
</feature>
字段描述: appId: (必须配置)用于插件获取当前应用在游易官网申请的广告
苹果在widget://res目录下添加Info.plist 可新建记事本重命名并添加
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>GADApplicationIdentifier</key>
<string>请填写注册应用成功后从游易官网获取的GADApplicationIdentifier</string>
</dict>
</plist>
iOS应用打包最低版本位9.0 使用插件前请先到游易官网注册账号、新建应用、新建广告位。 ####插件接口
####Splash插件 获取开屏广告 loadSplashAd({params},callback(success,error))
ad_id:
类型:字符串 描述:从游易官网获取的广告位ID
success:
类型:JSON对象 内部字段:
{
status:onAdLoadSuccess/onAdClick/onAdClosed/
}
error:
类型:JSON对象 内部字段:
{
errorCode:0, //数字类型
errorMsg:"错误信息"
}
function loadSplashAd() {
var yyAds = api.require('moduleYYAds');
yyAds.loadSplashAd({ad_id:"请填写从游易官网获取的开屏广告位ID"},function(success,error){
var result = success || error
try {
var resJsonStr = JSON.stringify(result);
console.log(resJsonStr);
} catch (err) {
console.log(err);
}
});
}
iOS系统 可提供的1.0.0版本
获取横幅广告 loadBannerAd({params},callback(success,error))
ad_id:
类型:字符串 描述:从游易官网获取的广告位ID
x:
类型: 数字类型 描述: 插件左上角的x坐标 (相对于所属的Window 或 Frame)
y:
类型: 数字类型 描述: 插件左上角的y坐标 (相对于所属的Window 或 Frame)
sizeRatio:
类型: 字符串 描述: 插件的宽高比例,固定值:YYBannerSizeRatio_375_54、YYBannerSizeRatio_375_56、YYBannerSizeRatio_375_58、YYBannerSizeRatio_375_94、YYBannerSizeRatio_375_162、YYBannerSizeRatio_375_187、YYBannerSizeRatio_375_210、YYBannerSizeRatio_375_250、YYBannerSizeRatio_375_312 需要根据平台创建广告位的尺寸选择相对应的插件比例标识,且每次调用只能选其中一个
interval:
类型: 数字类型 描述: 横幅广告的轮播时间,部分广告源有效,范围30~120s,小于30去30,大于120取120,此字段不传即不需开启轮播
success:
类型:JSON对象 内部字段:
{
status:onAdRenderSuccess/onAdClick/onAdClosed/
}
error:
类型:JSON对象 内部字段:
{
errorCode:0, //数字类型
errorMsg:"错误信息"
}
function loadBannerAd() {
var yyAds = api.require('moduleYYAds');
yyAds.loadBannerAd({ad_id:"请填写从游易官网获取的Banner广告位ID",x:0,y:100,sizeRatio:"YYBannerSizeRatio_375_54",interval:30},function(success,error){
var result = success || error
try {
var resJsonStr = JSON.stringify(result);
console.log(resJsonStr);
} catch (err) {
console.log(err);
}
});
}
iOS系统 可提供的1.0.0版本
获取插屏广告 loadInterstitialAd({params},callback(success,error))
ad_id:
类型:字符串 描述:从游易官网获取的广告位ID
success:
类型:JSON对象 内部字段:
{
status:onAdLoadSuccess/onAdClick/onAdClosed/
}
error:
类型:JSON对象 内部字段:
{
errorCode:0, //数字类型
errorMsg:"错误信息"
}
function loadInterstitialAd() {
var yyAds = api.require('moduleYYAds');
yyAds.loadInterstitialAd({ad_id:"请填写从游易官网获取的插屏广告位ID"},function(success,error){
var result = success || error
try {
var resJsonStr = JSON.stringify(result);
console.log(resJsonStr);
} catch (err) {
console.log(err);
}
});
}
iOS系统 可提供的1.0.0版本
获取激励视频广告 loadRewardAd({params},callback(success,error))
ad_id:
类型:字符串 描述:从游易官网获取的广告位ID user_id: 类型:字符串 描述:用于上传到广告源平台,非必传字段
success:
类型:JSON对象 内部字段:
{
status:onAdDownloadSuccess/onAdClick/onAdClosed/onAdRewardSuccess
}
error:
类型:JSON对象 内部字段:
{
errorCode:0, //数字类型
errorMsg:"错误信息"
}
function loadRewardAd() {
var yyAds = api.require('moduleYYAds');
yyAds.loadRewardAd({ad_id:"请填写从游易官网获取的激励视频广告位ID",user_id:"请填写App的用户ID"},function(success,error){
var result = success || error
try {
var resJsonStr = JSON.stringify(result);
console.log(resJsonStr);
} catch (err) {
console.log(err);
}
});
}
iOS系统 可提供的1.0.0版本
获取全屏视频广告 loadFullScreenAd({params},callback(success,error))
ad_id:
类型:字符串 描述:从游易官网获取的广告位ID
success:
类型:JSON对象 内部字段:
{
status:onAdDownloadSuccess/onAdClick/onAdClosed
}
error:
类型:JSON对象 内部字段:
{
errorCode:0, //数字类型
errorMsg:"错误信息"
}
function loadFullScreenAd() {
var yyAds = api.require('moduleYYAds');
yyAds.loadFullScreenAd({ad_id:"请填写从游易官网获取的全屏视频广告位ID"},function(success,error){
var result = success || error
try {
var resJsonStr = JSON.stringify(result);
console.log(resJsonStr);
} catch (err) {
console.log(err);
}
});
}
iOS系统 可提供的1.0.0版本
获取信息流广告 loadNativeAd({params},callback(success,error))
ad_id:
类型:字符串 描述:从游易官网获取的广告位ID x: 类型: 数字类型 描述: 插件左上角的x坐标 (相对于所属的Window 或 Frame)
y:
类型: 数字类型 描述: 插件左上角的y坐标 (相对于所属的Window 或 Frame)
w:
类型: 数字类型 描述: 插件的宽度,页面从x位置开始自动充满所属的Window或Frame的宽度,填写375即可,否则可能获取不到广告
success:
类型:JSON对象 内部字段:
{
status:onAdDownloadSuccess/onAdClick/onAdClosed
}
error:
类型:JSON对象 内部字段:
{
errorCode:0, //数字类型
errorMsg:"错误信息"
}
function loadNativeAd() {
var yyAds = api.require('moduleYYAds');
yyAds.loadNativeAd({ad_id:"请填写从游易官网获取的信息流广告位ID",x:0,y:84,w:375},function(success,error){
var result = success || error
try {
var resJsonStr = JSON.stringify(result);
console.log(resJsonStr);
} catch (err) {
console.log(err);
}
});
}
iOS系统 可提供的1.0.0版本
获取Draw视频广告 loadDrawAd({params},callback(success,error))
ad_id:
类型:字符串 描述:从游易官网获取的广告位ID
success:
类型:JSON对象 内部字段:
{
status:onAdDownloadSuccess/onAdClick/onAdClosed
}
error:
类型:JSON对象 内部字段:
{
errorCode:0, //数字类型
errorMsg:"错误信息"
}
function loadDrawAd() {
var yyAds = api.require('moduleYYAds');
yyAds.loadDrawAd({ad_id:"请填写从游易官网获取的Draw广告位ID"},function(success,error){
var result = success || error
try {
var resJsonStr = JSON.stringify(result);
console.log(resJsonStr);
} catch (err) {
console.log(err);
}
});
}
iOS系统 可提供的1.0.0版本