一般的なプッシュエラーメッセージ

ペイロードが無効なためプッシュ送信エラーが発生

このメッセージは、Apple Push Notification service（APNs）が無効なペイロードを理由にプッシュリクエストを拒否した場合に、ユーザープロファイルのエンゲージメントタブの連絡先設定 > プッシュ変更ログに表示されることがあります。

Brazeでは、このダッシュボードメッセージは次のAPNsエラー理由のいずれかに該当する可能性があります。

• PayloadEmpty：送信されたプッシュの種類に必要なコンテンツがペイロードに含まれていませんでした。
• PayloadTooLarge：ペイロードがAPNsの最大ペイロードサイズを超えました。

一般的な原因には以下が含まれます。

• カスタムキー（とその値）がペイロードを過大にしている（これには予想外に大きなLiquidレンダリング値が含まれる場合があります）。
• 必要な箇所でアラートや本文が空または欠落している（あるいはその他の不正なapsペイロード）。

次のステップ：

• カスタムキーを削減し、大きなダイナミックな値を短縮することでペイロードサイズを削減します。
• API経由で送信する場合、送信前に最終的なJSONペイロード（サイズを含む）を検証してください。

プッシュバウンス: BadToken

BadToken エラーはいくつかの理由で発生する可能性があります。

• プッシュトークンがBrazeに正しく送信されていない（例えば、registerDeviceToken: またはプラットフォームの同等のメソッドで）。
  • メッセージアクティビティログのトークンを確認してください。通常は、文字と数字の長い文字列のように見えます（例：6e407a9be8d07f0cdeb9e714733a89445f57a89ec890d63867c482a483506fa6）。そうでない場合は、Brazeにプッシュトークンを送信するコードを確認してください。
    
    
• プロビジョニング環境の不一致：
  • 開発用の証明書で登録し、本番用の証明書で送信しようとすると、このエラーが表示されることがあります。
  • Brazeは、本番環境のユニバーサル証明書のみをサポートしています。ユニバーサル証明書を使用した開発環境でのプッシュテストは機能しません。
  • このレポートは、本番環境ではバウンスを送信しますが、開発環境では送信しません。
    
    
• プロビジョニングプロファイルの不一致：
  • この問題は、証明書がトークンの取得に使用された証明書と一致しない場合に発生する可能性があります。これが疑われる場合、次のステップは以下のとおりです。
    • Brazeダッシュボードからのプッシュ送信に使用するプッシュ証明書とプロビジョニングプロファイルが正しく設定されていることを確認します。
    • APNS証明書を再作成し、APNS証明書がapp_idに設定された後にプロビジョニングプロファイルを再作成します。これによって、より目に見える問題が解決されることがあります。

バンドルIDが許可されていない

TopicDisallowed エラーは、リクエスト内のトピック（バンドルID）が使用されている認証情報で許可されていないため、APNsがプッシュを拒否したことを意味します。これを解決するには：

1. バンドルIDを確認します。 Brazeのアプリ設定で構成されているバンドルIDが、アプリのバンドルIDと正確に一致していることを確認してください。これには、サフィックスのバリエーション（例：.debug、.staging）も含まれます。
2. APNs認証設定を確認します。 アプリが正しいAPNs .p8キーで構成されていること、およびそのキーが送信先のアプリと同じApple Developer Teamに関連付けられていることを確認してください。
3. アプリ環境を確認します。 開発ビルドと本番ビルドでBrazeに別々のアプリIDがある場合、それぞれが正しいプッシュ認証情報と環境で構成されていることを確認してください。

Unregistered

このエラーはメッセージアクティビティログに次のように表示されます。

Received 'Unregistered' sending to '[Token String]'

これはAndroidのDEVICE_UNREGISTEREDエラーのiOS版です。通常、以下のいずれかの理由で発生します。

• ユーザーがアプリをアンインストールした場合。これが最も一般的な原因です。
• プッシュ証明書が更新された場合。チームがAPNs証明書を変更または更新した場合、以前の証明書で登録したユーザーは、アプリが再登録するまで無効なトークンを持つ可能性があります。
• カスタムロジックがユーザーのプッシュ登録を解除している場合。これはまれですが、iOS SDKを使用してプログラムでリモート通知の登録を解除することは技術的に可能です。

InvalidProviderToken

InvalidProviderToken エラーは、認証トークン（.p8キーから）またはプッシュ証明書（.p12）がアプリのバンドルIDまたはチームIDと一致しないため、APNsがリクエストを拒否したことを意味します。これを解決するには：

1. チームIDとキーIDを確認します。 .p8認証キーを使用している場合、Brazeダッシュボード（設定 > アプリ設定 > iOSアプリを選択）で構成されているチームIDとキーIDが、Apple Developerアカウントの値と一致していることを確認してください。
2. バンドルIDを確認します。 Brazeに登録されているバンドルIDがアプリのバンドルIDと一致していることを確認してください。大文字小文字の違いや.debugサフィックスなどの不一致がこのエラーの原因となります。
3. キーまたは証明書を再アップロードします。 .p8キーまたは.p12証明書が最近再生成または失効された場合、新しいキーをBrazeにアップロードし、古いものを削除してください。
4. APNs環境を確認します。 .p12証明書を使用している場合、アップロード時に正しい環境（開発と本番）を選択したことを確認してください。.p8キーの場合、これは自動的に処理されます。

プッシュバウンス: APNSフィードバックサービスによる削除

これは通常、ユーザーがアプリをアンインストールしたときに発生します。Brazeは毎晩APNSフィードバックサービスに問い合わせ、無効なトークンのリストを取得します。詳細については、Appleの「Communicating with APNs」を参照してください。