Airbridge sends silent push notifications to users who have performed any app event at least once in the past 6 months to check if they have deleted the app. These notifications are sent daily between 3:00 PM and 4:00 PM (UTC). Uninstall events can be monitored in the Airbridge reports and raw data export files.

Airbridge uses Firebase Cloud Messaging in Android uninstall tracking.

Note

Uninstall tracking is supported for Airbridge Android SDK v2.6.0 and later.

Submit the Firebase credentials to Airbridge to enable uninstall tracking.

Create a custom role following the steps below.

1. Sign in to the Google Cloud console. From the project selector, select a project to create a custom role.

2. Navigate to [IAM & Admin]>[Roles]. Click + Create Role.

3. Enter the following details:

• Title: Airbridge Uninstalls

• ID: abr_uninstalls

• Role launch stage: General Availability

4. Click +Add Permissions.

5. In the Enter property name or value field, enter "cloudmessaging.messages.create" and select it from the search results. Check the checkbox and click Add.

6. Click Create to finish creating the custom role.

Create a service account by following the steps below.

1. Navigate to [IAM & Admin]>[Service Accounts]. Click + Create Service Account.

2. Enter “ABR Uninstall Service Account” as the service account name. Click Create and Continue.

3. From the Select a role drop-down list, search and select "Airbridge Uninstalls." Click Continue.

4. Click Done to finish creating the service account.

Create a private key file for the service account.

1. Navigate to [IAM & Admin]>[Service Accounts]. From the service account list, click the email of the service account whose name is "ABR Uninstall Service Account."

2. Select the Keys tab. Click Add Key and select Create new key.

3. Select JSON as the key type and click Create. The JSON file containing the key file will be downloaded. Make sure to store the JSON file securely.

Follow the steps below to submit the credentials to Airbridge.

1. Navigate to [Settings]>[Uninstall Tracking] in the Airbridge dashboard.

2. Select the [Android] tab.

3. Upload the JSON key file by dropping the file or clicking to select the file.

Test silent push notifications to make sure the notifications are successfully sent to devices. To proceed with the test, click Test silent push and enter the FCM registration token of your test device. For detailed instructions on how to access your FCM registration token, refer to the Firebase documentation.

A success message will be shown when a silent push notification is successfully sent to your test device where the app is installed. A fail message containing the 404 error code will be shown when a silent push notification is successfully sent to a test device where the app is uninstalled.

Find the complete list of error codes below. For details about the error codes, refer to the Firebase documentation.

Testing silent push notifications does not affect the uninstall event count available in Airbridge reports and raw data export files. Note that testing silent push notifications does not result in the actual uninstall event collection.

For uninstall tracking, you must complete the Airbridge SDK setup by following the instructions below.

Add the following code snippet to AndroidManifest.xml.

<service
    android:name="${packageName}.MyFirebaseMessagingService"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

Send the push token created in the Firebase Cloud Messaging (FCM) through the Airbridge SDK.

class MyFirebaseMessagingService : FirebaseMessagingService() {

    override fun onMessageReceived(remoteMessage: RemoteMessage) {
        super.onMessageReceived(remoteMessage)
    }

    override fun onNewToken(token: String) {
        super.onNewToken(token)
        Airbridge.registerPushToken(token)
    }
}

public class MyFirebaseMessagingService extends FirebaseMessagingService {

    @Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        super.onMessageReceived(remoteMessage);
    }

    @Override
    public void onNewToken(String token) {
        super.onNewToken(token);
        Airbridge.registerPushToken(token);
    }
}

A push token may already have been issued in the Firebase Cloud Messaging. Add the code snippets below to send the existing push token as well.

class MyApplication : Application() {

    override fun onCreate() {
        super.onCreate()
        ...
        FirebaseMessaging.getInstance()
            .token
            .addOnSuccessListener {
                Airbridge.registerPushToken(it)
            }
        ...
    }
}

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        FirebaseMessaging.getInstance()
            .getToken()
            .addOnSuccessListener(new OnSuccessListener<String>() {
                @Override
                public void onSuccess(String token) {
                    Airbridge.registerPushToken(token);
                }
            });
    }
}

Attention

Make sure the above functions are called after the SDK initialization.

A silent push sends a silent notification without any data. However, depending on the implementation of the onMessageReceived function in the Firebase Cloud Messaging, the silent push notification may be shown to the user. By adding the exception handling code as below, the silent push will not be exposed to the user.

class MyFirebaseMessagingService : FirebaseMessagingService() {

    override fun onMessageReceived(remoteMessage: RemoteMessage) {
        super.onMessageReceived(remoteMessage)
        if (remoteMessage.data.containsKey("airbridge-uninstall-tracking")) {
            return
        } else {
                // handleNotification(remoteMessage) 
        }
    }

    override fun onNewToken(token: String) {
        super.onNewToken(token)
        Airbridge.registerPushToken(token)
    }
}

public class MyFirebaseMessagingService extends FirebaseMessagingService {

    @Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        super.onMessageReceived(remoteMessage);
        if (remoteMessage.getData().containsKey("airbridge-uninstall-tracking")) {
            return;
        } else {
            // handleNotification(remoteMessage);
        }
    }

    @Override
    public void onNewToken(String token) {
        super.onNewToken(token);
        Airbridge.registerPushToken(token);
    }
}

After submitting the credentials to Airbridge and completing the SDK setup, the [Enable uninstall tracking] toggle will be activated. Switch on the toggle to start tracking uninstall events.

For more details about uninstall tracking, refer to this article.