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 from the Apple Developer Portal.
Select [Identifiers] in the Apple Developer Portal.
Find and click on the app you want to track uninstalls. Then, check "Push Notification."
Select [Keys]. Click + to generate a new key. Then, download the APNs authentication key (p8). The APNs authentication key can be downloaded only when creating the key for the first time and cannot be downloaded again. If lost, the key must be regenerated. Up to 2 APNs authentication keys can be generated at once.
The Key ID can be found when clicking on the newly generated key in [Keys].
Navigate to [Certificates, Identifiers & Profiles]>[Identifiers] in the Apple Developer Portal. Click on the app you want to track uninstalls to find the Bundle ID.
Navigate to [Account]>[Membership details] in the Apple Developer Center to find the Team ID (App ID Prefix).
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 released via TestFlight, Ad Hoc, or Enterprise.
Push tokens collected: The actual push tokens used for uninstall tracking
Supported app: Development apps for testing purposes that are not supported in the production environment
Push token collected: Push token used in the development environment
In the development environment, you can only proceed with silent push testing. To actually track uninstalls, proceed with a production app.
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 several days ago. |
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 several days ago. |
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 purpose of the silent push test is to verify whether silent push notifications are being sent successfully using the submitted 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.
Airbridge.RegisterPushToken("YOUR_PUSH_TOKEN");
Attention
On iOS, send the APNS push token, and on Android, 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.
// ...
if (Airbridge.IsUninstallTrackingNotification(payload)) {
// app uninstall tracking push by airbridge.
// ignore these push notifications.
return;
}
else {
// ...
}
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?