facebookAds

来自于：开发者立即使用

showBanner initInterstitial showInterstitial

概述

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

showBanner

展示横幅广告

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

params

rect：

类型：JSON 对象 描述：（必填项）模块的位置及尺寸 内部字段：

  1. {
  2.     x: 0,   //（必填项）数字类型；模块左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认值：0
  3.     y: 0,   //（必填项）数字类型；模块左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认值：0
  4.     w: 320, //（必填项）数字类型；模块的宽度；默认值：所属的 Window 或 Frame 的宽度
  5.     h: 50  //（必填项）数字类型；模块的高度；默认值：50
  6. }

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对象
  • 内部字段：
  1. {
  2.     status: 1      //布尔型；1||0，当前横幅广告是否展示成功
  3. }

err：

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

示例代码

  1. var demo = api.require('facebookAds');
  2. demo.showBanner({
  3.     rect: {x: 0, y: 0, w: 320, h: 50},
  4.     fbPlacementId: "YOUR_PLACEMENT_ID",
  5.     type: "banner50",
  6.     fixedOn : api.frameName,
  7.     fixed : true
  8. },function(ret, err){
  9.      if (ret.status) {
  10.      //alert(JSON.stringify(ret));
  11.      //横幅广告已成功展示
  12.      } else {
  13.      //alert(JSON.stringify(err));
  14.      //横幅广告展示失败，详情参考错误代码
  15.      }
  16. });

可用性

iOS系统

可提供的1.0.0及更高版本

initInterstitial

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

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

params

fbPlacementId:

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

callback(ret, err)

ret：

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

err：

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

示例代码

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

可用性

iOS系统

可提供的1.0.0及更高版本

showInterstitial

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

showInterstitial()

示例代码

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

可用性

iOS系统

可提供的1.0.0及更高版本