資料查詢

為了方便客戶快速定位問題，目前平台提供線上狀態和推送生命週期工具。

線上狀態

場景

由於 EngageLab 推送的 EngageLab 通道依賴線上推送程序來接收推送通知，若使用者反映經常收不到推送，可以使用此工具檢查裝置是否在線上。若裝置不在線上，建議重新啟動應用程式。

參數說明

Registration ID：使用者終端裝置在 EngageLab 服務平台的 Registration ID，是使用者唯一的裝置識別 ID。同一支手機上不同 App 的 Registration ID 皆不相同。取得方式：Android、iOS

使用說明

• 在輸入框中輸入該 App 的「Registration ID」，支援輸入多個 RegID，以「,」分隔。

• 查詢結果顯示「false」表示裝置不在線上，「true」表示裝置在線上，右側可查看最後上線時間。

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

推送生命週期

場景

若透過線上狀態查詢後仍無法收到推送訊息，可以透過生命週期工具查詢訊息生命週期，並根據錯誤碼進行相應處理。

參數說明

• Registration ID：使用者終端裝置在 EngageLab 服務平台的 Registration ID，是使用者唯一的裝置識別 ID。同一支手機上不同 App 的 Registration ID 皆不相同。取得方式：Android、iOS
• Message ID：推送任務的 ID。

在控制台取得參數

在需要查詢的通知詳情頁面，可以取得 Message ID，點擊訊息體的 「View」 即可查看此推送的 JSON 訊息體。 若推送目標為「Registration ID」，則「receiverValue」的值即為 Registration ID。

在伺服器端取得參數

呼叫 API 後可在回應參數中取得 msg_id（Message ID）：

              
              {
    "sendno": "0",
    "msg_id": "2509042"
}

            

使用說明

取得 Message ID 和 Registration ID 參數後，進入【資料查詢】-【推送生命週期】頁面，輸入參數，點擊「查詢」即可查看該推送的完整生命週期。

• 若沒有生命週期過程，表示裝置不在此次推送目標中，請確認查詢的 Registration ID 是否在此次推送目標中。
• 此頁面包含裝置的完整生命週期，從被列為【計畫目標】到被列為【有效目標】，再到傳送、送達和點擊。若在任何節點發生失敗，將顯示失敗原因。
• 由於 EngageLab 在 Android 平台的推送策略，在透過某些廠商通道傳送失敗的情況下，會切換到 EngageLab 的線上通道進行傳送。訊息將暫時快取在伺服器上，待使用者透過長連線上線後再行傳送。因此，您可能會在訊息生命週期中看到兩個生命週期。