Android Push (FCM)

Integration Steps

Create a Firebase project in the firebase console

To start sending notifications from FCM, you’ll have to first create a firebase project. Create a firebase project and application in firebase console with your applications package name which you can find in MainApplication.java or AndroidManifest.xml.

Adding google-services.json to your project

You can get your Service Account JSON from Firebase Console Project Settings. Download google-services.json and add the file inside your android > app folder.

Adding Firebase dependencies and plugins

Add the below dependency inside projects build.gradle inside dependencies

dependencies {
        ...
        classpath 'com.google.gms:google-services:4.3.10' // or latest version
}

Add the below plugin inside the app build.gradle

apply plugin: 'com.google.gms.google-services'

Add the below dependency inside apps build.gradle inside dependencies

implementation("com.google.firebase:firebase-messaging:22.0.0") // or latest version

Implementing push

Push feature can be implemented in two ways:

You may use this option if all of your android push notifications are to be handled via SuprSend SDK. We recommend you use this method as it is just a single-step process to just register the service in your application manifest and everything else will be ready.

<!--If you are targeting to API 33 (Android 13) you will additional need to add POST_NOTIFICATIONS -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

<service
    android:name="app.suprsend.fcm.SSFirebaseMessagingService"
    android:enabled="true"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

Once you get a token from Firebase you can pass the token by using the below code

suprsend.user.setAndroidFcmPush(fcm_token);

When you get a push notification you will get a payload and it can be passed to the method provided by Suprsend React Native SDK and the notification displaying part will be handled by SDK.

suprsend.showNotification(notification_payload);

If notification payload contains key supr_send_n_pl then simply consider this as payload sent from suprsend and pass the payload to suprsend sdk by:

if (payload?.data?.supr_send_n_pl) { suprsend.showNotification(payload.data.supr_send_n_pl); }

Targeting Android 13 (API-33):

In Android13 (API 33) or higher notification permission will be disabled by default so permission needs to be asked to enable notifications if you are targeting android 13 users. You can follow this doc to update to support Andriod 13(API 33), if not already supported: https://developer.android.com/about/versions/13/setup-sdk. Please test the application as well as upgrading to API 33 may causes breaking changes.

Add POST_NOTIFICATIONS permission in AndroidManifest.xml if not present already.

<manifest ...>
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/> 
    <application ...>
        ...
    </application>
</manifest>

Call the SDK method to show a notification permission popup

This method is asynchronous and returns permission values like granted, denied, and never_ask_again.

NOTE: This method is asynchronous and returns permission values like granted, denied, and never_ask_again.

const permission = await Suprsend.askNotificationPermission();

Once permission is granted users can be able to get push notifications.

GETTING STARTED

CORE CONCEPTS

WORKFLOW BUILDER

SUPRSEND BACKEND SDK

SUPRSEND CLIENT SDK

Notification Inbox

PREFERENCE CENTRE

VENDOR INTEGRATION GUIDE

INTEGRATIONS

MONITORING & DEBUGGING

MANAGE YOUR ACCOUNT

Integration Steps

Targeting Android 13 (API-33):

GETTING STARTED

CORE CONCEPTS

WORKFLOW BUILDER

SUPRSEND BACKEND SDK

SUPRSEND CLIENT SDK

Notification Inbox

PREFERENCE CENTRE

VENDOR INTEGRATION GUIDE

INTEGRATIONS

MONITORING & DEBUGGING

MANAGE YOUR ACCOUNT

​Integration Steps

​Targeting Android 13 (API-33):

Integration Steps

Targeting Android 13 (API-33):