Android灵动分析入门指南

TalkingData 发布于 2015/10/21 17:37
阅读 1K+
收藏 1

Android灵动分析入门指南

添加应用

登录TalkingData官网后,在产品中心里,点击创建新应用,填写应用的基本信息,获取应用的唯一识别码App ID。
下载各个平台的SDK,下载完SDK,参照各个平台的开发指南进行具体的操作。

Android SDK下载/开发指南

一、综述

1、适用范围

TalkingData Analytics为移动应用提供数据统计分析服务,通过在应用中加入数据SDK,来在 www.talkingdata.com 网站中查阅应用的相关数据。
统计SDK适用于 Android 1.6(API Level 4)及以上的设备。

2. 统计标准

数据系统中的基本数据单元依据以下标准定义:

  • 新增用户
    TalkingData数据系统中的“用户”指用户的一台唯一设备。
  • 用户的一次使用
    指用户从打开应用的界面至离开界面的完整过程。如用户在离开界面后30秒内重新回到应用中,将被认为是上次使用被打扰后的延续,记为一次完整使用。
  • 页面
    指Android应用的每个Activity。
  • 自定义事件
    指用户在应用中进行了特定的操作或达成了特定的条件。例如:用户点击了广告栏、用户进行付费等。 自定义事件用于收集任意您期望跟踪的数据。


二、 接入数据系统

1、为应用申请App ID

在TalkingData网站中创建一款应用,您将获得一串32位的16进制App ID,用于唯一标识您的一款应用。TalkingData支持跨平台的应用,跨平台应用只需获得一个App ID即可。

2、向工程中导入追踪SDK

  • 1) Eclipse ADT
    下载数据统计SDK后解压至本地目录,将其中的TalkingdataAnalytics.jar 拷贝到工程的libs文件夹下。(如需使用灵动分析功能,请使用v2.0.X Beta及以上版本SDK)
  • 2) Android Studio

• 在 Android Studio 项目的 app 目录下新建 libs 目录。

• 将 TalkingdataAnalytics.jar 拷贝到上面新建的 libs 目录下。

• 在 app 目录下的 build.gradle 文件中的 dependencies 依赖项。

2、配置ANDROIDMANIFEST.XML文件

附注:已创建完成的应用,可进入该应用的数据报表页中,在“系统设置”-“编辑应用”页面里能随时查看到获得的App ID。

4、添加SDK初始化代码(重要)

TalkingData Analytics的SDK提供两种初始化的方法:

  • 1) 开发者可以通过com.tendcloud.tenddata.TCAgent.init方法手工传入AppId 。

  • 2) 开发者在AndroidManifest里的meta-data里配置AppId和ChannelId。

注意1:为了保证统计到的数据更加的全面,强烈建议不论哪种init 方式,都要在Application的onCreate里调用(不论您的程序是否有后台service还是多进程),如果您的程序里没有自定义的application类,请添加!

注意2:初始化是使SDK开始工作的关键,不进行初始化就对其他接口进行调用,会有引发程序崩溃的严重危险。请开发者一定注意。

5、代码混淆

请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上-keep public class com.tendcloud.tenddata.** { public protected *;}使得混淆的时候不会影响统计SDK的命名空间。

6、添加必须的调用方法(重要)

使用数据统计系统需要至少添加以下调用方法,这些调用用于准确跟踪用户每次的应用使用,是准确统计启动、活跃、留存数据的基础:

• 在需要调用SDK方法的类中导入com.tendcloud.tenddata.TCAgent类;

• 在应用的每个Activity的onResume方法里调用TCAgent.onResume(Activity context),传入的参数为当前Activity实例,用于统计基础数据。

•在应用的每个Activity中的onPause方法里调用TCAgent.onPause(Activity context),传入的参数为当前的Activity实例,用于统计基础数据。

注意1:确保在每个activity中都调用了以上方法,否则可能造成应用的使用时长数据错误。


三、更多高级功能

1、跟踪自定义的页面

用法说明

要统计应用内的页面访问数据,需要在每一个要跟踪的页面进入和离开的位置调用onPageStart和onPageEnd。需要注意的是,页面应该是一个接着一个的,不能嵌套调用;进入新页面,必须离开旧页面,否则可能导致页面统计数据异常。

调用方法

在进入页面的时候加入如下的代码调用:

其中pageName为自定义的页面名称,最大支持10个中英文字符。

在离开页面的时候加入如下的代码调用:

其中pageName为自定义的页面名称,需要和onPageStart中传入的一致;并且onPageStart和onPageEnd必须成对调用。


2、区分渠道查阅数据

给应用的安装包打入特殊的渠道标记,用户安装使用渠道包后,您可以在报表中区分来源单独查询出数据。在您为应用商店、下载站等分发渠道提供应用安装包时可以加入渠道标记,在进行特别的活动时亦可加入渠道标记来单独分析效果。

在AndroidManifest.xml里添加meta-data段,用您定义的渠道名替换value中的“Your_channel_id”

  • 渠道名可自行定义,格式:32个字符内,支持中文、英文、数字、空格、英文点和下划线,请勿使用其他符号。
  • 用户的渠道归属:每台设备仅记录给首次安装激活的渠道,同一用户在更替渠道包使用后不会重复计算新增,使用数据归入首次激活渠道。
  • 如果未添加渠道标记,或渠道标记是示例代码中的默认值,用户将会归入为“未知渠道”。




3、使用自定义事件

自定义事件用于统计任何您期望去跟踪的数据,如:用户点击某功能按钮、填写某个输入框、触发了某个广告等。

我们提供两种使用方法:1、直接在报表后台中设定追踪点并自动部署追踪代码的“灵动事件”;2、在App中以触发代码方式追踪数据的“集成事件”。


3.1. 灵动事件

灵动事件支持App界面中的按钮、输入框、单选和多选控件、图片按钮的点击动作自动计数。您不需要书写额外的触发代码,在报表平台中通过动态添加,SDK会自动部署追踪码。

在数据报表的以下位置来动态管理全部“灵动事件”:

[登录平台] - [选择应用,进入报表] – 左菜单进入[事件和转化] – 进入[灵动事件]

注意:使用灵动事件,需使用 v2.0.X Beta 以上版本的SDK。


3.2. 集成事件

用法说明

在App中手工添加触发代码方式来记录自定义的数据追踪点;

集成事件除了记录行为,还支持添加一些描述行为的参数,使用多对Key-Value的方式来进行发送(非必须使用),用来对事件发生时的状况做详尽分析。

Event ID无需提前在数据平台中定义,可自行定义名称,直接加入到应用中需要跟踪的位置即可生效。

格式:32个字符以内的中文、英文、数字、下划线,注意eventId中不要加空格或其他的转义字符。

TalkingData最多支持10000个不同的Event ID。 如果您要跟踪更多的事件,我们提供了Label参数的用法,可以给多个要跟踪的同类型或类似的事件使用相同的Event ID,通过给他们分配不同Label来达到区分跟踪多个事件的目的。这可理解为Event ID成为了多个事件的目录,EventID+Label形成了一个具体事件。请对事件做好分类,这也对您管理和查阅事件数据有利。

调用方法

在应用程序要跟踪的事件处加入下面格式的代码,也就成功的添加了一个简单事件到您的应用程序中了:

 跟踪多个同类型事件,无需定义多个Event ID,可以使用Event ID做为目录名,而使用Label标签来区分这些事件,可按照下面格式添加代码:

 为事件添加详尽的描述信息,可以更有效的对事件触发的条件和场景做分析,可按照下面格式添加代码:


注: 此Map的Value仅支持字符串(String)和数字(Number)类型,其他类型会自动调用toString()方法转换为String进行处理。在Value使用String格式时,报表中将给出事件发生时每种value出现的频次;Value为Number时,报表将帮助计算value值的总计值和平均数。

如果所有事件都需要传输相同的参数,可以设置全局的Key-Value,这些Key-Value会自动添加到所有自定义事件:

如果要移除全局Key-Value,则可以调用:

注: 如果onEvent里传入的Key-Value里的key和全局Key-Value里的key冲突,以onEvent里传入的为准。


示例1:

跟踪某电商应用中首页的5个不同推广位置的点击次数,并收集宣传品的品类、促销价格等信息:

注1:这里追踪的事件属于同类型,使用了Label标签的用法。以相同Event ID来作为统一名称,Label来确定不同位置。这样查阅Event ID数据即可了解全部推广位总量点击数据,展开Label可查阅具体某位置数据。

注2:在value取值较离散情况下(如示例中收集的促销价格信息),不要直接填充具体数值,而应划分区间后传入(如9.9元,可定义5~10元的价格区间,传入5~10元),否则value不同取值很可能超过平台最大数目限制,离散数据也对分析人员阅览数据造成影响。

示例2:

在一款休闲游戏中记录玩家在各关卡中的失败数据,并收集玩家具体信息。


4、收集应用错误日志

收集应用的错误日志可帮助您来修正BUG、改善产品。报表中,我们除了提供错误次数的数据外,还提供错误的详细信息阅览,并会对错误进行合理分类。 您可通过两种方式来获取错误日志:让TalkingData SDK自动捕获异常、或您主动传送错误信息给SDK。

SDK自动获取异常信息

为了简化开发者的工作,我们提供自动获取异常信息的功能,但衡量异常信息收集会损耗最终用户流量,因此自动捕获默认为关闭状态。

可向以下方法中传入true(开启自动捕获)或false(关闭自动捕获),来控制自动捕获功能的开关:

很多错误发生在应用刚启动时,自动异常捕获依赖于数据SDK已开始工作,如果您期望捕获更全面的异常信息,请在程序最先启动处加入以下代码,以使数据SDK更早开始工作,收集异常。

 主动传送异常信息

您也可主动调用以下方法将抛出的exception信息传入至方法中的第二个参数中(主动捕获关闭状态下依然有效):



四、重点问题解答

问题1:如何确定我的集成是正确的?

解答:集成后请进行必要的真机测试,登录统计后台查阅数据,数据已有体现后才说明集成正确。测试中请务必注意:

确保AndroidManifest.xml里的参数和必要的权限已正确添加,检查INTERNET, ACCESS_NETWORK_STATE, READ_PHONE_STATE,WIFI这些权限已添加;

确保App ID添加正确,没有输入多余的空格等难发现的字符;

确保每个Activity中的对onResume和onPause方法进行了正确调用;

测试渠道包数据,确保Channel ID添加正确,并确认该设备没有被计入其他的渠道中。

应用安装于设备后需要打开应用才可记录数据,测试过程确保您的设备网络连接正常。

通过检查logcat里输出的TAG为TalkingData的日志信息可帮助判定问题:

TalkingData Analytics SDK会在初始化时会输出类似下边的日志,其中会显示SDK检测到的APP_ID和CHANNEL_ID:
例如:

当SDK成功向服务器传输数据时,会有类似下边的日志输出:

例如:


问题2: 如何避免混淆对统计SDK的影响?

解答:有些开发者对打了统计SDK的程序进行混淆时,有可能会覆盖某些java类,导致统计SDK无法正常工作,解决方法如下:

请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最后加上-keep public class com.tendcloud.tenddata.** { public protected *;}使得混淆的时候不会影响统计SDK的命名空间。

问题3: 打入数据SDK的应用,混淆后导出APK时报Warning而导出失败?

解答:有一些字段或API引用只支持Android 2.3或以上版本的类库,就会导致引用Android较低的版本在导出apk时发生Warning的错误,解决方法如下:

请开发者在混淆配置文件proguard.cfg或proguard-project.txt的最上方加上-dontwarn com.tendcloud.tenddata.**。

问题4: 打入SDK的应用,运行时会在Logcat里有Tag为TDLog的日志,如何关闭?

解答:这些日志是用于帮助应用开发者检查是否正确集成了TalkingData的SDK。如果应用开发者希望关掉这些日志,可以在应用启动的时候(并且在SDK初始化之前),将日志开关设为false:

加载中
返回顶部
顶部