Android SDK基础API配置
SDK提供相关API,用于支持个性化设置,如渠道,crash收集,调试支持,日志发送策略等。
建议在调用 StatService.start(Context context)前调用。
api列表
appKey
设置appKey,可以通过如下java代码设置和获取;建议通过manifest.xml配置// 设置appKey
StatService.setAppKey(StringappKey);
// 获取appKey
StatService.getAppKey(Contextcontext);
channelId
设置渠道,可以通过如下java代码设置和获取;建议通过manifest.xml配置
备注:历史apisetAppChannel(String appChannel)已经废弃,请使用下面新api进行渠道设置。@paramcontext可以是application context
@paramappChannel渠道值,数值自定义,不同渠道自己能区分即可,例如"baidu market"
@paramsaveChannelWithCode设置为true,保存设置StatService.setAppChannel(Contextcontext,StringappChannel,booleansaveChannelWithCode);
crash收集
设置打开Crash日志收集。
备注:sdk 支持收集 java crash 和 native crash(底层C/C++代码崩溃)。具体native crash 收集请参考错误统计。仅收集java crash,flag = StatService.JAVA_EXCEPTION_LOG
同时收集java 和 native crash,flag = StatService.EXCEPTION_LOG@paramcontext可以是application context
@paramflag crash标识StatService.setOn(Contextcontext,intflag);
日志延时发送
设置启动后日志发送延时时间默认值0,启动时刻立即load数据发送日志@paramseconds延时时长,单位:sStatService.setLogSenderDelayed(intseconds);
session时长
设置应用进入后台再回到前台为同一次启动的最大间隔时间,有效值范围0~600s,例如设置值30s,则应用进入后台后,30s内唤醒为同一次启动默认值 30s
启动次数定义:顾名思义,启动次数就是在规定时间段内,用户打开应用的次数。“一次启动”是指用户从打开APP开始,到退出APP(或离开应用界面,进入后台)为止。一次启动过程中可能浏览多个页面。
启动次数技术判定:如果同一个用户在退出APP或离开应用界面进入后台,又在30秒之内再次启动应用,则两次启动算作一次。反之,如果用户在30秒之后再次启动应用,则启动次数算作两次。在百度移动统计SDK3.1版本以上中,开发者都可以对“30秒”这个业界标准根据应用自身情况进行调整设定。@paramseconds延时时长,单位:sStatService.setSessionTimeOut(intseconds);
调试开关
设置是否打印SDK中的日志,用于调试默认关闭;正式版本中,为避免影响APP性能,请关闭调试。@paramdebugtrue,打开;false,关闭StatService.setDebugOn(booleandebug);
mac id获取
设置是否采集mac地址,该接口仅对android 6 及以上版本生效。默认情况下采集macid。Macid有助于更精准的用户标识,优化报表展现。如您APP有国外发版需求,可以调用接口关闭macid获取。如果开发者需要在google play发布,考虑到审核风险,可以调用该接口,设置为 false则不采集mac地址;设置为false后,后续新版本如果需要采集,则需要在新版本显式调用,设置为true。@paramcontext可以是application context
@paramdebugtrue,打开;false,关闭StatService.enableDeviceMac(Contextcontext,booleanenable);
电视统计
电视统计,计算设备id的方式不同,因此需要单独打开开关默认是标准统计,适用于手机、平板等设备;如果是电视盒子上的APP,请调用此api打开。StatService.setForTv(Contextcontext,booleanvalue);
自定义帐号上传
3.9.0.0版本开始,SDK支持自定义帐号上传功能。开发者上传自定义帐号后,可以在百度移动统计WEB端开启用户自定义分群功能。设置用户id。设置后会在保存在本地,如果需要清除设置,传入null@paramcontext
@paramuserId开发者设置的用户idStatService.setUserId(Contextcontext,StringuserId);
推送ID上传
3.9.1.0版本开始,SDK支持推送ID上传功能。开发者上传推送平台ID后,可以在百度移动统计筛选特定用户群导出推送ID列表。设置推送平台id。设置后会在保存在本地,如果需要清除设置,传入null@paramcontext
@paramplatform推送平台
@parampushId客户端获取的对应推送平台的推送IDStatService.setPushId(Contextcontext,MtjConfig.PushPlatformplatform,StringpushId);