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

科大讯飞股份有限公司

iFLYTEK CO.,LTD

Android SDK接入指南

讯飞移动广告平台www.voiceads/，中国最大的移动交互式广告平台。平台凭借优质的广告资源、精准的数据分析、高效稳定的收益效果、智能多维的交互形式，为开发者带来强悍稳定的变现能力，致力于构建一个高质、高效的广告技术服务平台。

讯飞移动广告平台聚焦移动广告聚合优化，通过先进的收入优化算法和简单易用的管理界面，帮助开发者快速实现应用变现，大幅提高移动广告收入。独创的智能语音交互广告，打破了传统广告交互形式，让广告变得更生动有趣，从而带来极致的广告体验和最高效的广告收益。

1.概述

欢迎使用讯飞移动广告平台。通过本文档，您可以在几分钟之内轻松完成移动广告的集成过程。

集成过1.0~1.6版本SDK的开发者朋友，请先阅读SDK2.0集成注意事项，方便您快速集成。

2.集成说明

2.1申请appid

在www.voiceads/网站中注册成为开发者并创建一款应用，您将获得一个appid，用于标识您的应用。

2.2导入SDK

1.下载最新版SDK的zip包，将其中的libs 文件夹下jar文件复制到本地工程libs子目录下。

2.Eclipse用户右键点击工程根目录，选择Properties -> Java Build Path -> Libraries，然后点击Add 选择指向jar的路径，点击OK，即导入成功。

2.3配置AndroidManifest文件

打开l文件，增加如下权限：

权限	用途
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 (AdError error)中返回。

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 setParameter (String key, String value)