Uninstall Tracking Setup - Flutter SDK (v4)

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.

Submit Credentials

Submit your Apple Developer or Google Cloud Console credentials to Airbridge.

Get credentials from Apple Developer

Follow the steps below to get the required credentials from the Apple Developer Portal.

Get credentials from Google Cloud Console

Follow the steps below to get the required credentials from the Google Cloud Console.

Submit credentials to Airbridge

iOS

Follow the steps below to submit the credentials to Airbridge.

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

2. Select the [iOS] tab.

3. Submit the required credentials.

Select app environment

After submitting all the required credentials to Airbridge, select the app environment to collect push tokens.

Different push tokens are collected depending on the app environment you choose. For example, push tokens collected in the production environment cannot be used in the development environment.

Android

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

iOS

Test silent push notifications to make sure the notifications are successfully sent to the devices. To proceed with the test, click Test silent push. The silent push test does not measure or generate uninstall events; therefore, uninstalls cannot be confirmed in the Airbridge dashboard.

Conducting the silent push test is recommended as the Bundle ID, which is one of the required credentials for uninstall tracking, can only be validated through the silent push test.

To conduct a silent push test, you need an APNs push token (device token). The push token you collect varies depending on the app environment. You need to check the push token and the app environment before proceeding with a silent push test. Refer to the Apple Developer Documents for instructions on how to find the APNs push token.

Upon sending a silent push to a device from Airbridge, you can check for a success message or an error code. The main error codes that can be received are as follows. For more information about the error codes, refer to the Apple Developer Documents.

Attention

You cannot conduct silent push tests on the iOS Simulator.

Android

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 test does not affect the uninstall event count that is available in Airbridge reports and raw data export files. Note that testing silent push notifications does not result in the actual uninstall event collection.

Set Up the Airbridge SDK

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

Enable push notifications

Airbridge tracks app deletions through silent push notifications. Therefore, you need to set up the app to receive push notifications.

Send the push token

When the push token is generated, call the registerPushToken function to send it to the SDK.

123
import 'package:airbridge_flutter_sdk/airbridge_flutter_sdk.dart';
...
Airbridge.registerPushToken(token);

Attention

On iOS, send the APNS push token, and on Android, send the Firebase push token.

Silence push notifications

The silent push notifications Airbridge sends for uninstall tracking should not be displayed in the user's app. By adding the exception handling code as below, the silent push will not be exposed to the user.

1234567
import 'package:airbridge_flutter_sdk/airbridge_flutter_sdk.dart';
...
if (Airbridge.isUninstallTrackingNotification(payload)) {
    // app uninstall tracking push by airbridge.
    // ignore these push notifications.
    return
}

Enable Uninstall Tracking

Once the credentials have been submitted to Airbridge and the SDK setup is complete, 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.

Was this page helpful?

Have any questions or suggestions?