プッシュサブスクリプションの状態について
プッシュ通知のサブスクリプションの状態{#push-sub-states}
Brazeの 「プッシュ通知のサブスクリプションの状態」は、プッシュ通知の受信を希望するユーザーのグローバルな嗜好を識別します。サブスクリプションの状態はユーザーベースなので、個々のアプリに固有のものではない。サブスクリプションの状態は、プッシュ通知のターゲットにするユーザーを決定するときに役立つフラグです。
ユーザーのプッシュ通知のサブスクリプションの状態は、ユーザーのすべてのデバイスを含むユーザープロファイル全体に適用されます。
以下のサブスクリプション状態オプションが存在する: Subscribed, Opted-In, および Unsubscribed。
デフォルトでは、ユーザーがプッシュ通知でメッセージを受け取るには、プッシュサブスクリプション状態が「許可」またはSubscribed「拒否」のいずれかでなければならず、かつフォアグラウンドOpted-Inプッシュがイネーブルドになっている必要がある。メッセージの作成時に、この設定をオーバーライドできます。
| オプトイン状態 | 説明 |
|---|---|
Subscribed |
Brazeでユーザープロファイルが作成されたときのデフォルトのプッシュ通知のサブスクリプション状態。 |
Opted-In |
ユーザーは、プッシュ通知を受け取ることを明示的に希望した。ユーザーがOSレベルのプッシュ通知プロンプトを受け入れた場合、Brazeは自動的にOpted-Inそのユーザーのオプトイン状態を「許可済み」に変更する。Android 12 またはそれ以前のユーザーには適用されません。 |
Unsubscribed |
ユーザーがアプリケーションやブランドが提供するその他の方法で、プッシュ配信を明示的に解除した。デフォルトでは、Brazeのプッシュキャンペーンは、プッシュ通知に対してOpted-in「許可Subscribed」または「拒否」設定のユーザーのみを対象とする。 |
Braze で、ユーザーのプッシュ通知のサブスクリプションの状態を自動的に Unsubscribed にすることはありません。ユーザーのプッシュサブスクリプション状態が の場合、そのユーザーのセグメンテーションにおけるUnsubscribedForeground Push Enabled フィルターは であることをfalse覚えておけ。
プッシュ通知のサブスクリプションの状態の更新
ユーザーのプッシュサブスクリプション状態を更新する以下の方法を検討せよ:
自動オプトイン (デフォルト)
Braze はデフォルトで、ユーザーが初めてアプリのプッシュ通知を承認したときに、ユーザーのプッシュ通知のサブスクリプションの状態を Opted-In に設定します。Braze はまた、ユーザーがシステム設定でプッシュ許可を無効にした後、再度プッシュ許可を有効にした場合にもこれを行います。
このデフォルトの動作を無効にするには、Android Studio プロジェクトの braze.xml ファイルに次のプロパティを追加します。
1
<bool name="com_braze_optin_when_push_authorized">false</bool>
Braze Swift SDKバージョン 7.5.0 から、Xcode プロジェクトの AppDelegate.swift ファイルに optInWhenPushAuthorized の設定を追加することで、この動作を無効にしたり、さらにカスタマイズしたりすることができる:
1
2
3
4
configuration.optInWhenPushAuthorized = false // disables the default behavior
let braze = Braze(configuration: configuration)
AppDelegate.braze = braze
SDKの統合
Web、Android、または iOS 上で setPushNotificationSubscriptionType メソッドを使用して、Braze SDK でユーザーの購読状態を更新できる。例えば、この方法を使って、ユーザーが手動でプッシュ通知を有効または無効にできる設定ページをアプリ内に作成することができる。
REST API
ユーザーのサブスクリプションの状態を更新するには、Braze REST API で/users/track エンドポイントを使用して、ユーザーの push_subscribe 属性を更新します。
プッシュ通知のサブスクリプションの状態の確認

Brazeでは、以下のいずれかの方法でユーザーのプッシュ通知サブスクリプション状態を確認できる:
- ユーザープロフィール:Braze ダッシュボードの [ユーザー検索] ページから、個々のユーザープロファイルにアクセスできます。Eメールアドレス、電話番号、または外部ユーザーIDを介して)ユーザーのプロフィールを見つけた後、Engagementタブを選択してユーザーの購読状態を表示し、手動で調整することができる。
- REST API でのエクスポート:ExportUsers by segmentまたはUsers by identifierエンドポイントを使用して、個々のユーザープロファイルを JSON 形式でエクスポートすることができる。Brazeは、デバイスごとのプッシュ通知イネーブルメント情報を含むプッシュトークンオブジェクトを返す。
GitHub でこのページを編集