讯飞移动广告平台Android SDK接入指南.docx
《讯飞移动广告平台Android SDK接入指南.docx》由会员分享，可在线阅读，更多相关《讯飞移动广告平台Android SDK接入指南.docx（11页珍藏版）》请在冰豆网上搜索。
讯飞移动广告平台AndroidSDK接入指南
科大讯飞股份有限公司
iFLYTEKCO.,LTD
讯飞移动广告平台
AndroidSDK接入指南
讯飞移动广告平台
讯飞移动广告平台聚焦移动广告聚合优化，通过先进的收入优化算法和简单易用的管理界面，帮助开发者快速实现应用变现，大幅提高移动广告收入。
独创的智能语音交互广告，打破了传统广告交互形式，让广告变得更生动有趣，从而带来极致的广告体验和最高效的广告收益。
1.概述
欢迎使用讯飞移动广告平台。
通过本文档，您可以在几分钟之内轻松完成移动广告的集成过程。
集成过1.0~1.6版本SDK的开发者朋友，请先阅读SDK2.0集成注意事项，方便您快速集成。
2.集成说明
2.1申请appid
在
2.2导入SDK
1.下载最新版SDK的zip包，将其中的libs文件夹下jar文件复制到本地工程libs子目录下。
2.Eclipse用户右键点击工程根目录，选择Properties->JavaBuildPath->Libraries，然后点击AddExternalJARs...选择指向jar的路径，点击OK，即导入成功。
2.3配置AndroidManifest文件
打开AndroidManifest.xml文件，增加如下权限：
权限
用途
INTERNET
允许程序联网和发送统计数据的权限
ACCESS_NETWORK_STATE
允许应用检测网络连接状态
READ_PHONE_STATE
允许应用以只读的方式访问手机设备的信息，通过获取的信息来唯一标识用户
ACCESS_WIFI_STATE
允许程序访问Wi-Fi网络状态信息
WRITE_EXTERNAL_STORAGE
写sd卡的权限，用于缓存广告所用到的图片，节省流量，并可获得更好的用户体验
READ_EXTERNAL_STORAGE
读sd卡的权限，意义同WRITE_EXTERNAL_STORAGE
ACCESS_FINE_LOCATION
获取设备的上传数据时的位置信息，提高统计精准度
GET_TASKS
获取当前应用的运行信息
WAKE_LOCK
唤醒手机，保证广告正常下载
meta-data
用途
IFLYTEK_APPKEY_AD
用来唯一标识您的应用，请将以下示例代码中your_appid替换为您在讯飞移动广告平台申请的应用appid。
代码示例：
2.4组件声明
2.5添加旗帜广告
旗帜广告，即Banner广告，可以将该广告视图放于任何可以容纳的位置（容纳的容器或位置必须在屏幕内并且尺寸等于或大于广告视图，推荐放在界面的顶部或底部）。
旗帜广告具备轮播功能，默认15秒轮播一次。
为了提高应用体验效果，开发者可以为放置广告的Layout自定义背景色或背景图片。
2.6添加插屏广告
插屏广告，是一种开发者可以在界面过场时请求并根据需要进行展示的间质性广告形式。
用户通过点击插屏广告右上角的叉号图片，将广告取消。
目前，插屏广告不支持横屏模式。
2.7添加全屏广告
全屏广告，一种覆盖整个屏幕进行广告展示的广告类型。
广告展示一定时间后退出展示，展示时间可设置。
全屏广告的全屏显示可以通过移除标题栏和状态栏实现，代码参考Demo。
2.8接口说明
2.8.1错误码
列举了广告请求失败的错误原因，在onAdFailed（AdErrorerror）中返回。
错误码
描述
70200
广告请求成功
70204
请求成功，但是无广告内容
70400
无效的广告位ID
70403
当日广告请求次数达到上限
70500
服务错误
71001
未知错误
71002
无效的广告请求，比如：
请求频率过快
71003
网络错误
71004
Permission未设置
71005
Appid为空
71006
无效的Appid
71007
广告位ID为空
71008
广告页面加载超时
71009
广告页面加载异常
71010
手机无浏览器
2.8.2广告尺寸
IFLYAdSize
表示请求的广告尺寸，具有width和height两个属性，单位为dip。
须使用SDK提供的尺寸类型：
IFLYAdSize.BANNER,IFLYAdSize.INTERSTITIAL,IFLYAdSize.FULLSCREEN。
2.8.3对外接口
（1）publicvoidsetAdSize（IFLYAdSizeadSize）
设置要请求的广告大小（在第一次请求广告前设置）。
（2）publicvoidsetParameter（Stringkey,Stringvalue）
广告参数设置，请参考2.8.4。
（3）publicvoidloadAd（IFLYAdListenerlistener）
请求广告。
（4）publicvoidshowAd（）
展示广告。
2.8.4广告可设置参数
参数
说明
适用范围
APPID
广告应用ID
旗帜、插屏、全屏
DEBUG_MODE
设置是否调试模式，调试模式下可查看log，默认调试模式
旗帜、插屏、全屏
BACK_KEY_ENABLE
点击手机后退键是否销毁插屏广告，默认销毁广告
插屏
SHOW_TIME_FULLSCREEN
全屏广告展示时间，范围5000~10000，默认5000；如果设为-1，则使用叉号方式退出全屏广告
全屏
DOWNLOAD_ALERT
弹出下载广告提示框，默认不弹提示框
旗帜、插屏、全屏
使用示例：
bannerAd.setParameter（AdKeys.APPID,"544e2c99"）;
bannerAd.setParameter（AdKeys.DEBUG_MODE,"true"）;
interstitialAd.setParameter（AdKeys.BACK_KEY_ENABLE,"true"）;
fullScreenAd.setParameter（AdKeys.SHOW_TIME_FULLSCREEN,"6000"）;
bannerAd.setParameter（AdKeys.DOWNLOAD_ALERT,"true"）;
2.8.5事件监听
添加广告时，可以通过一些监听事件接收广告当前状态。
广告监听事件类IFLYAdListener定义的具体事件函数如下表：
监听事件
事件描述
onAdReceive
广告请求成功
onAdFailed
广告请求失败，同时返回错误码及描述
onAdClick
广告被点击
onAdClose
广告被关闭
3.混淆代码
工程混淆设置：
如需打包或者生成APK的时候进行混淆，在proguard.cfg中添加如下代码：
-keepclasscom.iflytek.voiceads.**{*;}
4.常见问题
1.Q:
adUnitId是什么？
A:
adUnitId，即广告位ID，是讯飞移动广告平台为每个广告位分配的唯一标识符。
2.Q:
可以自己设置广告的请求地址吗？
A:
请求地址封装于SDK内部，不允许用户自行设置。
3.Q:
SDK都支持哪些android版本？
A:
要求采用android2.3或更高版本。
4.Q:
如何查看广告SDK版本？
A:
利用Version.getVersion（）可获得广告SDK版本号。
5.SDK2.0集成注意事项
1.AndroidManifest.xml中请勿漏写权限声明，请参考2.3。
2.AndroidManifest.xml中需添加DownloadService，请参考2.4。
3.新增设置选项，请参考2.8.4：
1）广告下载前，可以设置弹出下载提示框，旗帜、插屏、全屏广告设置方式相同。
如：
bannerAd.setParameter（AdKeys.DOWNLOAD_ALERT,"true"）;
2）全屏广告展示时间设置，有效设置范围为5000~10000和-1。
设为-1时，通过点击全屏广告右上角的叉号控件退出广告。
如：
fullScreenAd.setParameter（AdKeys.SHOW_TIME_FULLSCREEN,"6000"）;
主流合作媒体
WiFi万能钥匙
WiFi万能钥匙是最好用的智能手机免费WiFi管理工具，云端数据库内置千万Wi-Fi热点数据包括中国电信百万ChinaNet热点数据，帮你随时随地免费连上附近WiFi热点，轻轻松松免费上网社交聊天、学习、购物、看电影、看视频、看新闻资讯、看美图、看搞笑段子、玩游戏、听音乐、看漫画、找女朋友！
WiFi万能钥匙——连接免费WiFi的上网神器，扫除无网断网状态，提高移动办公效率，尤其适合学生、商务、移动人群和重度网虫。
懒人听书
懒人听书是国内最受欢迎的有声阅读应用，通过两年的发展目前已积累上亿用户，是国内使用人数最多的移动互联网音频类产品。
懒人听书有声正版阅读资源丰富，每天不断录制更新，内容适用于不同年龄人群的手机用户使用，老人、白领、学生、儿童都可以在懒人听书上找到自己喜欢的资源。
快手看片
快手看片是下载量第一的聚合视频软件，免费高清在线播放，万部电影，18种分类：
电视剧，电影，综艺，动漫，纪实，微电影，轻视频，韩剧，欧美频道，浪漫爱情，动作战争，热点精选，新闻，咨询，音乐，搞笑，体育一网打尽。
完整收录了优酷、土豆、腾讯视频、搜狐视频、新浪、酷六、奇艺、乐视、芒果卫视、56、CNTV、PPTV等各大视频网络内容。
好豆菜谱
好豆菜谱是中国美食大全，提供多种菜系的做法，以及针对不同人群的食谱，是下厨房必备的美食菜谱软件。
好豆菜谱拥有中国最全的优质菜谱数据40多万道，包含人群分类和疾病调理的药膳食疗，提供各种健康饮食指导建议。
爱生活，爱美食，爱做菜，爱下厨，使用好豆菜谱，开启幸福生活！
微信锁
微信锁是一款微信隐私卫士，专注锁定微信社交隐私空间，对微信信息安全实现前“锁”未有的加密保护。
微信锁（微信伴侣），即使在亲朋好友、同事把玩你手机，也可以很好的伪装，不用担心会泄露你的微信聊天记录、朋友圈、微信支付及红包隐私信息。
围棋宝典
围棋宝典含大量精解专辑、棋谱、习题，是一款可以随时随地打谱、做题、学习、对弈（包括IGS即时对弈、非即时对弈、人机对弈）、棋力测试、研讨的免费手机围棋软件，所有资料精挑细选，是谓宝典；均带有文字解说和分支变化图。
愤怒的富翁
愤怒的富翁旨在让用户在玩游戏中获得金币奖励，同时也可以看网页来赚金币，金币都可以兑换成q币话费。
只要您是游戏达人，每天都能进英雄榜，可以得到金币奖励。
挖矿石，练矿石，赚金币，挖5次就能挖到矿石甚至金币，挖到之后可以去练矿石卖金币，何乐而不为。
股票龙虎榜
股票龙虎榜是一款为了迎合趋势投资和捕捉强势股而设计的一款软件。
股票龙虎榜主要用来收集每个交易日上海证券交易所和深圳证券交易所公布的公开交易信息数据,然后对数据进行分析，以供投资者参考。
讯飞语音+
讯飞语音+是一款支持语音合成、语音识别、语音播报和语音搜索的智能语音服务软件，可以运用在任何可以调用语音接口的APP中。
随着移动互联网的兴起，手机端搜索也开始崭露头角，并开始高速发展。
讯飞语音+便能帮您实现这样的扁平式搜索功能，因其对中文的解析度非常高、对中文的语音输出准确性很强，你可以通过它玩转语音搜索。
有谁能比中国人更了解中文呢？
语音搜索当选讯飞语音+。
2345浏览器
最“省钱”的浏览器！
国内唯一可以免费打电话的手机浏览器，小巧稳定且最省流量，集成了网址导航、新闻资讯、影视娱乐等海量内容！
网页智能压缩加载，后退不重新加载，智能拦截广告，全方位为您节省宝贵流量！
0秒启动，网页浏览预加载，上网提速5倍！
手势操作前进后退，快捷又方便！
讯飞移动广告平台
升级会员 