Mintegral Ads
/ Title: mintegralAds Description: Mintegral广告联盟 /
来自于:770104707@qq.com立即使用
概述
Mintegral广告联盟简介
Mintegral是全球性移动广告平台,为全球广告主和移动发布商提供用户获取、广告变现和创意解决方案。Mintegral致力于弥合东西方市场的差距,帮助合作伙伴降低跨区域移动营销的挑战性。
mintegralAds 模块概述
本模块封装了Mintegral广告联盟的原生 SDK,集成了开屏、横幅、插屏、全屏视频、激励视频、信息流;可用于实现app流量变现。(非上架google play版)
模块使用攻略
使用之前须从Mintegral广告联盟平台申请开发者账号并创建应用,获取 appId、appKey。
Mintegral广告联盟申请地址Mintegral广告联盟
使用此模块之前建议先配置 config.xml 文件,配置完毕,需通过云端编译生效,配置方法如下:
- 名称:mintegralAds
- 参数:android_appId、ios_appId、appKey
- 配置示例:
<feature name="mintegralAds">
<param name="android_appId" value="118690" />
<param name="ios_appId" value="118692" />
<param name="appKey" value="7c22942b749fe6a6e361b675e96b3ee9" />
</feature>
- 字段描述:
android_appId:安卓平台应用appId。
ios_appId:苹果平台应用appId。
appKey:集成广告所需的重要秘钥appKey。
模块接口
initSdk
sdk 初始化
initSdk({params},callback(ret, err))
params
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status: true, //初始化状态
code: 0, //状态码
type: 'onLoad', //事件类型 onInit
msg: "onInitSdk",//描述
result:{ //其他结果数据
version:"3.3.9" //sdk 版本号
}
}
示例代码
var mintegralAds = api.require('mintegralAds');
mintegralAds.initSdk({
appName:api.appName, //选填
},function(ret, err) {
if (ret.status) {
alert("sdk 初始化成功");
} else {
alert('sdk 初始化失败');
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
showSplashAD
开屏
showSplashAD({params}, callback(ret, err))
params
posId:
- 类型:字符串
- 描述:(必填)广告位ID。
unitId:
- 类型:字符串
- 描述:(必填)广告单元ID。
logo:
- 类型:字符串
- 描述:(可选项)开屏广告底部logo (widget://image/logo-bottom.png)[必须是widget://地址]
- 默认值:空
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status: true, //初始化状态
code: 0, //状态码
type: 'onLoad', //事件类型 onLoad onShow onClosed onClicked
msg: "描述",//描述
result:{ //其他结果数据
}
}
示例代码
var mintegralAds = api.require('mintegralAds');
mintegralAds.showSplashAD({
posId:"173349",
// posId:"177221",ios
unitId:"209547",
// unitId:"215246",ios
logo:"widget://image/logo-bottom.png"
}, function(ret, err) {
if (ret.status) {
if(ret.type == "onShow"){ //展示
}
if(ret.type == "onClosed"){ //关闭
}
} else {
alert(err.code);
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
showBannerAD
横幅
showBannerAD({params}, callback(ret, err))
params
posId:
- 类型:字符串
- 描述:(必填)广告位ID。
unitId:
- 类型:字符串
- 描述:(必填)广告单元ID。
rect
- 类型:对象
- 描述:(可选项)位置偏移量参数
{
}x:0, y:0, w:0, h:0,
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status: true, //初始化状态
code: 0, //状态码
type: 'onLoad', //事件类型 onLoad onShow onClosed onClicked
msg: "描述",//描述
result:{ //其他结果数据
}
}
示例代码
var mintegralAds = api.require('mintegralAds');
mintegralAds.showBannerAD({
posId:"138791",
// posId:"138804",ios
unitId: "146879",
// unitId: "146898", ios
rect:{
x:0,
y:api.frameHeight - (api.frameWidth/(20/3)),
w:api.frameWidth,
h:api.frameWidth/(20/3),
}
}, function(ret, err) {
if (ret.status) {
if(ret.type == "onShow"){ //展示
}
if(ret.type == "onClosed"){ //关闭
}
} else {
alert(err.code);
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
closeBannerAD
关闭横幅
closeBannerAD({params}, callback(ret, err))
params
无
callback(ret, err)
无
示例代码
var mintegralAds = api.require('mintegralAds');
mintegralAds.closeBannerAD({
}, function(ret, err) {
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
showInterstitialAD
插屏 (插屏图片)
showInterstitialAD({params}, callback(ret, err))
params
posId:
- 类型:字符串
- 描述:(必填)广告位ID。
unitId:
- 类型:字符串
- 描述:(必填)广告单元ID。
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status: true, //初始化状态
code: 0, //状态码
type: 'onLoad', //事件类型 onLoad onShow onClicked onClosed
msg: "描述",//描述
result:{ //其他结果数据
}
}
示例代码
var mintegralAds = api.require('mintegralAds');
mintegralAds.showInterstitialAD({
posId:"138783",
// posId:"138802",ios
unitId:"146871",
// unitId:"146896",ios
}, function(ret, err) {
if (ret.status) {
if(ret.type == "onShow"){ //展示
}
if(ret.type == "onClosed"){ //关闭
}
} else {
alert(err.code);
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
showFullScreenVideoAD
全屏视频 (插屏视频)
showFullScreenVideoAD({params}, callback(ret, err))
params
posId:
- 类型:字符串
- 描述:(必填)广告位ID。
unitId:
- 类型:字符串
- 描述:(必填)广告单元ID。
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status: true, //初始化状态
code: 0, //状态码
type: 'onLoad', //事件类型 onLoad onShow onClicked onCompleted onClosed
msg: "描述",//描述
result:{ //其他结果数据
}
}
示例代码
var mintegralAds = api.require('mintegralAds');
mintegralAds.showFullScreenVideoAD({
posId:"138781",
// posId:"138800",ios
unitId:"146869",
// unitId:"146894",ios
}, function(ret, err) {
if (ret.status) {
if(ret.type == "onShow"){ //展示
}
if(ret.type == "onClosed"){ //关闭
}
} else {
alert(err.code);
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
showRewardVideoAD
激励视频
showRewardVideoAD({params}, callback(ret, err))
params
posId:
- 类型:字符串
- 描述:(必填)广告位ID。
unitId:
- 类型:字符串
- 描述:(必填)广告单元ID。
userId:
- 类型:字符串
- 描述:(选填)用户标识。
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status: true, //初始化状态
code: 0, //状态码
type: 'onLoad', //事件类型 onLoad onShow onClicked onReward onCompleted onClosed
msg: "描述",//描述
result:{ //其他结果数据
}
}
示例代码
var mintegralAds = api.require('mintegralAds');
mintegralAds.showRewardVideoAD({
posId:"138786"
// posId:"138798",ios
unitId:"146892",
// unitId:"146894",ios
userId: "1",
}, function(ret, err) {
if (ret.status) {
if(ret.type == "onShow"){ //展示
}
if(ret.type == "onClosed"){ //关闭
}
} else {
alert(err.code);
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
showNativeExpressAD
信息流
showNativeExpressAD({params}, callback(ret, err))
params
posId:
- 类型:字符串
- 描述:(必填)广告位ID。
unitId:
- 类型:字符串
- 描述:(必填)广告单元ID。
frameName
- 类型:字符串
- 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
fixed
- 类型:布尔
- 描述:(可选项)模块是否不随所属 window 或 frame 浮动 默认值:false
scroll
- 类型:布尔
- 描述:(可选项)模块是否不随所属 window 或 frame 滚动 默认值:true
rect
- 类型:对象
- 描述:(可选项)位置偏移量参数
{
}x:0, y:0, w:0, h:0,
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status: true, //初始化状态
code: 0, //状态码
type: 'onLoad', //事件类型 onLoad onShow onClicked onCompleted onClosed onClicked
msg: "描述",//描述
result:{ //其他结果数据
}
}
示例代码
var mintegralAds = api.require('mintegralAds');
mintegralAds.showNativeExpressAD({
posId:"262716",
// posId:"204222",ios
unitId:"204222",
// unitId:"262716",ios
frameName:api.frameName,
fixed:false,
scroll:true,
rect:{
x:0,
y:0,
w:0,
h:0,
}
}, function(ret, err){
console.log(JSON.stringify(ret));
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
closeNativeExpressAD
关闭信息流
closeNativeExpressAD({params}, callback(ret, err))
params
无
callback(ret, err)
无
示例代码
var mintegralAds = api.require('mintegralAds');
mintegralAds.closeNativeExpressAD({
}, function(ret, err){
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本