mintegralAds

initSdk

showSplashAD

showBannerAD

closeBannerAD

showInterstitialAD

showFullScreenVideoAD

showRewardVideoAD

showNativeExpressAD

closeNativeExpressAD

概述

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

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