chanceAd

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

initChanceAd showBanner removeBanner showInterstitial closeInterstitial showMoreGame closeMoreGame

概述

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

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

initChanceAd

广告SDK初始化

params

adType:

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

publisherID:

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

placementID:

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

示例代码

  1. var chance = api.require('chanceAd');
  2. chance.initChanceAd({
  3. adType: "0",
  4. publisherID: "100032-4CE817-ABA2-5B48-14D009296720",
  5. placementID: ""
  6. }, 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 对象

内部字段:

  1. {
  2. Type:Banner // 广告类型Banner
  3. Msg:ReceiveAdADErrorWillShowDidRemove // banner 广告状态
  4. }

err:

  • 类型:JSON 对象

内部字段:

  1. {
  2. errorid:0 //错误码
  3. msg:"" //错误描述
  4. }

示例代码

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

补充说明

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

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

SizeRecommended
320x50iPhone/iPod Touch
728x90iPad

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

removeBanner

移除横幅广告(banner)

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

params

为空即可

callback

无回调

示例代码

  1. var chance = api.require('chanceAd');
  2. 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 对象

内部字段:

  1. {
  2. Type:Interstitial, // 广告类型Interstitial
  3. Msg:LoadFinishedADErrorDidShowWillCloseDidClose // Interstitial广告状态
  4. }

err:

  • 类型:JSON 对象

内部字段:

  1. {
  2. errorid:0 //错误码
  3. msg:"" //错误描述
  4. }

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

closeInterstitial

关闭插屏广告(Interstitial)

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

params

为空即可

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. Type:Interstitial // 广告类型Interstitial
  3. Msg:LoadFinishedADErrorDidShowWillCloseDidClose // Interstitial广告状态
  4. }

err:

  • 类型:JSON 对象

内部字段:

  1. {
  2. code:0 //错误码
  3. msg:"" //错误描述
  4. }

示例代码

  1. var chance = api.require('chanceAd');
  2. 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 对象

内部字段:

  1. {
  2. Type:MoreGame // 广告类型MoreGame
  3. Msg:LoadFinishedADErrorDidShowWillCloseDidClose // Interstitial广告状态
  4. }

err:

  • 类型:JSON 对象

内部字段:

  1. {
  2. errorid:0 //错误码
  3. msg:"" //错误描述
  4. }

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

closeMoreGame

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

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

params

为空即可

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. Type:Interstitial // 广告类型Interstitial
  3. Msg:LoadFinishedADErrorDidShowWillCloseDidClose // Interstitial广告状态
  4. }

err:

  • 类型:JSON 对象

内部字段:

  1. {
  2. code:0 //错误码
  3. msg:"" //错误描述
  4. }

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

基本概念 广告类型

基本概念

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

广告类型

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