プッシュチャネルのトラブルシューティング

• を介して送信されるダイレクトプッシュ通知メッセージについては SendMessages API、APIレスポンスをキャプチャして配信に関するインサイトを取得してください。そのためには、レスポンス内の EndpointResult オブジェクト内の StatusMessage 属性を確認します。この属性には、ダウンストリームプッシュ通知サービスから受信したプラットフォームレスポンスコードが含まれます。

• キャンペーンでは、Kinesis データストリームによるログ記録が有効になっていることを検証します。_campaign.send イベントのプラットフォームレスポンスコードをチェックして、Amazon Pinpoint がダウンストリームプッシュ通知サービスから受信した配信結果を確認します。

問題と解決策

• デバイス接続の問題 — 問題が特定のデバイスでのみ発生する場合は、そのデバイスが、プッシュ通知サービスのエンドポイントへの接続をブロックされていないことを検証します。FCM 「ポートとファイアウォール」と「Apple デバイスが Apple プッシュ通知を受信していない場合」を参照してください。

• エンドポイントOptOut属性値 – エンドポイントOptOut値が に設定されている場合ALL、エンドポイントは通知を受信しません。get-endpoint を使用してCLI、エンドポイントOptOut値が に設定されていることを確認しますNONE。エンドポイントがオプトアウトされている場合、キャンペーンやジャーニーを通じて送信されたメッセージはエンドポイントに配信されず、ログも生成されません。

• トークン環境 — Amazon Pinpoint エンドポイントのチャネルタイプが、デバイス用に生成されたトークンと一致することを検証します。例えば、 を FCMと統合したアプリケーショントークンアドレスのチャネルGCMとして、 を にAPNs、サンドボックスのアプリケーションに APNS_Sandbox に、または本番環境のアプリケーションAPNSに を使用します。

  失敗ステータスのある配信試行に関するインサイトについては、配信試行に使用された「それぞれのプッシュチャネルのプッシュ通知レスポンスコード」を参照してください。

• ログに配信成功と表示され、メッセージがシステム通知トレイに表示されない場合は、通知がデバイスに配信されるが、クライアントアプリケーションで適切に処理されないという問題が示されます。

• Kinesis イベントログに配信成功ステータスが表示されたり、特定のリクエストペイロードまたはメッセージタイプでのみ問題が発生したりすることがあります。この問題は、通知がデバイスに配信されているものの、システム通知トレイには表示されていないことを示している可能性があります。

  これは、特定のリクエストペイロードまたはメッセージタイプ ( のデータFCM、 のサイレントなどAPNs) で発生する可能性があります。例えば、メッセージがアラート/通知ペイロードとして受信され、データ/サイレントペイロードとして受信されない場合は、アプリケーションでメッセージタイプデータ、通知、アラート、または背景が受信されたときの意図したアクションとは何か、およびアプリケーションがさまざまなメッセージタイプを処理できるかどうかを確認してください。

• トラブルシューティングを行うには、アプリのメッセージハンドラーにログステートメントを組み込みます。例については、FCM「」および「」を参照してくださいAPNs。これにより、通知がデバイスによって受信されたが、システム通知トレイに表示されないかどうかを判断するのに役立ちます。