开发者社区 问答 正文

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



QueryPushStatByMsg



描述


查询消息维度的推送统计。

请求参数

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


响应参数

名称类型描述
MsgPushStats复杂对象消息/通知的推送结果统计MsgPushStatType组成的数组


错误码

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


示例



请求示例

  1. [backcolor=transparent]http[backcolor=transparent]:[backcolor=transparent]//cloudpush.aliyuncs.com/?Action=QueryPushStatByMsg
  2. [backcolor=transparent]&[backcolor=transparent]AppKey[backcolor=transparent]=[backcolor=transparent]23267207
  3. [backcolor=transparent]&[backcolor=transparent]MessageId[backcolor=transparent]=[backcolor=transparent]510427
  4. [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]<QueryPushStatByMsgResponse>
  3. [backcolor=transparent]    [backcolor=transparent]<RequestId>[backcolor=transparent]9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC[backcolor=transparent]</RequestId>
  4. [backcolor=transparent]    [backcolor=transparent]<MsgPushStats>
  5. [backcolor=transparent]      [backcolor=transparent]<PushStat>
  6. [backcolor=transparent]        [backcolor=transparent]<MessageId>[backcolor=transparent]510427[backcolor=transparent]</MessageId>
  7. [backcolor=transparent]        [backcolor=transparent]<AcceptCount>[backcolor=transparent]120[backcolor=transparent]</AcceptCount>
  8. [backcolor=transparent]        [backcolor=transparent]<SentCount>[backcolor=transparent]100[backcolor=transparent]</SentCount>
  9. [backcolor=transparent]        [backcolor=transparent]<ReceivedCount>[backcolor=transparent]60[backcolor=transparent]</ReceivedCount>
  10. [backcolor=transparent]        [backcolor=transparent]<OpenedCount>[backcolor=transparent]30[backcolor=transparent]</OpenedCount>
  11. [backcolor=transparent]        [backcolor=transparent]<DeletedCount>[backcolor=transparent]10[backcolor=transparent]</DeletedCount>
  12. [backcolor=transparent]      [backcolor=transparent]</PushStat>
  13. [backcolor=transparent]    [backcolor=transparent]</MsgPushStats>
  14. [backcolor=transparent]</QueryPushStatByMsgResponse>


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]"MsgPushStats"[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]"AcceptCount"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]120[backcolor=transparent],
  7. [backcolor=transparent]      [backcolor=transparent]"SentCount"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]100[backcolor=transparent],
  8. [backcolor=transparent]      [backcolor=transparent]"ReceivedCount"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]60[backcolor=transparent],
  9. [backcolor=transparent]      [backcolor=transparent]"OpenedCount"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]30[backcolor=transparent],
  10. [backcolor=transparent]      [backcolor=transparent]"DeletedCount"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]10
  11. [backcolor=transparent]    [backcolor=transparent]}
  12. [backcolor=transparent]  [backcolor=transparent]]
  13. [backcolor=transparent]}

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

查询消息维度的推送统计(QueryPushStatByMsg)操作指南

请求参数说明

  • Action: String, 必填。操作接口名称,固定取值为QueryPushStatByMsg
  • AppKey: Long, 必填。您的AppKey信息,用于标识应用。
  • MessageId: String, 必填。推送的消息ID,此ID在推送消息后会返回,用于唯一标识一次推送任务。

响应参数说明

  • MsgPushStats: 复杂对象数组。包含每条消息/通知的推送结果统计详情,具体包括但不限于接受计数(AcceptCount)、删除计数(DeletedCount)、打开计数(OpenedCount)、接收计数(ReceivedCount)、发送计数(SentCount)等指标。

错误码示例

  • TaskWaiting: 当请求的数据正在处理中时,返回此错误码,HTTP状态码为400。

请求示例

构造一个查询消息维度推送统计的HTTP请求,格式如下:

http://cloudpush.aliyuncs.com/
?Action=QueryPushStatByMsg
&AppKey=您的AppKey值
&MessageId=您要查询的消息ID

请注意替换您的AppKey值您要查询的消息ID为实际的值。

注意事项

  • 确保提供的AppKey正确无误,且与查询的应用相对应。
  • MessageId必须是之前推送成功后返回的ID,且注意数据隔天展示,不支持查询当日数据。
  • 在调用API前,请确保已具备相应的RAM权限,具体授权信息可参考相关文档中的说明。

通过上述步骤,您可以获取指定消息推送的详细统计信息,进而分析推送效果及优化策略。

参考资料:[1], [2]

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