android应用统计获取api,APICloud

统计云API

接口验证KEY生成规则说明：

生成规则

当调用 APICloud 统计相关接口时，我们需要对头部信息中X-APICloud-AppKey 进行验证，X-APICloud-AppKey 的生成规则如下：

var appKey = SHA1(应用ID + 'UZ' + 应用KEY +'UZ' + 当前时间毫秒数)+ '.' +当前时间毫秒数

例如：你的应用ID是A6968565094002，而你的应用KEY是62FB16B2-0ED6-B460-1F60-EB61954C823B，则你在请求头部信息X-APICloud-AppKey中设置的值应为

'A6968565094002'+'UZ'+'62FB16B2-0ED6-B460-1F60-EB61954C823B'+'UZ'+当前时间戳组合字符串后通过SHA1加密后返回字符串再加上’.当前时间毫秒数’。

示例代码如下：

var now = Date.now();

varappKey = sha1("A6968565094002"+"UZ"+ "62FB16B2-0ED6-B460-1F60-EB61954C823B"+"UZ"+now)+"."+now;

接口名称：应用统计信息获取接口

接口说明

该接口主要用于获取用户指定应用ID及时间范围内的相关应用统计数据信息。

调用地址

调用方法

getAppStatisticDataById

请求方式

POST

请求头部设置说明

相关接口调用需要在发送的请求头部设置相关应用ID及应用KEY。相关请求头部设置定义如下：

X-APICloud-AppId : {your app id}

X-APICloud-AppKey : {you app key}

接口接收参数

startDate – 开始时间 格式：YYYY-MM-DD 例如：2014-10-10

endDate – 结束时间 格式：YYYY-MM-DD

接口返回数据

调用成功则返回相关应用统计数据信息，失败则返回错误信息，相关数据信息均以JSON数据格式返回。

接口返回状态(st) ： 1－成功 0－失败

接口返回信息(msg)：－成功为相关应用统计数据信息，失败则为错误信息。

返回数据示例

返回字段说明

字段名称

字段说明

id

数据ID

appid

应用ID

devicesCount

设备总数

newRegsCount

当天新注册用户数

newUpdateCount

当天新升级用户数

activeCountInToday

当天活跃用户数

activeCountInSevenDays

七日内活跃用户数

activeCountInThirtyDays

三十日内活跃用户数

totalUseTime

应用累计使用时长

totalOperationCount

应用累计使用次数

reportDate

统计数据生成时间

接口名称：应用各版本统计信息获取接口

接口说明

该接口主要用于获取用户指定应用ID及时间范围内相关应用各版本的统计数据信息。

调用地址

调用方法

getVersionsStatisticDataById

请求方式

POST

请求头部设置说明

相关接口调用需要在发送的请求头部设置相关应用ID及应用KEY。相关请求头部设置定义如下：

X-APICloud-AppId : {your app id}

X-APICloud-AppKey : {you app key}

接口接收参数

startDate – 开始时间 格式：YYYY-MM-DD 例如：2014-10-10

endDate – 结束时间 格式：YYYY-MM-DD

接口返回数据

调用成功则返回相关应用各版本统计数据信息，失败则返回错误信息，相关数据信息均以JSON数据格式返回。

接口返回状态(st) ： 1－成功 0－失败

接口返回信息(msg)：－成功为相关应用各版本统计数据信息，失败则为错误信息。

返回数据示例

返回字段说明

字段名称

字段说明

id

数据ID

appid

应用ID

versionCode

应用版本号

devicesCount

该版本下设备总数

newRegsCount

该版本下当天新注册用户数

newUpdateCount

该版本下当天新升级用户数

activeCountInToday

该版本下当天活跃用户数

totalUseTime

该版本下应用累计使用时长

totalOperationCount

该版本下应用累计使用次数

reportDate

统计数据生成时间

接口名称：应用地理分布统计信息获取接口

接口说明

该接口主要用于获取用户指定应用ID及时间范围内的应用下各版本地理分布统计数据信息。

调用地址

调用方法

getGeoStatisticDataById

请求方式

POST

请求头部设置说明

相关接口调用需要在发送的请求头部设置相关应用ID及应用KEY。相关请求头部设置定义如下：

X-APICloud-AppId : {your app id}

X-APICloud-AppKey : {you app key}

接口接收参数

startDate – 开始时间 格式：YYYY-MM-DD 例如：2014-10-10

endDate – 结束时间 格式：YYYY-MM-DD

versionCode – 版本

接口返回数据

调用成功则返回相关应用各版本地理分布统计数据信息，失败则返回错误信息，相关数据信息均以JSON数据格式返回。

接口返回状态(st) ： 1－成功 0－失败

接口返回信息(msg)：－成功为相关应用地理分布统计数据信息，失败则为错误信息。

返回数据示例

返回字段说明

字段名称

字段说明

id

数据ID

appid

应用ID

versionCode

版本号

geoNewRegsResult

该版本下新增用户地理分布JSON数据集合

geoDevicesCountResult

该版本下全部用户地理分布JSON数据集合

geoStartupCountResult

该版本下全部启动次数地理分布JSON数据集合

geoActiveCountResult

该版本下全部活跃用户地理分布JSON数据集合

reportDate

统计数据生成时间

特别说明

geoNewRegsResult、geoDevicesCountResult、geoStartupCountResult、geoActiveCountResult相关数据均为JSON格式数据集合，单个数据对象由city及count属性构成，其中city为城市名城而count 则为对应省份(或城市)相关统计数据信息。

接口名称：应用设备分布统计信息获取接口

接口说明

该接口主要用于获取用户指定应用ID及时间范围内的应用下各版本设备信息分布统计数据信息。

调用地址

调用方法

getDeviceStatisticDataById

请求方式

POST

请求头部设置说明

相关接口调用需要在发送的请求头部设置相关应用ID及应用KEY。相关请求头部设置定义如下：

X-APICloud-AppId : {your app id}

X-APICloud-AppKey : {you app key}

接口接收参数

startDate – 开始时间 格式：YYYY-MM-DD 例如：2014-10-10

endDate – 结束时间 格式：YYYY-MM-DD

接口返回数据

调用成功则返回相关应用各版本设备分布统计数据信息，失败则返回错误信息，相关数据信息均以JSON数据格式返回。

接口返回状态(st) ： 1－成功 0－失败

接口返回信息(msg)：－成功为相关应用各版本设备分布统计数据信息，失败则为错误信息。

返回数据示例

返回字段说明

字段名称

字段说明

id

数据ID

appid

应用ID

versionCode

版本号

modelNewRegsResult

当前版本下按型号区分新增用户数(JSON数据集合)

resolutionNewRegsResult

当前版本下按分辨率区分新增用户数(JSON数据集合)

osNewRegsResult

当前版本下按手机操作系统区分新增用户数(JSON数据集合)

connTypeResult

当前版本下按手机联网方式区分连接次数数据(JSON数据集合)

modelNewActiveResult

当前版本下按型号区分活跃用户数(JSON数据集合)

resolutionNewActiveResult

当前版本下按分辨率区分活跃用户数(JSON数据集合)

osNewActiveResult

当前版本下按手机操作系统区分活跃用户数(JSON数据集合)

modelTotalResult

当前版本下按型号区分用户总数(JSON数据集合)

resolutionTotalResult

当前版本下按分辨率区分用户总数(JSON数据集合)

osTotalResult

当前版本下按手机操作系统区分用户总数(JSON数据集合)

connTypeTotalResult

当前版本下按手机联网方式区分连接总次数数据(JSON数据集合)

reportDate

统计数据生成时间

特别说明

modelNewRegsResult、resolutionNewRegsResult、osNewRegsResult、connTypeResult、modelNewActiveResult、resolutionNewActiveResult、osNewActiveResult、modelTotalResult、resolutionTotalResult、osTotalResult、connTypeTotalResult相关数据均为JSON格式数据集合，相关集合集合内各数据对象定义详见下表：

数据集合名称

数据对象属性

属性说明

modelNewRegsResult、modelNewActiveResult、modelTotalResult

model、count

model – 手机型号、count – 统计数据

resolutionNewRegsResult、resolutionNewActiveResult、resolutionTotalResult

resolution、count

resolution – 分辨率、count – 统计数据

osNewRegsResult、osNewActiveResult、osTotalResult

os、count

os – 手机操作系统、count – 统计数据

connTypeResult、connTypeTotalResult

connType、count

connType – 联网方式 、count – 统计数据

接口名称：应用异常错误统计信息获取接口

接口说明

该接口主要用于获取用户指定应用ID及时间范围内的应用下各版本异常错误统计数据信息。

调用地址

调用方法

getExceptionsStatisticDataById

请求方式

POST

请求头部设置说明

相关接口调用需要在发送的请求头部设置相关应用ID及应用KEY。相关请求头部设置定义如下：

X-APICloud-AppId : {your app id}

X-APICloud-AppKey : {you app key}

接口接收参数

startDate – 开始时间 格式：YYYY-MM-DD 例如：2014-10-10

endDate – 结束时间 格式：YYYY-MM-DD

接口返回数据

调用成功则返回相关应用各版本异常统计数据信息，失败则返回错误信息，相关数据信息均以JSON数据格式返回。

接口返回状态(st) ： 1－成功 0－失败

接口返回信息(msg)：－成功为相关应用各版本异常统计数据信息，失败则为错误信息。

返回数据示例

返回字段说明

字段名称

字段说明

id

数据ID

appid

应用ID

versionCode

版本号

model

异常信息涉及机型

systemVersion

异常信息系统版本

excepTitle

异常摘要

excepCount

异常发生数量

reportDate

统计数据生成时间

接口名称：应用异常错误详细信息获取接口

接口说明

该接口主要用于根据应用异常错误摘要获取异常错误详细信息。

调用地址

调用方法

getExceptionsDetailByTitle

请求方式

POST

请求头部设置说明

相关接口调用需要在发送的请求头部设置相关应用ID及应用KEY。相关请求头部设置定义如下：

X-APICloud-AppId : {your app id}

X-APICloud-AppKey : {you app key}

接口接收参数

title – 错误摘要信息

接口返回数据

调用成功则返回指定异常错误摘要的详细信息，失败则返回错误信息，相关数据信息均以JSON数据格式返回。

接口返回状态(st) ： 1－成功 0－失败

接口返回信息(msg)：－成功为指定异常错误摘要的详细信息，失败则为错误信息。

返回数据示例

返回字段说明

字段名称

字段说明

content

异常错误具体信息