Register Your Firebase App to Enable Mobile Publisher Android Push Notifications

To set up push notifications for your Android app, provide Mobile Publisher with information from a Google Firebase project associated with your app. To get the required information, register your Android app and generate a private key. Then, submit the information to your app’s Setup for Mobile Publisher project.

Note If you submitted your Mobile Publisher Android app before November 2023, don’t create a new Google Firebase project. Confirm that you’ve completed steps 4 through 6 with your existing Firebase project. You must complete those steps to receive a new Android app build.

1. Log in to the Google Firebase Console with the Google Play account associated with your Mobile Publisher app.
2. Create a Firebase project.
   1. In the Google Firebase Console, click Create a project.
   2. Click Add Firebase to Google Cloud project.
   3. In the Project name field, select the Google Cloud project where you previously created a service account user.
   4. Follow the prompts to create a project.
3. Assign the project’s Firebase admin role to your Salesforce Developer ID.
   1. In a separate browser window or tab, open the Google Play Console, and then click Users and permissions. In the Users tab, copy your Salesforce Developer ID.
      The Salesforce Developer ID is in the format of an 8-character alphanumeric username and the @salesforcemobilepublisher.com domain, similar to 1a2b3c4d@salesforcemobilepublisher.com. The Salesforce Developer ID is the same user that you invited to your Google Play account when you granted Salesforce permission to distribute your branded app.
   2. Return to the browser window or tab showing your Firebase project. In the Firebase project, click the cog icon next to Project Overview, and then click Project settings.
   3. Select the Users and permissions tab.
   4. In the email address field, add the Salesforce Developer ID that you copied from the Google Play Console.
   5. In the Role(s) field, select Assign Firebase role(s), and select the Admin column of the Firebase row.
4. Register your Android app on Firebase and download its config file.
   1. In a separate browser window or tab, open your app’s Setup for Mobile Publisher project. In the App Distribution section, copy the value of the Store Identifier field.
      The identifier name format is similar to: com.mysalesforce.mycommunity.C00AB0000000CDefGHI.A0BCD00000001ABcDEF
   2. Return to the browser window or tab showing your Firebase project. In the Firebase project, click the cog icon next to Project Overview, and then click Project settings.
   3. In the Your apps section, click Add app, and then click the Android icon.
   4. In the Android package name field, enter the store identifier that you copied from your app's Setup for Mobile Publisher project.
      

      Note If you get an error message in the Firebase registration workflow that states there's already an app with that package name, close the registration window. Confirm that you see your app's store identifier in the list of apps, and then click the link to download google-services.json. Continue to step 7.
   5. In the App nickname field, enter your app’s name.
      We recommend that you use the same app name that’s entered in the Product Details section of your Setup for Mobile Publisher project.
   6. Click Register app.
   7. Click Download google-services.json, and then click Next. Note the location of the downloaded file, because you need it later.
      Don’t change the settings under Firebase SDK.
   8. Click Next, and then click Continue to console.
5. Generate and download a private key for your Firebase service account.
   1. Click the cog icon next to Project Overview, and then click Project settings.
   2. Select the Service accounts tab, and then click Generate new private key.
   3. Download the JSON file that contains the private key. Note the location of the downloaded file, because you need it later.
      The file name format for this private key is similar to project-name-firebase-adminsdk-a1bcd-a1234bc5678.json.

      

      Note The private key for your Firebase service account is a different JSON file than the Google Cloud Platform service account key that you upload when you add a Google Play developer account to your Mobile Publisher project. Make sure that the private key you're downloading to set up push notifications contains firebase-adminsdk in the JSON file name.
6. Add the Firebase information to your app’s Setup for Mobile Publisher project.
   1. From Setup, enter Mobile Publisher in the Quick Find box, then select Mobile Publisher.
   2. Open your app’s Android project, and then scroll to the Push Notifications section.
   3. For the App Setup area, upload or drop the google-services.json file that you downloaded when you registered your app on Firebase.
   4. If you want to enable Push Notifications, do so when you Set Up an External Client App. When you select to enable push notifications, upload or drop the private key that you generated for your Firebase service account in the Firebase Admin SDK Private Key field.
      The file name format for this private key is similar to project-name-firebase-adminsdk-a1bcd-a1234bc5678.json.