全部产品
云市场

设备新增与留存

更新时间:2018-03-22 19:07:53

QueryDeviceStat

描述

查询App维度的设备统计。目前只支持返回天的数据,天维度最多支持查31天内数据。

请求参数

名称 类型 是否必须 描述
Action String 操作接口名称,取值:QueryDeviceStat
AppKey Long AppKey信息
StartTime String 查询的起始时间, ISO-8601格式, 格式为 YYYY-MM-DDThh:mm:ssZ
EndTime String 查询的结束时间, ISO-8601格式, 格式为 YYYY-MM-DDThh:mm:ssZ
DeviceType String 设备类型,取值范围为:
  • iOS:iOS设备
  • ANDROID:Andriod设备
  • ALL:全部类型设备
QueryType String 查询的是新增设备数还是历史累计设备数,NEW:是新增设备,TOTAL:是累计设备数

响应参数

名称 类型 描述
AppDeviceStats 复杂对象 设备统计数据AppDeviceStat组成的数组

错误码

错误代码 描述 HTTP 状态码 语义
InvalidPeriod.ExceedMonth The period between specified EndTime and StartTime exceeds 31 days. 400 查询的时间段超过了31天

示例

请求示例

  1. http://cloudpush.aliyuncs.com/?Action=QueryDeviceStat
  2. &AppKey=23267207
  3. &StartTime=2016-07-28T00:00:00Z
  4. &EndTime=2016-07-29T00:00:00Z
  5. &DeviceType=iOS
  6. &QueryType=NEW
  7. &<公共请求参数>

返回示例

XML格式

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <QueryDeviceStatResponse>
  3. <RequestId>9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC</RequestId>
  4. <AppDeviceStats>
  5. <AppDeviceStat>
  6. <Time>2016-07-28T00:00:00Z</Time>
  7. <Count>100</Count>
  8. <DeviceType>iOS</DeviceType>
  9. </AppDeviceStat>
  10. <AppDeviceStat>
  11. <Time>2016-07-29T00:00:00Z</Time>
  12. <Count>100</Count>
  13. <DeviceType>iOS</DeviceType>
  14. </AppDeviceStat>
  15. </AppDeviceStats>
  16. </QueryDeviceStatResponse>

JSON格式

  1. {
  2. "RequestId": "9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC",
  3. "AppDeviceStats": [
  4. {
  5. "Time": "2016-07-28T00:00:00Z",
  6. "Count": 100,
  7. "DeviceType": "New"
  8. },
  9. {
  10. "Time": "2016-07-29T00:00:00Z",
  11. "Count": 100,
  12. "DeviceType": "New"
  13. }
  14. ]
  15. }