chanceAd

来自于:畅思广告立即使用

概述

畅思广告平台,是触控科技旗下的专业移动开发者和广告主服务平台。本模块封装了畅思多个 SDK 产品,只需简单调用几个接口即可实现对广告平台的集成。目前包括:横幅(Banner)、插屏(Interstitial)广告。

开发者需要注意在畅思后台为自己的 App 申请独立的 Publisher ID 和 Placement ID参见基本概念

initChanceAd

广告SDK初始化

params

adType:

  • 类型:字符串
  • 描述:广告类型,0 横幅类型;1 插屏类型;

publisherID:

  • 类型:字符串
  • 描述:应用 ID(详见基本概念),不能为空,且必须为在畅思广告平台后台中申请的正确应用 ID

placementID:

  • 类型:字符串
  • 描述:广告位 ID(详见基本概念),不能为空,且必须为您在畅思广告平台后台申请的对应广告位 ID

示例代码

var chance = api.require('chanceAd');
chance.initChanceAd({
    adType: "0",
    publisherID: "100032-4CE817-ABA2-5B48-14D009296720",
    placementID: ""
}, function(ret, err) {});

补充说明

该方法只适用于Android平台,每种广告类型使用前均需要调用。iOS平台可以不调用

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showBanner

展示横幅广告(banner)

showBanner({params}, callback(ret, err))

params

publisherID:

  • 类型:字符串
  • 描述:应用 ID(详见基本概念),不能为空,且必须为在畅思广告平台后台中申请的正确应用 ID

placementID:

  • 类型:字符串
  • 描述:广告位 ID(详见基本概念),不能为空,且必须为您在畅思广告平台后台申请的对应横幅广告位 ID

x:

  • 类型:浮点数
  • 描述:横幅广告显示位置的 X 坐标

y:

  • 类型:浮点数
  • 描述:横幅广告显示位置的 Y 坐标

requestInterval:

  • 类型:整数
  • 描述:横幅广告相邻两次广告请求的请求间隔

displayTime:

  • 类型:整数
  • 描述:横幅广告一次广告的展现时长

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
     Type:Banner                                  // 广告类型Banner
     Msg:ReceiveAd、ADError、WillShow、DidRemove   // banner 广告状态
}

err:

  • 类型:JSON 对象

内部字段:

{
    errorid:0    //错误码
    msg:""       //错误描述
}

示例代码

var chance = api.require('chanceAd');
chance.showBanner({
    publisherID: "100032-4CE817-ABA2-5B48-14D009296720",
    placementID: "",
    x: "0",
    y: "20",
    "requestInterval": "20",
    "displayTime": "15"
}, function(ret, err) {});

补充说明

此接口向广告平台请求横幅(banner)广告并自动显示

目前我们所支持的横幅广告尺寸包括

Size Recommended
320x50 iPhone/iPod Touch
728x90 iPad

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

removeBanner

移除横幅广告(banner)

removeBanner({params}, callback(ret, err))

params

为空即可

callback

无回调

示例代码

var chance = api.require('chanceAd');
chance.removeBanner({}, function(ret, err) {});

showInterstitial

展现插屏广告(interstitial)

showInterstitial({params}, callback(ret, err))

params

publisherID:

  • 类型:字符串
  • 描述:应用 ID(详见基本概念),不能为空,且必须为在畅思广告平台后台中申请的正确应用 ID

placementID:

  • 类型:字符串
  • 描述:广告位 ID(详见基本概念),不能为空,且必须为您在畅思广告平台后台申请的对应插屏广告位 ID

scale:

  • 类型:浮点数
  • 描述:插屏广告显示比例

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    Type:Interstitial,                                            // 广告类型Interstitial
    Msg:LoadFinished、ADError、DidShow、WillClose、DidClose       // Interstitial广告状态
}

err:

  • 类型:JSON 对象

内部字段:

{
    errorid:0    //错误码
    msg:""       //错误描述
}

示例代码

var chance = api.require('chanceAd');
chance.showInterstitial({
    publisherID: "100032-4CE817-ABA2-5B48-14D009296720",
    placementID: "",
    scale: "0.9"
}, function(ret, err) {});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

closeInterstitial

关闭插屏广告(Interstitial)

closeInterstitial({params}, callback(ret, err))

params

为空即可

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    Type:Interstitial                                            // 广告类型Interstitial
    Msg:LoadFinished、ADError、DidShow、WillClose、DidClose       // Interstitial广告状态
}

err:

  • 类型:JSON 对象

内部字段:

{
    code:0    //错误码
    msg:""    //错误描述
}

示例代码

var chance = api.require('chanceAd');
chance.closeInterstitial({}, function(ret, err) {});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showMoreGame

展示精品推荐广告(MoreGame) (畅思广告平台已废弃此接口)

showMoreGame({params}, callback(ret, err))

params

publisherID:

  • 类型:字符串
  • 描述:应用 ID(详见基本概念),不能为空,且必须为在畅思广告平台后台中申请的正确应用 ID

placementID:

  • 类型:字符串
  • 描述:广告位 ID(详见基本概念),不能为空,且必须为您在畅思广告平台后台申请的对应横幅广告位 ID

scale:

  • 类型:浮点数
  • 描述:插屏广告显示比例

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    Type:MoreGame                                               // 广告类型MoreGame
    Msg:LoadFinished、ADError、DidShow、WillClose、DidClose       // Interstitial广告状态
}

err:

  • 类型:JSON 对象

内部字段:

{
    errorid:0    //错误码
    msg:""       //错误描述
}

示例代码

var chance = api.require('chanceAd');
chance.showMoreGame({
    publisherID: "100032-4CE817-ABA2-5B48-14D009296720",
    placementID: "",
    scale: "0.9"
}, function(ret, err) {});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

closeMoreGame

关闭精品推荐广告(MoreGame) (畅思广告平台已废弃此接口)

closeMoreGame({params}, callback(ret, err))

params

为空即可

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    Type:Interstitial                                            // 广告类型Interstitial
    Msg:LoadFinished、ADError、DidShow、WillClose、DidClose       // Interstitial广告状态
}

err:

  • 类型:JSON 对象

内部字段:

{
    code:0    //错误码
    msg:""    //错误描述
}

示例代码

var chance = api.require('chanceAd');
chance.closeMoreGame({}, function(ret, err) {});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

基本概念

  • PublisherID:应用 ID,您的 App 在畅思广告平台中的唯一标识。
  • PlacementID:广告位 ID,媒体在畅思广告平台中为某类广告申请的广告位标识。

广告类型

类型 说明
Banner 横幅广告
Intersititial 插屏广告