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及更高版本