推送偵測
為了方便客戶快速定位問題,目前本平台提供線上狀態查詢和推送生命週期查詢工具。
線上狀態查詢
使用情境
由於 EngageLab 推送的 EngageLab 通道需依賴推送程序在線上時才能收到推送,如果使用者反映經常收不到推送,可以透過此工具查詢裝置是否在線上;若裝置不在線上,建議重新啟動應用程式。
參數說明
Registration ID:使用者終端裝置在極光服務平台的註冊 ID,是使用者唯一的裝置識別 ID。同一支手機上的不同 App,其 Registration ID 皆不相同,取得方式詳見 取得 RegistrationID。
使用說明
- 在輸入框中輸入該 App 的 Registration ID,支援輸入多個 RegID,請以「,」分隔。

- 查詢結果顯示 "false" 表示裝置不在線上,"true" 表示裝置在線上,右側可查看最後上線時間。

- 若輸入的 Registration ID 不正確,查詢結果會顯示具體的錯誤原因。

推送生命週期
使用情境
如果透過線上狀態查詢後,仍無法解決收不到推送的問題,可以透過生命週期工具查詢訊息的生命週期,並根據錯誤碼進行相應處理。
參數說明
- Registration ID:使用者終端裝置在極光服務平台的註冊 ID,是使用者唯一的裝置識別 ID。同一支手機上的不同 App,其 Registration ID 皆不相同,取得方式詳見 取得 RegistrationID。
- Message ID:推送任務 ID。
控制台取得參數
在需要查詢的通知詳情頁面中,可以取得 Message ID。點擊訊息體的「查看」,即可查看此推送的 JSON 訊息體。

如果推送目標為 "Registration ID",則 "receiverValue" 的值為 Registration ID。

服務端取得參數
API 呼叫後可在回應參數中取得 msg_id(Message ID):
{
"sendno": "0",
"msg_id": "2509042"
}
{
"sendno": "0",
"msg_id": "2509042"
}
此代碼塊在浮窗中顯示
使用說明
取得 Message ID 和 Registration ID 參數後,進入【資料查詢】-【推送生命週期】頁面,輸入參數,點擊「查詢」即可查看該推送的完整生命週期。
- 1 為 EngageLab 伺服器回傳,2 為系統瀏覽器的伺服器回傳。
- 若沒有生命週期過程,表示裝置不在此次推送目標中,請確認查詢的 Registration ID 是否包含在此次推送目標內。

