信息流广告集成说明
信息流
步骤1:确认已添加插件apk(如:FeedPlugin-1.0.apk)到项目工程的 assets/mu/目录下
步骤2:确定已添加聚合广告平台依赖包到本地工程的libs子目录下(该步骤非必须,只有用到聚合广告平台才需添加)
步骤3:开发者需要创建一个或多个广告位,每个广告位对应一个feed
步骤4:添加广告代码,添加广告代码前请确定已初始化SDK
属性设置接口说明 - MMUFeedProperties
1.构造方法
properties = new MMUFeedProperties(this, slotId);
参数说明:slotId:广告位ID
2.属性设置
1. properties.setReqCount(reqCount); //设置请求广告条数,SDK 1.1.0版本以上添加该接口
2. properties.setAdSize(320,100); //设置请求广告位尺寸,单位逻辑像素
3. properties.setAcct(MmuProperties.ACCT.VIEW);//设置请求方式,SDK方式:MmuProperties.ACCT.VIEW,SDK-数据方式:MmuProperties.ACCT.DATA,注意:需要和后台广告位设置保持一致
4. properties.setMMUFeedListener(feedListener);//设置监听器
5. properties.addCustomAdapter(id, customAdapter); //添加自定义平台Adapter,只有用到自定义平台功能时需要添加
注意:根据集成方式设置属性:SDK方式、SDK-数据方式
加载广告接口说明 - MMUSDK
mmuSDK = MMUSDKFactory.getMMUSDK();
mmuSDK.init(getApplication());//初始化SDK,该方法必须保证在集成代码前调用,可移到程序入口处调用
mmuSDK.attach(properties); //通过properties属性,开始加载广告
SDK方式集成
广告模版接口说明 - MMUFeedController
1. mController = properties.getController(); //获取信息流控制器 获取广告模版方式一:
2. mController.getFeedView(this, adInfos, params);//使用回调中获取的广告数据获取广告View,参数说明,this:Activity,adInfo:List 一组广告数据,params:LayoutParams 获取广告模版方式二:
3. mController.getFeedView(this, adInfo, params);//使用回调中获取的广告View,参数说明,this:Activity,adInfo:MMUAdInfo 一个广告数据,params:LayoutParams,SDK 1.1.0版本以上支持
说明:方式一为获取小图排列模版,方式二为获取其他模版,对应后台配置模版
视频广告说明
1. 视频广告模版支持Android 4.0及以上版本
2. 视频广告划出屏幕后,需要手动remove掉视频模版View以释放资源
注意:SDK 1.1.0及以上版本支持视频模版
模版id说明 - MMUAdInfo.rtid
rtid值
模版类型
版本说明
1
标题大图
9
小图描述
3或10
小图排列
11
视频
1.1.0及以上
PS:更多设置请参考Demo中集成代码,com.alimama.mobile.demo.MMUFeedViewActivity。
SDK-数据方式集成
数据接口说明 - MMUAdInfo
1. adInfo.attachAdView(view); //当广告展示时,必须调用attachAdView()方法并传入展示的View
2. adInfo.onClickAd(); //当广告被点击时,必须调用onClickAd()方法
3. adInfo.onDestroy(); //当广告被销毁时调用onDestroy()方法
4. adInfo.getContentValue(key); //调用getContentValue(),通过key获取对应的数据
5. adInfo.notifyVideoOnStart(); //通知视频开始播放
6. adInfo.notifyVideoOnComplete(); //通知视频播放完成
7. adInfo.onEvent(int eventId,String eventMsg); //自定义事件上报
信息流数据接口Key-Value说明
Key
Value
版本说明
MMUAdInfoKey.TITLE
标题
MMUAdInfoKey.SUBTITLE
副标题
MMUAdInfoKey.PRICE
价格
MMUAdInfoKey.PROMOPRICE
折扣价
MMUAdInfoKey.SELL
销量
MMUAdInfoKey.IMG_SIZE
图片大小
MMUAdInfoKey.LINK
点击地址,当地址为空或空字符串时不需要处理
MMUAdInfoKey.CLICKTYPE
点击类型
MMUAdInfoKey.RATING
星级
MMUAdInfoKey.IMAGE_URL
图片地址
MMUAdInfoKey.ICON_URL
Icon地址
MMUAdInfoKey.RATION_NAME
平台名称
MMUAdInfoKey.MODEL_TYPE
模版类型
MMUAdInfoKey.VIDEO_URL
视频地址
1.1.0 及以上
MMUAdInfoKey.AUTO_PLAY
播放控制,1:手动播放、2:自动播放、3:仅WIFI自动播放
1.1.0 及以上
MMUAdInfoKey.VIDEO_TIME
视频播放时长
1.1.0 及以上
数据接口补充字段说明 - adInfo.getContent()
字段名
类型
描述
“cid”
String
广告创意ID
“provider”
Map类型
创意广告商
字段 provider结构说明
字段名
类型
描述
“name”
String
广告商名称
“icon”
Map类型
广告商角标信息
字段 icon结构说明
字段名
类型
描述
“icu”
String
角标图片地址
“icpos”
int
角标位置
“icsz”
Map
角标尺寸
PS:更多设置请参考Demo中集成代码,com.alimama.mobile.demo.MMUFeedDataActivity。