よくある質問
この記事では、プッシュチャネルに関するよくある質問への回答を提供します。
1つのデバイスに複数のユーザーがログインするとどうなりますか？
ユーザーがデバイスまたはWebサイトからログアウトしても、別のユーザーがログインするまでプッシュで到達可能な状態が続きます。別のユーザーがログインした時点で、プッシュトークンは新しいユーザーに再割り当てされます。これは、各デバイスがアプリまたはWebサイトごとに1つのアクティブなプッシュサブスクリプションしか持てないためです。
プッシュトークンが再割り当てされると、その変更はユーザープロファイルのプッシュ変更ログに反映されます。ユーザープロファイルのエンゲージメントタブに移動すると確認できます。
テストプッシュを送信すると、すべてのデバイスに届きますか？
はい。テストプッシュは、選択したユーザープロファイルに関連付けられたプッシュ有効なすべてのデバイスに送信されます。同じユーザーで複数のスマートフォンやタブレットにログインしている場合、有効なプッシュトークンを持つ各デバイスが通知を受信します。
テストプッシュを1つのデバイスにのみ送信するには、テスト前にユーザープロファイルから他のデバイスのプッシュトークンを削除します。または、/messages/send エンドポイントで送信する場合は、apple_pushまたはandroid_pushオブジェクトでsend_to_most_recent_device_onlyをtrueに設定すると、最も最近アクティブだったデバイスのみがプッシュを受信します。
「ペイロードが無効なためプッシュの送信エラー」とはどういう意味ですか？
このメッセージは、無効なペイロード（例：空のペイロードやサイズが大きすぎるペイロード）が原因で、APNsがプッシュリクエストを拒否したことを示しています。
詳細と次のステップについては、一般的なプッシュエラーメッセージを参照してください。
オプトインしたユーザーにプッシュトークンがないのはなぜですか？
これは、同じデバイスを使用した別のユーザーにプッシュトークンが再割り当てされた場合に発生することがあります。
- 該当するユーザーのプロファイルのエンゲージメントタブにあるプッシュ変更ログに移動します。
- プッシュトークンが別のユーザーに移動されたというメッセージを探します。
- プッシュトークンをコピーしてユーザー検索バーに貼り付けます。
- プッシュトークンがまだ存在する場合、そのデバイスで最も最近ログインしたユーザーに移動します。
プッシュトークンを元のユーザーに再割り当てしたい場合：
- プッシュトークンが欠落しているプロファイルに元のユーザーをログインさせます。
- 新しいプッシュ送信をトリガーします。デバイスレベルでプッシュが有効になっている場合、トークンがそのアカウントに戻されます。
下書きCampaignのテスト時に「モバイルアプリ内でWeb URLを開く」が常にアプリを開くのはなぜですか？
Campaignがまだ下書きステータスの場合、テストプッシュを送信して通知をタップすると、モバイルアプリ内でWeb URLを開くオプションが選択されているかどうかに関係なく、常にアプリが最初に開きます。Campaignがライブの場合、クリック時の動作は設定どおりに機能します。
アプリ内オプションなしでWeb URLを開くを選択した場合、リンクはデバイスのデフォルトブラウザで直接開きます。モバイルアプリ内でWeb URLを開くを選択した場合、リンクはアプリ内Webビューで開きます。
iOSプッシュ証明書の「Send to Production」と「Send to Development」の違いは何ですか？
BrazeでAppleプッシュ証明書を追加する際、Send to ProductionとSend to Developmentのオプションは、Brazeがプッシュ通知を配信するために使用するAPNs（Apple Push Notification service）ゲートウェイを決定します。
- Send to Development： Xcodeで開発モードでビルドされ、開発プロビジョニングプロファイルで署名されたアプリの場合に選択します。プッシュ通知はAppleの開発（サンドボックス）ゲートウェイを通じてルーティングされます。
- Send to Production： AppleのTestFlight、App Store、またはエンタープライズ配布を通じて配布されるアプリの場合に選択します。プッシュ通知はAppleの本番ゲートウェイを通じてルーティングされます。
間違ったオプションを選択すると、プッシュトークンの種類がゲートウェイと一致しないため、プッシュ通知がサイレントに失敗します。通常、TestFlightまたはApp Storeを通じて配布されるアプリはSend to Productionを使用する必要があります。
「Foreground Push Enabled」フィルターと「Background or Foreground Push Enabled」フィルターの違いは何ですか？
これらのセグメンテーションフィルターは、異なる条件をチェックします。
| フィルター | チェック内容 | ユースケース |
|---|---|---|
| Foreground Push Enabled | ユーザーが有効なフォアグラウンドプッシュトークンを持ち、かつプッシュサブスクリプション状態がOpted-InまたはSubscribedである。 |
可視プッシュ通知を受信できるユーザーをターゲットにします。 |
| Background or Foreground Push Enabled | ユーザーがいずれかのプッシュトークン（フォアグラウンドまたはバックグラウンド）を持ち、かつプッシュサブスクリプション状態がOpted-InまたはSubscribedである。これには、可視プッシュ通知を無効にしているがバックグラウンドプッシュトークンを保持しているユーザーも含まれます。 |
アンインストール追跡、サイレントプッシュ通知、およびジオフェンシングに使用されます。 |
ユーザーはForeground Push EnabledでなくてもBackground or Foreground Push Enabledになることがあります。これは、ユーザーがデバイス設定で可視プッシュ通知を無効にしているが、アプリがバックグラウンドプッシュトークンを保持している場合に発生します。詳細については、プッシュユーザーとサブスクリプションを参照してください。
Brazeはプッシュメッセージがいつ正常に送信されたかをどのように判断しますか？
メッセージは、プッシュサービスプロバイダーによって受信された時点で送信済みとして記録されます。これは、ユーザーがメッセージを受信または閲覧したことを必ずしも意味するものではありません。
iOSの場合、プッシュサービスプロバイダーはApple Push Notification Service（APNs）であり、Androidの場合は通常Firebase Cloud Messaging（FCM）です。プッシュサービスプロバイダーは即座に成功または失敗を返します。失敗にはバウンスやネットワーク障害による再試行が含まれる場合があります。
成功メッセージが返された場合、送信はBrazeによって記録され、その後プッシュサービスがデバイスへの配信を試みます。デバイスにすぐに到達できない場合、サービスはBrazeで設定された有効期限オプション（Androidの場合はTTL、iOSの場合は有効期限）まで再試行します。メッセージがタイムアウトした場合、プッシュサービスはプッシュを破棄しますが、バウンスとはみなされません。
- アクションベースの配信プッシュCampaignの場合、メッセージ送信はユーザーがCampaignをトリガーするアクションを実行した時点で記録されます。
- スケジュールされたCampaignの場合、送信時間はメッセージがキューに入れられ、プッシュサービスプロバイダーに渡された時間です。
- どちらの配信タイプでも、ユーザーがまだプッシュを閲覧または受信していなくても、メッセージはBrazeおよびユーザープロファイルの受信したCampaignで「送信済み」としてマークされます。
ダッシュボードのプッシュの「配信」指標は、ページ読み込み時に送信数からバウンス数を差し引いた値として計算されます。