A push notification is an out-of-app alert that appears on the user’s screen when an important update occurs. Push notifications are a valuable way to provide your users with time-sensitive and relevant content or to re-engage them with your app.
Sample push notification:
Check out our troubleshooting section for additional best practices.
Braze sends push notifications to Android devices using Firebase Cloud Messaging (FCM).
In order to integrate braze push notifications into your app, you need to:
- Enable Firebase
- Configure your Android Manifest
- Configure your appboy.xml
- Set your API key on the Braze dashboard
Step 1: Enable Firebase
To get started, follow the instructions at Add Firebase to Your Android Project.
Next, add the Firebase Unity SDK to your app as described in the Firebase Unity Setup Docs.
Note that integrating the Firebase Unity SDK may cause your
AndroidManifest.xml to be overriden. If that occurs, make sure to revert it to its original self.
Step 2: Configure your Android Manifest
Once you have setup your Firebase project, it is time to configure your Android Manifest with required permissions for Braze push.
- Add the following permissions to your
1 2 <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.WAKE_LOCK" />
AndroidManifest.xml is available at our public repo.
Step 3: Configure your appboy.xml
In order for a device to receive push notifications, it must register with the FCM server. The Braze SDK can handle the registration process for you.
- To tell Braze to handle registration automatically, add the following configuration to your
1 2 <!-- Whether or not Braze should handle registering the device to receive push notifications. Default is false. --> <bool name="com_appboy_firebase_cloud_messaging_registration_enabled">true</bool>
- Add the following configuration element to your
appboy.xmlfile and replace
REPLACE_WITH_YOUR_FCM_SENDER_IDwith your Firebase Sender ID:
1 2 <!-- Replace with your Firebase Sender ID --> <string name="com_appboy_firebase_cloud_messaging_sender_id">REPLACE_WITH_YOUR_FCM_SENDER_ID</string>
- Recommended To instruct Braze to handle deep links from push automatically, add the following configuration to your
1 2 <!-- Whether to open push deep links from Braze automatically. --> <bool name="com_appboy_handle_push_deep_links_automatically">true</bool>
- Recommended: Specify the drawable resource that should be displayed in the push notification in your appboy.xml file.
1 2 <!-- The drawable that should be displayed whenever a push notification is received. If no icon is given, the notification will use the application icon --> <drawable name="com_appboy_push_small_notification_icon">REPLACE_WITH_YOUR_ICON</drawable>
- Optional: Braze will broadcast Intents whenever a push notification is received or opened. If you need to perform custom logic upon push notifications open or receipt, you may create and register a custom broadcast receiver to listen to and respond to these intents. The names of the actions are:
1 2 3 REPLACE_WITH_YOUR_BUNDLE_IDENTIFIER.intent.APPBOY_PUSH_RECEIVED REPLACE_WITH_YOUR_BUNDLE_IDENTIFIER.intent.APPBOY_NOTIFICATION_OPENED REPLACE_WITH_YOUR_BUNDLE_IDENTIFIER.intent.APPBOY_PUSH_DELETED
appboy.xml is available at our public repo.
Step 4: Set Your Firebase Credentials
You need to input your Firebase Server Key and Sender ID into the Braze dashboard:
- On the app settings page (where your API keys are located), select your Android app.
- Enter your Firebase Server Key in the field labeled “Cloud Messaging API Key” under the Push Notification Settings section.
- Enter your Firebase Sender ID in the field labeled “Cloud Messaging Sender ID” under the Push Notification Settings section.
If you’re not familiar with the location of your Firebase Server Key and Sender ID, follow these steps:
Login to the Firebase Developers Console
Select your Firebase project
Select Cloud Messaging under Settings and copy the Server Key and Sender ID:
The sample project in the Braze Unity SDK repository contains a full working sample app that includes FCM.
Deep Linking to In-App Resources
Although Braze can handle standard deep links (such as website urls, Android uris, etc.) out of the box, creating custom deep links requires additional Manifest setup.
See Android’s documentation on “Deep Linking” to In-App Resources