使用流程

配置回執事件采集

1. 開通日志服務

   登錄日志服務控制臺，并開通日志服務。

   說明

   回執日志功能通過流日志投遞到日志服務，涉及流日志生成費和日志服務的服務費，詳情請參見流日志計費說明、按使用功能計費模式計費項。

2. 登錄EMAS管理控制臺。

3. 查找您的項目，單擊項目，進入EMAS概覽頁。

4. 在頂部導航欄，選擇用戶增長。

5. 在用戶增長產品頁面，從左側導航欄選擇移動推送 > 回執日志，進入回執日志主頁面。

6. 單擊配置日志審計服務，進入日志審計服務的全局配置頁面。

7. 在全局配置頁面中，配置如下信息：

   1. 在中心項目Project所在區域中，選擇日志中心化存儲的目標地域。

   2. 配置采集同步授權。

      推薦勾選通過賬號密鑰輔助授權，輸入AccessKey信息（AccessKey信息不會被保存，僅臨時使用），單擊授權。

      授權成功后，將顯示當前賬號已授權日志服務采集同步日志。

   3. 在云產品列表中，將移動推送行對應的推送回執事件開關打開，并配置存儲時間。

      

   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：到達 arrive_fail：到達失敗，指推送到廠商通道時通道通過回執形式異步返回的錯誤信息，如廠商通道不支持回執則無arrive_fail日志 click：點擊，點擊事件依賴于設備側和廠商通道的上報 clean：清除，清除事件依賴于設備側和廠商通道的上報， 說明 當前自有通道離線投遞不會產生sent日志。 到達、點擊、清除事件依賴于設備或廠商通道的上報，部分通道不支持上報機制，如APNs。 iOS通知是投遞給蘋果APNs服務器的，而APNs不支持返回arrive回執，所以使用APNs廠商通道將不會產生arrive回執信息。 iOS的清除請注意配置：iOS通知刪除上報配置
   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	設備網絡類型，示例：WIFI。
   os	設備操作系統，示例：Android。
   os_version	設備操作系統版本或API Level，示例：34。
   isp	設備所屬運營商，示例：聯通。
   job_key	推送任務自定義標識，當推送請求的JobKey不為空時，回執日志中會附帶該字段。示例：123。
   event_channel	發送通道，可能的值有：accs、huawei、honor、xiaomi、oppo、vivo、meizu、gcm、fcm、apsn，后續可能隨功能調整而增加通道類型。
   vendor_message_id	廠商通道消息ID。
   reason	發送失敗或到達失敗原因。一般格式為“code#msg”，code為廠商通道錯誤碼，msg為錯誤解釋或HTTP Code。錯誤信息查看錯誤解釋，或直接根據code查詢廠商通道的錯誤碼文檔獲取。
   owner_id	阿里云主賬號的uid。

消息回執分析

1. 返回 回執日志 主頁面。

2. 單擊分析，進入Android消息回執分析/iOS消息回執分析頁面。

3. 輸入app_key對回執分析結果進行過濾。

4. 回執分析中將展示以下信息。

   參數	說明
   來源IP分布	展示所選時間范圍內所有回執的IP分布情況。
   總數	展示所選時間范圍內所有回執的總數。
   到達數	所有送達到設備的消息總數。 Android：所有設備收到的消息總數。Android端自有通道、廠商通道均有送達的回執，到達數是所有到達類型回執的總和。 iOS：iOS通知是投遞給蘋果APNs服務器的，到達依據是只要蘋果服務器沒有返回錯誤反饋，就認為送達。 HarmonyOS：所有設備收到的消息總數。HarmonyOS端自有通道、廠商通道均有送達的回執，到達數是所有到達類型回執的總和。
   點擊數	展示所選時間范圍內，推送到設備的通知或消息被用戶點擊的數量。統計方式：event_type為click的所有回執數量。
   回執趨勢	展示所選時間范圍內所有回執類型的數量趨勢。
   品牌分布	展示時間范圍內所有推送成功的設備的品牌分布情況。
   運營商分布	展示時間范圍內所有推送成功的設備的運營商分布情況。
   操作系統分布	展示時間范圍內所有推送成功的設備的操作系統分布情況。
   操作系統版本分布	展示時間范圍內所有推送成功的設備的操作系統版本分布情況。