moduleYYAds

来自于:开发者立即使用

概述

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))

params

ad_id:

类型:字符串 描述:从游易官网获取的广告位ID

callback(success,error)

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))

params

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,此字段不传即不需开启轮播

callback

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版本

InterstitialAd模块

获取插屏广告 loadInterstitialAd({params},callback(success,error))

params

ad_id:

类型:字符串 描述:从游易官网获取的广告位ID

callback

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版本

RewardAd

获取激励视频广告 loadRewardAd({params},callback(success,error))

params

ad_id:

类型:字符串 描述:从游易官网获取的广告位ID user_id: 类型:字符串 描述:用于上传到广告源平台,非必传字段

callback

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版本

fullScreenAd

获取全屏视频广告 loadFullScreenAd({params},callback(success,error))

params

ad_id:

类型:字符串 描述:从游易官网获取的广告位ID

callback

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版本

NativeAd模块

获取信息流广告 loadNativeAd({params},callback(success,error))

params

ad_id:

类型:字符串 描述:从游易官网获取的广告位ID x: 类型: 数字类型 描述: 模块左上角的x坐标 (相对于所属的Window 或 Frame)

y:

类型: 数字类型 描述: 模块左上角的y坐标 (相对于所属的Window 或 Frame)

w:

类型: 数字类型 描述: 模块的宽度,页面从x位置开始自动充满所属的Window或Frame的宽度,填写375即可,否则可能获取不到广告

callback

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版本

DrawAd

获取Draw视频广告 loadDrawAd({params},callback(success,error))

params

ad_id:

类型:字符串 描述:从游易官网获取的广告位ID

callback

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版本