トラブルシューティング
このページは、Pushメッセージングチャネルで発生する可能性のあるさまざまな問題のトラブルシューティングに役立つ。
プッシュ通知を受信しない
プッシュ通知での配信に課題を感じているか?以下の点を確認してこの問題のトラブルシューティングを行うためのステップがいくつかあります。
プッシュ通知のサブスクリプションのステータス
プッシュ通知は、登録済みユーザーまたはオプトインしたユーザーにのみ送信できます。ユーザープロファイル[]セクションの[エンゲージメント]](/docs/ja/user_guide/engagement_tools/segments/using_user_search/#engagement-tab)タブでユーザープロファイルを確認し、テスト対象のワークスペースでアクティブにプッシュ登録されているかどうかを確認する。複数のアプリに登録している場合は、「Push Registered For」フィールドにリストアップされる:

Brazeエクスポートエンドポイントを使用してユーザープロファイルをエクスポートすることもできる:
どちらのエンドポイントも、デバイスごとのプッシュ有効化情報を含むプッシュトークンオブジェクトを返す。
セグメント
テストではなく本番のキャンペーンの場合)ターゲットにしているセグメントに該当することを確認する。ユーザープロフィールでは、ユーザーが現在属しているセグメントのリストが表示される。セグメンテーションはリアルタイムで更新されるため、これは常に変化する変数であることに注意してください。
![セグメント一覧]](/docs/ja/assets/img_archive/trouble2.png?b79bfc1b3d07082f048b5d2343ab63f7)
また、セグメンテーションを作成する際に、User Lookupを使用することで、ユーザーがセグメンテーションの一部であることを確認することができる。

プッシュ通知上限
グローバル周波数の上限を確認します。ワークスペースにグローバル頻度上限が設定されており、指定された時間枠のプッシュ通知上限をすでに超えているため、プッシュ通知を受け取れなかった可能性がある。
このためには、ダッシュボードでグローバルフリークエンシーキャップを確認します。キャンペーンがフリークエンシー・キャッピング・ルールに従うように設定されている場合、これらの設定によって影響を受けるユーザーが多数存在する。
![キャンペーン内容]](/docs/ja/assets/img_archive/trouble3.png?2da7b998d84ba2c094988dfd2606da8f)
レート制限
キャンペーンまたはキャンバスにレート制限が設定されている場合、この制限を超過したためにメッセージングを受信できなくなる可能性があります。詳細については、「レート制限」を参照してください。
コントロールグループステータス
これが単一チャンネルのキャンペーンや、コントロールグループのあるキャンバスであれば、コントロールグループに属している可能性がある。
- バリアントの分布をチェックして、コントロールグループがあるかどうかを確認します。
- もしそうであれば、キャンペーンコントロールグループでフィルターするセグメントを作成し、セグメントをエクスポートして、ユーザーIDがこのリストにあるかどうかをチェックする。
有効なプッシュトークン
プッシュトークンは、送信者がプッシュ通知を持つ特定の機器を対象にするために使用する識別子です。つまり、デバイスが有効なプッシュトークンを持っていなければ、そのデバイスにプッシュ通知を送ることはできない。
プッシュ通知タイプ
正しい種類のプッシュ通知を使用しているか確認する。例えば、FireTVをターゲットにしたい場合は、Androidのプッシュ・キャンペーンではなく、Kindleのプッシュ通知を使うことになる。同様に、Android をターゲットにする場合は、iOS のプッシュキャンペーンではなく、Android のプッシュ通知を使用します。Brazeのワークフローを理解するための詳細については、以下の記事をチェックしてほしい:
現在のアプリ
内部ユーザーでプッシュ通知をテストする場合、プッシュ通知を受け取りたいユーザーが現在該当アプリにログインしていることを確認する。これが原因で、ユーザーがプッシュを受け取らないか、またはセグメンテーション対象ではないと思われるプッシュを受け取ることがあります。
アプリで予期しない開封を押します
プッシュ通知のリンクが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の場合は、APNにプッシュ通知を登録するプッシュ統合ガイドのステップ1を再確認する。アプリの起動が完了する前に、デリゲートオブジェクトが同期的に割り当てられるようにします。このステップは
application:didFinishLaunchingWithOptions:メソッドで完了する必要があります。 - **連携をテストする: **調整後、iOSとAndroidの両方のデバイスでプッシュ通知の動作をテストし、問題が解決したことを確認する。
Web プッシュ通知が期待どおりに動作しない
ブラウザーでプッシュ通知の問題が発生した場合は、サイトの通知権限をリセットし、サイトのストレージをクリアする必要がある場合があります。サポートが必要な場合は、以下のステップを参照してください。
デスクトップのChrome をリセットする
- Chrome ブラウザのURL の横にあるView Site Information スライダアイコンを選択します。
- Notificationsの下で、Reset permissionを選択します。
- Chrome DevTools を開きます。オペレーティングシステムごとの関連するショートカットは次のとおりです。
| OS | キーボードショートカット |
|---|---|
| Mac | Fn + F12Ctrl + Shift + I |
| Windows | F12Ctrl + Shift + I |
4.DevTools で、Application タブに移動します。
- サイドバーで、Storage を選択します。
- サイトデータクリアを選択します。
- 更新された設定を適用するために、Chrome でページの再読み込みを求められます。Re 読み込むを選択します。
プッシュ権限がリセットされます。サイトに新しいタブを開き、試してみてください。
Android で Chrome をリセットする
Android 通知ドロワーにサイトからの通知が表示されている場合:
- プッシュ通知からをタップし、Site 設定sを選択します。
- サイト設定sから、クリア&リセットをタップします。
サイトからの通知が開かれていない場合:
- Android で Chrome を開きます。
- メニューをタップします。
- [設定] > [サイトの設定] > [通知] に移動します。
- 通知s が送信前に確認(推奨)に設定されていることを確認します。
- リストでサイトを見つけます。
- エントリを選択し、[クリアしてリセット] をタップします。
プッシュ権限がリセットされます。サイトに新しいタブを開き、試してみてください。
デスクトップのFirefox をリセットする
- サイトURL の横にある または を選択します。
- [権限] で、[通知を受信] の横にある [] を選択して通知権限をクリアします。
- 同じメニューで、Clear Cookies and Site Dataを選択します。
- 選択を確認するダイアログで、OKを選択します。
プッシュ権限がリセットされます。サイトに新しいタブを開き、試してみてください。
Android時にFirefox を初期化する
Androidのプッシュ権限を再設定するには、このMozilla サポート記事 を参照してください。
macOS での Safari のリセット
これらのステップはmacOS 専用です。Apple は、Windows ではWeb Push for Safari に対応していません。
- Safari を開きます。
- Macのメニューバーから、Safari> 設定> Webサイト> 通知に進みます。
- リストからサイトを選択します。
- Removeを選択すると、サイトの通知権限が削除されます。
- 次に、[プライバシー] > [Web サイトデータを管理] に移動します。
- リストからサイトを選択します。
- Removeを選択するか、すべてのサイトデータを削除するには、Remove Allを選択します。
- [完了] を選択します。
プッシュ権限がリセットされます。サイトに新しいタブを開き、試してみてください。
サポートが必要な場合は、サポートチケットをを登録してください。
GitHub でこのページを編集