wapsAd

来自于:开发者立即使用

initInstance getPoints spendPoints awardPoints showOffers showGameOffers setOffersCloseListener showBannerAd showPopAd initAdInfo getAdInfoList getAdInfo clickAd downloadAd

概述

wapsAd封装了万普世纪移动营销服务平台(以下称为“万普平台”)的 SDK, 提供了一套现成的开发 包,便于开发者在应用中方便的集成万普平台的各项功能。

本文档描述了标准版 SDK 的用途用法,并提供了示例代码。您仅需要在现有的应用中加入少 量新代码,就可以集成万普平台的各项功能,轻松获得用户量和收入的倍增。

iOS版本正在赶制中,近期将会推出,请求期待;技术支持QQ:277165921

使用万普平台基本流程说明:

1.在万普登录官网http://waps.cn 注册帐号,并创建应用,获取APP_ID

initInstance

初始化接口,该接口是所有其他接口能正常使用的基础,在每次应用启动时,必须调用该接口进行初始化操作, 才能保证获得准确的统计数据

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

params

APP_ID:

  • 类型:字符串
  • 描述:应用标识,从万普平台获取的 APP_ID。测试APP_ID:(android:0d3ad41e785f13f11726926634e18376 ios:c2aaae8743bb8d0a3ff60bd612e93078)

APP_PID:

  • 类型:字符串
  • 描述:分发渠道标识,可随意填写。

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"初始化成功!" //消息信息。
  4. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. var param = { APP_ID: "0d3ad41e785f13f11726926634e18376", APP_PID: "mengfei" };
  3. uzmoduledemo.startWork(param, function(ret, err) {
  4. if (ret) {
  5. alert(JSON.stringify(ret));
  6. }
  7. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

getPoints

从服务器端获取用户点数/虚拟货币余额

getPoints(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"操作成功!" //消息信息。
  4. currencyName:"积分" //名称:积分、金币。
  5. intpointTotal:"53" //积分数。
  6. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. uzmoduledemo.getPoints(function(ret, err) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

spendPoints

花费(扣减)用户虚拟货币

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

params

amount:

  • 类型:整型
  • 描述:扣减虚拟货币数。

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"操作成功!" //消息信息。
  4. currencyName:"积分" //名称:积分、金币。
  5. intpointTotal:"53" //积分数。
  6. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. var param = { amount: "1" };
  3. uzmoduledemo.spendPoints(param, function(ret, err) {
  4. if (ret) {
  5. alert(JSON.stringify(ret));
  6. }
  7. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

awardPoints

奖励(增加)用户虚拟货币

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

params

amount:

  • 类型:整型
  • 描述:扣减虚拟货币数。

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"操作成功!" //消息信息。
  4. currencyName:"积分" //名称:积分、金币。
  5. intpointTotal:"53" //积分数。
  6. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. var param = { amount: "10" };
  3. uzmoduledemo.spendPoints(param, function(ret, err) {
  4. if (ret) {
  5. alert(JSON.stringify(ret));
  6. }
  7. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

showOffers

积分墙接口,积分墙(也称 Offer,广告墙)是万普平台提供的一种集中展示型广告。开发者可在应用中合适的位 置加入“推荐应用”、“免费赚积分”等类似字样的功能,获取更高的广告收益

showOffers(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"操作成功!" //消息信息。
  4. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. uzmoduledemo.showOffers(function(ret, err) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

showGameOffers

游戏积分墙接口

showGameOffers(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"操作成功!" //消息信息。
  4. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. uzmoduledemo.showGameOffers(function(ret, err) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

setOffersCloseListener

设置关闭积分墙的监听接口,必须在showOffers接口之前调用

setOffersCloseListener(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"积分墙关闭!" //消息信息。
  4. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. uzmoduledemo.setOffersCloseListener(function(ret, err) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

showBannerAd

互动广告接口,互动广告是一个显示在应用内固定位置高度为 50 像素广告条,将自动显示万普平台提供的广告。结 合虚拟货币功能使用,可获得最佳的广告效果和用户体验

showBannerAd(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: false //布尔型;true||false
  3. msg:"Banner广告无数据" //消息信息。
  4. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. uzmoduledemo.showBannerAd(function(ret, err) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

showPopAd

插屏广告是推出的一种新型广告形式,以全屏对话框的新式显示广告,支持透明 背景和浮层特效。和传统 Banner 广告相比,显示效果更炫,转化率更高,而且具有良好的用户体 验。不占用固定广告位,特别适用于应用启动、游戏通关等场景使用。

showPopAd(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"获取成功!" //消息信息。
  4. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. uzmoduledemo.showPopAd(function(ret, err) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

initAdInfo

自定义广告接口,初始化(预先加载)广告数据,必须首先调用,开发者可通过自定义广告,广告接口获取所有可用广告的元数据,自定义广告的展现方式,便于让广告内容完全和您的应用 UI 融合,可显著提升广告效果。

该接口将在首次调用时,需要预先将所有可用广告的元数据(通常 20 条左右)全部获取到手 机内存,便于程序随时快速调用。广告数据首次加载时间视网络情况决定,通常需要花几秒钟时 间,因此,如果应用内需要使用自定义广告功能,建议在程序启动后,尽早先调用 initAdInfo()方法 预先异步加载一次元数据,便于后续调用 getAdInfo()或 getAdInfoList()方法时能立即获得数据。

initAdInfo(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"初始化成功!" //消息信息。
  4. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. uzmoduledemo.initAdInfo(function(ret, err) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

getAdInfoList

归属自定义广告接口,获取所有可用广告的元数据,必须在初始化(initAdInfo)方法后使用

getAdInfoList(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"获取成功!" //消息信息。
  4. data:[{
  5. "adPackage": "com.medapp.man",
  6. "adText": "免费健康顾问,告别难言之隐",
  7. "filesize": "3.98",
  8. "adId": "04d4be719a82ac5f794f3d832c5e23e9",
  9. "description": "\t男性私人医生是一款针对男性生理健康及其他相关专科类病症,提供在线咨询的医疗软件。尴尬症状会因为顾虑不方便表述或工作忙碌等原因而忽略去医院。本产品集合全国各城市几百家医院的资源,提供医疗健康咨询;免去挂号难,排队久的困扰,便捷的咨询过程,省时省事,为您的健康生活提供全面的保护。",
  10. "adIcon": "android.graphics.Bitmap@43519830",
  11. "action": "注册",
  12. "imageUrls": "[Ljava.lang.String;@43517f18",
  13. "provider": "天亚科创",
  14. "appType": "应用",
  15. "adName": "男性私人医生",
  16. "version": "3.0.60",
  17. "adPoint": 50
  18. }] //广告数据,json对象
  19. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. uzmoduledemo.getAdInfoList(function(ret, err) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

getAdInfo

归属自定义广告接口,随机获取一条广告的元数据,必须在初始化(initAdInfo)方法后使用

getAdInfo(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"获取成功!" //消息信息。
  4. data:{
  5. "adPackage": "com.medapp.man",
  6. "adText": "免费健康顾问,告别难言之隐",
  7. "filesize": "3.98",
  8. "adId": "04d4be719a82ac5f794f3d832c5e23e9",
  9. "description": "\t男性私人医生是一款针对男性生理健康及其他相关专科类病症,提供在线咨询的医疗软件。尴尬症状会因为顾虑不方便表述或工作忙碌等原因而忽略去医院。本产品集合全国各城市几百家医院的资源,提供医疗健康咨询;免去挂号难,排队久的困扰,便捷的咨询过程,省时省事,为您的健康生活提供全面的保护。",
  10. "adIcon": "android.graphics.Bitmap@43519830",
  11. "action": "注册",
  12. "imageUrls": "[Ljava.lang.String;@43517f18",
  13. "provider": "天亚科创",
  14. "appType": "应用",
  15. "adName": "男性私人医生",
  16. "version": "3.0.60",
  17. "adPoint": 50
  18. } //广告数据,json对象
  19. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. uzmoduledemo.getAdInfo(function(ret, err) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

clickAd

归属自定义广告接口,当广告被点击时,显示广告详情

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

params

adId:

  • 类型:字符串
  • 描述:广告ID。

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"操作成功!" //消息信息。
  4. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. var param = {
  3. adId: "04d4be719a82ac5f794f3d832c5e23e9"
  4. };
  5. uzmoduledemo.clickAd(param, function(ret, err) {
  6. alert(JSON.stringify(ret));
  7. });

可用性

Android系统,iOS系统暂不支持,将于近期更新

可提供的1.0.0及更高版本

downloadAd

当用户确认要下载广告应用时,启动下载(仅适用于应用下载类广告)

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

params

adId:

  • 类型:字符串
  • 描述:广告ID。

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. msg:"下载广告中" //消息信息。
  4. }

示例代码

  1. var uzmoduledemo = api.require('wapsAd');
  2. var param = {
  3. adId: "04d4be719a82ac5f794f3d832c5e23e9"
  4. };
  5. uzmoduledemo.downloadAd(param, function(ret, err) {
  6. alert(JSON.stringify(ret));
  7. });

可用性

Android系统

可提供的1.0.0及更高版本