

**サポート終了通知:** 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 エンドユーザーメッセージングでサポートされています。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# プッシュチャネルのトラブルシューティング
<a name="channels-push-troubleshooting"></a>

失敗の原因を特定しやすくするため、ログ記録が有効になっていることを検証します。詳細については、「[モニタリングとログ記録](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)を確認します。

## 配信の問題のモニタリング
<a name="troubleshooting-push-delivery"></a>
+ 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 データストリームによるログ記録が有効になっていることを検証します。[\$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 がダウンストリームプッシュ通知サービスから受信した配信結果を確認します。

## メッセージを受信しない
<a name="troubleshooting-push-message-not-received"></a>

****問題と解決策****
+ デバイス接続の問題 — 問題が特定のデバイスでのみ発生する場合は、そのデバイスが、プッシュ通知サービスのエンドポイントへの接続をブロックされていないことを検証します。「[FCM ports and your firewall](https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall)」および「[If your Apple devices aren't getting Apple push notifications](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 を統合したアプリトークンアドレスのチャネルとして GCM を使用し、APN の場合は GCM を、サンドボックス内のアプリには APNS\$1Sandbox を、本番環境のアプリには APNS を使用します。

  失敗ステータスのある配信試行に関するインサイトについては、配信試行に使用された「[それぞれのプッシュチャネルのプッシュ通知レスポンスコード](https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html#platform-returncodes)」を参照してください。

## メッセージが表示されない
<a name="troubleshooting-push-message-not-displayed"></a>
+ ログに配信成功と表示され、メッセージがシステム通知トレイに表示されない場合、これは、通知がデバイスに配信されているが、クライアントアプリケーションで適切に処理されていない問題を示します。
+ Kinesis イベントログに **[配信成功]** ステータスが表示される場合や、特定のリクエストペイロードまたはメッセージタイプでのみ問題が発生している場合があります。この問題は、通知がデバイスに配信されているものの、システム通知トレイには表示されていないことを示している可能性があります。

  これは、特定のリクエストペイロードまたはメッセージタイプ (FCM のデータ、APN のサイレントなど) で発生する可能性があります。メッセージがアラートまたは通知ペイロードとして受信され、データまたはサイレントペイロードとしては受信されない場合は、アプリケーションでデータ、通知、アラート、バックグラウンドなどのメッセージタイプを受信したときの意図したアクションがどのようなものか、およびアプリケーションがさまざまなメッセージタイプを処理できるかどうかを確認してください。
+ トラブルシューティングを行うには、アプリのメッセージハンドラーにログステートメントを組み込んでください。例については、「[FCM](https://firebase.google.com/docs/cloud-messaging/android/receive)」と「[APN](https://developer.apple.com/documentation/uikit/uiapplicationdelegate/1623013-application)」を参照してください。これは、通知がデバイスで受信されたものの、システム通知トレイには表示されていないかどうかを判断するのに役立ちます。