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>