仪表板
推送儀表板為您提供所有註冊活動的詳細信息、交付狀態和統計數據的單一視圖。
搜尋¶
您可以搜索当前连接的用户拥有权限的游戏所发送的活动的状态和统计信息。
根據交付時間表（保留）選擇一個日期，然後選擇一個應用程序和一個活動。交付時間表默認設置為今天的日期。所有數據將基於每日單位顯示。然而，您還可以在各自的活動詳細數據區間中查看重複活動的整體、國家和伺服器的重複期間的趨勢圖。
Note
您可以搜索最多一年前的数据。
遊戲狀態¶
您可以查看特定游戏某一天的整个数据图、令牌数量、交付、开启和注册的活动。
Note
開啟次數代表當天的開啟次數。請注意，不僅當天發送的活動開啟次數會被計算，之前發送的活動開啟次數也會被計算。例如，如果用戶打開了昨天發送給他的推播，這次推播的開啟次數會被計算為今天的。因此，當天活動開啟次數的總和可能會出現不匹配。除了開啟次數（例如，令牌數量）之外的所有數字都代表當天的計數。（不過，Facebook 的開啟案例計算不在此列。）
上面的地圖顯示了特定日期的全球配送數量。彩色部分是配送量較多的地方。如果將光標放在上面，您可以通過工具提示查看詳細信息。
上面的圖表顯示了特定日期的令牌數量變化。該圖表每小時實時刷新，您可以根據累積的令牌數量預測交付量，特別是當您需要發送大量時。
活動資訊¶
在顶部选择游戏和日期后，点击搜索以显示结果。 您可以点击特定的活动以查看其详细数据。
點擊右上角的下載按鈕，以圖表格式下載數據為 Excel 文件。
顯示所選活動當天的交付總數、成功案例、開放案例和失敗案例的數量。
如果所選的活動是一個只發送一天的單一活動，它將顯示為“點”圖表。 當您點擊圖表區域時，您將看到該日期單一活動的案例成功/失敗率圖表及失敗原因。
如果所選的活動是跨多天發送的重複活動，它將顯示為“折線”圖。對於重複活動，您可以查看整個重複間隔的數據趨勢，以及頂部的特定日期。頂部選擇的日期將是標準日期，並且包含所選日期的整個發送間隔（默認值）的週將顯示在此區域。單擊圖表區域中的特定日期以查看詳細信息，例如對應日期的成功/失敗率以及底部的失敗原因圖。如果這是一個運行超過一週的活動，您可以單擊標題區域右側的[上週]或[下週]按鈕按週查看結果。
在所選活動當天的總交付金額中，結果將顯示成功和失敗率的餅圖。（左）
右側的圖表顯示了詳細失敗的原因以及當天總失敗數的比例。在 Google (FCM) 和 Apple (APNS) 上，如果有關於請求的推送通知發生失敗，將返回錯誤代碼，以便您可以找出失敗的原因。Google (FCM) 提供總共 16 種響應，而 Apple (APNS) 提供 28 種錯誤響應。推送為用戶提供了失敗的原因，以便用戶可以了解不是系統問題的錯誤。以下顯示了每個失敗錯誤代碼的概述。
FCM(Google)¶
| 錯誤 | 描述 | 等等 |
|---|---|---|
| 缺少註冊 | 檢查請求是否包含註冊令牌 （在純文本消息中的 registration_id，或在 JSON 中的 to 或 registration_ids 字段）。 | 當在發送到 FCM 服務的有效負載中省略令牌時發生 |
| 無效的註冊 | 檢查您傳遞給伺服器的註冊令牌格式。 確保它與客戶端應用從 Firebase 通知註冊時接收到的註冊令牌匹配。 請勿截斷或添加額外的字符。 | 當令牌無效時發生 |
| 未註冊 | 在多種情況下，現有的註冊令牌可能會失效，包括： 如果客戶端應用程序與 FCM 取消註冊。 如果客戶端應用程序自動取消註冊，這可能發生在用戶卸載應用程序的情況下。 例如，在 iOS 上，如果 APNS 反饋服務報告 APNS 令牌無效。 如果註冊令牌過期 （例如，Google 可能會決定刷新註冊令牌，或者 APNS 令牌對於 iOS 設備已過期）。 如果客戶端應用程序已更新，但新版本未配置為接收消息。 對於所有這些情況，請從應用服務器中刪除此註冊令牌，並停止使用它來發送消息。 | 如果應用程序已被刪除則會發生 |
| 無效的包名 | 請確保消息是發送到與請求中傳遞的值匹配的註冊令牌的包名。 | 當請求從伺服器發送推送的應用程序與令牌應用程序不匹配時發生 |
| MismatchSenderId | 註冊令牌與某組發送者相關聯。當客戶端應用註冊 FCM 時， 必須指定哪些發送者被允許發送消息。 在向客戶端應用發送消息時，應使用這些發送者 ID 中的一個。 如果切換到不同的發送者，則現有的註冊令牌將無法使用。 | 當請求從伺服器發送推送的發送者 ID 與用於創建令牌的發送者 ID 不匹配時發生 |
| 無效的參數 | 檢查提供的參數是否具有正確的名稱和類型。 | 當發送到FCM服務的有效負載無效時發生 |
| MessageTooBig | 檢查消息中包含的有效負載數據的總大小是否超過FCM限制： 大多數消息為4096字節，或針對主題的消息為2048字節。 這包括鍵和值。 | 當發送到FCM服務的有效負載大小超過4K時發生 |
| InvalidDataKey | 檢查有效負載數據中是否包含 FCM 內部使用的鍵（例如 from、gcm 或任何以 google 為前綴的值）。 注意某些單詞（例如 collapse_key）也被 FCM 使用，但在有效負載中是允許的， 在這種情況下，有效負載值將被 FCM 值覆蓋。 | 當發送到 FCM 服務的有效負載的字段名稱無效時發生 |
| 不可用 | 伺服器未能及時處理請求。 | FCM 服務錯誤 |
| 內部伺服器錯誤 | 伺服器在處理請求時遇到錯誤。 | FCM 服務錯誤 |
APNS(Apple)¶
| 錯誤 | 描述 | 等等 |
|---|---|---|
| BadCollapsedId | 折疊識別符超過允許的最大大小。 | 當要覆蓋的折疊 ID 超過其允許的最大大小時發生 |
| 壞的設備令牌 | 指定的設備令牌無效。請驗證請求是否包含有效的令牌 並且該令牌與環境匹配。 | 當推送令牌無效時發生 |
| MissingDeviceToken | 請求的 :path 中未指定設備令牌。 請確認 :path 標頭包含設備令牌。 | 當在發送到 APNS 服務的有效負載中省略令牌時會發生 |
| 有效負載為空 | 消息有效負載為空。 | 當發送到 APNS 服務的有效負載被省略時發生 |
| 壞證書 | 證書無效。 | 推送證書錯誤 |
| 錯誤的證書環境 | 客戶端證書用於錯誤的環境。 | 應用證書錯誤 |
| 未註冊 | 該設備令牌對於指定主題是非活動的。 | 如果應用程序已被刪除，則會發生此情況 |
| 有效負載過大 | 消息有效負載過大。 | 當發送到 APNS 服務的有效負載大小超過 4K 時發生 |
| 過多請求 | 對同一設備令牌連續發出了過多請求。 | 當使用相同令牌請求過多推送交付時發生 |
| 內部伺服器錯誤 | 發生內部伺服器錯誤。 | APNS 服務錯誤 |
| 服務不可用 | 服務不可用。 | APNS 服務錯誤 |
| 關閉 | 伺服器正在關閉。 | APNS 服務錯誤 |
ADM(Amazon)¶
| 錯誤 | 描述 | 等等 |
|---|---|---|
| 未註冊 | 與註冊 ID 相關聯的應用實例不再可用於接收消息。 | 當應用已被刪除時發生 |
| 無效的註冊 ID | 註冊 ID 與提供的訪問令牌識別的發件人不相符。 | 當令牌無效時發生 |
| 無效數據 | - | 當發送到ADM服務的有效負載無效時發生 |
| 存取權杖已過期 | 提供的存取權杖無效。 發送者應該刷新他們的存取權杖。 | 伺服器認證的權杖過期 |
| MessageTooLarge | 在數據參數中提供的消息有效負載超過了最大允許數據大小（6 KB）。 | 當發送到ADM服務的有效負載大小超過6K時發生 |
| MaxRateExceeded | 請求者已超過其允許的最大消息速率。 發送者可能會在稍後重試，遵循響應中包含的 Retry-After 標頭。 為了確保高可用性，ADM 限制在給定時間內可以發送的消息數量。 | 當同時請求過多推送交付時發生 |
| 內部伺服器錯誤 | 發生了內部伺服器錯誤。 | 由於ADM服務錯誤，返回HTTP代碼500 |
| 不可用 | 伺服器暫時無法使用。 | 由於ADM服務錯誤，返回HTTP代碼500 |
臉書¶
| 錯誤代碼 | 錯誤訊息 | 其他 |
|---|---|---|
| 190 | 無效的 OAuth 存取權杖簽名。 | 當在應用程式中心註冊的 app_secret 和 app_id 值不正確時會發生 |
| 100 | 參數主體必須至少為 10 個字符長。 | 當主體文本為 10 個字符或更少時發生的通知 |
| 參數標題必須最多為30個字符長。 | 當標題為30個字符或更多時發生的通知 | |
| 參數正文長度必須最多為180個字符。 | 當正文文本為180個字符或更多時發生的通知 | |
| 參數媒體不是有效的URI。 | 當輸入無效的圖像URI時發生的通知 | |
| 613 | 自上次遊玩以來，只能向用戶發送 5 條通知。 | 當通知 API 調用的數量超過限制時發生的通知 |
請參考以下網址，以獲取Google、Apple、Amazon和Facebook提供的開發者指南。
Note
※由Google (FCM)、Apple (APNS)、Amazon (ADM)和Facebook提供的錯誤響應代碼指南 來自FCM的下游消息錯誤響應代碼 : 前往 來自APNs的HTTP/2響應 : 前往 來自ADM的響應格式 : 前往 Facebook的Graph API錯誤處理 : 前往
左側的圖表顯示了各國的交付信息，右側的圖表顯示了按伺服器的交付信息。
顯示特定日期所選活動的每個伺服器或國家的交付數量、成功案例、未解決案例和失敗案例。預設情況下，交付數量最多的伺服器或國家將首先顯示，因為可能有許多國家或伺服器進行了交付。如果至少有一個伺服器或國家進行了交付，您可以使用頂部的多選選項同時顯示兩個或更多數據圖表並進行比較。
任務資訊¶
在頂部選擇特定的活動以顯示。 活動的 任務 數量因是否選擇批量交付而異，這取決於實際工作。如果選擇批量交付，則只有一個 任務，因為案件是根據 KST 一次性發送的，而不考慮國家和時區之間的時差。相反，如果不選擇批量交付，則最多可以存在 24 個 任務，因為它們是根據各國和時區指定的時間按順序發送的。
在這個部分，您可以查看所選活動的每個任務的詳細信息。您必須點擊並選擇某個任務以查看如下數據。
顯示所選任務的按國家或伺服器的交付資訊。
顯示選定的 task 之 AppID 的交付資訊。
左側的圓餅圖顯示了所選任務的成功率和失敗率，與當日的總交付量有關。
右側的表格顯示了選定日期的詳細失敗原因和總失敗次數的百分比。失敗原因的錯誤代碼的詳細描述與整個活動頂部的失敗原因圖表區間相同。
如果在一個活動中有10個失敗案例，而其中8個發生在特定的任務上，您可以在此部分檢查並找出它們失敗的原因。
如果您没有使用批量交付，并且任务被发送到韩国，而失败的原因主要是由于应用程序被删除，您可以假设在韩国删除应用程序的用户比其他国家更多。