zySigmobAd

adGetVersions adRequestPermission

adInit adShowSplash adShowInteraction adLoadRewardVideo adShowRewardVideo adLoadFullScreenVideo adShowFullScreenVideo

论坛示例

为帮助用户更好更快的使用插件，请访问示例说明页面

概述

插件简介

zySigmobAd封装Sigmob移动广告平台 Android、Ios广告sdk，包含开屏、插屏、激励视频、全屏视频等功能 。

IOS 云编译最低版本为11.0，Android云编译最低版本为4.0.3。

使用插件前请先到Sigmob移动广告平台后台注册帐号、新建应用、添加代码位使用。插件中默认测试代码位可直接测试使用。

点击进入快手联盟控制台

插件接口

adGetVersions

获取当前集成的sdk版本号

adGetVersions(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
  status:true, //调用成功
  result:"1.0",//结果
}

示例代码

var zySigmobAd = api.require('zySigmobAd');
zySigmobAd.adGetVersions(function(ret){
  alert("zySigmobAd："+JSON.stringify(ret));
});

可用性

Android系统，ios系统

可提供的2.0.0及更高版本

adRequestPermission

设置插件所需权限可提高收益(请在必要时申请) 安卓：获取权限 苹果为：ios14以上才有的获取idfa权限(低版本自动有)

adRequestPermission(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
  status:true, //安卓不返回 苹果返回idfa值
  result:"XXXX",//结果
}

示例代码

var zySigmobAd = api.require('zySigmobAd');
zySigmobAd.adRequestPermission({},function(ret){
    alert("zySigmobAd："+JSON.stringify(ret));
});

可用性

Android系统，ios系统

可提供的2.0.0及更高版本

adInit

初始化插件（使用前必须）

adInit({params}, callback(ret))

params

appId:

  • 类型：字符串
  • 描述：（必选项）应用id
  • 默认值：无

appKey:

  • 类型：字符串
  • 描述：（必选项）应用appKey
  • 默认值：demo

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
  status:true,
  result:"初始化成功"
}

示例代码

var zySigmobAd = api.require('zySigmobAd');
var param = {
    appId:api.systemType=="ios"?"6877":"6878",
    appKey:api.systemType=="ios"?"eccdcdbd9adbd4a7":"8ebc1fd1c27e650c",
};
zySigmobAd.adInit(param,function(ret){
    console.log("zySigmobAd："+JSON.stringify(ret));
    api.removeLaunchView();
    api.toast({ msg:ret.result })
});

可用性

Android系统，ios系统

可提供的2.0.0及更高版本

adShowSplash

展示开屏广告

adShowSplash({params}, callback(ret))

params

codeId：

  • 类型：字符串
  • 描述：（必选项）代码位id
  • 默认值：无

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    status:	true的结果如下   				false结果则显示对应错误提示
    result:	加载中								具体错误码或原因说明
                加载成功						缓存失败
                ECPM:0
                缓存中
                缓存成功
                view添加
                展示
                点击
                跳过
                关闭
}

示例代码

var zySigmobAd = api.require('zySigmobAd');
var param = {
    codeId:api.systemType=="ios"?"ea1f8f9bd12":"ea1f8f21300",//代码位 ea1f8f21300 f66bcfb7641
    fetchDelay:5,//广告允许最大等待返回时间 默认5
    userId:"123456789",//用户ID 没有不用传
    options:{//加载扩展参数 没有不传
        //user_id:"123456",
    }
};
zySigmobAd.adShowSplash(param,function(ret){
    console.log("zySigmobAd："+JSON.stringify(ret));
    if(ret.status){
        if(ret.result == "展示"){
            api.setFullScreen({fullScreen: true,animation:"slide"});
        }
        if(ret.result == "关闭"){
            api.setFullScreen({fullScreen: false,animation:"slide"});
        }
    }else{
        api.toast({ msg:ret.result })
    }
});

可用性

Android系统，ios系统

可提供的2.0.0及更高版本

adShowInteraction

展示插屏广告

adShowInteraction({params}, callback(ret))

params

codeId：

  • 类型：字符串
  • 描述：（必选项）代码位id
  • 默认值：无

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
status	 true								false
result	 加载中								具体错误码或原因说明
            加载成功							缓存失败
            ECPM:0
            缓存中
            缓存成功
            view添加
            展示
            点击
            关闭

}

示例代码

var zySigmobAd = api.require('zySigmobAd');
var param = {
    codeId:api.systemType=='ios'?"f51c91aac60":"f51c93d4b5f",//代码位
};
zySigmobAd.adShowInteraction(param,function(ret){
    console.log("zySigmobAd："+JSON.stringify(ret));
    if(!ret.status){
        api.toast({ msg:ret.result })
    }
});

可用性

Android系统，ios系统

可提供的2.0.0及更高版本

adLoadRewardVideo

加载激励视频广告

adLoadRewardVideo({params}, callback(ret))

params

codeId：

  • 类型：字符串
  • 描述：（必选项）代码位id
  • 默认值：无

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
status	 true								false
result	 加载中								具体错误码或原因说明
            加载成功							缓存失败
            ECPM:0
            缓存中
            缓存成功
            展示
            点击
            奖励:true
            跳过
            关闭

}

示例代码

var zySigmobAd = api.require('zySigmobAd');
var param = {
    codeId:api.systemType=='ios'?"ea1f8f7b662":"ea1f8ea2d90",//代码位
};
api.showProgress({});
zySigmobAd.adLoadRewardVideo(param,function(ret){
    console.log("zySigmobAd："+JSON.stringify(ret));
    if(ret.status){
        if(ret.result == "缓存成功"){
            api.hideProgress();
            //缓存成功后可以展示广告
            //moduleClick('adShowRewardVideo');
            //api.setFullScreen({fullScreen: true,animation:"slide"});
        }
        if(ret.result == "关闭"){
            api.setFullScreen({fullScreen: false,animation:"slide"});
        }
    }else{
        api.hideProgress();
        api.toast({ msg:ret.result })
    }
});

可用性

Android系统，ios系统

可提供的2.0.0及更高版本

adShowRewardVideo

展示激励视频

adShowRewardVideo(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
  status:false,
  result:	请先加载广告
                 广告过期
}

示例代码

var zySigmobAd = api.require('zySigmobAd');
zySigmobAd.adShowRewardVideo(function(ret){
    console.log("zySigmobAd："+JSON.stringify(ret));
    if(!ret.status){
        api.toast({ msg:ret.result })
    }
});

可用性

Android系统，ios系统

可提供的2.0.0及更高版本

adLoadFullScreenVideo

加载全屏视频广告

adLoadFullScreenVideo({params}, callback(ret))

params

codeId：

  • 类型：字符串
  • 描述：（必选项）代码位id
  • 默认值：无

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
status	 true								false
result	 加载中								具体错误码或原因说明
            加载成功							缓存失败
            ECPM:0
            缓存中
            缓存成功
            展示
            点击
            跳过
            关闭

}

示例代码

var param = {
    codeId:api.systemType=='ios'?"ea1f8fb93fb":"ea1f8f45d80",//代码位
};
api.showProgress({});
zySigmobAd.adLoadFullScreenVideo(param,function(ret){
    console.log("zySigmobAd："+JSON.stringify(ret));
    if(ret.status){
        if(ret.result == "缓存成功"){
            api.hideProgress();
            //缓存成功后可以展示广告
            //moduleClick('adShowFullScreenVideo');
            //api.setFullScreen({fullScreen: true,animation:"slide"});
        }
        if(ret.result == "关闭"){
            api.setFullScreen({fullScreen: false,animation:"slide"});
        }
    }else{
        api.hideProgress();
        api.toast({ msg:ret.result })
    }
});

可用性

Android系统，ios系统

可提供的2.0.0及更高版本

adShowFullScreenVideo

展示全屏视频

adShowFullScreenVideo(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
status	false
result	请先加载广告
            广告过期
}

示例代码

var zySigmobAd = api.require('zySigmobAd');
zySigmobAd.adShowFullScreenVideo(function(ret){
    console.log("zySigmobAd："+JSON.stringify(ret));
    if(!ret.status){
        api.toast({ msg:ret.result })
    }
});

可用性

Android系统，ios系统

可提供的2.0.0及更高版本

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