facebookAds

来自于:开发者立即使用

概述

facebookAds封装了Facebook Audience Network的SDK。Facebook 的 Audience Network 使您能够通过定位明确的广告,让 iOS 和 Android 应用实现创收。该模块集成了iOS平台的不同尺寸的横幅广告和插屏广告。

showBanner

展示横幅广告

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

params

rect:

类型:JSON 对象 描述:(必填项)模块的位置及尺寸 内部字段:

{
    x: 0,   //(必填项)数字类型;模块左上角的 x 坐标(相对于所属的 Window 或 Frame);默认值:0
    y: 0,   //(必填项)数字类型;模块左上角的 y 坐标(相对于所属的 Window 或 Frame);默认值:0
    w: 320, //(必填项)数字类型;模块的宽度;默认值:所属的 Window 或 Frame 的宽度
    h: 50  //(必填项)数字类型;模块的高度;默认值:50
}

fixedOn:

类型:字符串 描述:(可选项)模块所属 Frame 的名字,若不传则模块归属于当前 Window

fixed:

类型:布尔 描述:((可选项)模块是否随所属 Window 或 Frame 滚动 默认值:true(不随之滚动)

fbPlacementId:

类型:字符串类型 描述:(必填项)横幅广告版位id(Facebook Placement ID)

type:

类型:字符串类型 描述:(必填项)横幅广告类型(Facebook AdSize)

  • 默认值:banner50
  • 取值范围:
    • banner50(kFBAdSizeHeight50Banner)
    • banner90(kFBAdSizeHeight90Banner)
    • banner250(kFBAdSizeHeight250Rectangle)

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: 1      //布尔型;1||0,当前横幅广告是否展示成功
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    code: ""     //字符串类型;
                //错误码:
                //1000 - Network Error
                //1001 - No Fill
                //1002 - Ad Load Too Frequently
                //1011 - Display Format Mismatch
                //1203 - Not An App Admin, Developer or Tester
                //2000 - Server Error
                //2001 - Internal Error
                //错误码详情即对应解决方案请参考https://developers.facebook.com/docs/audience-network/testing?locale=zh_CN
}

示例代码

var demo = api.require('facebookAds');
demo.showBanner({
    rect: {x: 0, y: 0, w: 320, h: 50},
    fbPlacementId: "YOUR_PLACEMENT_ID",
    type: "banner50",
    fixedOn : api.frameName,
    fixed : true
},function(ret, err){
     if (ret.status) {
     //alert(JSON.stringify(ret));
     //横幅广告已成功展示
     } else {
     //alert(JSON.stringify(err));
     //横幅广告展示失败,详情参考错误代码
     }
});

可用性

iOS系统

可提供的1.0.0及更高版本

initInterstitial

初始化插屏广告,初始化成功后才可以展示插屏广告

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

params

fbPlacementId:

类型:字符串类型 描述:(必填项)插屏广告版位id(Facebook Placement ID)

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: 1      //布尔型;1||0,当前横幅广告是否展示成功
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    code: ""     //字符串类型;
                //错误码:
                //1000 - Network Error
                //1001 - No Fill
                //1002 - Ad Load Too Frequently
                //1011 - Display Format Mismatch
                //1203 - Not An App Admin, Developer or Tester
                //2000 - Server Error
                //2001 - Internal Error
                //错误码详情即对应解决方案请参考https://developers.facebook.com/docs/audience-network/testing?locale=zh_CN
}

示例代码

var demo = api.require('facebookAds');
demo.initInterstitial({
    fbPlacementId: "YOUR_PLACEMENT_ID"
},function(ret, err){
     if (ret.status) {
     //alert(JSON.stringify(ret));
     //插屏广告初始化成功,可以调用showInterstitial方法来展示
     } else {
     //alert(JSON.stringify(err));
     //插屏广告初始化失败,详情参考错误代码
     }
});

可用性

iOS系统

可提供的1.0.0及更高版本

showInterstitial

展示插屏广告,需配合initInterstitial一起使用,初始化成功后才可以展示插屏广告

showInterstitial()

示例代码

var demo = api.require('facebookAds');
demo.initInterstitial({
    fbPlacementId: "YOUR_PLACEMENT_ID"
},function(ret, err){
     if (ret.status) {
     //alert(JSON.stringify(ret));
     //插屏广告初始化成功,可以调用showInterstitial方法来展示
     demo.showInterstitial();
     } else {
     //alert(JSON.stringify(err));
     //插屏广告初始化失败,详情参考错误代码
     }
});

可用性

iOS系统

可提供的1.0.0及更高版本