讯飞移动广告平台Android SDK接入指南.docx

1、讯飞移动广告平台Android SDK接入指南 科大讯飞股份有限公司iFLYTEK CO.,LTD讯飞移动广告平台Android SDK接入指南讯飞移动广告平台讯飞移动广告平台聚焦移动广告聚合优化，通过先进的收入优化算法和简单易用的管理界面，帮助开发者快速实现应用变现，大幅提高移动广告收入。独创的智能语音交互广告，打破了传统广告交互形式，让广告变得更生动有趣，从而带来极致的广告体验和最高效的广告收益。1.概述欢迎使用讯飞移动广告平台。通过本文档，您可以在几分钟之内轻松完成移动广告的集成过程。集成过1.01.6版本SDK的开发者朋友，请先阅读SDK2.0集成注意事项，方便您快速集成。2.集成说明

2、2.1申请appid在2.2导入SDK1.下载最新版SDK的zip包，将其中的libs 文件夹下jar文件复制到本地工程libs子目录下。2.Eclipse用户右键点击工程根目录，选择Properties - Java Build Path - Libraries，然后点击Add External JARs. 选择指向jar的路径，点击OK，即导入成功。2.3配置AndroidManifest文件打开AndroidManifest.xml文件，增加如下权限：权限用途INTERNET允许程序联网和发送统计数据的权限ACCESS_NETWORK_STATE允许应用检测网络连接状态READ_PHON

3、E_STATE允许应用以只读的方式访问手机设备的信息，通过获取的信息来唯一标识用户ACCESS_WIFI_STATE允许程序访问Wi-Fi网络状态信息WRITE_EXTERNAL_STORAGE写sd卡的权限，用于缓存广告所用到的图片，节省流量，并可获得更好的用户体验READ_EXTERNAL_STORAGE读sd 卡的权限，意义同WRITE_EXTERNAL_STORAGEACCESS_ FINE_LOCATION获取设备的上传数据时的位置信息，提高统计精准度GET_TASKS获取当前应用的运行信息WAKE_LOCK唤醒手机，保证广告正常下载meta-data用途IFLYTEK_APPKEY

4、_AD用来唯一标识您的应用，请将以下示例代码中your_appid替换为您在讯飞移动广告平台申请的应用appid。代码示例：2.4组件声明2.5添加旗帜广告旗帜广告，即Banner 广告，可以将该广告视图放于任何可以容纳的位置（容纳的容器或位置必须在屏幕内并且尺寸等于或大于广告视图，推荐放在界面的顶部或底部）。旗帜广告具备轮播功能，默认15秒轮播一次。为了提高应用体验效果，开发者可以为放置广告的Layout自定义背景色或背景图片。2.6添加插屏广告插屏广告，是一种开发者可以在界面过场时请求并根据需要进行展示的间质性广告形式。 用户通过点击插屏广告右上角的叉号图片，将广告取消。目前，插屏广告不支

5、持横屏模式。2.7添加全屏广告全屏广告，一种覆盖整个屏幕进行广告展示的广告类型。广告展示一定时间后退出展示，展示时间可设置。全屏广告的全屏显示可以通过移除标题栏和状态栏实现，代码参考Demo。2.8接口说明2.8.1 错误码列举了广告请求失败的错误原因，在onAdFailed (AdError error)中返回。错误码描述70200广告请求成功70204请求成功，但是无广告内容70400无效的广告位ID70403当日广告请求次数达到上限70500服务错误71001未知错误71002无效的广告请求，比如：请求频率过快71003网络错误71004Permission未设置71005Appid为空

6、71006无效的Appid71007广告位ID为空71008广告页面加载超时71009广告页面加载异常71010手机无浏览器2.8.2 广告尺寸IFLYAdSize表示请求的广告尺寸，具有width和height两个属性，单位为dip。须使用SDK提供的尺寸类型：IFLYAdSize.BANNER, IFLYAdSize.INTERSTITIAL, IFLYAdSize.FULLSCREEN。2.8.3 对外接口(1)public void setAdSize (IFLYAdSize adSize)设置要请求的广告大小（在第一次请求广告前设置）。(2)public void setParame

7、ter (String key, String value)广告参数设置，请参考2.8.4。(3)public void loadAd (IFLYAdListener listener)请求广告。(4)public void showAd ()展示广告。2.8.4 广告可设置参数参数说明适用范围APPID广告应用ID旗帜、插屏、全屏DEBUG_MODE设置是否调试模式，调试模式下可查看log，默认调试模式旗帜、插屏、全屏BACK_KEY_ENABLE点击手机后退键是否销毁插屏广告，默认销毁广告插屏SHOW_TIME_FULLSCREEN全屏广告展示时间，范围500010000，默认5000；如

8、果设为-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.setParame

9、ter(AdKeys.DOWNLOAD_ALERT, true);2.8.5 事件监听添加广告时，可以通过一些监听事件接收广告当前状态。广告监听事件类IFLYAdListener定义的具体事件函数如下表：监听事件事件描述onAdReceive广告请求成功onAdFailed广告请求失败，同时返回错误码及描述onAdClick广告被点击onAdClose广告被关闭3.混淆代码工程混淆设置：如需打包或者生成 APK的时候进行混淆，在proguard.cfg中添加如下代码： -keep class com.iflytek.voiceads.*;4.常见问题1.Q: adUnitId 是什么？ A:

10、adUnitId，即广告位ID，是讯飞移动广告平台为每个广告位分配的唯一标识符。2.Q: 可以自己设置广告的请求地址吗？ A: 请求地址封装于SDK内部，不允许用户自行设置。3.Q: SDK 都支持哪些android版本？A:要求采用android 2.3或更高版本。4.Q: 如何查看广告SDK版本？A: 利用Version.getVersion()可获得广告SDK版本号。5.SDK2.0集成注意事项1.AndroidManifest.xml中请勿漏写权限声明，请参考2.3。2.AndroidManifest.xml中需添加DownloadService，请参考2.4。3.新增设置选项，请参考

11、2.8.4：1）广告下载前，可以设置弹出下载提示框，旗帜、插屏、全屏广告设置方式相同。如：bannerAd.setParameter(AdKeys.DOWNLOAD_ALERT, true);2）全屏广告展示时间设置，有效设置范围为500010000和-1。设为-1时，通过点击全屏广告右上角的叉号控件退出广告。如：fullScreenAd.setParameter(AdKeys.SHOW_TIME_FULLSCREEN, 6000);主流合作媒体WiFi万能钥匙 WiFi万能钥匙是最好用的智能手机免费WiFi管理工具，云端数据库内置千万Wi-Fi热点数据包括中国电信百万ChinaNet热点数据

12、，帮你随时随地免费连上附近WiFi热点，轻轻松松免费上网社交聊天、学习、购物、看电影、看视频、看新闻资讯、看美图、看搞笑段子、玩游戏、听音乐、看漫画、找女朋友！WiFi万能钥匙连接免费WiFi的上网神器，扫除无网断网状态，提高移动办公效率，尤其适合学生、商务、移动人群和重度网虫。懒人听书懒人听书是国内最受欢迎的有声阅读应用，通过两年的发展目前已积累上亿用户，是国内使用人数最多的移动互联网音频类产品。懒人听书有声正版阅读资源丰富，每天不断录制更新，内容适用于不同年龄人群的手机用户使用，老人、白领、学生、儿童都可以在懒人听书上找到自己喜欢的资源。快手看片快手看片是下载量第一的聚合视频软件，免费高清

13、在线播放，万部电影，18种分类：电视剧，电影，综艺，动漫，纪实，微电影，轻视频，韩剧，欧美频道，浪漫爱情，动作战争，热点精选，新闻，咨询，音乐，搞笑，体育一网打尽。完整收录了优酷、土豆、腾讯视频、搜狐视频、新浪、酷六、奇艺、乐视、芒果卫视、56、CNTV、PPTV等各大视频网络内容。好豆菜谱好豆菜谱是中国美食大全，提供多种菜系的做法，以及针对不同人群的食谱，是下厨房必备的美食菜谱软件。好豆菜谱拥有中国最全的优质菜谱数据40多万道，包含人群分类和疾病调理的药膳食疗，提供各种健康饮食指导建议。爱生活，爱美食，爱做菜，爱下厨，使用好豆菜谱，开启幸福生活！微信锁微信锁是一款微信隐私卫士，专注锁定微信社

14、交隐私空间，对微信信息安全实现前“锁”未有的加密保护。微信锁（微信伴侣），即使在亲朋好友、同事把玩你手机，也可以很好的伪装，不用担心会泄露你的微信聊天记录、朋友圈、微信支付及红包隐私信息。围棋宝典围棋宝典含大量精解专辑、棋谱、习题，是一款可以随时随地打谱、做题、学习、对弈(包括IGS即时对弈、非即时对弈、人机对弈)、棋力测试、研讨的免费手机围棋软件，所有资料精挑细选，是谓宝典；均带有文字解说和分支变化图。愤怒的富翁愤怒的富翁旨在让用户在玩游戏中获得金币奖励，同时也可以看网页来赚金币，金币都可以兑换成q币话费。只要您是游戏达人，每天都能进英雄榜，可以得到金币奖励。挖矿石，练矿石，赚金币，挖5次就

15、能挖到矿石甚至金币，挖到之后可以去练矿石卖金币，何乐而不为。股票龙虎榜股票龙虎榜是一款为了迎合趋势投资和捕捉强势股而设计的一款软件。股票龙虎榜主要用来收集每个交易日上海证券交易所和深圳证券交易所公布的公开交易信息数据,然后对数据进行分析，以供投资者参考。讯飞语音+讯飞语音+是一款支持语音合成、语音识别、语音播报和语音搜索的智能语音服务软件，可以运用在任何可以调用语音接口的APP中。随着移动互联网的兴起，手机端搜索也开始崭露头角，并开始高速发展。讯飞语音+便能帮您实现这样的扁平式搜索功能，因其对中文的解析度非常高、对中文的语音输出准确性很强，你可以通过它玩转语音搜索。有谁能比中国人更了解中文呢？语音搜索当选讯飞语音+。2345浏览器最“省钱”的浏览器！国内唯一可以免费打电话的手机浏览器，小巧稳定且最省流量，集成了网址导航、新闻资讯、影视娱乐等海量内容！网页智能压缩加载，后退不重新加载，智能拦截广告，全方位为您节省宝贵流量！0秒启动，网页浏览预加载，上网提速5倍！手势操作前进后退，快捷又方便！讯飞移动广告平台