开发者社区 问答 正文

任务维度推送统计如何实现?



QueryPushStat



描述


查询某一次推送的统计数据, 包含发送数,到达数,打开数,删除数。注意:消息是没有打开删除概念,只有通知才有,iOS通知没有删除统计。

请求参数

名称类型是否必须描述
ActionString操作接口名称,取值:QueryPushStat
AppKeyLongAppKey信息
MessageIdString推送的消息ID,推送之后会返回该ID


响应参数

名称类型描述
PushStatsPushStatType消息/通知的推送结果统计PushStatType组成的数组


错误码

错误码描述HTTP 状态码语义
StatWaitingThe requested data is processing.400请求的数据正在处理中


请求示例

  1. [backcolor=transparent]http[backcolor=transparent]:[backcolor=transparent]//cloudpush.aliyuncs.com/?Action=QueryPushStat
  2. [backcolor=transparent]&[backcolor=transparent]AppKey[backcolor=transparent]=[backcolor=transparent]1234567
  3. [backcolor=transparent]&[backcolor=transparent]MessageId[backcolor=transparent]=[backcolor=transparent]510427
  4. [backcolor=transparent]&<公共请求参数>


返回示例

  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]<QueryPushStatResponse>
  3. [backcolor=transparent]    [backcolor=transparent]<RequestId>[backcolor=transparent]9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC[backcolor=transparent]</RequestId>
  4. [backcolor=transparent]    [backcolor=transparent]<PushStats>
  5. [backcolor=transparent]      [backcolor=transparent]<PushStat>
  6. [backcolor=transparent]        [backcolor=transparent]<MessageId>[backcolor=transparent]510427[backcolor=transparent]</MessageId>
  7. [backcolor=transparent]        [backcolor=transparent]<SentCount>[backcolor=transparent]1000000[backcolor=transparent]</SentCount>
  8. [backcolor=transparent]        [backcolor=transparent]<ReceivedCount>[backcolor=transparent]999888[backcolor=transparent]</ReceivedCount>
  9. [backcolor=transparent]        [backcolor=transparent]<OpenedCount>[backcolor=transparent]599888[backcolor=transparent]</OpenedCount>
  10. [backcolor=transparent]        [backcolor=transparent]<DeletedCount>[backcolor=transparent]199888[backcolor=transparent]</DeletedCount>
  11. [backcolor=transparent]      [backcolor=transparent]</PushStat>
  12. [backcolor=transparent]    [backcolor=transparent]</PushStats>
  13. [backcolor=transparent]</QueryPushStatResponse>


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]"PushStats"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent][
  4. [backcolor=transparent]    [backcolor=transparent]{
  5. [backcolor=transparent]      [backcolor=transparent]"MessageId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"510427"[backcolor=transparent],
  6. [backcolor=transparent]      [backcolor=transparent]"SentCount"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]1000000[backcolor=transparent],
  7. [backcolor=transparent]      [backcolor=transparent]"ReceivedCount"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]999888[backcolor=transparent],
  8. [backcolor=transparent]      [backcolor=transparent]"OpenedCount"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]599888[backcolor=transparent],
  9. [backcolor=transparent]      [backcolor=transparent]"DeletedCount"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]199888
  10. [backcolor=transparent]    [backcolor=transparent]}
  11. [backcolor=transparent]  [backcolor=transparent]]
  12. [backcolor=transparent]}

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

要查询某一次推送的统计数据,包括发送数、到达数、打开数和删除数,请遵循以下步骤:

  1. 构造请求参数

    • Action: 必须设置为QueryPushStat,表示查询推送统计的动作。
    • AppKey: 需要提供您的应用在阿里云移动推送服务中注册的AppKey信息。
    • MessageId: 提供您想要查询的那条推送消息的ID。这个ID在每次推送后会由系统返回。
  2. 发起API请求

    • 使用HTTP GET方法构造请求URL,格式如下(请替换[backcolor=transparent]为实际字符以形成有效链接):
      http://cloudpush.aliyuncs.com/?Action=QueryPushStat&AppKey=您的AppKey&MessageId=您的MessageId
      
    • 确保在实际请求中去除示例中的[backcolor=transparent]占位符,并使用正确的AppKey与MessageId值。
  3. 处理响应数据

    • 成功响应将包含PushStats字段,它是一个数组,数组内的每个元素代表一条推送消息/通知的统计结果,包含但不限于:
      • SentCount: 推送服务端实际发出的数目。
      • ReceivedCount: 实际送达到设备的数目。
      • OpenedCount: 通知在设备上被点击的数目(仅针对通知类型)。
      • DeletedCount: 通知在设备上被清除的数目(仅针对支持此统计的操作系统版本和通知类型,注意iOS通知不支持删除统计)。
  4. 注意事项

    • 数据延迟:推送数据隔天展示,意味着不支持查询当日数据。
    • 消息与通知区别:消息没有打开和删除的概念,这些统计指标仅适用于通知类型。
    • iOS限制:iOS系统下,删除数统计有特定限制,iOS 10以下系统不支持删除数统计,且从通知栏点击全部清除的行为不会被计入删除数。
    • 错误码处理:如遇到错误响应,需根据返回的错误码进行相应处理,例如StatWaiting表示请求的数据正在处理中,此时应稍后再试。

通过上述步骤,您可以获取到指定推送消息的详细统计数据。

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