有米Android SDK开发者文档

最新推荐文章于 2024-09-28 09:16:42 发布
最新推荐文章于 2024-09-28 09:16:42 发布
阅读量4.1k 收藏 1
点赞数
分类专栏： android 文章标签： android

前言

1.文档说明

有米Android SDK v4从4.02版本开始整合了有米平台的所有广告形式以及实用功能服务。广告方面主要包含有积分和无积分两大类广告形式，无积分形式以广告条、插屏和自定义广告为主；有积分广告形式是以积分墙为核心，配合多种展现形式实现的一套完整的积分广告流程；实用功能包含检查更新和在线配置参数等功能服务。

*v4系列SDK的接口已经进行了大量修改，所有配置请以本文档为准。如果您的项目之前使用的是有米积分墙v2、广告条v3的话，建议清除所有相关的广告配置，并按本文档重新实现广告配置。

2.SDK功能概览

  • 无积分广告
    • 广告条
    • 插播
    • 自定义广告
  • 积分广告
    • 全屏积分墙列表
    • 对话框积分墙列表
    • 积分广告条
    • 积分迷你广告条
  • 实用功能
    • 检查更新
    • 在线配置

3.更新日志

  • v4.04

    • 无积分广告[插播]
      • 增加引导安装提示语
    • 无积分广告[自定义广告]
      • 新增迷你广告条展现形式
      • 新增推荐墙展现形式

  • v4.03

    • 无积分广告[插播]
      • 支持CPC广告
      • 支持开发者后台云控制插播防误点功能
      • 支持开发者后台云控制插播展示频率

  • v4.02

    • SDK整合，详见 SDK功能概览
    • 有积分广告
      • 新增积分广告条和积分迷你广告条两种积分广告的展现形式。
      • 新增积分墙显示积分余额的功能(该功能可以在开发者主站控制面板关闭)。
      • 修复弹出框积分列表的若干bug。
    • 修复了一个特殊情况下无法启动下载任务的bug。
    • 修复使用4.2.2(即API-17)打包时无法正常显示广告的bug。

一、准备工作

1.申请AppID

1). 点击 创建应用 进行新应用创建。
2). 查看 应用详情 ，获取发布ID和应用密钥，在后续初始化中使用。

2.导入SDK

将 YoumiSdk_*.jar 导入您的工程中。

1). 右键您的工程根目录，选择“New”，再选择“Folder”，输入Folder name为"libs"
2). 将 YoumiSdk_.jar 拷贝到工程根目录的libs文件夹下
3). 右键 YoumSdk_.jar ，选择“Build Path”再选择“Add to Build Path”
4). 右键您的工程根目录，选择Properties->Java Build Path->Order and Export，勾选Android Private Libraries和Android Dependencies，可消除classnotfoundexception，详见下图。 5). 导入成功

设置输出第三方jar

3.配置AndroidManifest

3.1 配置用户权限(重要)

在AndroidManifest.xml文件中配置用户权限

请将下面权限配置代码复制到 AndroidManifest.xml 文件中 :


    <uses-permission android:name="android.permission.INTERNET"/> 
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <!--以下两个为可选权限-->
    <uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"/>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
3.2 添加必须组件(重要)

为确保正常使用广告业务，请务必配置AdBrowser,AdReceiver和AdService 。

请将以下代码复制到AndroidManifest.xml的Application节点里面:


    <activity
        android:name="net.youmi.android.AdBrowser"
        android:configChanges="keyboard|keyboardHidden|orientation"            
        android:theme="@android:style/Theme.Light.NoTitleBar" >
    </activity>
    <service
        android:name="net.youmi.android.AdService"
        android:exported="false" >
    </service>
    <receiver 
        android:name="net.youmi.android.AdReceiver" >
        <intent-filter>
            <action android:name="android.intent.action.PACKAGE_ADDED" />
            <data android:scheme="package" />
        </intent-filter>
    </receiver>

为了避免由于手写引起的配置错误，建议直接复制上述代码

3.3 配置OffersReceiver(重要)

为正常使用积分广告业务，请务必配置OffersReceiver，否则将有可能获取不到积分。(如果您没有使用积分墙广告，则可以跳过该步骤)

请将以下代码复制到AndroidManifest.xml的Application节点里面:


    <receiver
        android:name="net.youmi.android.offers.OffersReceiver"
        android:exported="false" >
    </receiver>

4.设置渠道号(可选)

目前，有米已经与多家应用商店合作，当您发布的目标应用商店有要求您加上有米的渠道号时，您可以按以下操作加入渠道号进行打包，这样可以保证您的应用在该应用商店上顺利审核通过。

渠道号列表详见:有米广告推广渠道号列表
请在AndroidManifest.xml中添加以下代码:


    <meta-data android:name="YOUMI_CHANNEL"
                android:value="这里替换为非负整数的渠道号" >
    </meta-data>

5.调用初始化接口(重要)

请务必在主Activity的onCreate中调用AdManager.getInstance(context).init 接口初始化App的发布ID 、应用密钥和测试模式等参数。
其中，发布ID和密钥在上文的申请AppID获得。

代码示例:


    package com.test
    import android.app.Activity 
    import net.youmi.android.AdManager;
    /**
    * 这是您的应用的主Activity
    */  
    public class YourMainActivity extends Activity { 
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            // TODO Auto-generated method stub
            super.onCreate(savedInstanceState); 
            // 初始化应用的发布ID和密钥，以及设置测试模式
            AdManager.getInstance(this).init("您的应用发布ID","您的应用密钥", false); 
        }
    }

！请将测试模式设置为false后上传至网站等待审核。
！未上传应用安装包、未通过审核的应用、模拟器运行，都只能获得测试广告，审核通过后，模拟器上依旧是测试广告，真机才会获取到正常的广告。

6.混淆配置(重要)

如果您的项目使用了Proguard混淆打包，请务必在proguard-project.txt中添加以下代码,否则将有可能获取不到广告:

    -dontwarn net.youmi.android.**
    -keep class net.youmi.android.** {  
    *;  
    }

二、调用无积分广告

1.有米广告条调用接口

1.1 广告条尺寸

！AdSize提供了四种广告条尺寸提供给开发者使用： 
AdSize.SIZE_320x50 手机
AdSize.SIZE_300x250 手机，平板
AdSize.SIZE_468x60 平板
AdSize.SIZE_728x90 平板

1.2 普通布局(适用于应用)
1.2.1 配置布局文件

复制以下代码到要展示广告的Activity的layout文件中，并且放在合适的位置：


    <LinearLayout android:id="@+id/adLayout"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:gravity="center_horizontal">
    </LinearLayout>
1.2.2 将AdView加入布局

在展示广告的Activity类中，添加如下代码：


    //实例化广告条
    AdView adView = new AdView(this, AdSize.SIZE_320x50);
    //获取要嵌入广告条的布局
    LinearLayout adLayout=(LinearLayout)findViewById(R.id.adLayout);
    //将广告条加入到布局中
    adLayout.addView(adView);
1.2.3 悬浮布局(适用于游戏)

在展示广告的Activity的onCreate中，添加如下代码:


    //实例化LayoutParams(重要)
    FrameLayout.LayoutParams layoutParams = new FrameLayout.LayoutParams(
        FrameLayout.LayoutParams.FILL_PARENT,
        FrameLayout.LayoutParams.WRAP_CONTENT);     
    //设置广告条的悬浮位置
    layoutParams.gravity = Gravity.BOTTOM | Gravity.RIGHT; // 这里示例为右下角  
    //实例化广告条
    AdView adView = new AdView(this, AdSize.SIZE_320x50);
    //调用Activity的addContentView函数
    this.addContentView(adView, layoutParams);
1.2.4 使用广告条监听接口（可选）

SDK提供给有需要的开发者使用广告条监听接口，用于监听广告条的状态


    adView.setAdListener(new AdViewLinstener() { 
        @Override
        public void onSwitchedAd(AdView adView) {
        // 切换广告并展示
        }  
        @Override
        public void onReceivedAd(AdView adView) {
        // 请求广告成功
        }
        @Override
        public void onFailedToReceivedAd(AdView adView) {
        // 请求广告失败  
        }
    });

2.有米插屏广告调用接口

2.1 预加载插屏广告数据

预加载广告数据，在应用启动初始化的时候调用，SDK将会以异步方式预加载3-5条广告数据到本地缓存，当调用展示插播接口时候便能立即展示广告。
如果不先加载数据，调用展示插播接口的时候，会等待广告数据加载成功再进行展示，会造成一定延时。

调用接口


    SpotManager.getInstance(this).loadSpotAds();

注:this参数是继承自Context的类实例

2.2 展示插播广告

展示插播广告，一般可以在应用启动或者游戏通关等场景中调用。 开发者可以到开发者后台设置展示频率，需要到开发者后台设置页面（详细信息->业务信息->无积分广告业务->高级设置） 自4.03版本增加云控制是否开启防误点功能，需要到开发者后台设置页面（详细信息->业务信息->无积分广告业务->高级设置）


    SpotManager.getInstance(this).showSpotAds(this);

3.有米自定义广告调用接口

3.1 预加载自定义广告数据

预加载广告数据，在应用启动初始化的时候调用，SDK将会以异步方式预加载自定义广告列表到手机内存，当调用getAdObject()或者getAdList()接口时候便能立即获得数据。

调用接口


    DiyManager.initAdObjects(this);
3.2 获取源数据广告列表

调用接口


    List<AdObject> list = DiyManager.getAdList(this);
3.3 获取单条源数据广告

调用接口


    AdObject adObject = DiyManager.getAdObject(this); //轮流获取列表中的广告
    int adid = adObject.getAdId();         //应用广告id
    String appName = adObject.getAppName();      //应用广告名
    String appText = adObject.getAdText();       //应用广告语
    String author = adObject.getAuthor();       //应用作者
    String category = adObject.getCategory();     //应用分类
    String description = adObject.getDescription();  //应用广告描述
    Bitmap icon = adObject.getIcon();         //图标
    String iconUrl = adObject.getIconUrl();      //图标地址
    String packageName = adObject.getPackageName();  //包名
    String size = adObject.getSize();         //安装包大小
    int versionCode = adObject.getVersionCode();  //安装包版本号
    String versionName = adObject.getVersionName();  //安装包版本名
    ArrayList<String> screenShortcuts = adObject.getScreenShortcuts(); //安装包截图数张
3.3 下载事件接口

调用接口


    DiyManager.downloadAd(this, adObject.getAdId());
3.4 推荐墙接口

调用接口


    DiyManager.showRecommendWall(this); //展示所有无积分推荐墙
    //DiyManager.showRecommendAppWall(this);  //展示应用推荐墙
    //DiyManager.showRecommendGameWall(this); //展示游戏推荐墙
3.5 迷你广告条接口

显示无积分的横幅广告条，将高度为32dp的广告条定义为迷你Banner。

3.5.1 普通布局(适用于应用)

1).配置布局文件

复制以下代码到要展示广告的Activity的layout文件中，并且放在合适的位置：


    <RelativeLayout android:id="@+id/AdLayout"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:gravity="center_horizontal">
    </RelativeLayout>

2).将积分Banner加入布局

在展示广告的Activity类中，添加如下代码：


    //获取要嵌入迷你广告条的布局
    RelativeLayout adLayout=(RelativeLayout)findViewById(R.id.AdLayout);
    //demo 1 迷你Banner : 宽满屏，高32dp
    DiyBanner banner = new DiyBanner(this, DiyAdSize.SIZE_MATCH_SCREENx32);//传入高度为32dp的AdSize来定义迷你Banner    
    //demo 2 迷你Banner : 宽320dp，高32dp
    DiyBanner banner = new DiyBanner(this, DiyAdSize.SIZE_320x32);//传入高度为32dp的AdSize来定义迷你Banner 
    //将积分Banner加入到布局中
    adLayout.addView(banner);
3.5.1 悬浮布局(适用于游戏)

在展示广告的Activity的onCreate中，添加如下代码:


    //实例化LayoutParams(重要)
    FrameLayout.LayoutParams layoutParams = new FrameLayout.LayoutParams(
        FrameLayout.LayoutParams.FILL_PARENT,
        FrameLayout.LayoutParams.WRAP_CONTENT);     
    //设置迷你Banner的悬浮位置
    layoutParams.gravity = Gravity.BOTTOM | Gravity.RIGHT; // 这里示例为右下角  
    //实例化迷你Banner
    DiyBanner banner = new DiyBanner(this, DiyAdSize.SIZE_MATCH_SCREENx32);//传入高度为32dp的DiyAdSize来定义迷你Banner
    //调用Activity的addContentView函数
    this.addContentView(banner, layoutParams);

三、调用积分广告

>了解积分墙

!注意,使用积分广告请务必配置 OffersReceiver

1.设置用户标识(可选)

如果您的应用有独立的用户账号体系，并且允许用户随时切换账户，那么您可能需要准确跟踪用户的哪个账号完成了积分墙广告并赚取了积分。通过为用户设置一个自定义标识(比如账户名)，便可以将这个标识附加在积分墙会话中，这样在积分结算以及订单回调时，您将可以清楚知道具体哪个账号完成了积分任务，从而进行下一步处理。 示例代码:


    // 调用以下接口设置您的用户的唯一标识  
    OffersManager.getInstance(this).setCustomUserId("abcdefg_123");

注:用户标识必须为"字母数字下划线"组合 *此设置适用于自定义积分账户和服务器积分订单回调 *

2.积分墙初始化接口

请务必在应用的启动代码，即在主Activity的onCreate方法中分别调用积分墙专用的初始化接口。
代码示例:


    package com.test
    import android.app.Activity 
    import net.youmi.android.AdManager;
    import net.youmi.android.offers.OffersManager;
    /**
    * 这是您的应用的主Activity
    */  
    public class YourMainActivity extends Activity { 
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            // TODO Auto-generated method stub
            super.onCreate(savedInstanceState); 
            // 初始化应用发布ID和密钥，以及设置测试模式
            AdManager.getInstance(this).init("您的应用发布ID","您的应用密钥", false); 
            // 请务必调用以下代码，告诉SDK应用启动，可以让SDK进行一些初始化操作。该接口务必在SDK的初始化接口之后调用。
            OffersManager.getInstance(this).onAppLaunch(); 
        } 
    }

3.积分墙会话结束接口

请务必在应用退出前调用积分墙专用的会话结束接口，让SDK进行一些资源的释放和清理。
代码示例:


    import net.youmi.android.offers.OffersManager;  
    ...
    // 请务必在应用退出的时候调用以下代码，告诉SDK应用已经关闭，可以让SDK进行一些资源的释放和清理。
    OffersManager.getInstance(this).onAppExit(); 
    ...

4.积分广告展现形式

4.1 全屏积分墙

全屏积分墙

4.1.1 基本调用方法

调用OffersManager.getInstance(this).showOffersWall()展示全屏的积分墙。 代码示例:


    import android.app.Activity  
    import net.youmi.android.offers.OffersManager;
    ....
    //调用showOffersWall显示全屏的积分墙界面
    OffersManager.getInstance(this).showOffersWall();
    ....
4.1.2 设置全屏积分墙屏幕方向(可选)

积分墙默认情况下根据手机系统的屏幕方向布局，如果希望强制设置积分墙的方向为竖向或横向，只需要在AndroidManifest.xml中配置AdBrowser即可。 设置为竖向显示:


    <activity
        android:name="net.youmi.android.AdBrowser"
        android:configChanges="keyboard|keyboardHidden|orientation"
        android:screenOrientation="portrait"
        android:theme="@android:style/Theme.Light.NoTitleBar" >
    </activity>

设置为横向显示:


    <activity
        android:name="net.youmi.android.AdBrowser"
        android:configChanges="keyboard|keyboardHidden|orientation"
        android:screenOrientation="landscape"
        android:theme="@android:style/Theme.Light.NoTitleBar" >
    </activity>
4.2 对话框积分墙

对话框积分墙

调用OffersManager的showOffersWallDialog(Activity activity)方法即可。 如果您希望自定义对话框的大小，可以调用其重载函数。
代码示例


    import android.app.Activity  
    import net.youmi.android.offers.OffersManager;
    ....
    //下面展示三种可选的调用方法:
    //*调用方式1.调用showOffersWallDialog显示默认的对话框样式积分墙:
    OffersManager.getInstance(this).showOffersWallDialog(this); 
    //*调用方式2.传入宽度和高度的像素值(注意：传入的宽高请确保是在竖屏状态下最佳的值，sdk会自动适应屏幕方向):
    OffersManager.getInstance(this).showOffersWallDialog(this,300,400); 
    //*调用方式3.传入宽度和高度占系统屏幕的百分比(注意,值类型为double，请确保大于0并小于1)
    OffersManager.getInstance(this).showOffersWallDialog(this,0.9d,0.95d);
    ....
4.3 积分Banner和积分迷你Banner

显示有积分的横幅广告条，将高度为60dp的积分广告条定义为积分Banner，高度为32dp的积分广告条定义为积分迷你Banner。
通过OffersBanner和OffersAdSize实例化积分广告条。

以下是OffersAdSize的几种规格定义:

  • OffersAdSize.SIZE_320x60 => 宽:320dp,高:60dp的积分Banner
  • OffersAdSize.SIZE_320x60 => 宽:320dp,高:60dp的积分Banner
  • OffersAdSize.SIZE_320x60 => 宽:320dp,高:60dp的积分Banner
  • OffersAdSize.SIZE_320x60 => 宽:320dp,高:60dp的积分Banner

效果图1(竖屏):

积分广告条尺寸展示（竖屏）

效果图2(横屏):

积分广告条尺寸展示（横屏）

4.3.1 普通布局(适用于应用)

1).配置布局文件

复制以下代码到要展示广告的Activity的layout文件中，并且放在合适的位置：


    <RelativeLayout android:id="@+id/offersAdLayout"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:gravity="center_horizontal">
    </RelativeLayout>

2).将积分Banner加入布局

在展示广告的Activity类中，添加如下代码：

    ...
    import net.youmi.android.offers.OffersBanner; 
    import net.youmi.android.offers.OffersAdSize;
    ... 
    //获取要嵌入积分广告条的布局
    RelativeLayout adLayout=(RelativeLayout)findViewById(R.id.offersAdLayout);
    //demo 1 积分Banner : 宽满屏，高60dp
    OffersBanner banner = new OffersBanner(this, OffersAdSize.SIZE_MATCH_SCREENx60);//传入高度为60dp的OffersAdSize来定义积分Banner 
    //demo 2 积分Banner : 宽320dp，高60dp
    OffersBanner banner = new OffersBanner(this, OffersAdSize.SIZE_320x60);//传入高度为60dp的OffersAdSize来定义积分Banner  
    //demo 3 积分迷你Banner : 宽满屏，高32dp
    OffersBanner banner = new OffersBanner(this, OffersAdSize.SIZE_MATCH_SCREENx32);//传入高度为32dp的OffersAdSize来定义积分迷你Banner   
    //demo 4 积分迷你Banner : 宽320dp，高32dp
    OffersBanner banner = new OffersBanner(this, OffersAdSize.SIZE_320x32);//传入高度为32dp的OffersAdSize来定义积分迷你Banner    
    //将积分Banner加入到布局中
    adLayout.addView(banner);
4.3.2 悬浮布局(适用于游戏)

在展示广告的Activity的onCreate中，添加如下代码:


    //实例化LayoutParams(重要)
    FrameLayout.LayoutParams layoutParams = new FrameLayout.LayoutParams(
        FrameLayout.LayoutParams.FILL_PARENT,
        FrameLayout.LayoutParams.WRAP_CONTENT);     
    //设置积分Banner的悬浮位置
    layoutParams.gravity = Gravity.BOTTOM | Gravity.RIGHT; // 这里示例为右下角  
    //实例化积分Banner
    OffersBanner banner = new OffersBanner(this, OffersAdSize.SIZE_MATCH_SCREENx60);//传入高度为60dp的OffersAdSize来定义积分Banner
    //调用Activity的addContentView函数
    this.addContentView(banner, layoutParams);
4.4 积分广告相关设置

可以在有米主站开发者面板设置积分广告条的切换频率和背景颜色等。

5.积分托管

积分墙SDK内置积分账户托管，以下是调用方法。

5.1 查询积分余额

代码示例:


    import android.app.Activity  
    import net.youmi.android.offers.OffersManager;
    ...  
    //调用queryPoints获取积分余额
    int myPointBalance = PointsManager.getInstance(this).queryPoints();
    Log.d("test","积分余额为:"+myPointBalance);
    ...
5.2 消费积分

代码示例:


    import android.app.Activity  
    import net.youmi.android.offers.PointsManager;
    ...   
    //调用spendPoints消费指定金额的积分，这里示例消费100积分
    if(PointsManager.getInstance(this).spendPoints(100)){           
        Log.d("test","已消费100积分");
    }else{
        Log.d("text","消费积分失败(积分余额不足)");
    }   
    ...
5.3 奖励积分(可选)

当用户连续n天登录或通过了某关卡时，您可以使用以下接口奖励用户一定额度的积分。
代码示例:


    import android.app.Activity  
    import net.youmi.android.offers.PointsManager;
    ...
    //调用awardPoints可以奖励指定金额的积分，这里示例奖励50积分   
    PointsManager.getInstance(this).awardPoints(50);                
    Log.d("test","已成功奖励50积分");          
    ...
5.4 监听积分余额变动

SDK提供了监听积分余额变动接口，方便UI自动刷新显示变动的积分余额。
监听积分变动的UI相关的类必须implements PointsChangeNotify接口，并且需要在初始化及关闭时分别调用PointsManager的registerNotify和unRegisterNotify接口示例如下:


    package com.test
    import net.youmi.android.offers.OffersManager;
    import net.youmi.android.offers.PointsChangeNotify;
    import net.youmi.android.offers.PointsManager;
    import android.app.Activity;        
    public class YourTestActivity extends Activity implements PointsChangeNotify { 
        @Override
        protected void onCreate(Bundle savedInstanceState) {    
            // TODO Auto-generated method stub
            super.onCreate(savedInstanceState);     
            //注意:请务必调用registerNotify来注册监听器，否则将得不到积分账户余额变动的通知。
            PointsManager.getInstance(this).registerNotify(this);    
        }
        @Override
        protected void onDestroy() {
            // TODO Auto-generated method stub
            super.onDestroy();
            //注意:请务必在onDestroy中调用unRegisterNotify来注销监听
            PointsManager.getInstance(this).unRegisterNotify(this);
        } 
        @Override
        public void onPointBalanceChange(int pointsBalance) {
            // TODO Auto-generated method stub  
            //当该方法被调用时，表示积分账户余额已经变动了，这里的pointsBalance是积分的当前余额数
            Log.d("test","积分账户余额已变动，当前余额为:"+pointsBalance);
            //注:您可以在这里进行更新界面显示等操作，
        }
    }

6.监听积分赚取订单 (可选)

上文提到的监听积分余额变动只是用于监听SDK托管积分账户的余额变动，如果您希望监听用户赚取积分的订单详情，您可以使用监听积分赚取订单接口。

首先，您需要定义一个MyPointsReceiver类(名字可以随意)，它必须继承自PointsReceiver:
示例代码:


    package com.test;  
    import android.content.Context;    
    import net.youmi.android.offers.EarnPointsOrderList;  
    import net.youmi.android.offers.PointsReceiver; 
    public class MyPointsReceiver extends PointsReceiver{       
        @Override
        protected void onEarnPoints(Context context, EarnPointsOrderList list) {
            //当SDK获取到用户赚取积分的订单时，会第一时间调用该方法通知您。
            //参数EarnPointsOrderList是一个积分订单列表，您可以在这里处理积分详细订单。
        }       
        @Override
        protected void onViewPoints(Context context) {
            //这里是个有趣的小功能，当用户赚取积分之后，积分墙SDK会在通知栏上显示一条获取积分的提示，如果用户点击了这个通知，该函数会被调用。  
            //这时候您可以在这里实现一个跳转，让用户跳转到您设计好的一个积分账户余额页面(如"我的账户"之类的Activity)。
            //该操作是可选的，如果需要关闭通知栏积分提示，请调用PointsManager.getInstance(context).setEnableEarnPointsNotification(false) 
        }   
    }

下一步，您需要在AndroidManifest.xml上配置刚刚定义的 MyPointsReceiver:

示例代码:


    <receiver
        android:name="MyPointsReceiver"
        android:exported="false" >
        <intent-filter>
            <action android:name="ep_请替换为您的AppID" />
            <action android:name="vp_请替换为您的AppID" />
        </intent-filter>
    </receiver>

注意:这里有一个很关键的细节，您必须为MyPointsReceiver配置两个Action，Action的名字分别是以"ep_"和"vp_"开头的，以您的应用的AppID结尾的字符串。（AppID是从有米主站上申请的应用ID，16个字符，所以Action的总长度应该是19个字符）

附录:积分订单类定义

EarnPointsOrderList:

    package net.youmi.android.offers;
    ...
    /**
     * 积分订单列表
     * 
     */
    public class EarnPointsOrderList {
        /**
         * 获取服务器上设置积分单位名称
         */
        public String getCurrencyName();
        /**
         * 根据index获取订单详情(EarnPointsOrderInfo)
         */
        public EarnPointsOrderInfo get(int index);
        /**
         * 判断列表是否为空
         */
        public boolean isEmpty();
        /**
         * 获取列表项数量
         */
        public int size(); 
    }

EarnPointsOrderInfo:

    package net.youmi.android.offers; 
    /**
     * 赚取积分的订单
     */
    public final class EarnPointsOrderInfo {
        /**
         * 获取订单号(具有唯一性)
         */
        public String getOrderID();
        /**
         * 获取渠道号，这里指在AndroidManifest.xml上配置的有米渠道号，详见文档 
         */
        public int getChannelId();
        /**
         * 获取开发者自定义用户唯一标识，该值通过OffersManager设置
         */
        public String getCustomUserID();
        /**
         * 获取积分订单的状态: 1.表示开发者获得了收入并且用户获得了积分。 2.表示开发者没有获得收入但用户获得了积分(未通过审核以及测试模式下结算无效等情况)。
         */
        public int getStatus()
        /**
         * 本次获取积分的描述语，如"成功安装《--》获取了100金币" 
         */
        public String getMessage();
        /**
         * 本次获得的积分 
         */
        public int getPoints();
        /**
         * 本次获得积分的结算时间
         */
        public long getSettlingTime();
}

7.自定义积分账户(可选)

如果您不想使用上文提到的SDK积分托管，而是希望实现自己的客户端积分托管功能(即自定义积分账户)，请参照监听积分赚取订单的步骤实现积分订单监听并实现自定义积分管理功能。

8.服务器积分订单回调(可选)

如果您希望用户赚取积分的订单结算完成后，直接由有米的服务器通知您的服务器，可以使用服务器积分订单回调接口， 协议传送门: 有米积分墙积分订单服务器回调协议 
1.实现接收订单的回调接口时，请务必按照协议说明进行。
2.务必在有米主站开发者面板的目标应用详情页上设置您的回调地址。

请注意，一旦您设置了积分订单回调地址，有米服务器会在用户的积分订单成功结算后第一时间通知您的服务器，但客户端将不再接收到任何积分订单记录，即上文提到的SDK积分托管、监听积分赚取订单以及自定义积分账户等功能将不可用。

9.配置积分墙SDK的积分到账提醒(可选)

为了让用户更加清楚获知积分的赚取情况，SDK使用了悬浮提示框以及通知栏提示来提醒用户积分到账情况。此功能是默认开启的，但您可以通过PointsManager的相关接口来关闭提醒功能。

示例代码


    ...
    import net.youmi.android.offers.PointsManager   
    ...  
    //关闭积分到账通知栏提示功能
    PointsManager.getInstance(this).setEnableEarnPointsNotification(false);
    ...
    //关闭积分到账悬浮框提示功能
    PointsManager.getInstance(this).setEnableEarnPointsToastTips(false);
    ...

四、实用功能

1.检查更新接口 (可选)

有米广告SDK提供应用版本检查更新接口，您可以在应用中调用提示用户升级。
通过在有米主站上传应用的新版本通过审核后，使用有米广告SDK的应用版本检查更新接口就可以获得更新信息，它包括更新提示和下载地址，这样您可以进行下一步的操作，如向用户提示更新以及下载安装新版本。

接口:


    ...
    import net.youmi.android.AdManager
    import net.youmi.android.dev.AppUpdateInfo
    import net.youmi.android.dev.CheckAppUpdateCallBack;
    ...
    //通过调用AdManager的syncCheckAppUpdate或asyncCheckAppUpdate接口即可检查更新。
    //返回值AppUpdateInfo包含了更新提示以及下载地址，如果结果为null则表示当前已经是最新版本，无需下一步操作
    //
    //1.同步调用方法:   
    AppUpdateInfo updateInfo=AdManager.getInstance(this).syncCheckAppUpdate();  //注意，此方法务必在非UI线程调用，否则有可能不成功。
    //
    //2.异步调用方法
    AdManager.getInstance(this).asyncCheckAppUpdate(callback); //注意，此方法可以在任意线程中调用。
    //
    //当updateInfo不为null时，请自行处理提示及下载安装流程。    
    ...

示例(同步接口，必须在非UI线程中调用，示例使用了AsyncTask):


    import net.youmi.android.AdManager;  
    import net.youmi.android.dev.AppUpdateInfo;  
    import android.app.AlertDialog;
    import android.content.Context;
    import android.content.DialogInterface;
    import android.content.Intent;
    import android.net.Uri;
    import android.os.AsyncTask;
    /*
    *这里示例一个调用更新应用接口的工具类，由开发者自定义，继承自AsyncTask 
    *
    */
    public class UpdateHelper extends AsyncTask<Void, Void, AppUpdateInfo> {
    private Context mContext; 
    public UpdateHelper(Context context) {
        mContext = context;
    }
    @Override
    protected AppUpdateInfo doInBackground(Void... params) { 
        try {
            //在doInBackground中调用AdManager的checkAppUpdate即可从有米服务器获得应用更新信息。
            return AdManager.getInstance(mContext).syncCheckAppUpdate();  //此方法务必在非UI线程调用，否则有可能不成功。
        } catch (Throwable e) {
            // TODO: handle exception
            e.printStackTrace();
        }
        return null;
    }
    @Override
    protected void onPostExecute(AppUpdateInfo result) {
        super.onPostExecute(result);
        try {
            if (result == null || result.getUrl() == null) {
                //如果AppUpdateInfo为null或它的url属性为null，则可以判断为没有新版本。
                Toast.makeText(this, "当前版本已经是最新版", Toast.LENGTH_SHORT).show();
                return;
            } 
            //这里简单示例使用一个对话框来显示更新信息
            new AlertDialog.Builder(mContext)
                    .setTitle("发现新版本")
                    .setMessage(result.getUpdateTips())//这里是版本更新信息
                    .setNegativeButton("马上升级",
                            new DialogInterface.OnClickListener() {
                                @Override
                                public void onClick(DialogInterface dialog,
                                        int which) {
                                    Intent intent = new Intent(
                                            Intent.ACTION_VIEW, Uri
                                                    .parse(result
                                                            .getUrl())); 
                                    intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); 
                                    mContext.startActivity(intent);
                                    //ps:这里示例点击"马上升级"按钮之后简单地调用系统浏览器进行新版本的下载，
                                    //但强烈建议开发者实现自己的下载管理流程，这样可以获得更好的用户体验。
                                }
                            })
                    .setPositiveButton("下次再说",
                            new DialogInterface.OnClickListener() {
                                @Override
                                public void onClick(DialogInterface dialog,
                                        int which) { 
                                    dialog.cancel();
                                }
                            }).create().show(); 
                } catch (Throwable e) { 
                    e.printStackTrace();
                }
        }
    }

示例(异步接口，可在任意线程使用):


    import net.youmi.android.AdManager;  
    import net.youmi.android.dev.AppUpdateInfo;   
    import net.youmi.android.dev.CheckAppUpdateCallBack;
    import android.content.Context;
    import android.app.Activity 
    import android.content.Intent;
    import android.net.Uri; 
    /*
    *这里示例一个Activity调用
    *
    */
    public class UpdateActivity extends Activity implements CheckAppUpdateCallBack{ 
    @Override
    protected void onCreate(Bundle savedInstanceState)  {  
        //调用检查更新接口，这里可以在UI线程调用，也可以在非UI线程调用。
        AdManager.getInstance(this).asyncCheckAppUpdate(this);   
    }
    @Override 
    public void onCheckAppUpdateFinish(AppUpdateInfo updateInfo) {
        //检查更新回调，注意，这里是在UI线程回调的，因此您可以直接与UI交互，但不可以进行长时间的操作(如在这里访问网络  是不允许的)
        if(updateInfo==null){
            //当前已经是最新版本
        }else{
            //有更新信息
        }
    }  
    }

2.在线参数 (可选)

2.1 在线参数介绍

在线参数是有米平台推出的新服务，可以让开发者动态修改应用中的配置项，如欢迎语、道具价格、广告开关等等。它以Key-Value的形式使用。

2.2 使用在线参数

开发者可以在有米主站开发者面板的应用详情里面设置指定应用的在线参数，然后在代码中调用它。接口示例如下:

示例代码:


    import net.youmi.android.AdManager;   
    import net.youmi.android.dev.OnlineConfigCallBack; //异步回调
    ... 
    String mykey="mycustomkey";//key  
    String defaultValue=null;//默认的value，当获取不到在线参数时，会返回该值  
    //1.同步调用方法，务必在非UI线程中调用，否则可能会失败。
    String value=AdManager.getInstance(context).syncGetOnlineConfig(key,
        defaultValue);  
    //--------------------------------------------------
    //2.异步调用方法(可在任意线程中调用):
    AdManager.getInstance(this).asyncGetOnlineConfig(mykey, new OnlineConfigCallBack() {
        @Override
        public void onGetOnlineConfigSuccessful(String key, String value) {
        // TODO Auto-generated method stub
            //获取在线参数成功
        }       
        @Override
        public void onGetOnlineConfigFailed(String key) {
            // TODO Auto-generated method stub
            //获取在线参数失败，可能原因有：键值未设置或为空、网络异常、服务器异常
        }
    });
    ...

注:在线配置服务缓存具有一定的延时，因此在开发者控制面板上更改的配置项客户端可能需要一定的时间才能响应更新。

五、打包发布

1.打包前检查

请检查是否已经按文档的步骤嵌入了广告SDK，包括AndroidManifest.xml的配置、初始化接口的调用以及各个广告接口的使用。

1.1 检查基本配置
1.2 检查混淆配置

请务必详细检查混淆配置，否则将有可能获取不到广告。

2.测试

请在手机上运行测试是否可以正常获取广告。

3.上传审核

发布前请在有米主站上传应用进行审核。审核通过之后请测试是否可以正常获得收入，在有米主站开发者面板的收入报表中可以查看收入情况。

4.发布

通过审核并且确认可以获得广告收入之后，就可以正式发布应用了。

六、常见问题

1.环境配置问题

1.1 有米广告SDK使用哪种字符编码

有米广告SDK使用UTF-8字符编码,在嵌入广告以及导入示例程序的时候请使用UTF-8编程环境，否则会出现乱码情况。

1.2 有米广告SDK兼容Android系统SDK的哪些版本

有米广告Android SDK兼容Android 系统 2.1及以上版本SDK，对于2.1以下版本可能会有兼容性问题。

2.如何关闭debug log

如果需要关闭有米广告SDK的 debug log，请调用AdManager.setEnableDebugLog(false)来关闭sdk的log输出。

"代码示例:"


    import net.youmi.android.AdManager
    ...
    //调用以下接口关闭有米广告SDK相关的log
    AdManager.getInstance(this).setEnableDebugLog(false);
    ...

注意:上传到有米主站进行审核时务必开启debug log,这样才能保证通过审核。

3.关于测试模式

广告运行在非发布状态下的情况属于测试模式。

以下情况下属于测试模式：
1. 在初始化接口设置测试模式为true
2. 应用未上传、待审核的情况下属于测试模式
3. 已上传并通过审核，但是后续版本应用ID和密钥与应用的包名不对应

测试模式下积分墙的标题会有"测试"字样的提示语，该模式下可以获得更多的测试广告，已经安装过的广告卸载后可以重复安装，但只能结算积分，不结算收入。正式发布前请务必将初始化接口的测试模式参数设置为flase，并且上传应用到有米主站进行审核。

4.联系我们

如果您在使用有米Android SDK 的过程中遇到了问题，或者对于SDK有任何宝贵的改进意见，欢迎联系我们的企业客服Q : 800006808 我们将竭诚为您服务。

劝君更尽一杯酒
关注
专栏目录
微盘AndroidSDK开发者文档1
08-03
《微盘Android SDK开发者文档1》 新浪微盘VDisk Android SDK是专为Android开发者设计的一个工具包，它允许开发者将微盘的功能集成到自己的应用中，实现文件的上传、下载、分享等操作。这份文档详细介绍了如何在...
Youmi广告sdk
qq524784740的专栏
12-03 1434
a
Android 项目集成有米 SDK 添加广告
Jession 的博客
12-31 4158
我们有时候需要在app里面，添加一些广告，作为额外的一些收入，那么该怎么办呢。最好的办法，集成第三方的SDK，这样就能满足我们的需求了。这里使用的是有米的SDK，接下来介绍其使用步骤。这里我们介绍其三种广告类型，分别为开屏广告、插屏广告和广告条广告。其他类型，读者自行去官方网站查
Android开发中文API文档大全
最新发布
weixin_32287387的博客
09-28 1804
本文还有配套的精品资源，点击获取 简介：中文开发者在面对英文版Android API文档时可能遇到障碍，这份《Android安卓中文API开发文档详解》通过详尽的中文解释，解决了语言障碍，使得开发者能够直接理解API用法。文档包括了Android系统核心组件、界面设计、数据存储、网络通信等关键方面的信息。它包含了Android的核心组件Activity、Service、Br...
【Android】接入有米广告SDK
weixin_34274029的博客
10-23 744
测试：接入有米广告SDK（测试广告）。 步骤： 1、注册并登录有米广告。 2、下载相应的SDK，这里我选了第一个【Android广告SDK 】，如下图： 3、下好后，根据doc文档步骤进行操作，包括： 导入SDK（一个jar包） 权限配置 在第一个 Activity（启动的第一个类）的 onCreate 中初始化应用信息。 其他在真实项目中需要的配置。。。。 4、在有米广告网站上添...
游量SDK android 1.0.0接入指南
qungxue的专栏
12-04 1022
锦途SDK android接入指南 注： 此SDK文档对应的版本是1.0.0，本文档只针对于Android Studio开发环境提供接入文档 1. 申请你的appid 请到 开发者应用登记页面 进行登记，登记并选择移动应用进行设置后，将该应用提交审核，只有审核通过的应用才能进行开发。 2. 下载SDK和api文档 前往资源下载页下载最新锦途SDK 3. 搭建开发环境 1. 在android s...
Android应用嵌入有米SDK教程
zhjp4295216的专栏
07-03 740
<br /><br />欢迎使用有米广告平台的android端SDK，以下将为您介绍如何在android程序中嵌入有米广告。<br /> <br />步骤一：将youmiad-android.jar导入您的工程中。<br />Ø右键您的工程根目录，选择“Properties”<br />Ø在左面板中选择“Java Build Path”<br />Ø然后选择“Libraries”标签<br />Ø点击“Add External JARs…”<br />Ø选择youmiad-android.jar的目录路径<
有米广告Android SDK开发者文档
12-12
### 有米广告Android SDK开发者文档知识点概览 #### 一、SDK嵌入步骤 **1.1 准备工作** - **1.1.1 步骤一：将youmi-android.jar导入您的工程中** - 在进行任何集成之前，首先需要确保已经将`youmi-android.jar`...
Android SDK 中文开发文档.pdf
05-10
综上所述，《Android SDK 中文开发文档》是Android开发者的重要参考资料，涵盖了Android平台的各个方面，无论是初学者还是经验丰富的开发者，都能从中获取所需的知识和技能，以构建高质量的Android应用程序。
Android SDK 中文帮助文档
11-07
这份“Android SDK 中文帮助文档”无疑是为开发者提供了方便，特别是对于那些中文阅读更为舒适的开发者，他们可以更高效地理解和掌握Android开发的各项技术。 文档可能涵盖了以下几个主要部分： 1. **API 文档**：...
DuMix AR Unity SDK 开发者文档1
08-08
DuMix AR Unity SDK 开发者文档1主要针对使用Unity引擎进行增强现实（AR）应用开发的程序员。在开始使用此SDK之前，开发者需要具备基本的AR技术知识，并且已经获得了DuMix AR应用的授权，目前该SDK仅支持试用授权。...
最新有米广告集成demo
07-23
采用2017最新有米广告文档集成，亲测可用
youmi-android-sdk-v3.05_2011-12-30 android应用广告嵌入
11-13
如何为自己的android应用嵌入广告。
九麟SDK 接入文档
jin290的博客
04-14 1333
1接入登录SDK AndroidManifest.xml 添加代码 权限 <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permissi
android芝麻认证sdk,芝麻认证接入文档.docx
weixin_30305727的博客
05-27 151
芝麻认证接入文档MegviiCloudFace++PAGE \* MERGEFORMAT12芝麻认证 SDKZMCertificationv1.0.3变更和修订历史记录文档编号：版本号完成日期修改记录1.0.02016-12-23初稿1.0.12017-2-26增加用户每日调用次数达到上限的错误类型；增加FAQ1.0.22017-3-31算法升级1.0.32017-5-2增加视频录制方法目录T...
Android教程-从零开始一步一步接入SDK
2401_83916394的博客
03-28 716
下面是有几位Android行业大佬对应上方技术点整理的一些进阶资料。希望能够帮助到大家提升技术高级UI，自定义ViewUI这块知识是现今使用者最多的。当年火爆一时的Android入门培训，学会这小块知识就能随便找到不错的工作了。不过很显然现在远远不够了，拒绝无休止的CV,亲自去项目实战，读源码，研究原理吧！《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》，点击传送门即可获取！高级UI，自定义ViewUI这块知识是现今使用者最多的。
Android apm监控框架,移动性能监控 SDK 详细集成文档
weixin_34368102的博客
05-30 750
移动性能监控 SDK 详细集成文档一. Gradle配置在 Project 的 build.gradle 文件中添加ArgusAPM的相关配置，示例如下：在项目根目录的 build.gradle(注意：不是 app/build.gradle) 中添加以下配置：buildscript {repositories {jcenter()}dependencies {classpath 'com.andr...
Android消息推送 SDK 集成指南
weixin_30263073的博客
07-28 202
使用提示 本文是 Android SDK 标准的集成指南文档。 匹配的 SDK 版本为：r1.8.0及以后版本。 本文随SDK压缩包分发。在你看到本文时，可能当前的版本与本文已经不是很适配。所以建议关注在线文档： 3 分钟快速 Demo（Android）：如果您想要快速地测试、感受下极光推送的效果，请参考本文在几分钟内跑通Demo。 极光推送文档网站上，有极光推送相关的所有指南、AP...
"微盘AndroidSDK开发者文档：导入项目和添加权限步骤
本文主要介绍了微盘AndroidSDK开发者文档中的一些基本内容。这些内容包括在Eclipse中导入VDiskSdk项目，以及在项目的AndroidManifest.xml中添加可能需要使用的权限。同时，还列出了微盘Android SDK开发者文档的一些...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值