基础配置
SDK提供相关API,用于支持个性化设置,如渠道,crash收集,调试支持,日志发送策略等。
建议在调用 StatService.start(Context context)
前调用。
api列表
appKey
设置appKey,可以通过如下java代码设置和获取;建议通过manifest.xml配置
// 设置appKey
StatService.setAppKey(String appKey);
// 获取appKey
StatService.getAppKey(Context context);
channelId
设置渠道,可以通过如下java代码设置和获取;建议通过manifest.xml配置
备注:历史apisetAppChannel(String appChannel)
已经废弃,请使用下面新api进行渠道设置。
@param context 可以是application context
@param appChannel 渠道值,数值自定义,不同渠道自己能区分即可,例如"baidu market"
@param saveChannelWithCode 设置为true,保存设置
StatService.setAppChannel(Context context, String appChannel, boolean saveChannelWithCode) ;
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
@param context 可以是application context
@param flag crash标识
StatService.setOn(Context context, int flag);
日志延时发送
设置启动后日志发送延时时间
默认值
0
,启动时刻立即load数据发送日志
@param seconds 延时时长,单位:s
StatService.setLogSenderDelayed(int seconds);
session时长
设置应用进入后台再回到前台为同一次启动的最大间隔时间,有效值范围0~600s,例如设置值30s,则应用进入后台后,30s内唤醒为同一次启动
默认值 30s
启动次数定义:顾名思义,启动次数就是在规定时间段内,用户打开应用的次数。“一次启动”是指用户从打开APP开始,到退出APP(或离开应用界面,进入后台)为止。一次启动过程中可能浏览多个页面。
启动次数技术判定:如果同一个用户在退出APP或离开应用界面进入后台,又在30秒之内再次启动应用,则两次启动算作一次。反之,如果用户在30秒之后再次启动应用,则启动次数算作两次。在百度移动统计SDK3.1版本以上中,开发者都可以对“30秒”这个业界标准根据应用自身情况进行调整设定。
@param seconds 延时时长,单位:s
StatService.setSessionTimeOut(int seconds);
调试开关
设置是否打印SDK中的日志,用于调试
默认关闭;正式版本中,为避免影响APP性能,请关闭调试。
@param debug true,打开;false,关闭
StatService.setDebugOn(boolean debug);
mac id获取
设置是否采集mac地址,该接口仅对android 6 及以上版本生效。默认情况下采集macid。Macid有助于更精准的用户标识,优化报表展现。如您APP有国外发版需求,可以调用接口关闭macid获取。
如果开发者需要在google play发布,考虑到审核风险,可以调用该接口,设置为 false则不采集mac地址;设置为false后,后续新版本如果需要采集,则需要在新版本显式调用,设置为true。
@param context 可以是application context
@param debug true,打开;false,关闭
StatService.enableDeviceMac(Context context, boolean enable);
电视统计
电视统计,计算设备id的方式不同,因此需要单独打开开关
默认是标准统计,适用于手机、平板等设备;如果是电视盒子上的APP,请调用此api打开。
StatService.setForTv(Context context, boolean value) ;
自定义帐号上传
3.9.0.0
版本开始,SDK支持自定义帐号上传功能。开发者上传自定义帐号后,可以在百度移动统计WEB端开启用户自定义分群
功能。
设置用户id。设置后会在保存在本地,如果需要清除设置,传入null
@param context
@param userId 开发者设置的用户id
StatService.setUserId(Context context, String userId);
推送ID上传
3.9.1.0
版本开始,SDK支持推送ID上传功能。开发者上传推送平台ID后,可以在百度移动统计筛选特定用户群导出推送ID列表。
设置推送平台id。设置后会在保存在本地,如果需要清除设置,传入null
@param context
@param platform 推送平台
@param pushId 客户端获取的对应推送平台的推送ID
StatService.setPushId(Context context, MtjConfig.PushPlatform platform, String pushId);
自定义用户属性
3.9.5.7
版本开始,SDK支持自定义用户属性上传功能。
设置自定义map属性。设置后会在保存在本地,如果需要清除设置,传入null
@param context
@param map 开发者设置的自定义参数
StatService.setUserProperty(Context context, Map<String, String> map);
browseMode
根据四部委最新颁布的《常见类型移动互联网应用程序必要个人信息范围规定》(简称《规定》,下同),App不得因为用户不同意提供非必要个人信息,而拒绝用户使用其基本功能服务,并规定了各类型产品必要信息范围。详细规定请见 http://www.cac.gov.cn/2021-03/22/c_1617990997054277.htm 对于《规定》中规定用户无需提供个人信息即可使用基本服务的App,需提供"浏览模式",用户在不提供个人信息的条件下,也可使用基本服务。 因此,百度移动统计提供浏览模式接口。当用户开启"浏览模式"使用你的app时,可调用SDK的该接口设置为“浏览模式”,移动统计sdk将不会采集相关部分用户信息,同时通过埋点、自动埋点记录的用户行为也将不会采集。用户关闭"浏览模式"时,需要调用SDK接口,关闭浏览模式,用户的相关数据才能正常采集。
设置app是否为仅浏览模式,该模式下所有行为打点采集无效,包括手动埋点与全埋点数据。默认值
false
// 建议在start之前调用(全埋点版本在autoTrace接口之前调用),设置是否为浏览模式
StatService.browseMode(boolean mode);