94      阿里云  技术社区[云栖]

AndroidSDK__SDK手册_移动定向营销_规则引擎-阿里云

1. 前言

移动定向营销与移动数据分析(以下简称MAN) 共用同一个Mobile Analytics Android SDK，以下介绍Android SDK的基础使用指南。

• 若您已经集成了移动数据分析的SDK，则可以跳过本步骤
• 参照下文，安装并初始化SDK，将不影响您在移动定向营销服务中的正常使用
• 若您希望更深入的了解移动数据分析（MAN），请查看完整版本的SDK使用指南。

您可以通过获取alicloud-android-demo工程源码获得移动数据分析服务的使用例程。

2. 安装Mobile Analytics Android SDK

Mobile Analytics Android SDK文件包括：

1. alicloud-android-sdk-man.jar
2. alisdk-ut.jar
3. utdid4all.jar

引入工程后可参考下文所述步骤使用。

3. 应用程序初始化

在您使用Mobile Analytics Android SDK进行数据统计与监控前，您需要对SDK的上下文进行一些初始化配置，如权限声明、传递应用上下文、访问控制等。其中权限声明在AndroidManifest.xml文件中进行。

3.1 权限声明及配置AppKey,AppSecret

以下是Mobile Analytics Android SDK所需要的Android权限及配置AppKey,AppSecret，请把这些权限配置到您的AndroidManifest.xml文件，否则，SDK将无法正常工作。

...
<meta-data android:name="com.alibaba.app.appkey" android:value="YourAppKey"></meta-data>
<meta-data android:name="com.alibaba.app.appsecret" android:value="YourAppSecret"></meta-data>
</application>
<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<uses-permission android:name="android.permission.GET_TASKS"></uses-permission>
<uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
<uses-permission android:name="android.permission.READ_SETTINGS"/>
<uses-permission android:name="android.permission.WRITE_SETTINGS"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

3.2 初始化及参数设置示例

在Application的实现类中，添加初始化SDK的代码。

Mobile Analytics Android SDK初始化部分的接口如下：

public class YourApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        /* 【注意】建议您在Application中初始化MAN，以保证正常获取MANService*/
        // 获取MAN服务
        MANService manService = MANServiceProvider.getService();
        // 打开调试日志，线上版本建议关闭
        // manService.getMANAnalytics().turnOnDebug();
        // MAN初始化方法之一，从AndroidManifest.xml中获取appKey和appSecret初始化
        manService.getMANAnalytics().init(this, getApplicationContext());
        // MAN另一初始化方法，手动指定appKey和appSecret
        // String appKey = "******";
        // String appSecret = "******";
        // manService.getMANAnalytics().init(this, getApplicationContext(), appKey, appSecret);
        // 若需要关闭 SDK 的自动异常捕获功能可进行如下操作,详见文档5.4
        manService.getMANAnalytics().turnOffCrashHandler();
        // 通过此接口关闭页面自动打点功能，详见文档4.2
        manService.getMANAnalytics().turnOffAutoPageTrack();
        // 设置渠道（用以标记该app的分发渠道名称），如果不关心可以不设置即不调用该接口，渠道设置将影响控制台【渠道分析】栏目的报表展现。如果文档3.3章节更能满足您渠道配置的需求，就不要调用此方法，按照3.3进行配置即可
        manService.getMANAnalytics().setChannel("某渠道");
        // 若AndroidManifest.xml 中的 android:versionName 不能满足需求，可在此指定
        // 若在上述两个地方均没有设置appversion，上报的字段默认为null
        manService.getMANAnalytics().setAppVersion("3.1.1");
    }
}

3.3 配置渠道信息

您可以在AndroidManifest.xml中配置您的渠道信息，您只需要将<YOUR CHANNEL ID>替换您的渠道信息即可。

<application ...
    <meta-data
        android:name="ALIYUN_MAN_CHANNEL"
        android:value="<YOUR CHANNEL ID>" >
    </meta-data>
</application>