Airbridge sends silent push notifications everyday between 0:00 and 1:00 KST (Korea Standard Time) to users who have tracked app events at least once in the past 6 months, to check whether the app has been deleted. You can check app deletion events through Airbridge reports and by extracting original data.
Enter your Apple Developer Center and Google Cloud Console certification information on the Airbridge dashboard.
Please check the following 4 pieces of certification information at the Apple Developer Center.
To get the APNs authentication key, you first need to turn on the app's push notification in the Apple Developer Center.
Click on [Identifiers] in the Apple Developer Center.
Find and click on the app that tracks app deletion. Please check 'Push Notification' in the app.
Click on [Keys] in the Apple Developer Center. Create a new key by clicking the '+' button. Then download the APNs authentication key (p8). The APNs authentication key can be downloaded only in the process of creating the key for the first time. It cannot be downloaded again. If lost, you must reissue the key. The maximum number of APNs authentication keys that can be generated at once is two.
You can check the Key ID by clicking on the newly created key in [Keys].
Click on [Certificates, Identifiers & Profiles]>[Identifiers] at the Apple Developer Center. Find and click on the app you are using. You can check the Bundle ID of the app you clicked on.
You can check the Team ID (App ID Prefix) at [Account]>[Membership details] in the Apple Developer Center.
Please do the following 3 pieces of tasks to check certification information at the Google Cloud console.
Create a custom role following the steps below.
1. Sign in to the Google Cloud console. From the drop-down list, 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 of 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 securely store the JSON file.
Enter all the certification information from the Apple Developer Center into [Settings]>[Uninstall Tracking]>[iOS App Uninstall Tracking] of Airbridge.
After entering all the authentication information in Airbridge, select the app environment to collect push tokens.
The push token collected differs depending on the app environment you choose. For example, push tokens collected in the Production environment cannot be used in the Development environment.
Supported Apps: Apps downloaded from the Apple App Store or test apps distributed via TestFlight, Ad Hoc, Enterprise methods.
Collected Push Tokens: The actual push tokens used in app deletion tracking.
Supported App: It is a development app(for testing purposes) not supported in Production.
Collected Push Token: Push token used in the development environment.
Development can only proceed with silent push testing. To actually track app deletion, please proceed in Production.
Follow the steps below to submit Firebase 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.
Silent Push Test is a test that lets you confirm whether the silent push is being sent correctly. When you click 'Silent Push Test', you can verify whether the silent push is being properly sent to your device with the entered authorization information. The silent push test does not measure or generate app deletion events, so you cannot verify app deletions on the Airbridge dashboard.
One of the authentication informations needed for app deletion tracking, the Bundle ID, can only be validated through the Silent Push Test. Therefore, we recommend proceeding with 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 conducting a silent push test. Please refer to the Apple Developer Guide for how to check the APNs push token.
When you send 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 checked via a silent push test in an iOS environment are as follows. For more information about error codes, please refer to the Apple developer guide.
Error Code | Meaning |
---|---|
403 (InvalidProviderToken) | Invalid APNs credentials. Enter the correct Key ID and Team ID, and try again. |
400 (TopicDisallowed) | Invalid Bundle ID. Enter the correct Bundle ID, and try again. |
400 (BadDeviceToken) | Invalid push token. The actual app environment and the app environment configuration may not match. |
410 (Unregistered) | Invalid push token. The actual app environment and the app environment configuration may not match, or the user may have deleted the app. |
410 (ExpiredToken) | Invalid push token. The actual app environment and the app environment configuration may not match, or the user may have deleted the app. |
Some error codes that indicate that the app has been deleted could show as a result of the silent push test. Regardless, be reminded that the silent push notification test is just a test to verify if silent push notifications are being sent successfully using the entered credentials.
Test the silent push notification on a device for testing purposes where the app has been installed recently and retained for the last 10 days.
Attention
You cannot conduct silent push tests on the iOS Simulator.
Test silent push notifications to make sure the notifications can be 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 Firebase documentation.
A success message will be shown when a silent push notification is successfully sent to a test device with the app. A failure message containing the error 404 will be shown when a silent push notification is successfully sent to a test device without the app.
Find the complete list of error codes below. For details about the error codes, refer to Firebase documentation.
Error code | HTTP Error Code | Description |
---|---|---|
INVALID_ARGUMENT | 400 | Invalid request parameters. Check the package name, data key, etc. |
THIRD_PARTY_AUTH_ERROR | 401 | Invalid or missing APN certificate or web push auth key. Check the validity of your credentials. |
SENDER_ID_MISMATCH | 403 | The authorized sender ID and the sender ID of the registered token don't match. Check the sender ID. |
UNREGISTERED | 404 | Invalid token, which Airbridge assumes that the app has been uninstalled. Airbridge can successfully collect the Uninstall event. |
QUOTA_EXCEEDED | 429 | The sending limit was exceeded. |
INTERNAL | 500 | An error occurred in the Firebase server. Retry after a moment. If this error persists, contact Firebase for troubleshooting. |
UNAVAILABLE | 503 | The Firebase server is overloaded. Retry after a moment. |
The test never affects the uninstall event count available via Airbridge reports and raw data exports. Therefore, it is impossible to track actual uninstall events by testing the silent push notifications.
To track app deletions, you need to complete the Airbridge SDK setup.
Airbridge tracks app deletions through silent push notifications. Please set up the ability to receive push notifications in the app for this.
When the push token is generated, please deliver it to the SDK by calling the registerPushToken function.
import { Airbridge } from 'airbridge-react-native-sdk'
...
Airbridge.registerPushToken(token)
Warning
On iOS, you need to send the APNS push token, and on Android, you need to send the Firebase push token.
The silent push notifications that Airbridge sends to track app deletions should not appear to the user in the app. The app should ignore these push notifications. Please refer to the following code.
import { Airbridge } from 'airbridge-react-native-sdk'
...
if (Airbridge.isUninstallTrackingNotification(payload)) {
return
}
Once you enter the authentication information on the Airbridge dashboard and complete the Airbridge SDK setup, you can activate the app deletion tracking toggle. When the toggle is activated, app deletion tracking starts.
For more details on app deletion, please check the Airbridge guide.
Was this page helpful?