王尘宇

1.版本说明

版本：2.5.15
更新说明：
1.横幅新增CPD广告样式

版本：2.5.14
更新说明：
1.魅族横幅广告轮播时间间隔支持后台配置
2.下载实现优化（service声明中
  com.meizu.advertise.services.DownloadService需改为
  com.meizu.advertise.services.ProxyService）

版本：2.4.0
更新说明：
1.支持魅族应用下载类广告（需增加res资源，见搭建开发环境）
2.横幅广告展示逻辑调整为自动请求广告并轮播展示（横幅广告接入方式有所调整，详见文档或Demo）
3.处理插屏广告展示时状态栏弹出问题
4.增加多种信息流样式支持（信息流广告接入有所调整，详见文档或Demo）

版本：2.3.0
更新说明：
1.支持DeepLink方式拉起应用
2.增加下载弹窗提示
3.完善配置功能
4.修复魅族插屏广告返回键onKeyUp事件没有拦截的问题

版本：2.2.4
更新说明：
1.精简包大小
2.处理魅族插屏广告关闭回调问题

版本：2.2.0
更新说明：
1.魅族开屏广告样式调整
2.支持魅族广告请求超时设置
3.代码优化

版本：2.1.3
更新说明：
1.更新魅族广告样式，增加魅族广告关闭功能
2.支持魅族游戏中心和魅族应用中心下载类广告

版本：2.1.0
更新说明：
1.魅族广告标签上的文字由“魅族推广”更改为“魅族广告”
2.拆分初始化和预加载接口，预加载方法由应用决定是否调用
3.调整定位方式
4.处理Eclipse版本以拷贝方式接入SDK出现的R文件报错问题

版本：2.0.6
更新说明：
1.魅族开屏，魅族插屏，魅族横幅广告增加推广标签
2.修复预加载异常

版本：2.0.4
更新说明：
1.优化缓存策略
2.魅族插屏广告限定context为activity

版本：2.0.1
更新说明：
1.增加魅族开屏，插屏，横幅功能
2.API优化

2.搭建开发环境

1)拷贝advertise.jar文件到项目libs目录下，以及将res目录下的资源拷贝至项目对应的目录下

2)配置AndroidManifest.xml

2.1)添加权限

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.GET_ACCOUNTS"/>
<uses-permission android:name="android.permission.LOCAL_MAC_ADDRESS"/>
<uses-permission android:name="android.permission.ROOT_RECOVERY_STATE"/>
<uses-permission android:name="com.meizu.stats.permission.READ_USAGESTATS"/>
<uses-permission android:name="com.meizu.stats.permission.WRITE_USAGESTATS"/>

2.2)添加activity声明

<activity
    android:name="com.meizu.adplatform.api.activity.WebSurfingActivity"
    android:theme="@android:style/Theme.Black.NoTitleBar"
    android:configChanges="keyboardHidden|orientation|navigation|screenSize"/>

2.3)添加service声明

<service android:name="com.meizu.advertise.services.ProxyService"/>
<service android:name="com.meizu.advertise.services.ProxyIntentService"/>
<service android:name="com.meizu.gslb.push.GslbPushHandler"/>

2.3)添加 receiver

<receiver android:name="com.meizu.gslb.push.GslbDataRefreshReceiver">
    <intent-filter>
        <action android:name="com.meizu.flyme.gslb.push.broadcast"/>
    </intent-filter>
</receiver>

3.魅族广告API说明

AdManager : 魅族广告管理类

方法名	说明
static void init(Context context, String appId)	SDK初始化，在Application的onCreate方法中调用，传入Application对象和应用ID
static AdDataLoader getAdDataLoader()	获取魅族广告数据加载类

AdDataLoader : 广告数据加载类

方法名	说明
AdRequest load(String mzid, AdResponse adResponse)	异步请求广告，传入位置ID和请求回调
AdData load(String mzid)	同步请求广告，需放子线程调用，传入位置ID

AdRequest : 魅族广告请求

方法名	说明
void cancel()	取消魅族广告请求，释放资源，避免内存泄露

AdResponse : 广告请求回调

方法名	说明
void onSuccess(AdData adData)	请求魅族广告数据成功时回调
void onNoAd(long code)	没有魅族广告时回调，常见返回码404，500，此返回码是广告平台内部定义的状态码；回调此方法通常是后台没有配置广告或广告填充率低
void onFailure(String msg)	请求魅族广告数据失败时回调，常见失败有超时，网络问题

AdData : 广告数据

AdView extends FrameLayout : 信息流广告

方法名	说明
static AdView create(Context context)	创建一个信息流广告视图，传入当前Activity
AdView setAdListener(AdListener adListener)	设置魅族广告监听
void setPadding(int left, int top, int right, int bottom)	设置边距，默认边距均为0
AdView bindData(AdData adData)	将数据绑定到广告视图中

AdListener : 广告监听

方法名	说明
void onLoadFinished()	魅族广告加载完成时回调
void onNoAd(long code)	没有魅族广告时回调
void onError(String msg)	魅族广告获取失败或数据异常时回调
void onExposure()	魅族广告曝光上报时回调
void onClick()	魅族广告视图被点击时回调

ClosableAdListener extends AdListener : 广告监听，增加关闭时回调

方法名	说明
void onLoadFinished()	魅族广告加载完成时回调
void onNoAd(long code)	没有魅族广告时回调
void onError(String msg)	魅族广告获取失败或数据异常时回调
void onExposure()	魅族广告曝光上报时回调
void onClick()	魅族广告视图被点击时回调
void onClose()	魅族广告关闭时回调

BannerView extends FrameLayout : 横幅广告

方法名	说明
BannerView(Context context)	构造函数，传入当前Activity
BannerView(Context context, AttributeSet attrs)	构造函数，在layout布局中使用
BannerView setId(String mzid)	设置位置ID
BannerView setAdListener(AdListener adListener)	设置广告监听
void pause()	暂停轮播，需在当前Activity的onPause方法中调用
void resume()	恢复轮播，需在当前Activity的onResume方法中调用
void load()	开始加载数据，关闭后调用会重新恢复加载

Interstitial : 插屏广告

方法名	说明
Interstitial(Context context, String mzid, AdListener listaner)	构造函数，传入当前Activity、位置ID、魅族广告监听，创建对象即开始请求广告
void show()	魅族展示广告，需要在广告加载完成后调用，未加载完成调用无效
void dismiss()	手动关闭魅族广告，一般不需要用到
void release()	释放资源，避免泄露，在当前Activity的onDestory方法中调用

SplashAd : 开屏广告

方法名	说明
SplashAd(Context context, String mzid, SplashAdListener listener)	构造函数，传入当前Activity、位置ID、魅族广告监听，创建对象即开始请求广告
void skip()	手动调过魅族广告
void release()	释放资源，避免泄露，在当前Activity的onDestory方法中调用

SplashAdListener extends AdListener : 魅族开屏广告监听

方法名	说明
void onLoadFinished()	魅族广告加载完成时回调
void onNoAd(long code)	没有广告时回调
void onError(String msg)	魅族广告获取失败或数据异常时回调
void onExposure()	魅族广告曝光上报时回调
void onClick()	魅族广告视图被点击时回调
void onAdDismissed()	魅族广告关闭时回调

4.示例

见Demo

5.Q&A

Q:应用ID和位置ID怎么获取?
A:在魅族ssp管理后台(ssp.flyme.cn)申请，详见附件`SSP新建位置操作指引.pdf`

Q:请求不到魅族广告，回调onNoAd，code=404或者code=500
A:请找魅族推广运营人员确认位置是否通过审核，配置是否正确

Q:魅族广告点击逻辑如何处理？
A:魅族广告跳转页面相关工作已在SDK中实现，应用无需额外处理

Q:提示unknown style type
A:配置了SDK不支持的样式，请找运营人员调整配置

Q:提示style type error, expected:<**> but was:<**>
A:接入时使用了错误的类，请根据API说明选择相应的类

Q:为什么魅族横幅广告每隔一定时间触发一次AdListener的回调？
A:魅族横幅广告自2.4.0版本起，每隔4秒请求一次广告，每请求一次广告触发一次回调。

Q:魅族横幅广告的尺寸如何确定？为何素材被裁剪？
A:魅族广告控件的尺寸在ssp后台进行配置；当返回的素材比例与配置的控件比例不一致时，居中裁剪；
  素材的比例需要运营人员在对应的dsp处进行配置。