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、向工程中导入追踪SDK1) 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个字符内,支持中文、英文、数字、空格、英文点和下划线,请勿使用其他符号。用户的渠道归属:每台设备仅记录给首次安装激活的渠道,同一用户在更替渠道包使用后不会重复计算新增,使用数据归入首次激活渠道。如果未添加渠道标记,或渠道标记是示例代码中的默认值,用户将会归入为“未知渠道”。我们提供多渠道打包工具以帮助您快速生成多个不同渠道包,支持V1.2.74版本及以上。该工具修改的渠道ID会优先于手动修改的渠道ID被读取。 详见:http://www.talkingdata.com/activity/packTool-Explain/index.html3、使用自定义事件自定义事件用于统计任何您期望去跟踪的数据,如:用户点击某功能按钮、填写某个输入框、触发了某个广告等。我们提供两种使用方法:1、直接在报表后台中设定追踪点并自动部署追踪代码的“灵动事件”;2、在App中以触发代码方式追踪数据的“集成事件”。3.1. 灵动事件灵动事件支持App界面中的按钮、输入框、单选和多选控件、图片按钮的点击动作自动计数。您不需要书写额外的触发代码,在报表平台中通过动态添加,SDK会自动部署追踪码。在数据报表的以下位置来动态管理全部“灵动事件”:[登录平台] - [选择应用,进入报表] �C 左菜单进入[事件和转化] �C 进入[灵动事件]注意:使用灵动事件,需使用 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。


该文章转自OSChina


你可能感兴趣的:(android,广告,移动应用,产品,识别码)