友盟统计使用记录

为了以后方便，在此记录一下具体步骤：（大多信息来自友盟集成文档：http://dev.umeng.com/analytics/android-doc/integration?spm=0.0.0.0.ZOAGcu#3_6）

一、  集成友盟SDK之前，您首先需要到友盟官网(http://dev.umeng.com/analytics/android-doc/www.umeng.com)注册并且添加新应用，获得Appkey

二、下载SDK,添加，如果是android Studio在Gradle依赖中添加：

dependencies { 
  compile 'com.umeng.analytics:analytics:latest.integration' 
}

三、以上是准备工作，基本配置是：

1：场景类型设置接口：MobclickAgent.setScenarioType(Context context, EScenarioType etype)

2：etype是官方场景，有如下场景:

EScenarioType. E_UM_NORMAL　　普通统计场景类型
EScenarioType. E_UM_GAME     　　游戏场景类型
EScenarioType. E_UM_ANALYTICS_OEM  统计盒子场景类型
EScenarioType. E_UM_GAME_OEM      　 游戏盒子场景类型

3：在Manifext.xml中配置

<manifest……>
<uses-sdk android:minSdkVersion="4"></uses-sdk>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission>
<application ……>
……
<activity ……/>
<meta-data android:value="YOUR_APP_KEY" android:name="UMENG_APPKEY"></meta-data>
<meta-data android:value="Channel ID" android:name="UMENG_CHANNEL"/>
</application>    
</manifest>

需要替换appKey,Channel ID 替换为您应用的推广渠道名称   

例如：在豌豆荚渠道推广此包，代码示例： <meta-data android:value="Wandoujia" android:name="UMENG_CHANNEL"/>

非常重要：每台设备仅记录首次安装激活的渠道，如果该设备再次安装其他渠道包，则数据仍会被记录在初始的安装渠道上。 所以在测试不同的渠道时，请使用不同的设备来分别测试。也可使用集成测试功能进行测试，了解更多集成测试请点击这里(http://dev.umeng.com/analytics/functions/testmode)

  4：在代码中配置渠道id

MobclickAgent. startWithConfigure(UMAnalyticsConfig config)
UMAnalyticsConfig(Context context, String appkey, String channelId)
UMAnalyticsConfig(Context context, String appkey, String channelId, EScenarioType eType)
UMAnalyticsConfig(Context context, String appkey, String channelId, EScenarioType eType,Boolean isCrashEnable)

构造意义：
String appkey:官方申请的Appkey
String channel: 渠道号
EScenarioType eType: 场景模式，包含统计、游戏、统计盒子、游戏盒子
Boolean isCrashEnable: 可选初始化. 是否开启crash模式

注意：一个包中只能添加一个渠道，多个渠道需要打多个包。开发者新增渠道需要在工程manifest中或者activity中调用接口添加我们的渠道信    息，友盟后台没有添加渠道的地方。您可以使用Gradle实现多渠道打包

四、Android Studio gradle 多渠道打包配置(摘自：http://bbs.umeng.com/thread-9119-1-1.html)

以友盟的渠道统计为例，渠道信息一般在 AndroidManifest.xml中修改以下值：

<meta-data android:name="UMENG_CHANNEL" android:value="wandoujia" />

首先你必须在 AndroidManifest.xml中的meta-data修改以下的样子：

<meta-data    android:name="UMENG_CHANNEL"    android:value="${UMENG_CHANNEL_VALUE}" />

其中${UMENG_CHANNEL_VALUE}中的值就是你在gradle中自定义配置的值。

build.gradle文件就利用productFlavors这样写：

productFlavors {
wandoujia {
manifestPlaceholders = [UMENG_CHANNEL_VALUE: "wandoujia"]
}
baidu {
manifestPlaceholders = [UMENG_CHANNEL_VALUE: "baidu"]
}
c360 {
manifestPlaceholders = [UMENG_CHANNEL_VALUE: "c360"]
}
uc {
manifestPlaceholders = [UMENG_CHANNEL_VALUE: "uc"]
}
}

其中[UMENG_CHANNEL_VALUE: "wandoujia"]就是对应${UMENG_CHANNEL_VALUE}的值。

最新更新

后来发现上面的重复代码太多，就在网上又发现了一个更简洁的写法

productFlavors {
wandoujia {}
baidu {}
c360 {}
uc {}
productFlavors.all { flavor ->
flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name]
}
}

其中name的值对相对应各个productFlavors的选项值，这样就达到自动替换渠道值的目的了。

这样生成apk时，选择相应的Flavors来生成指定渠道的包就可以了，而且生成的apk会自动帮你加上相应渠道的后缀，非常方便和直观 。大家可以自己反编译验证。

一次生成所有渠道包

在android studio底栏中有个命令行工具Terminal,打开后就CMD可以自动切换到当前项目的目录下。

有的项目下会有graldew.bat这个文件，你就可以输入这个命令：

gradlew assembleRelease

就可以一次性生成所有的渠道包了
不过我一般不建议大家使用这个命令，gradlew这个命令的gralde的版本无法控制，有时候会莫名其妙的下载老版本的gradle
所以我个人推荐大家使用以下的用法。

先找到gralde的根目录，在系统变量里添加两个环境变量：

变量名为：GRADLE_HOME，变量值就为gradle的根目录；
所以变量值为：C:\Users\yazhou\.gradle\wrapper\dists\gradle-2.1-all\27drb4udbjf4k88eh2ffdc0n55\gradle-2.1

还有一个在系统变量里PATH里面添加gradle的bin目录
我的就是C:\Users\yazhou\.gradle\wrapper\dists\gradle-2.1-all\27drb4udbjf4k88eh2ffdc0n55\gradle-2.1\bin

这里配置完成了，接着在Terminal中敲下 gradle assembleRelease就可以一次性生成所有的渠道包了。

所有生成的apk在项目的build\outputs\apk下。

如果只是想生成单个渠道的包呢？

打开Android Studio的Gradle tasks面板(右边侧边栏)，会发现模块多了很多任务，如下图所示。

此时可以直接双击该任务生成对应的apk，也可以用命令行单独生成，比如

gradle assembleWandoujiaRelease

多渠道打包从此就非常快捷了，今天就写到这里，以后Android studio有相应的tips还是会分享给大家。

五、session的统计

在每个Activity的onResume方法中调用 , 

<span style="white-space:pre">	</span>MobclickAgent.onResume(Context)

onPause方法中调用 

<span style="white-space:pre">	</span>MobclickAgent.onPause(Context)

• 确保在所有的Activity中都调用 MobclickAgent.onResume() 和MobclickAgent.onPause()方法，这两个调用将不会阻塞应用程序的主线程，也不会影响应用程序的性能。
• 注意 如果您的Activity之间有继承或者控制关系请不要同时在父和子Activity中重复添加onPause和onResume方法，否则会造成重复统计，导致启动次数异常增高。(eg.使用TabHost、TabActivity、ActivityGroup时)。
• 当应用在后台运行超过30秒（默认）再回到前端，将被认为是两个独立的session(启动)，例如用户回到home，或进入其他程序，经过一段时间后再返回之前的应用。可通过接口：MobclickAgent.setSessionContinueMillis(long interval) 来自定义这个间隔（参数单位为毫秒）。
• 如果开发者调用Process.kill或者System.exit之类的方法杀死进程，请务必在此之前调用MobclickAgent.onKillProcess(Context context)方法，用来保存统计数据。

1：启动次数统计规则：

在每个Activity的开始和结束时分别调用onResume和onPause方法.

当一个onResume方法与上一个Activity的onPause方法相差30秒，标志新session的开始；当一个onPause方法发生后30秒内没 有再触发任何一个Activity的onResume方法，标志该session结束。

如果应用Crash， Android平台处理成onPause, 照例通过30秒规则来判断是否是session的终止.

即Android平台一次完整的启动包括如下三种情况：

1.从启动应用到关闭应用

2.从启动应用到应用退至后台，且在后台运行时间超过30s

3.启动应用后设备黑屏，黑屏时间超过30s

符合以上三种情况的前提下，Android启动次数+1.+

2：用户统计规则：

友盟在统计用户时以设备为标准，如果需要统计应用自身的账号（需使用5.6.1及以上版本SDK）要使用以下接口：

publicstaticvoidonProfileSignIn(String ID) ;
publicstaticvoidonProfileSignIn(String Provider, String ID) ;

• ID：用户账号ID，长度小于64字节
• Provider：账号来源。如果用户通过第三方账号登陆，可以调用此接口进行统计。支持自定义，不能以下划线"_"开头，使用大写字母和数字标识，长度小于32 字节; 如果是上市公司，建议使用股票代码。

publicstaticvoidonProfileSignOff();

• 账号登出时需调用此接口，调用之后不再发送账号相关内容。

示例：

当用户使用自有账号登录时，可以这样统计：

MobclickAgent.onProfileSignIn("userID");

当用户使用第三方账号（如新浪微博）登录时，可以这样统计：

MobclickAgent.onProfileSignIn("WB"，"userID");

3：页面统计最佳策略：

访问页面：（http://blog.umeng.com/products/2928.html）

六、应用混淆

-keepclassmembersclass * {public <init> (org.json.JSONObject);}

这是由于SDK中的部分代码使用反射来调用构造函数， 如果被混淆掉， 在运行时会提示"NoSuchMethod"错误。 另外，由于SDK需要引用导入工程的资源文件，通过了反射机制得到资源引用文件R.java，但是在开发者通过proguard等混淆/优化工具处理apk时，proguard可能会将R.java删除，如果遇到这个问题，请在proguard配置文件中添加keep命令如：

-keep public class [您的应用包名].R$*{publicstatic final int *;}

把[您的应用包名] 替换成您自己的包名，如com.yourcompany.example。如果您使用5.0.0及以上版本的SDK，请添加如下命令：

-keepclassmembersenum * { publicstatic **[] values(); publicstatic ** valueOf(java.lang.String);}

更多详细信息到友盟官方网站查看，这里只是一个大概过程。