小米广告SDK Android集成指南
一、SDK介绍
米盟广告SDK提供各种广告形式给客户端集成，应用既可以在MIUI系统上运行，也可以在非MIUI系统上运行。
米盟广告SDK Demo（含SDK文件）：点击查看米盟广告SDK
在继续之前，建议您先下载上面的米盟广告SDK Demo，该项目包含了米盟广告SDK的接入示例代码，有助于您快速理解我们SDK的整个接入流程。
SDK支持的广告形式包括：
∙开屏广告
∙插屏广告
∙横幅
二、SDK接入说明
1、MiAdSDK包含以下部分（位于libs目录下）:
∙AdSdk.jar : Sdk的接口部分
∙AdServer.apk : 放在应用的assets下
∙analytics_core.apk : 同上
2、注册App，开发者需要注册你的App
2.1在小米开发者站注册账号或使用已有账号创建游戏。
2.2到广告平台到该游戏->开启广告状态->应用详情->添加新广告位->选择广告位->获取广告位ID(以下称为POSITION_ID)
3、配置l
MiAd SDK需要的权限列表:
<uses-permissionandroid:name="android.permission.INTERNET"/>
<uses-permissionandroid:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permissionandroid:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permissionandroid:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permissionandroid:name="android.permission.READ_PHONE_STATE"/>
<uses-permissionandroid:name="android.permission.GET_TASKS"/>
MiAd SDK需要的Activity声明:
<activity
android:name="com.xiaomi.ad.AdActivity"
android:configChanges="keyboard|keyboardHidden|orientation|screenSize"
android:exported="false"
android:screenOrientation="behind"
        android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"></activity>
4、 配置Proguard
AdSdk.jar已经做过代码的混淆，可以不用做混淆，如果要做混淆的话，需要在配置里如下的keep项
    -keep class com.xiaomi.ad.**{*;}
    -keep class com.miui.analytics.**{*;}
    -keep class com.xiaomi.analytics.*{public protected *;}
5、 初始化AdSdk
在 Application onCreate 时候需要初始化 MiAdSdk。 调用如下接口:
AdSdk.initialize(this, appId);
appId请在开发者网站注册后获取。
三、接入广告
1、 SplashAd 开屏广告
请求广告接口
newSplashAd(Context context, final ViewGroup container, intdefaultSplashId, final SplashAdListenersplashAdListener)
          .requestAd(String positionId);
context　Activity context
sdkcontainer　开屏ViewGroup，为一个全屏（match_parent）的ViewGroup
defaultSplashId 默认图的id
splashAdlistener　开屏广告事件监听
positionId　广告位ID
参考:
  1) l 的SplashAdActivity部分，需要指定 Activity 的 android:screenOrientation 为 portrait（竖版开屏）或 landscape（横版开屏）并确认您的广告位是横版还是竖版
  2) 参考AdDemo/src/com/xiaomi/ad/demo/VerticalSplashAdActivity.java和HorizonSplash
AdActivity.java
  3) 注意在配置了开屏的activity中配置android:configChanges="keyboard|keyboardHidden|orientation|screenSize
  4) 开屏请求广告需要联网一段时间，在取广告期间，可以选择指定一张默认的全屏图，避免取开屏广告期间无内容展示，影响体验。可以参考 VerticalSplashAdActivity添加一张默认图片
   5) 请勿使用系统开屏广告位ID，否则将没有广告返回
2、 InterstitialAd 插屏广告
插屏广告初始化
      new InterstitialAd(Context context, View anchorView)或
newInterstitialAd(Context context, Activity activity)
context　请求广告的context
anchorView　任意一个可以获得window token的关联view，建议使用"getWindow().getDecorView()"
activity 请求广告的acticity引用
插屏广告请求
questAd(String positionId, AdListeneradListener)
positionId 广告位ID
adListener 插屏广告事件监听
参考:
1)插屏广告提供isReady()接口供开发者获取插屏广告准备情况，在准备完全可以调用show()显示插屏
2)在注册的Adlistener的onViewCreated接口中，并不会返回真实的view，但是通知开发者插屏广告已经ready，可以show
3)细节请参考AdDemo/src/com/xiaomi/ad/demo/InterstitialAdActivity.java
3、标准原生广告
请求广告接口
newStandardNewsFeedAd(Context context).requestAd(String positionId, int count, NativeAdNetworkListener listener)
context 请求广告的context
positionId 广告位ID
count 请求广告数量
listener 广告监听
获得广告view
StandardNewsFeedAd.buildViewAync(AdInfoResponse response, intcontainerWidth, AdListener listener)
response 用于创建指定view
containerWidth 广告容器的宽度
listener 创建广告view的监听
参考:
1)广告reponse会通过NativeInfoSuccess(List list)返回,每个response可以创建对应的广告内容
2)最终的广告view会通过ViewCreated(View view)返回
3)细节请参考AdDemo/src/com/xiaomi/ad/demo/StandardNewsFeedActivity.java
4、 自定义原生广告
请求广告接口
newCustomNewsFeedAd(Context context).requestAd(String positionId, int count, NativeAdNetworkListener listener)
context 请求广告的context
positionId 广告位ID
count 请求广告数量
listener 广告监听
获得广告view
CustomNewsFeedAd.buildViewAync(AdInfoResponse response, JSONObjectcustomInfo, AdListener listener)
response 用于创建指定view
customInfo 自定义信息
listener 创建广告view的监听
参考:
1)广告reponse会通过NativeInfoSuccess(List list)返回,每个response可以创建对应的广告内容
2)最终的广告view会通过ViewCreated(View view)返回
3)自定义信息中必须包括本地的layout id，然后根据广告类型的不同设置title id,summary id,
若干image id,install id(如果是下载类广告的话)
4)细节请参考AdDemo/src/com/xiaomi/ad/demo/CustomNewsFeedActivity.java
5、 list模式原生广告 
参考:
1)AdDemo/src/com/xiaomi/ad/demo/StandardNewsFeedListActivity.java
6、 Banner广告 
参考：
1)AdDemo/src/com/xiaomi/ad/demo/BannerActivity
7、 SDK调试

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。