プッシュ通知のトラブルシューティング
このページでは、プッシュ通知の配信、クリック動作、認証情報の問題をトラブルシューティングします。SDKに固有の設定については、Braze SDKのプッシュ通知のトラブルシューティングを参照してください。エラーコードについては、一般的なプッシュエラーメッセージを参照してください。
まずはここから：症状を確認する
| 症状 | 参照先 |
|---|---|
| ユーザーがプッシュ通知を受信しなかった | プッシュ通知が届かない |
| プッシュ通知が遅れて届く | プッシュ通知の遅延 |
| プッシュ送信が予想より遅い | プッシュ通知の送信が予想より遅い |
MismatchSenderID エラー（Android） |
エラー：MismatchSenderID |
| プッシュをタップしてもアプリが開かない | プッシュ通知をクリックしてもアプリが開かない |
| プッシュリンクがブラウザーではなくアプリで開く | プッシュクリックが予期せずアプリ内で開く |
| Webプッシュの権限または配信の問題 | Webプッシュ通知が期待どおりに動作しない |
.p12 から .p8 への移行が必要（iOS） |
.p8認証キーへの移行 |
| ログに特定のプッシュエラーコードがある | プッシュエラーメッセージ |
標準的な調査パス
ユーザーまたはテストデバイスがプッシュを受信しなかった場合は、このワークフローを使用してください。ステップ1から始めてください。
- ユーザーがプッシュ購読済みまたはオプトイン済みであり、プロファイルのエンゲージメントタブに有効なプッシュトークンがあることを確認します。
- 送信時にユーザーがキャンペーンまたはキャンバスのターゲットオーディエンスに含まれていることを確認します（セグメントはリアルタイムで更新されます）。
- キャンペーンまたはキャンバスのグローバルフリークエンシーキャップ、レート制限、コントロールグループの割り当てを確認します。
- デバイスに対して正しいプッシュタイプを使用していることを確認します（例：Android、iOS、またはKindle）。
- 内部テストの場合、テスターがデバイス上の正しいアプリにログインしていることを確認します。
- それでも配信に失敗する場合は、よくあるプッシュエラーメッセージを確認するか、キャンペーンまたはキャンバスのID、ユーザーID、タイムゾーン付きのタイムスタンプを添えてBrazeサポートにお問い合わせください。
プッシュ通知が届かない
症状： ユーザーが期待されるプッシュ通知を受信しなかった。
プッシュ通知が期待どおりに届かない場合は、以下の項目を順に確認してください。
プッシュサブスクリプションステータス
プッシュ通知は、購読中またはオプトインしたユーザーにのみ送信できます。ユーザープロファイルでエンゲージメントタブを開き、テスト対象のワークスペースでプッシュ通知に登録されていることを確認してください。複数のアプリに登録している場合は、Push Registered Forに一覧表示されます。
Brazeのエクスポートエンドポイントを使用してユーザープロファイルをエクスポートすることもできます。
いずれのエンドポイントも、デバイスごとのプッシュ有効化情報を含むプッシュトークンオブジェクトを返します。
セグメント
ターゲットにしているセグメントに自分が含まれていることを確認してください（ライブキャンペーンの場合、テストではない場合）。ユーザープロファイルには、ユーザーが現在含まれているセグメントの一覧が表示されます。セグメントメンバーシップはリアルタイムで更新されます。
セグメントを作成する際にユーザー検索を使用して、ユーザーがそのセグメントに含まれていることを確認することもできます。ユーザー検索はexternal_idまたはbraze_idのみを受け付けます。メールアドレスや電話番号は使用できません。メール、電話番号、プッシュトークン、またはユーザーエイリアスで検索するには、ユーザーを検索を参照してください。
プッシュ通知キャップ
グローバルフリークエンシーキャップを確認してください。ワークスペースにグローバルフリークエンシーキャップが設定されており、指定された期間のプッシュ通知キャップにすでに達しているため、プッシュ通知を受信できなかった可能性があります。
キャンペーンの分析ページで、フリークエンシーキャップのバナーを確認し、過去30日間にキャンペーンを受信しなかったユーザーのおおよその数を確認してください。個別の送信を調査するには、メッセージング診断ダッシュボードを使用し、フリークエンシーキャップでフィルタリングしてください。ルールの確認や変更については、グローバルフリークエンシーキャップを参照してください。
レート制限
キャンペーンまたはキャンバスにレート制限が設定されている場合、その制限を超えたためにメッセージを受信できなくなっている可能性があります。詳細については、レート制限を参照してください。
コントロールグループのステータス
単一チャネルのキャンペーンまたはコントロールグループを含むキャンバスの場合、コントロールグループに入っている可能性があります。
- バリアント配分を確認して、コントロールグループがあるかどうかを確認します。
- コントロールグループがある場合は、キャンペーンコントロールグループ内でフィルタリングするセグメントを作成し、セグメントをエクスポートして、自分のユーザーIDがリストに含まれているかどうかを確認します。
有効なプッシュトークン
プッシュトークンは、送信者が特定のデバイスにプッシュ通知を送信するために使用する識別子です。有効なプッシュトークンがなければ、Brazeはそのデバイスにプッシュ通知を送信できません。
Brazeはユーザープロファイルごとに最大20台のデバイスを保存します。21台目のデバイスが登録されると、最も古いデバイスが削除されます（先入れ先出し、FIFO）。SDKでchangeUser()を呼び出すと、現在のデバイスがプロファイルに再登録されます。
プッシュ通知の種類
ターゲットにしているデバイスまたはプラットフォームに合ったプッシュの種類を使用してください。たとえば、Fire TVをターゲットにする場合は、Androidプッシュキャンペーンではなく、Kindleプッシュ通知を使用します。Androidデバイスの場合は、iOSプッシュキャンペーンではなく、Androidプッシュ通知を使用します。
プラットフォーム固有のトラブルシューティングワークフローについては、以下を参照してください。
現在のアプリ
内部ユーザーでプッシュをテストする場合、プッシュ通知を受信させたいユーザーが正しいアプリにサインインしていることを確認してください。そうでない場合、プッシュ通知を受信しなかったり、セグメンテーションに基づいて予期しないプッシュ通知を受信したりする可能性があります。
Androidで画像付きのプッシュメッセージを送信する場合、FCMが画像を破棄し、プッシュメッセージにテキストのみを表示することがあります。この問題は通常、サーバー接続の問題が原因です。
エラー：MismatchSenderID
症状： AndroidプッシュがMismatchSenderIDエラーで失敗します。
MismatchSenderIDは、Firebase Cloud Messaging（FCM）での認証失敗を示します。FirebaseのSender IDとFCM APIキーが正しいことを確認してください。
正しいFirebaseサーバーキーを見つけて置き換えるには：
- アプリのFirebaseコンソールに移動します。
- Project Overviewで、Project Settingsを選択します。
- Cloud Messagingタブで、APIキーとともに表示されているSender IDがBrazeのもの（設定 > アプリ設定 > Cloud Messaging API Key）と一致していることを確認します。
Brazeダッシュボードでは、Sender IDを変更しないでください。変更すると、既存のプッシュ登録が無効になります。Sender IDが一致しない場合は、一致するSender IDを持つFirebaseプロジェクトを見つける必要があります。
- Project credentialsの下にあるServer Keyをコピーします。
- Brazeで、設定 > アプリ設定に移動し、アプリを選択して、サーバーキーをCloud Messaging API Keyフィールドに貼り付けます（古いキーを置き換えます）。
- Saveを選択します。
- 確認するには、APIキーを変更する前と後に、アプリを開かずにデバイスにテストプッシュを送信します。これにより、新しいプッシュ登録ID（プッシュトークン）を生成しなくても、ユーザーが引き続きプッシュ通知を受信できることを確認できます。
トラブルシューティングシナリオ
プッシュ通知の遅延
症状: プッシュ通知が予想より遅れて届きます。
プッシュ通知が遅延する原因として、以下が考えられます。
- デバイスのデータ接続が弱い
- アプリ内のカスタムコードがBrazeのプッシュ通知を抑制している
- デバイスの設定でのプッシュ通知に関するユーザーの設定
- キャンペーンまたはキャンバスで作成されたプッシュのメッセージ優先度
- プッシュサービスプロバイダー（FCMおよびAPNs）のトラフィック遅延や問題
プッシュ通知の送信が予想より遅い
症状: キャンペーンまたはキャンバスのプッシュ送信が、完了するまでに予想以上の時間がかかります。
プッシュ通知の設定が以下のベストプラクティスに従っていることを確認してください。
- プッシュ有効ステータスを考慮せずに大規模なオーディエンスに送信している場合、送信速度が遅くなる可能性があります。代わりに、プッシュ有効なユーザーのみに送信してオーディエンスのサイズを縮小することを検討してください。
- 可能であれば、即時送信ではなく、事前にキャンペーンをスケジュールするようにしてください。
- キャンバスで多数のユーザーにプッシュ通知をターゲティングしている場合、キャンバス内の後続のメッセージステップは、ユーザーに即時送信するキャンペーンとは異なる処理時間を要することが予想されます。この場合、キャンバスの最初の「ステップ」はユーザーが特定のユーザージャーニーに適格かどうかを確認することであるため、通常キャンペーンの方がキャンバスよりも先に送信を完了します。
プッシュ通知をタップしてもアプリが開かない
症状： プッシュ通知をタップしても、アプリが開かない、または設定どおりに遷移しない。
プッシュ通知をタップしてもアプリが開かない場合は、プラットフォームに応じて以下を確認してください。
Android
- クリック時の動作を確認する： キャンペーンがクリック時にアプリを開くように設定されていることを確認します。
- ディープリンクの処理を確認する：
braze.xmlファイルで、com_braze_handle_push_deep_links_automaticallyがtrueに設定されているかfalseに設定されているかを確認します。trueに設定されている場合、Braze SDKがディープリンクを直接処理し、アプリは期待どおりに開きます。falseに設定されている場合、アプリにはプッシュの受信および開封インテントをリッスンして処理するブロードキャストレシーバーが必要です。このレシーバーが正しく実装されていることを確認してください。
- 詳細ログを収集する： 詳細ログを有効にし、問題を再現して、ログと
braze.xmlおよびAndroidManifest.xmlをBrazeサポートに提供してください。
iOS
- クリック時の動作を確認する： キャンペーンがクリック時にアプリを開くように設定されていることを確認します。
- プッシュの統合を確認する： プッシュからアプリへのディープリンクは、Brazeの標準プッシュ統合によって自動的に処理されます。カスタムデリゲートの処理を含め、統合が正しく実装されていることを確認してください。
- 詳細ログを収集する： 詳細ログを有効にし、問題を再現して、ログをBrazeサポートに提供してください。
プッシュのクリックが予期せずアプリ内で開く
症状: プッシュ通知内のリンクが、デバイスのWebブラウザではなくアプリ内で開きます。
プッシュ通知内のリンクがWebブラウザではなく予期せずアプリ内で開く問題が発生している場合、キャンペーンの設定またはSDKの実装に問題がある可能性があります。以下の手順を参照してください。
クリック時の動作を確認する
キャンペーンまたはキャンバスステップで、モバイルアプリ内でWeb URLを開くが選択されていないことを再確認してください。選択されている場合は、選択を解除して再起動してください。
クリック時の動作「Web URLを開く」のデフォルトの動作はSDKバージョンによって異なります。SDKバージョンiOS 2.29.0およびAndroid 2.0.0以降では、このオプションはデフォルトで選択されており、Web URLはアプリ内のWebビューで開きます。これらのバージョンより前では、このオプションはデフォルトで選択解除されており、Web URLはデバイスのデフォルトWebブラウザで開きます。
これが問題でない場合は、プッシュの実装に問題がある可能性があります。
プッシュ統合を再確認する
プッシュ通知内のリンクが予期せずアプリ内で開く場合、プッシュ通知の統合またはカスタマイズ設定に問題がある可能性があります。以下の手順でトラブルシューティングを行ってください。
- プッシュデリゲートの実装を確認する: Brazeプッシュデリゲートが正しく実装されていることを確認します。詳細な手順については、お使いのプラットフォームのプッシュ通知統合ガイドを参照してください。
- カスタムリンク処理を確認する: アプリにすべての
https://リンクに対するカスタム処理が含まれていないか確認します。カスタム設定がデフォルトの動作を上書きしている可能性があります。開発チームと協力して、必要に応じてこれらの設定を確認・調整してください。 - iOSプッシュ登録を確認する: iOSの場合、APNsへのプッシュ通知の登録に関するプッシュ統合ガイドのステップ1を再確認してください。デリゲートオブジェクトがアプリの起動完了前に同期的に割り当てられていることを確認します。このステップは
application:didFinishLaunchingWithOptions:メソッドで完了する必要があります。 - 統合をテストする: 調整を行った後、iOSとAndroidの両方のデバイスでプッシュ通知の動作をテストし、問題が解決されたことを確認してください。
アプリがバックグラウンドで実行中のディープリンク（iOS）
アプリが実行されていないとき、またはリンクを直接使用したときにはディープリンクが機能するが、アプリがすでにバックグラウンドで実行されているときには機能しない場合、アプリがリンクを処理する方法に問題がある可能性があります。メソッドスウィズリングを使用するサードパーティライブラリを使用していないか確認してください。スウィズリングはディープリンクの実装に問題を引き起こす可能性があるため、オフにすることをお勧めします。
.p8認証キーへの移行
症状： iOSプッシュ認証情報をレガシー証明書から.p8キーに移行する必要がある、または認証情報の変更後にプッシュ配信が失敗した。
Appleの.p8認証キーは、BrazeでのAPNsプッシュに必要なアプローチです。レガシーの証明書ファイルタイプとは異なり、.p8キーは有効期限がなく、単一のキーですべてのアプリをサポートするため、年次の証明書更新が不要になり、プッシュ配信の失敗リスクが軽減されます。
現在.p12または.pem証明書を使用している場合は、できるだけ早く.p8キーに移行してください。.p8キーの作成とアップロードの手順については、APNsプッシュ証明書のアップロードを参照してください。Appleの開発者アカウントから.p8キーを生成する方法については、認証トークンを使用したAPNsとの通信を参照してください。
.p8キーと.p12証明書の比較
以下の表で、認証情報の種類、有効期限、およびダッシュボードでの表示を比較できます。
| 認証情報 | 有効期限 | ダッシュボードのステータスインジケーター |
|---|---|---|
.p8認証キー |
有効期限なし | 緑色のステータスインジケーターなし（これは想定どおりです） |
.p12プッシュ証明書 |
毎年有効期限切れ | 証明書が有効な場合は緑色のインジケーター |
.p12証明書を.p8キーに置き換える（または新しい認証情報をアップロードする）と、Brazeが変更を処理する間、プッシュ配信が一時的に停止する場合があります。可能であれば、メンテナンスウィンドウ中に更新を計画してください。
設定 > アプリ設定 > プッシュ通知の設定で、App Bundle ID、Team ID、およびKey ID（.p8キーの場合）がApple Developerアカウントの値と一致していることを確認してください。複数のBrazeワークスペースで、iOSアプリのバンドルIDが同一であれば、同じAppleプッシュ認証情報を使用できます。認証情報の環境（開発と本番）は、アプリのビルド方法と一致する必要があります。
Braze Swift SDK 10.0.0以降のアプリでは、動的APNsゲートウェイ管理を使用して、トークンを正しいAPNs環境に自動的にルーティングできます。
Webプッシュ通知が期待どおりに動作しない
症状： ブラウザーのプッシュ通知が表示されない、またはサイトの権限が固まっているように見えます。
ブラウザーでプッシュ通知に問題が発生している場合は、サイトの通知権限をリセットし、サイトのストレージをクリアする必要がある場合があります。以下の手順を参考にしてください。
デスクトップでChromeをリセットする
- Chromeブラウザーで URL の横にある View Site Information スライダーアイコンを選択します。
- Notifications の下で、Reset permission を選択します。
- Chrome DevToolsを開きます。オペレーティングシステムごとの関連するショートカットは以下のとおりです。
| OS | キーボードショートカット |
|---|---|
| Mac | Fn + F12Ctrl + Shift + I |
| Windows | F12Ctrl + Shift + I |
- DevToolsで、Application タブに移動します。
- サイドバーで Storage を選択します。
- Clear site data を選択します。
- Chromeが更新された設定を適用するためにページの再読み込みを求めます。Reload を選択します。
プッシュ権限がリセットされました。サイトの新しいタブを開いて試してみてください。
AndroidでChromeをリセットする
サイトからの通知がAndroidの通知ドロワーに表示されている場合：
- プッシュ通知から Settings を選択し、Site settings を選択します。
- Site settings から、Clear & Reset をタップします。
サイトからの通知が開いていない場合：
- AndroidでChromeを開きます。
- メニューをタップします。
- Settings > Site Settings > Notifications に移動します。
- 通知が Ask before sending (recommended) に設定されていることを確認します。
- リストからサイトを見つけます。
- エントリを選択し、Clear and Reset をタップします。
プッシュ権限がリセットされました。サイトの新しいタブを開いて試してみてください。
デスクトップでFirefoxをリセットする
- サイトのURLの横にある または を選択します。
- Permissions の下で、Receive Notifications の横にある Clear permission を選択して通知権限をクリアします。
- 同じメニューで、Clear Cookies and Site Data を選択します。
- 選択を確認するダイアログで、OK を選択します。
プッシュ権限がリセットされました。サイトの新しいタブを開いて試してみてください。
AndroidでFirefoxをリセットする
Androidでプッシュ権限をリセットするには、Mozilla SupportのClear your browsing history and other personal dataを参照してください。
macOSでSafariをリセットする
これらの手順はmacOS専用です。AppleはWindows上のSafariではWebプッシュをサポートしていません。
- Safariを開きます。
- Macのメニューバーから、Safari > Settings > Websites > Notifications に移動します。
- リストからサイトを選択します。
- Remove を選択して、サイトの通知権限を削除します。
- 次に、Privacy > Manage Website Data に移動します。
- リストからサイトを選択します。
- Remove を選択するか、すべてのサイトデータを削除するには Remove All を選択します。
- Done を選択します。
プッシュ権限がリセットされました。サイトの新しいタブを開いて試してみてください。
プッシュ開封指標
Brazeは、ユーザーが通知をタップしてアプリがセッションを開始したときに直接開封を記録します。アプリを開かずにリッチプッシュ通知を展開しても、直接開封は記録されません。
ユーザーがプッシュ通知を受信した後、通知をタップせずにアプリを開いた場合、Brazeは代わりに影響を受けた開封を記録することがあります。定義とレポートについては、影響を受けた開封を参照してください。
プッシュエラーメッセージ
症状： 特定のプッシュエラーコード（例：DEVICE_UNREGISTERED、Unregistered、NotRegistered）が表示されます。
一般的なプッシュエラーコード（DEVICE_UNREGISTERED、NotRegistered、Unregisteredなど）の定義については、一般的なプッシュエラーメッセージを参照してください。
FCMがDEVICE_UNREGISTEREDやNotRegisteredなどのエラーを返した場合、Brazeは通常、影響を受けたプッシュトークンをユーザープロファイルから削除します。この削除は、アプリがアンインストールされたか、トークンが無効になったことを示す場合が多いです。アンインストール追跡キャンペーンは、同じトークン削除ロジックを大規模に使用します。