Skip to content

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

このページを使って、プッシュメッセージングチャネルの問題をトラブルシューティングできます。

プッシュ通知を受信しない

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

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

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

登録済みのプッシュ通知

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

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

セグメント

ターゲットにしているセグメントに該当することを確認します（テストではなく本番のキャンペーンの場合）。ユーザープロファイルでは、ユーザーが現在属しているセグメントのリストが表示されます。セグメンテーションはリアルタイムで更新されるため、これは常に変化する変数であることに注意してください。

セグメント一覧

また、セグメントを作成する際にUser Lookupを使用することで、ユーザーがセグメントに含まれていることを確認することもできます。

検索フィールドを備えたユーザー検索セクション。

プッシュ通知上限

グローバルフリークエンシーキャップを確認します。ワークスペースにグローバルフリークエンシーキャップが設定されており、指定された時間枠のプッシュ通知上限をすでに超えているため、プッシュ通知を受け取れなかった可能性があります。

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

キャンペーン詳細

レート制限

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

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

これが単一チャネルのキャンペーンや、コントロールグループのあるキャンバスであれば、コントロールグループに属している可能性があります。

  1. バリアントの分布を確認して、コントロールグループがあるかどうかを確認します。
  2. コントロールグループがある場合は、キャンペーンコントロールグループでフィルターするセグメントを作成し、セグメントをエクスポートして、ユーザー ID がこのリストにあるかどうかを確認します。

有効なプッシュトークン

プッシュトークンは、送信者がプッシュ通知で特定のデバイスをターゲットにするために使用する識別子です。つまり、デバイスが有効なプッシュトークンを持っていなければ、そのデバイスにプッシュ通知を送ることはできません。

プッシュ通知タイプ

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

現在のアプリ

内部ユーザーでプッシュ送信をテストする場合、プッシュ通知を受け取りたいユーザーが現在該当アプリにログインしていることを確認してください。これが原因で、ユーザーがプッシュを受け取らなかったり、セグメント対象ではないと思われるプッシュを受け取ったりすることがあります。

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

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

Android

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

iOS

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

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

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

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

キャンペーンまたはキャンバスステップで、[モバイルアプリ内で 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 キーを生成する方法については、Apple のガイダンス「Communicate with APNs using authentication tokens」を参照してください。

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

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

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

  1. Chrome ブラウザで URL の横にある「サイト情報を表示」のスライダーアイコンを選択します。
  2. 通知の設定で、権限のリセットを選択します。
  3. Chrome DevTools を開きます。オペレーティングシステムごとの関連するショートカットは次のとおりです。
  1. DevTools で、Application タブに移動します。
  2. サイドバーで、Storage を選択します。
  3. サイトデータを消去するを選択します。
  4. 更新された設定を適用するために、Chrome でページの再読み込みを求められます。再読み込みを選択します。

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

Android で Chrome をリセットする

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

  1. プッシュ通知からをタップし、サイトの設定を選択します。
  2. サイトの設定から、クリアしてリセットをタップします。

サイトからの通知が表示されていない場合:

  1. Android で Chrome を開きます。
  2. メニューをタップします。
  3. [設定] > [サイトの設定] > [通知] に移動します。
  4. 通知が送信前に確認する（推奨）に設定されていることを確認します。
  5. リストでサイトを見つけます。
  6. エントリを選択し、[クリアしてリセット] をタップします。

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

デスクトップの 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 など）の詳細については、「一般的なプッシュエラーメッセージ」を参照してください。

さらにサポートが必要な場合は、サポートチケットを登録してください。
Github   GitHub でこのページを編集
New Stuff!