Skip to content

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

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

プッシュ通知が届かない

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

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

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

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のワークフローの詳細については、以下の記事を参照してください。

現在のアプリ

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

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

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

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を開きます。以下はオペレーティングシステムごとの関連するショートカットです。
  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!