快速找到所需文档，高效完成接入与排障

一、SDK预初始化

public static void preInit(Context context,String appkey,String channel)

UMConfigure.preInit(this,"您的appkey","您的渠道");

1.3参数解释：

1.3.1 appkey：Appkey是友盟+为每一个应用生成的唯一标识码，用来在数据计算时，区分数据是哪个应用的，非常重要！请勿填写出错！创建或查看链接：应用管理列表

1.3.2 channel：标识设备安装时的来源渠道。设备仅记录首次安装激活的渠道，在其他渠道再次安装不会重复计量。 所以在测试不同的渠道的时候，需查看集成测试中的“本次安装渠道”，但是在产品中计算是“初次安装渠道”

1.3.3 Channel渠道的命名规范

• 可以由英文字母、阿拉伯数字、下划线、中划线、空格、括号组成，可以含汉字以及其他明文字符，但是不建议使用中文命名，会出现乱码。

• 首尾字符不可以为空格。

• 不要使用纯数字作为渠道ID。

• 最多256个字符。

• “unknown” 及其各种大小写形式，作为【友盟+】保留的字段，不可以作为渠道名。

在您查看数据时，渠道会作为一个数据细分的维度。

1.3.4 账号统计及用户属性上报

【友盟+】在统计用户时以设备为标准，如果需要统计应用自身的账号，请参考 高级功能 完成账号统计的集成。

设置上报用户上报后，在U-App中的应用及实践场景可参考文档：用户账号及用户属性

二、SDK初始化

确保App首次冷启动时，在用户阅读您的《隐私政策》并取得用户授权之后，才调用正式初始化函数UMConfigure.init()初始化统计SDK，此时SDK才会真正采集设备信息并上报数据。反之，如果用户不同意《隐私政策》授权，则不能调用UMConfigure.init()初始化函数。

一旦App获取到《隐私政策》的用户授权，后续的App冷启动，开发者应该保证在Applicaiton.onCreate函数中调用预初始化函数UMConfigure.preInit()。正式初始化函数UMConfigure.init可以按需调用（可以在预初始化函数之后紧接着调用，也可以放到后台线程中延迟调用，但还是必须调用，不能遗漏）。

2.1初始化接口：

/**
* 注意: 即使您已经在AndroidManifest.xml中配置过appkey和channel值，也需要在App代码中调
* 用初始化接口（如需要使用AndroidManifest.xml中配置好的appkey和channel值，
* UMConfigure.init调用中appkey和channel参数请置为null）。
*/
UMConfigure.init(Context context,String appkey,String channel,int deviceType,String pushSecret);

或者

/** 
* 注意：如果您已经在AndroidManifest.xml中配置过appkey和channel值，可以调用此版本初始化函数。
*/
UMConfigure.init(Context context,int deviceType,String pushSecret);

2.2示例：

UMConfigure.init(this,"您的appkey","您的渠道",UMConfigure.DEVICE_TYPE_PHONE, "");

2.3参数解释：

2.3.1 appkey和channl必须保持和预初始化一致！！！

2.3.2 deviceType：设备类型，UMConfigure.DEVICE_TYPE_PHONE为手机、UMConfigure.DEVICE_TYPE_BOX为盒子

2.3.3 pushSecret：Push推送业务的secret

三、程序退出时，用于保存统计数据的API。

如果开发者调用kill或者exit之类的方法杀死进程，或者双击back键会杀死进程，请务必在此之前调用MobclickAgent.onKillProcess方法，用来保存统计数据。

public static void onKillProcess(Context context);

四、完整代码示例

详细可见友盟+SDK集成Demo

public class App extends Application {

    SharedPreferencesHelper sharedPreferencesHelper;

    @Override
    public void onCreate() {
        super.onCreate();
        sharedPreferencesHelper=new SharedPreferencesHelper(this,"umeng");

        //设置LOG开关，默认为false
        UMConfigure.setLogEnabled(true);

        //友盟预初始化
        UMConfigure.preInit(getApplicationContext(),"59892f08310c9307b60023d0","Umeng");

        /**
         * 打开app首次隐私协议授权，以及sdk初始化，判断逻辑请查看SplashTestActivity
         */
        //判断是否同意隐私协议，uminit为1时为已经同意，直接初始化umsdk
        if(sharedPreferencesHelper.getSharedPreference("uminit","").equals("1")){
            //友盟正式初始化
            UmInitConfig umInitConfig=new UmInitConfig();
            umInitConfig.UMinit(getApplicationContext());
        }
    }
}

五、集成校验

如果初始化正确，那您已经完成了基础统计，在产品中以下模块是可以正常统计显示数据分析结果的，包括产品中的“实时”和“统计”除“功能使用”外都会有数据。

为了帮助您判断初始化是否正确，为您提供测试工具，包括集成测试、日志打印和合规检测。

/**
*设置组件化的Log开关
*参数: boolean 默认为false，如需查看LOG设置为true
*/
UMConfigure.setLogEnabled(true);