关于SDK
Last updated
Was this helpful?
Last updated
Was this helpful?
灯塔SDK目前支持Android、iOS、H5、小程序4大平台的终端设备;接入SDK请参照,下载的资源包里面的灯塔SDK接入指南文档。
SDK的基础接入工作只需要简单的三个步骤:资源包的引入,APPKEY的配置,初始化接口的调用。正常情况下10分钟内即可完成接入,并看到启动上报的数据。具体可参见下载资源包里的SDK接入指南文档
Android SDK 全功能包大小为215KB,引入后apk实际增长113KB;基础功能包(事件测速)包大小为155KB,引入后apk实际增长84KB; iOS SDK 资源包合入app后,实际增长大小为0.54MB。
Android 内存占用:0.5-2.7MB; 流量消耗:首次初始化策略请求上报2.8-3.6K,触发一次事件上报,5条实时事件0.6K,20条普通事件2K。 iOS 内存占用:0.5-0.61MB; 流量消耗:10条实时事件:1K,50条普通事件:1.3K。
QIMEI是灯塔推出的终端ID精准识别体系,包含Android/iOS两类主流终端的识别。其主要思想为:SDK将各种ID采集上报,后台利用的ID关系库、山寨库和校准算法,实时生成/找回终端唯一ID并下发。
嵌入灯塔SDK之后,即可调用统一的QIMEI获取接口进行获取QIMEI。
灯塔SDK本地存储以及上报的数据均有加密和压缩,对称加解密密钥云端可配置,压缩方式云端可配,支持zip和gzip两种方式。
普通事件:普通事件会先存在内存中,累计12条或者等待1分钟写DB,在符合以下任意一条件的时候,会把db和内存所有事件上报:
DB中累计20条事件
熄屏&灭屏
热启动
网络状态切换
实时事件:每累计12条会上报,或者等待1分钟时间会进行上报,实时事件重试3次上报失败,变成普通事件同步DB。参数值SDK和云端均支持修改配置
会上报,上报规则为距上一次切到后台间隔1分钟以上才会记录上报,有频率控制。并且会当作热启动,纳入启动次数的统计。
SDK支持IP:Port和域名探测2种,获取TCP连接耗时和域名探测中的dns解析,TCP连接,请求发送,等待响应,接收返回数据5个阶段的耗时情况。
探测由SDK主动完成并上报,不需要app做额外的操作。
需要app按照接入指南文档中的说明,正确规范配置不同的渠道号标识,灯塔在上报时会采集渠道信息。
会记录。
Android平台是采集的AndroidManifest.xml配置文件中的versionName+ versionCode的值。
iOS平台是采集的XCode中设置的版本号。
Android,UserAction.getSDKVersion() 接口。
iOS,AnalyticsInterface getSDKVersion接口。
支持,在SDK初始化函数中,UserAction.initUserAction(Context context, boolean isUploadProcess) 通过第二个参数进行设置,true为上报进程,只需设置一个做为上报进程,其他的设置为false,当作记录进程。其他接口的使用上无区别。
SDK会记录本次启动到目前SDK自身的网络流量消耗,并且区分了wifi和非wifi的流量消耗,Android上可通过UserAction.getSDKTotalConsume(Context context, boolean onlyGPRS)接口获取,@param onlyGPRS true只统计GPRS流量,否则包括wifi。 SDK自身的流量消耗上限是10M/天(wifi下不限制流量),超过之后数据将不会进行上报。 app的网络流量消耗目前的版本还未进行记录统计。
还有疑问?欢迎反馈给tbeacon@tencent.com,会有专人为您服务。