序言
记得很久以前有做过友盟这个东西,不过这个功能是同事弄的。现在在另一家公司做了,自己要实现这个功能了app上线后,一般公司都希望跟踪app在市场上的使用情况。包括新增用户、活跃用户、渠道信息、错误信息等,还有例如商城类的app,需要跟踪用户最喜欢浏览哪种类型的店铺或商品。这些都可以通过集成友盟统计来轻松实现。
集成
一、添加新应用
集成友盟SDK之前,首先需要到友盟官网注册并且添加新应用如下图所示:
二、获取Appkey
获取Appkey(一般公司项目不需要自己申请账号,跟项目经理要即可)。每个应用对应的Appkey是唯一的,如下:
三、导入SDK
有两种方法:(本例中采用第二种方法)
方法一:下载SDK,将解压出来的jar包复制到工程libs/目录下。
下载地址:https://developer.umeng.com/sdk/android?refer=UApp
只需要下载Analytics SDK即可,如下:
方法二:添加SDK在maven中心库的线上依赖1、在app的builde.gradle中添加依赖
/*友盟统计需要的最新版本组件化基础库和统计SDK*/
implementation 'com.umeng.sdk:common:latest.integration'
implementation 'com.umeng.sdk:analytics:latest.integration'
如果无法正常集成,则需要在项目的builde.gradle中添加如下配置:
allprojects {
repositories {
mavenCentral()
}
}
四、在AndroidManifest.xml中添加权限、配置Appkey与渠道(Channel)
manifest的配置主要包括添加权限,以下权限缺一不可,填写Appkey和填写渠道id三部分,代码示例如下:
<manifest……>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<application ……>
……
<activity ……/>
<meta-data android:value="YOUR_APP_KEY" android:name="UMENG_APPKEY"/>
<!--value的值填写渠道名称,例如yingyongbao。这里设置动态渠道名称变量-->
<meta-data android:value="${UMENG_CHANNEL_VALUE}"android:name="UMENG_CHANNEL"/></application>
</manifest>
在app的builde.gradle中配置需要的渠道(这里只测试应用宝、豌豆荚、小米),对应上面的渠道名称变量。
/*配置渠道*/
productFlavors {
yingyongbao {
manifestPlaceholders = [UMENG_CHANNEL_VALUE: "yingyongbao"]
}
wandoujia {
manifestPlaceholders = [UMENG_CHANNEL_VALUE: "wandoujia"]
}
xiaomi {
manifestPlaceholders = [UMENG_CHANNEL_VALUE: "xiaomi"]
}
}
完整app的build。gradle如下:
apply plugin: 'com.android.application'
android {
//签名信息配置
signingConfigs {
android_studio_app {
keyAlias 'key'
keyPassword '123456'
storeFile file('D:/asdemo/MyViewPagerFragment/key/umeng.jks')
storePassword '123456'
}
}
compileSdkVersion 25
buildToolsVersion '27.0.3'
defaultConfig {
applicationId "com.example.a31210.myviewpagerfragment"
minSdkVersion 15
targetSdkVersion 25
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
signingConfig signingConfigs.android_studio_app
}
debug {
signingConfig signingConfigs.android_studio_app
}
}
flavorDimensions "a"
/*配置渠道*/
productFlavors {
yingyongbao {
dimension "a"
manifestPlaceholders = [UMENG_CHANNEL_VALUE: "yingyongbao"]
}
wandoujia {
dimension "a"
manifestPlaceholders = [UMENG_CHANNEL_VALUE: "wandoujia"]
}
xiaomi {
dimension "a"
manifestPlaceholders = [UMENG_CHANNEL_VALUE: "xiaomi"]
}
}
}
dependencies {
implementation fileTree(include: ['*.jar'], dir: 'libs')
androidTestImplementation('com.android.support.test.espresso:espresso-core:2.2.2', {
exclude group: 'com.android.support', module: 'support-annotations'
})
implementation 'com.android.support:appcompat-v7:25.3.1'
implementation 'com.android.support.constraint:constraint-layout:1.0.2'
testImplementation 'junit:junit:4.12'
/*友盟统计需要的最新版本组件化基础库和统计SDK*/
implementation 'com.umeng.sdk:common:latest.integration'
implementation 'com.umeng.sdk:analytics:latest.integration'
}
五、添加初始化方法
在项目工程的自定义application中的onCreate方法中添加以下方法:
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
/**
* 参数1:上下文,必须的参数,不能为空
* 参数2:友盟 app key,非必须参数,如果Manifest文件中已配置app key,该参数可以传空,则使用Manifest中配置的app key,否则该参数必须传入
* 参数3:友盟 channel,非必须参数,如果Manifest文件中已配置channel,该参数可以传空,则使用Manifest中配置的channel,否则该参数必须传入,channel命名请详见channel渠道命名规范
* 参数4:设备类型,必须参数,传参数为UMConfigure.DEVICE_TYPE_PHONE则表示手机;传参数为UMConfigure.DEVICE_TYPE_BOX则表示盒子;默认为手机
* 参数5:Push推送业务的secret,需要集成Push功能时必须传入Push的secret,否则传空
*/
UMConfigure.init(this,UMConfigure.DEVICE_TYPE_PHONE,"");
}
}
通过上面的步骤,友盟统计就已经集成好了,下面来看看它各种统计的使用。
使用
Session统计
即启动数据的统计(包括新增用户、活跃用户、启动次数、使用时长等基本数据)
需要在每个Activity的onResume方法中调用 MobclickAgent.onResume(Context),
onPause方法中调用 MobclickAgent.onPause(Context),如下:
@Override
protected void onResume() {
//设置为竖屏
if(getRequestedOrientation()!= ActivityInfo.SCREEN_ORIENTATION_PORTRAIT){
setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);
}
super.onResume();
MobclickAgent.onResume(this);
}
@Override
protected void onPause() {
super.onPause();
MobclickAgent.onPause(this);
}
-
确保在所有的Activity中都调用 MobclickAgent.onResume() 和onPause()方法。
-
如果Activity之间有继承或者控制关系请不要同时在父和子Activity中重复添加nPause和nResume方法,否则会造成重复统计。例如在BaseActivity中添加过,则它的子类就不需要添加了。
安装app启动后。在友盟后台就可以看到统计的数据了。如下:
新增用户、启动次数、日活等数据:
渠道分析数据:
自定义事件统计
自定义事件可以实现在应用程序中埋点来统计用户的点击行为。如果应用是商城类的,就需要统计用户是喜欢进入“picture
”店铺,还是“new banlance"店铺。自定义事件目前包括"计数事件"和"计算事件",这里主要讲下计数事件。
1、首先需要在友盟后台添加自定义事件:设置-事件-手工添加-添加事件。如下:
2、在需要监听自定义事件的地方添加代码,如下模拟点击进入”picture“店铺。
第二个参数为当前统计的事件ID,需要与友盟后台设置的事件ID一致(即上图的事件ID)。
MobclickAgent.onEvent(getActivity(),"picture");
3、运行app,触发该事件后。在友盟后台就可以看到统计的数据了。如下:
其中消息数量即为事件被触发的次数。
错误统计
错误分析是友盟为移动开发者提供的Crash收集和分析工具,帮助开发者监测App在移动设备上的运行状况,及时发现并解决错误,提升App的稳定性。
Android统计SDK从V4.6版本开始内建错误统计,不需要开发者再手动集成。
SDK通过Thread.UncaughtExceptionHandler 捕获程序崩溃日志,并在程序下次启动时发送到服务器。 如不需要错误统计功能,可通过此方法关闭
MobclickAgent.setCatchUncaughtExceptions(false);
如果开发者自己捕获了错误,需要上传到【友盟+】服务器可以调用下面方法:
public static void reportError(Context context, String error)
//或
public static void reportError(Context context, Throwable e)
现在我在demo中模拟一次错误,如下:
tv_pic.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Toast.makeText(getActivity(),"图片",Toast.LENGTH_SHORT).show();
int i = 1 / 0;
}
});
再到友盟后台查看错误,如下:
其他统计
上面三个统计是比较常用的统计,还有很多统计,例如账号统计、页面统计等就不一一列举了。有需求的可以参考友盟统计集成文档