Push Notifications

These instructions are for integrating push with Firebase Cloud Messaging (FCM).

For ADM integration instructions, see our advanced use cases documentation.

In order to integrate Braze push notifications into your app, you need to:

  1. Enable Firebase
  2. Configure your Android Manifest
  3. Configure your braze.xml
  4. 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.

  1. Add the following permissions to your AndroidManifest.xml:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WAKE_LOCK" />

Step 3: Configure your braze.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 braze.xml file:
<!-- 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 braze.xml file and replace REPLACE_WITH_YOUR_FCM_SENDER_ID with your Firebase Sender ID:
<!-- 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 braze.xml file:
<!-- 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 braze.xml file.
<!-- 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:

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 “Firebase Cloud Messaging Server Key” under the Push Notification Settings section.
  • Enter your Firebase Sender ID in the field labeled “Firebase 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:

  1. Login to the Firebase Developers Console

  2. Select your Firebase project

  3. Select Cloud Messaging under Settings and copy the Server Key and Sender ID: FirebaseServerKey

Implementation Example

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

New Stuff!