开发者社区 问答 正文

如何推送去重设备统计?



QueryUniqueDeviceStat



描述


推送去重设备统计(去重设备统计是以月为周期计数,每个月月初都会清零重新计数,目前只支持返回天的数据,天维度最多支持查31天内数据)。

请求参数

名称类型是否必须描述
ActionString操作接口名称,取值:QueryUniqueDeviceStat
AppKeyLongAppKey信息
StartTimeString查询的起始时间, ISO-8601格式, 格式为 YYYY-MM-DDThh:mm:ssZ
EndTimeString查询的结束时间, ISO-8601格式, 格式为 YYYY-MM-DDThh:mm:ssZ(目前只有按天查询,查询范围不能超过31天)


响应参数

名称类型描述
AppDeviceStatsAppDeviceStatType设备统计数据AppDeviceStat组成的数组


错误码



请求示例

  1. [backcolor=transparent]http[backcolor=transparent]:[backcolor=transparent]//cloudpush.aliyuncs.com/?Action=QueryUniqueDeviceStat
  2. [backcolor=transparent]&[backcolor=transparent]AppKey[backcolor=transparent]=[backcolor=transparent]1234567
  3. [backcolor=transparent]&[backcolor=transparent]StartTime[backcolor=transparent]=[backcolor=transparent]2016[backcolor=transparent]-[backcolor=transparent]08[backcolor=transparent]-[backcolor=transparent]25T00[backcolor=transparent]:[backcolor=transparent]00[backcolor=transparent]:[backcolor=transparent]00Z
  4. [backcolor=transparent]&[backcolor=transparent]EndTime[backcolor=transparent]=[backcolor=transparent]2016[backcolor=transparent]-[backcolor=transparent]08[backcolor=transparent]-[backcolor=transparent]26T00[backcolor=transparent]:[backcolor=transparent]00[backcolor=transparent]:[backcolor=transparent]00Z
  5. [backcolor=transparent]&<公共请求参数>


返回示例



XML格式

  1. [backcolor=transparent]<?[backcolor=transparent]xml version[backcolor=transparent]=[backcolor=transparent]'1.0'[backcolor=transparent] encoding[backcolor=transparent]=[backcolor=transparent]'UTF-8'[backcolor=transparent]?>
  2. [backcolor=transparent]<QueryUniqueDeviceStatResponse>
  3. [backcolor=transparent]    [backcolor=transparent]<RequestId>[backcolor=transparent]9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC[backcolor=transparent]</RequestId>
  4. [backcolor=transparent]    [backcolor=transparent]<AppDeviceStats>
  5. [backcolor=transparent]      [backcolor=transparent]<AppDeviceStat>
  6. [backcolor=transparent]        [backcolor=transparent]<Time>[backcolor=transparent]2016-08-25T00:00:00Z[backcolor=transparent]</Time>
  7. [backcolor=transparent]        [backcolor=transparent]<Count>[backcolor=transparent]100000[backcolor=transparent]</Count>
  8. [backcolor=transparent]      [backcolor=transparent]</AppDeviceStat>
  9. [backcolor=transparent]      [backcolor=transparent]<AppDeviceStat>
  10. [backcolor=transparent]        [backcolor=transparent]<Time>[backcolor=transparent]2016-08-26T00:00:00Z[backcolor=transparent]</Time>
  11. [backcolor=transparent]        [backcolor=transparent]<Count>[backcolor=transparent]200000[backcolor=transparent]</Count>
  12. [backcolor=transparent]      [backcolor=transparent]</AppDeviceStat>
  13. [backcolor=transparent]    [backcolor=transparent]</AppDeviceStats>
  14. [backcolor=transparent]</QueryUniqueDeviceStatResponse>


JSON格式

  1. [backcolor=transparent]{
  2. [backcolor=transparent]  [backcolor=transparent]"RequestId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC"[backcolor=transparent],
  3. [backcolor=transparent]  [backcolor=transparent]"AppDeviceStats"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent][
  4. [backcolor=transparent]    [backcolor=transparent]{
  5. [backcolor=transparent]      [backcolor=transparent]"Time"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"2016-08-25T00:00:00Z"[backcolor=transparent],
  6. [backcolor=transparent]      [backcolor=transparent]"Count"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]100000
  7. [backcolor=transparent]    [backcolor=transparent]},
  8. [backcolor=transparent]    [backcolor=transparent]{
  9. [backcolor=transparent]      [backcolor=transparent]"Time"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"2016-08-26T00:00:00Z"[backcolor=transparent],
  10. [backcolor=transparent]      [backcolor=transparent]"Count"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]200000
  11. [backcolor=transparent]    [backcolor=transparent]}
  12. [backcolor=transparent]  [backcolor=transparent]]
  13. [backcolor=transparent]}

展开
收起
猫饭先生 2017-10-23 10:16:03 1279 分享 版权
阿里云 AI 助理回答

推送去重设备统计操作指南

任务描述

查询应用维度的去重设备统计信息,以便了解在指定时间段内应用的唯一活跃设备数量。去重设备统计以月为周期计数,每月1日清零重新开始计数,当前接口仅支持获取天级别的数据,且查询范围限制在31天内。

操作步骤

  1. 构造请求参数

    • Action: 必填,操作接口名称,固定值QueryUniqueDeviceStat
    • AppKey: 必填,您的AppKey信息,类型为长整型数字,例如:23267207
    • StartTime: 必填,查询起始时间,需遵循ISO-8601格式,如2016-07-25T00:00:00Z
    • EndTime: 必填,查询结束时间,格式同上,注意查询范围不超过31天,例如:2016-07-26T00:00:00Z
  2. 发起API调用

    • 您可以通过OpenAPI Explorer直接运行此接口进行调试,无需手动计算签名,该工具还会自动生成SDK代码示例供您参考。
  3. 解析响应结果

    • 成功响应将包含一个名为AppDeviceStats的数组,其中每个元素AppDeviceStat代表一天或一月的设备统计数据,包括:
      • Count: 去重设备数。
      • Time: 统计的时间片,格式为ISO-8601日期时间。
      • RequestId: 请求ID,用于问题追踪。

注意事项

  • 确保StartTimeEndTime的日期格式正确,并且时间跨度不超过31天。
  • 记得每个月初设备统计会清零,因此跨月查询时需考虑这一特性。
  • 调用API前,请确保已具备mpush:QueryUniqueDeviceStat的读取权限。

示例请求结构

http://cloudpush.aliyuncs.com/
?Action=QueryUniqueDeviceStat
&AppKey=23267207
&StartTime=2016-07-25T00:00:00Z
&EndTime=2016-07-26T00:00:00Z

通过上述步骤,您可以有效查询并获取到指定时间段内应用的去重设备统计信息。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
问答分类:
问答地址: