Skip to content

プッシュ通知のトラブルシューティング

このページでは、プッシュ通知メッセージングチャネルに関する問題のトラブルシューティングを行います。

プッシュ通知が届かない

プッシュ通知の配信に問題がありますか？以下の項目を確認することで、この問題をトラブルシューティングできます。

プッシュサブスクリプションステータス

プッシュ通知は、購読中またはオプトインしたユーザーにのみ送信できます。ユーザープロファイルセクションのエンゲージメントタブでユーザープロファイルを確認し、テスト対象のワークスペースでプッシュ通知に登録されているかどうかを確認してください。複数のアプリに登録している場合は、Push Registered Forフィールドに一覧表示されます。

プッシュ通知の登録先

Brazeのエクスポートエンドポイントを使用してユーザープロファイルをエクスポートすることもできます。

いずれのエンドポイントも、デバイスごとのプッシュ有効化情報を含むプッシュトークンオブジェクトを返します。

Segment

ターゲットにしているSegmentに自分が含まれていることを確認してください（ライブCampaignの場合、テストではない場合）。ユーザープロファイルには、ユーザーが現在含まれているSegmentの一覧が表示されます。セグメンテーションはリアルタイムで更新されるため、これは常に変化する変数であることに注意してください。

Segmentの一覧

Segmentを作成する際にユーザー検索を使用して、ユーザーがそのSegmentに含まれていることを確認することもできます。

検索フィールドを含むユーザー検索セクション。

プッシュ通知キャップ

グローバルフリークエンシーキャップを確認してください。ワークスペースにグローバルフリークエンシーキャップが設定されており、指定された期間のプッシュ通知キャップにすでに達しているため、プッシュ通知を受信できなかった可能性があります。

ダッシュボードでグローバルフリークエンシーキャップを確認することで、これを確認できます。Campaignがフリークエンシーキャップルールに従うように設定されている場合、これらの設定の影響を受けるユーザーが存在します。

Campaignの詳細

レート制限

CampaignまたはCanvasにレート制限が設定されている場合、この制限を超えたためにメッセージを受信できなくなっている可能性があります。詳細については、レート制限を参照してください。

コントロールグループのステータス

単一チャネルのCampaignまたはコントロールグループを含むCanvasの場合、コントロールグループに入っている可能性があります。

  1. バリアント配分を確認して、コントロールグループがあるかどうかを確認します。
  2. コントロールグループがある場合は、Campaignコントロールグループ内でフィルタリングするSegmentを作成し、Segmentをエクスポートして、自分のユーザーIDがこのリストに含まれているかどうかを確認します。

有効なプッシュトークン

プッシュトークンは、送信者が特定のデバイスにプッシュ通知を送信するために使用する識別子です。そのため、デバイスに有効なプッシュトークンがない場合、プッシュ通知を送信する方法はありません。

プッシュ通知の種類

正しい種類のプッシュ通知を使用しているか確認してください。たとえば、FireTVをターゲットにする場合は、Androidプッシュ通知ではなくKindleプッシュ通知を使用します。同様に、Androidをターゲットにする場合は、iOSプッシュ通知ではなくAndroidプッシュ通知を使用します。Brazeのワークフローの詳細については、以下の記事を参照してください。

現在のアプリ

内部ユーザーでプッシュ送信をテストする場合、プッシュ通知を受信させたいユーザーが現在関連するアプリにログインしていることを確認してください。これにより、ユーザーがプッシュ通知を受信しなかったり、セグメンテーション対象外と思われるプッシュ通知を受信したりする可能性があります。

エラー: MismatchSenderID

MismatchSenderIDは、Firebase Cloud Messaging（FCM）での認証エラーを示します。Firebase送信者IDとFCM APIキーが正しいことを確認してください。

正しいFirebaseサーバーキーを見つけて置き換えるには:

  1. アプリのFirebaseコンソールに移動します。
  2. Project Overviewの下で、Project Settingsを選択します。
  3. Cloud Messagingタブで、APIキーの下にある送信者IDがBraze（設定 > アプリ設定 > Cloud Messaging API Key）のものと一致していることを確認します。
  1. Project credentialsの下にあるServer Keyをコピーします。
  2. Brazeで、設定 > アプリ設定に移動し、アプリを選択して、サーバーキーをCloud Messaging API Keyフィールドに貼り付けます（古いキーを置き換えます）。
  3. Saveを選択します。
  4. 確認のため、APIキーを変更する前後に、アプリを開かずにデバイスにテストプッシュを送信します。これにより、新しいプッシュ登録ID（プッシュトークン）を生成する必要なく、ユーザーが引き続きプッシュ通知を受信できることを確認できます。

トラブルシューティングシナリオ

プッシュ通知の遅延

プッシュ通知は以下の理由で遅延する可能性があります。

  • デバイスのデータ接続が弱い
  • Brazeのプッシュ通知を抑制するアプリ内のカスタムコード
  • デバイスの設定でのプッシュ通知に関するユーザーの設定
  • CampaignまたはCanvasで作成されたプッシュのメッセージ優先度
  • プッシュサービスプロバイダー（FCMおよびAPNs）のトラフィック遅延または問題

プッシュ通知の送信が予想より遅い

プッシュ通知の設定が以下のベストプラクティスに従っていることを確認してください。

  • プッシュ有効ステータスを考慮せずに大規模なオーディエンスに送信している場合、送信速度が遅くなる可能性があります。代わりに、プッシュ有効なユーザーのみに送信してオーディエンスのサイズを縮小することを検討してください。
  • 可能であれば、即時送信ではなく事前にCampaignsをスケジュールしてください。
  • Canvasで多数のユーザーにプッシュ通知をターゲットにしている場合、Canvas内の後続のメッセージステップは、ユーザーに即時送信するCampaignとは異なる処理時間を必要とすることが予想されます。この場合、Campaignsは通常Canvasよりも先に送信を完了します。Canvasの最初の「ステップ」は、ユーザーが特定のユーザージャーニーに適格かどうかを確認することだからです。

プッシュ通知をタップしてもアプリが開かない

プッシュ通知をタップしてもアプリが開かない場合は、プラットフォームに応じて以下を確認してください。

Android

  1. クリック時の動作を確認する: Campaignがクリック時にアプリを開くように設定されていることを確認します。
  2. ディープリンクの処理を確認する: braze.xmlファイルで、com_braze_handle_push_deep_links_automaticallyがtrueまたはfalseに設定されているか確認します。
    • trueに設定されている場合、Braze SDKがディープリンクを直接処理し、アプリは期待どおりに開くはずです。
    • falseに設定されている場合、アプリにはプッシュ受信およびオープンインテントをリッスンして処理するブロードキャストレシーバーが必要です。このレシーバーが正しく実装されていることを確認してください。
  3. 詳細ログを収集する: 詳細ログを有効にし、問題を再現して、ログとbraze.xmlおよびAndroidManifest.xmlをBrazeサポートに提供してください。

iOS

  1. クリック時の動作を確認する: Campaignがクリック時にアプリを開くように設定されていることを確認します。
  2. プッシュ統合を確認する: プッシュからアプリへのディープリンクは、Brazeの標準プッシュ統合によって自動的に処理されます。カスタムデリゲート処理を含め、統合が正しく実装されていることを確認してください。
  3. 詳細ログを収集する: 詳細ログを有効にし、問題を再現して、ログをBrazeサポートに提供してください。

プッシュのクリックが予期せずアプリ内で開く

プッシュ通知内のリンクがWebブラウザではなく予期せずアプリ内で開く問題が発生している場合、Campaignの設定またはSDKの実装に問題がある可能性があります。以下の手順を参照してください。

クリック時の動作を確認する

CampaignまたはCanvasステップで、モバイルアプリ内でWeb URLを開くが選択されていないことを再確認してください。選択されている場合は、選択を解除して再起動してください。

「クリック時の動作」フィールドで「Web URLを開く」に設定され、「モバイルアプリ内でWeb URLを開く」のチェックが外されているプッシュ設定。

クリック時の動作「Web URLを開く」のデフォルトの動作はSDKバージョンによって異なります。SDKバージョンiOS 2.29.0およびAndroid 2.0.0以降では、このオプションはデフォルトで選択されており、Web URLはアプリ内のWebビューで開きます。これらのバージョンより前では、このオプションはデフォルトで選択解除されており、Web URLはデバイスのデフォルトWebブラウザで開きます。

これが問題でない場合は、プッシュの実装に問題がある可能性があります。

プッシュ統合を再確認する

プッシュ通知内のリンクが予期せずアプリ内で開く場合、プッシュ通知の統合またはカスタマイズ設定に問題がある可能性があります。以下の手順でトラブルシューティングを行ってください。

  1. プッシュデリゲートの実装を確認する: Brazeプッシュデリゲートが正しく実装されていることを確認します。詳細な手順については、お使いのプラットフォームのプッシュ通知統合ガイドを参照してください。
  2. カスタムリンク処理を確認する: アプリにすべてのhttps://リンクに対するカスタム処理が含まれていないか確認します。カスタム設定がデフォルトの動作を上書きしている可能性があります。開発チームと協力して、必要に応じてこれらの設定を確認・調整してください。
  3. iOSプッシュ登録を確認する: iOSの場合、APNsへのプッシュ通知の登録に関するプッシュ統合ガイドのステップ1を再確認してください。デリゲートオブジェクトがアプリの起動完了前に同期的に割り当てられていることを確認します。このステップはapplication:didFinishLaunchingWithOptions:メソッドで完了する必要があります。
  4. 統合をテストする: 調整を行った後、iOSとAndroidの両方のデバイスでプッシュ通知の動作をテストし、問題が解決されたことを確認してください。

アプリが実行されていないとき、またはリンクを直接使用したときにはディープリンクが機能するが、アプリがすでにバックグラウンドで実行されているときには機能しない場合、アプリがリンクを処理する方法に問題がある可能性があります。メソッドスウィズリングを使用するサードパーティライブラリを使用していないか確認してください。スウィズリングはディープリンクの実装に問題を引き起こす可能性があるため、オフにすることをお勧めします。

.p8認証キーへの移行

Appleの.p8認証キーは、BrazeでのAPNsプッシュに必要なアプローチです。レガシーの証明書ファイルタイプとは異なり、.p8キーは有効期限がなく、単一のキーですべてのアプリをサポートするため、年次の証明書更新が不要になり、プッシュ配信の失敗リスクが軽減されます。

現在.p12または.pem証明書を使用している場合は、できるだけ早く.p8キーに移行してください。.p8キーの作成とアップロードの手順については、APNsプッシュ証明書のアップロードを参照してください。Appleの開発者アカウントから.p8キーを生成する方法については、認証トークンを使用したAPNsとの通信を参照してください。

Webプッシュ通知が期待どおりに動作しない

ブラウザでプッシュ通知に問題が発生している場合は、サイトの通知権限をリセットし、サイトのストレージをクリアする必要がある場合があります。以下の手順を参照してください。

デスクトップでChromeをリセットする

  1. ChromeブラウザのURLの横にあるサイト情報を表示スライダーアイコンを選択します。
  2. 通知の下で、権限をリセットを選択します。
  3. Chrome DevToolsを開きます。以下はオペレーティングシステムごとの関連するショートカットです。
OS キーボードショートカット
Mac Fn + F12
Ctrl + Shift + I
Windows F12
Ctrl + Shift + I
  1. DevToolsで、Applicationタブに移動します。
  2. サイドバーでStorageを選択します。
  3. Clear site dataを選択します。
  4. Chromeが更新された設定を適用するためにページの再読み込みを求めます。Reloadを選択します。

プッシュ権限がリセットされました。サイトの新しいタブを開いて試してみてください。

AndroidでChromeをリセットする

サイトからの通知がAndroidの通知ドロワーに表示されている場合:

  1. プッシュ通知からをタップし、Site settingsを選択します。
  2. Site settingsからClear & Resetをタップします。

サイトからの通知が開いていない場合:

  1. AndroidでChromeを開きます。
  2. メニューをタップします。
  3. Settings > Site Settings > Notificationsに移動します。
  4. 通知がAsk before sending (recommended)に設定されていることを確認します。
  5. リストからサイトを見つけます。
  6. エントリを選択し、Clear and Resetをタップします。

プッシュ権限がリセットされました。サイトの新しいタブを開いて試してみてください。

デスクトップでFirefoxをリセットする

  1. サイトのURLの横にあるまたはを選択します。
  2. 権限の下で、通知を受信の横にあるを選択して通知権限をクリアします。
  3. 同じメニューで、Cookieとサイトデータを消去を選択します。
  4. 確認ダイアログでOKを選択します。

プッシュ権限がリセットされました。サイトの新しいタブを開いて試してみてください。

AndroidでFirefoxをリセットする

Androidでプッシュ権限をリセットするには、このMozillaサポート記事を参照してください。

macOSでSafariをリセットする

  1. Safariを開きます。
  2. Macのメニューバーから、Safari > 設定 > Webサイト > 通知に移動します。
  3. リストからサイトを選択します。
  4. 削除を選択して、サイトの通知権限を削除します。
  5. 次に、プライバシー > Webサイトデータを管理に移動します。
  6. リストからサイトを選択します。
  7. 削除を選択するか、すべてのサイトデータを削除するにはすべてを削除を選択します。
  8. 完了を選択します。

プッシュ権限がリセットされました。サイトの新しいタブを開いて試してみてください。

プッシュエラーメッセージ

一般的なプッシュエラーメッセージ（DEVICE_UNREGISTERED、Unregistered、NotRegisteredなど）の詳細については、一般的なプッシュエラーメッセージを参照してください。

さらにサポートが必要ですか？サポートチケットを開いてください。
New Stuff!