Android | 统计分析 | 开发者中心 | 友盟 友盟统计分析sdk集成

友盟开发者中心

客户端下载

English

首页 / 统计分析 / Android

快速开始集成准备

基本功能集成

测试与调试

技术支持

使用高级功能

SDK下载

SDK更新日志

自定义事件案例

FAQ



1.集成准备

1.1 获得Appkey

1.2 下载SDK

1.3 导入SDK

2.基本功能集成

2.1 配置manifest

2.1.1 获取权限

2.1.2 appkey填写

2.1.3 channel填写

2.1.4 version标识

2.2 session的统计

2.3 页面的统计

2.3.1 只由Activity构成的应用

2.3.2 包含Activity、Fragment或View的应用

2.4发送策略

3.测试与调试

3.1 确认如下内容

3.2 使用集成测试服务(推荐)

3.3 使用普通测试流程

4.技术支持

1.集成准备

1.1 获得Appkey

集成友盟SDK之前,您首先需要到友盟官网注册并且添加新应用,获得Appkey



1.2 下载SDK

下载统计SDK umeng-sdk-analytics.zip并解压缩

若您同时使用自动更新或用户反馈SDK,请下载时同时选择多个服务,分开下载有可能出现资源冲突问题。同时下载多个SDK,解压后对应多个jar包,但是共用同一份res资源文件,如下图所示:



1.3 导入SDK

将下载包中的libs 文件夹合并到本地工程libs子目录下;在Eclipse中右键工程根目录,选择Properties -> Java Build Path -> Libraries,然后点击Add External JARs... 选择指向jar的路径,点击OK,即导入成功。(ADT17及以上不需要手动导入)

2.基本功能集成

2.1 配置manifest

;

manifest的配置主要包括添加权限,填写Appkey和填写渠道id三部分,代码示例如下:

<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>2.1.1 权限说明

权限用途

ACCESS_NETWORK_STATE(必须)检测联网方式,区分用户设备使用的是2G、3G或是WiFi

READ_PHONE_STATE(必须)获取用户设备的IMEI,通过IMEI和mac来唯一的标识用户。

ACCESS_WIFI_STATE(必须)获取用户设备的mac地址,在平板设备上,无法通过imei标示设备,我们会将mac地址作为用户的唯一标识

INTERNET(必须)允许应用程序联网,以便向我们的服务器端发送数据。

2.1.2 appkey填写

将<meta-data android:value="YOUR_APP_KEY" android:name="UMENG_APPKEY"></meta-data> 中的YOUR_APP_KEY 替换为您在友盟后台申请的应用Appkey(Appkey可在统计后台的 统计分析->设置->应用信息 页面查看),其他部分均不需改动。

如不想在manifest里配置友盟的appkey,可在Activity中配置:只需在程序启动时的Activity中调用此接口:AnalyticsConfig.setAppkey(String appkey)

2.1.3 channel填写

将<meta-data android:value="Channel ID" android:name="UMENG_CHANNEL"/> 中的Channel ID 替换为您应用的推广渠道名称。

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

如不想在manifest里配置友盟的channel,可在Activity中配置:只需在程序启动时的Activity中调用此接口:AnalyticsConfig.setChannel(String channel)

您可以使用20位以内的英文或数字为渠道命名(不建议使用中文命名),在您查看数据时,渠道会作为一个数据细分的维度。

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

2.1.4 version标识

以SDk打包时的VersionName作为应用程序的版本标识。

2.2 session的统计

正确集成如下代码,才能够保证获取正确的新增用户、活跃用户、启动次数、使用时长等基本数据。

在每个Activity的onResume方法中调用 MobclickAgent.onResume(Context), onPause方法中调用 MobclickAgent.onPause(Context)

public void onResume() {super.onResume();MobclickAgent.onResume(this);}public void onPause() {super.onPause();MobclickAgent.onPause(this);}确保在所有的Activity中都调用 MobclickAgent.onResume() 和MobclickAgent.onPause()方法,这两个调用将不会阻塞应用程序的主线程,也不会影响应用程序的性能。

注意如果您的Activity之间有继承或者控制关系请不要同时在父和子Activity中重复添加onPause和onResume方法,否则会造成重复统计(eg.使用TabHost、TabActivity、ActivityGroup时)。

当应用在后台运行超过30秒(默认)再回到前端,将被认为是两个独立的session(启动),例如用户回到home,或进入其他程序,经过一段时间后再返回之前的应用。可通过接口:MobclickAgent.setSessionContinueMillis(long interval) 来自定义这个间隔(参数单位为毫秒)。

2.3 页面的统计

页面统计集成正确,才能够获取正确的页面访问路径、访问深度(PV)的数据。

页面访问路径的数据为抽样统计(抽样比例为所有log的3%),数据量达到一定程度才会在后台展示。若您希望查看测试数据,请使用集成测试服务,了解更多集成测试请点击这里。

2.3.1 只由Activity构成的应用

如果您已经完成2.3步骤之前的代码添加,那么SDK已默认统计了每个Activity的跳转路径。页面统计不需要再添加其他代码。

2.3.2 包含Activity、Fragment或View的应用

统计程序中包含Fragment的情况比较复杂,首先要明确一些概念。

MobclickAgent.onResume() 和MobclickAgent.onPause() 方法是用来统计应用时长的(也就是Session时长,当然还包括一些其他功能)

MobclickAgent.onPageStart() 和 MobclickAgent.onPageEnd() 方法是用来统计页面跳转的

在仅有Activity的程序中,SDK 自动帮助开发者调用了 2. 中的方法,并把Activity 类名作为页面名称统计。但是在包含fragment的程序中我们希望统计更详细的页面,所以需要自己调用方法做更详细的统计。首先,需要在程序入口处,调用 MobclickAgent.openActivityDurationTrack(false) 禁止默认的页面统计方式,这样将不会再自动统计Activity。

然后需要做两步集成:

1. 使用 onResume 和 onPause 方法统计时长, 这和基本统计中的情况一样(针对Activity)

2. 使用 onPageStart 和 onPageEnd 方法统计页面(针对页面,页面可能是Activity 也可能是Fragment或View)

对于一些典型,比如页面是直接放在Activity里面的,统计代码大约是这样:

public void onResume() { super.onResume(); MobclickAgent.onPageStart("SplashScreen"); //统计页面 MobclickAgent.onResume(this); //统计时长}public void onPause() { super.onPause(); MobclickAgent.onPageEnd("SplashScreen"); // 保证 onPageEnd 在onPause 之前调用,因为 onPause 中会保存信息 MobclickAgent.onPause(this);}

如果页面是使用FragmentActivity + Fragment实现的,需要在 FragmentActivity 中统计时长:

public void onResume() { super.onResume(); MobclickAgent.onResume(this); //统计时长}public void onPause() { super.onPause(); MobclickAgent.onPause(this);}

并在其包含的 Fragment 中统计页面:

public void onResume() { super.onResume(); MobclickAgent.onPageStart("MainScreen"); //统计页面}public void onPause() { super.onPause(); MobclickAgent.onPageEnd("MainScreen"); }

需要注意的是这些方法的调用,需要保证线性不交叉,每个 start 都有一个 end 配对,如下:

onPageStart ->onPageEnd-> onPageStart -> onPageEnd -> onPageStart ->onPageEnd

这样才能保证每个页面统计的正确,关于页面统计API的最佳实践说明见这里 。

2.4发送策略

发送策略定义了用户由统计分析SDK产生的数据发送回友盟服务器的频率。

您需要在程序的入口 Activity 中添加

MobclickAgent.updateOnlineConfig( mContext );

Android平台的数据发送策略有两种方式:

* 启动时发送:APP启动时发送当次启动数据和上次的使用时长等缓存数据,当次使用过程中产生的自定义事件数据缓存在客户端,下次启动时发送

* 按间隔发送:按特定间隔发送数据,间隔时长介于90秒与1天之间。您可以在后台自定义发送间隔。

在没有取到在线配置的发送策略的情况下,会使用默认的发送策略:启动时发送。

你可以在友盟后台“设置->发送策略”页面自定义数据发送的频率。

注意:打开调试模式(debug)后,数据实时发送,不受发送策略控制

到此,基本统计功能集成已经完成。

3.测试与调试

3.1 确认如下内容

确认已经将整个res资源文件夹合并到了工程中
Android | 统计分析 | 开发者中心 | 友盟 友盟统计分析sdk集成

确认所需的权限都已经添加:INTERNET, READPHONESTATE

确认APPKEY已经正确的写入Androidmanifest.xml

确认所有的Activity中都调用了onResume和onPause方法

确认测试手机(或者模拟器)已成功连入网络

集成中可能出现的问题,参见这里

3.2 使用集成测试服务(推荐)

集成测试是通过收集和展示已注册测试设备发送的日志,来检验SDK集成有效性和完整性的一个服务。 所有由注册设备发送的应用日志将实时地进行展示,您可以方便地查看包括应用版本、渠道名称、自定义事件、页面访问情况等数据,提升集成与调试的工作效率。

所有测试数据不会进入应用正式的统计后台,而只是展示在测试的数据报表中,您不必再担心因为测试而导致的数据污染问题,让数据更加真实有效的反应用户使用情况。

集成测试服务详细说明请参见这里,了解更多集成测试请点击这里。

3.3 使用普通测试流程

如果您不使用集成测试服务来测试数据,那您可以通过普通测试流程查看测试数据。

使用普通测试流程,您的测试数据会与用户的真实使用数据同时处理,从而导致数据污染。

使用普通测试流程,请先在程序入口添加以下代码打开调试模式:

MobclickAgent.setDebugMode( true );

打开调试模式后,您可以在logcat中查看您的数据是否成功发送到友盟服务器,以及集成过程中的出错原因等,友盟相关log的tag是MobclickAgent。

4.技术支持

点击访问:友盟开发者社区

QQ:800083942

Email:support@umeng.com

为了能够尽快响应您的反馈,请提供您的appkey及logcat中的详细出错日志,您所提供的内容越详细越有助于我们帮您解决问题。

产品与服务

开发组件

消息推送

社会化组件

用户反馈

自动更新

统计分析

统计分析

游戏统计分析

APP错误分析

社会化行为分析

客户端

营销推广

应用联盟交叉推广

推广效果分析

付费推广

盈利服务

应用联盟广告网络

应用联盟自主广告

友盟实验室

Android渠道打包工具

友盟统计Unity插件

Android插件框架

数据

数据报告

友盟指数

友盟观点

帮助与支持

社会化组件

用户反馈

自动更新

APP统计分析

社会化行为分析

应用联盟

技术支持

关于我们

公司介绍

友盟新闻

合作伙伴

最佳案例

加入我们

联系我们

隐私政策

开发者沙龙

移动开发者服务平台

? 2011-2015 Umeng.com , All Rights Reserved.

京ICP备案11021163号-6 | 京公网安备 110108008330

  

爱华网本文地址 » http://www.413yy.cn/a/25101013/169603.html

更多阅读

短信中心号码怎么设置 联通设置短信中心号码

短信中心号码怎么设置——简介短信中心号码是实现信息转发的重要“中转站”,通过情况下导致手机无法收发信息的重要原因是短信中心号码设计不正确造成下。下面就来看一下如何设置短信中心号码。短信中心号码怎么设置——工具/原料An

教你为何破解Root权限 vivox5sl破解root权限

对于新近入手Android系统手机的机友来说,一定会接触到一个新词“ROOT”,他的出现频率很高,在各个论坛上,网友的字里行间经常会出现,那么ROOT权限是什么呢?可以给我们带来怎样的好处呢?什么是root,我需要它做什么?root就是手机的神经中枢

友加推广全分析:友加APP是如何把自己“推”死的

“那年那月,一票人围坐在一起,开始定下“用身体换XXX”几个主题字后,整个事件的结果就注定会惹上不该惹的管理者;也注定会遇到“火中取栗”的炒作难堪局面。”——大博哥对《用身体换旅行》事件的评价。木木哥认为去介绍这个软件你们肯

转载 用友软件研发支出财务分析 研发支出加计扣除

原文地址:用友软件研发支出财务分析作者:51kuaiji用友软件研发支出财务分析在传统的财务分析和会计报表披露将研发支出进行了很细线条的披露。特别是研发支出在我国的会计处理中对大多数进行了费用化的处理,在上市公司的相关年报中披

声明:《Android | 统计分析 | 开发者中心 | 友盟 友盟统计分析sdk集成》为网友男总统分享!如侵犯到您的合法权益请联系我们删除