🤳 Push Registration

1️⃣ Push Tokens

• To receive push notifications, push tokens are required

• Braze connects with push service providers like Firebase Cloud Messaging Service (FCMs) for Android and Apple Push Notification Service (APNs) for iOS, and those providers send unique device tokens that identify your app

• There are 2 types of push tokens:

  • Foreground push provide the ability to send regular visible push notifications to the foreground of a user’s device.

  • Background push are available regardless of whether a particular device has opted-in to receive push notifications from that brand. Background push allows brands to send silent push notifications.

• Braze provides a specific segmentation filter, Push enabled for App, to help identify the users who have enabled push notifications.

2️⃣ Push Registration by Device

• Android:

  • Android 13: Push permission must be asked of and granted by the user. Receives a token after permission is granted by the user.

  • Android 12 and earlier: All users are considered Subscribed upon their first session when Braze automatically requests a push token.
    

• iOS: Not automatically registered for push.

  • iOS 12 (with Provisional Authorization):
    Your app can request provisional authorization or authorized push. Authorized push requires explicit permission from a user before sending any notifications (receives a token after permission is granted by user), whereas [provisional push][provisional-blog] lets you send notifications quietly, directly to the notification center without any sound or alert.

  • iOS 11 and later & iOS 12 (without Provisional Authorization):
    All users must explicitly opt-in to receive push notifications. Will receive a token after users opted-in.
    

• Web: You must request explicit opt-in from users via the native browser permission dialog. Will receive a token after users opt-ed in.

3️⃣ Step by step guest facing enablement

Option A - First time login

• The first time you download the app, there is a native device push prompt

• Accept notifications from the push prompt

• Opt-in to notification also in the app setting (sign up page/communication preference page)

Option B - Post log in

1. Open your iPhone’s Settings app. You’ll find this gray gear icon on your Home screen, in your App Library, or by searching.

2. Tap Notifications. This option has a red icon with a white bell and is usually in the second group of settings.

3. Choose whether to show notification previews.

   1. ‘Always’ to show all previews,

   2. ‘When unlocked’ to show them only when your screen is unlocked,

   3. ‘Never’ if you prefer to see just the name of the app with a notification.

4. Tap the app you want to manage. Each app on your iPhone has its own push notification settings.

5. Toggle the “Allow Notifications” switch to On. Select the app you want and enable notification. As long as this switch is enabled, you’ll receive push notifications for this app.

6. Choose your alert preferences. You can select where you want to see the notifications: on the Lock Screen, in the Notification Center, or as Banners. You can also choose the banner style—‘Persistent’ or 'Temporary’.

7. Choose whether to hear notification sounds and whether to show notification badges on the app icon.

8. Go to the app you want to receive notifications, and make sure to opt-in in the app notification center as well

4️⃣ How to check if notifications are enabled?

1. Go to the app setting, and check in the communication center that you have opted in

2. Go to the device setting, and check that you have granted permission from the device

3. Look up for your user in Braze

4. Check under engagement if the user has correctly registered push tokens

📲 Type of notifications

Name	Description	Devices
Background push notification	Push notifications that are not rendered for the device. Usually used to send packets of information down to the app for background processes and uninstall tracking. A Background-enabled push token is required for background push to be sent.	IOS Android Web
Regular push notifications	These appear on your user's device with a notification sound and message which slides in or appears in a notification bar or stack.	IOS Android Web
Silent push notifications	A push notification that does not wake up the device when rendering on the device. Instead, the notification will be stored in the device's notification tray.	IOS Android Web
HTML Push Notifications	Coded push notifications that don’t follow Braze templates. They allow more customization	IOS Android Web
Notification IDs & Channel IDs	Notification IDs and Channel IDs allow you to replace or update push notifications already received, but not opened, by the user.	IOS Android Web
Provisional Push Notifications	Introduced by Apple in iOS 12, provisional authorization automatically occurs on install for iOS apps, allowing brands to send silent notifications without displaying a push prompt to users. When the silent push is sent and viewed in the device's notification tray, users will be given the option to allow or discontinue push notifications.	IOS Android Web
Push Stories	Push Stories are immersive messages that take your user through a visual journey in the form of a carousel. These are available for mobile devices only	IOS Android Web
Push with Action Buttons	Push with action buttons are messages that allow you to provide options to your users and offer several calls to action.	IOS Android Web
Wearable Push	These push notifications allow brands to send messages directly to wearable devices like the Apple Watch.	IOS Android Web

👀 Push Primer

• User have to opt-in to receive push notifications

• To optimize the chances that users will accept to receive push notifications, you can set up a push primer (in-app message explaining why the user should opt-in to notifications)

• Leverage the button on-click behavior “Request Push Permission” when creating an in-app message for iOS, Android, or Web.

• For iOS, push campaigns are relevant as foreground push notifications (such as notifications that wake up the device) are not enabled until a user explicitly opts into iOS' native push prompt.

• Guide on how to set up a push primer:https://www.braze.com/docs/user_guide/message_building_by_channel/push/best_practices/push_primer_messages/#step-5-target-users