**支援結束通知：**2026 年 10 月 30 日， AWS 將結束對 Amazon Pinpoint 的支援。2026 年 10 月 30 日之後，您將無法再存取 Amazon Pinpoint 主控台或 Amazon Pinpoint 資源 (端點、區段、行銷活動、旅程和分析)。如需詳細資訊，請參閱 [Amazon Pinpoint 終止支援](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：**與 SMS、語音、行動推播、OTP 和電話號碼驗證相關的 APIs 不受此變更影響，並受 AWS 最終使用者傳訊支援。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 對推送通道進行故障診斷
確認已開啟記錄功能，以協助識別失敗的原因。詳情請參閱[監控和記錄](troubleshooting.md#troubleshooting-logging)。對於未透過行銷活動或旅程傳送的交易推播通知，請記錄 [API 回應](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams.html)以了解[交付狀態](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#apps-application-id-messages-model-messageresult)。
## 監控交付問題
+ 直接推播通知訊息若是透過 SendMessages API 傳送，請確認您已擷取 API 回應以查看交付的詳細資訊。若要執行此操作，請查看回應中 [EndpointResult](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#apps-application-id-messages-model-messageresponse) 物件內的 StatusMessage 屬性。此屬性包含從下游推播通知服務接收的[平台回應代碼](https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html#platform-returncodes)。
+ 在行銷活動中，確認已開啟透過 Kinesis Data Streams 進行日誌記錄。請參閱 [\$1campaign.send](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams-data-campaign.html#event-streams-data-campaign-attributes) 事件中的[平台回應代碼](https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html#platform-returncodes)，以了解 Amazon Pinpoint 從下游推播通知服務收到的傳送結果。
## 未收到訊息
****問題與解決方案****
+ 裝置連線問題 – 如果問題只發生在某些裝置上，請確認這些裝置未遭到封鎖，可以連線到推播通知服務端點。請參閱 [FCM 連接埠和防火牆](https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall)以及[如果您的 Apple 裝置沒有收到 Apple 推播通知](https://support.apple.com/en-us/102266)。
+ 端點 **OptOut** 屬性值 – 如果端點 **OptOut** 值設為 `ALL`，端點將不會接收通知。使用 [get-endpoint](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/get-endpoint.html) CLI，確認端點 **OptOut** 值設為 `NONE`。如果端點選擇不接收，透過行銷活動或旅程傳送的訊息將不會交付到端點，也不會產生日誌。
+ 權杖環境 – 確認 Amazon Pinpoint 端點的管道類型，是否與為了裝置而產生的權杖相符。例如：對於具有 FCM 整合的應用程式權杖位址以及 APN，使用 GCM 作為管道，對於沙盒中的應用程式則使用 APNS\$1Sandbox，或對於製作中的應用程式使用 APNS。
如需深入了解失敗狀態的交付嘗試，請參閱交付嘗試中使用的[個別推播管道的推播通知回應代碼](https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html#platform-returncodes)。
## 不會顯示訊息
+ 如果日誌顯示成功交付，且系統通知匣上未顯示訊息，這表示通知傳送至裝置但未在用戶端應用程式中適當處理的問題。
+ 您可能會看到 Kinesis 事件日誌顯示**成功交付**狀態，或只有特定請求承載或訊息類型發生問題。此問題可能表示通知已交付到裝置，但未顯示在系統通知匣上。
這可能發生在特定的請求承載或訊息類型 （例如 FCM 的資料、APNs 的靜音）。例如，如果收到的訊息是警示/通知承載，而不是資料/無提示承載，請檢查當您的應用程式收到訊息類型的資料、通知、提醒或背景時，預期的動作是什麼，以及應用程式是否可以處理不同的訊息類型。
+ 若要疑難排解，請在您應用程式的訊息處理常式中納入日誌陳述式。如需範例，請參閱 [FCM](https://firebase.google.com/docs/cloud-messaging/android/receive) 和 [APN](https://developer.apple.com/documentation/uikit/uiapplicationdelegate/1623013-application)。這將有助於判斷裝置是否收到通知，但未顯示在系統通知匣中。