回执日志

使用流程

配置回执事件采集

1. 开通日志服务

   登录日志服务控制台，并开通日志服务。

   说明

   日志服务涉及读写流量、存储、索引等费用，详情请参见计费概述。

2. 登录移动推送控制台。

3. 左侧导航栏选择数据统计>回执日志，进入回执日志主页面。

4. 单击配置日志审计服务，进入日志审计服务的全局配置页面。

5. 在全局配置页面中，配置如下信息：

   1. 在中心项目Project所在区域中，选择日志中心化存储的目标地域。

   2. 配置采集同步授权。

      推荐勾选通过账号密钥辅助授权，输入AccessKey信息（AccessKey信息不会被保存，仅临时使用），单击授权。

      授权成功后，将显示当前账号已授权日志服务采集同步日志。

   3. 在云产品列表中，将移动推送行对应的推送回执事件开关打开，并配置存储时间。

      
      说明

      目前日志审计服务免费，其涉及日志服务的shard租用、数据存储、读写流量、数据加工等收费内容，详情请参见计费概述。

   4. 单击保存。

      配置生效需要等待1分钟，完成后返回回执日志页面，并刷新。更多日志审计服务配置请参考日志审计服务文档。

查询回执日志

1. 登录移动推送控制台。

2. 左侧导航栏选择数据统计>回执日志，进入日志查询页面。

3. 选择时间范围，系统自动筛选符合时间范围的回执日志。

   

4. 在搜索框中输入查询分析语句，单击查询/分析，查看分析结果。

   说明

   查询分析语句有查询语句和分析语句构成，格式为查询语句|分析语句，详情请参见查询分析日志。

   回执日志字段说明如下：

   字段	说明
   __time__	事件时间，示例：2018-02-27 11:58:15
   __topic__	主题，固定为cps_callback_event
   app_key	AppKey
   message_id	消息ID，示例：868947123456789
   event_time	回执事件时间，示例：2020-03-02 11:04:51
   event_type	回执事件类型，有以下几种类型： sent：送出 sent_fail：送出失败 arrive：到达 click：点击 clean：清除 说明 因为iOS通知是投递给苹果APNs服务器的，而APNs不支持返回arrive回执，所以使用APNs厂商通道将不会产生arrive回执信息。
   device_id	设备ID，示例：96d7c9db01ccxxxxxxxxxxxxxxxxxxxx
   device_type	设备类型，示例：ANDROID/IOS
   last_active_time	设备最后活跃时间，示例：2020-01-31 11:58:02
   app_version	应用版本号，示例：5.20
   client_ip	客户端IP
   brand	设备品牌，示例：vivo
   network_type	设备网络类型，示例：Wi-Fi
   os	设备操作系统，示例：Android
   os_version	设备操作系统版本，示例：4.2.2
   isp	设备所属运营商，示例：联通
   job_key	推送任务自定义标识，当JobKey不为空时，回执日志中会附带该字段。示例：123
   utdid	设备内部utdid，示例：VoVRNvfToCwDAP49K0RVeWJz
   app_id	应用ID
   event_channel	发送通道
   vendor_message_id	厂商通道消息ID
   reason	发送失败原因

消息回执分析

1. 登录移动推送控制台。

2. 左侧导航栏选择数据统计>回执日志，选择Android消息回执分析/iOS消息回执分析页签。

3. 输入app_key对回执分析结果进行过滤。

4. 回执分析中将展示以下信息。

   参数	说明
   来源IP分布	展示所选时间范围内所有回执的IP分布情况。
   总数	展示所选时间范围内所有回执的总数
   到达数	所有送达到设备的消息总数。Android：所有设备收到的消息总数。Android端自有通道、厂商通道均有送达的回执，到达数是所有到达类型回执的总和。iOS：iOS通知是投递给苹果APNs服务器的，到达依据是只要苹果服务器没有返回错误反馈，就认为送达。
   点击数	展示所选时间范围内，推送到设备的通知或消息被用户点击的数量。统计方式：event_type为click的所有回执数量。
   回执趋势	展示所选时间范围内所有回执类型的数量趋势。
   品牌分布	展示时间范围内所有推送成功的设备的品牌分布情况。
   运营商分布	展示时间范围内所有推送成功的设备的运营商分布情况。
   操作系统分布	展示时间范围内所有推送成功的设备的操作系统分布情况。
   操作系统版本分布	展示时间范围内所有推送成功的设备的操作系统版本分布情况。