Firebase

​

Step 1. Setup

1. Firebase has a great platform wise documentation on how to setup Firebase Cloud Messaging (FCM) for Android, iOS and Web. Please follow the steps if you have not setup FCM yet.
   • Android setup.
   • iOS setup.
   • Web setup.

You can also check these Github example projects for Android, iOS and Web.

​

Step 2. Firebase Integration in Raven

​

Step 3. Managing Tokens

Firebase identifies each device by generating a unique registration token on the client side for each install. You can either manage the tokens on your backend, or let Raven manage the tokens for you.

1. Manage yourself: You can follow the Firebase guide here.
2. Managed by Raven: You can use the Raven Client SDK to send the tokens generated from the client to Raven server ( setDeviceToken method in the SDK). Please refer to our Client SDK section for more details. Raven will take care of the active/stale tokens and will keep the tokens updated.

​

Step 4. Sending Notifications

Here’s how you can pass fcm tokens in user object in Send Event API:

{
   "user" : {
      "fcm_tokens" : ["fcm_token_1", "fcm_token_2",..]
   }
}

​

Step 5. Notification Rendering

Notification rendering should be handled by you on the client side using the Firebase SDK. Please refer to the platform wise Firebase guide on displaying notifications.

1. Android
2. iOS
3. Web

​

Step 6. Delivery Reports

Since Firebase does not send any delivery callbacks to server, delivery reports need to be setup using the Client SDK. You can integrate the Raven Client SDK and use the updateStatus method to send the notification status to Raven server. Please refer to our Client SDK section for more details.

​

Advanced

Send additional parameters to Firebase

Raven will send the fields present in the Push template to Firebase by default. Check our Push Template section to see which fields are sent to Firebase. Also, you can send other additional parameters directly to Firebase in the Send Event API as shown below.

"override" : {
    "providers" : {
       "<FIREBASE_INTEGRATION_NAME>": {   //integration name
           payload: {
               "<key>": "<value>" //key-values to be passed
               ...
           }
       }
    }
 }

Check our Send Event API doc for the complete request.

​

Links

• Firebase (FCM) Website​
• Firebase (FCM) Documentation ​
  • Android
  • iOS
  • Web
• Firebase (FCM) Console