English

Uninstall and reinstall tracking

Use Adjust's uninstall and reinstall tracking for elevated insights into your app's retention rates. By knowing when users have uninstalled and reinstalled your app from their device, you can accurately assess your organic and network partners’ performance, know your churn, and evaluate your app’s lifecycle.

Before you begin

Requirements

  • Purchase of our uninstall and reinstall tracking package. (For more information, contact your sales manager or sales@adjust.com).
  • App configured to send push notifications, as Adjust relies on these to determine whether an app is installed. See the implementation guidelines for iOS and Android.

SDK Setup

To use this feature, you first need to download and set up the Adjust SDK for your platform. Follow the instructions linked below to get started.

⚙️ iOS SDK v4.18.1 and later / Android SDK v4.12.0 and later

Helpful information

  • Reinstalls are considered in-app events within Adjust and do not automatically result in reattributions

For further information on uninstall and reinstall KPIs, callbacks, Amazon S3 bucket uploads, and Audience Builder functionality, see the following sections:

1-4: Adjust captures the app's push token

1/2

Track uninstalls and reinstalls on iOS

Adjust’s app uninstall and reinstall tracking relies on silent push notifications to know whether an app is installed on a device. Developer instructions for configuring your app to send push notifications on iOS can be found below.

Use the resources below to prepare your iOS app for Adjust's uninstall and reinstall tracking.

Requirements

  • In Xcode, the Background Modes capability configured to enable remote notifications
  • An iOS push services certificate
    • Anyone with access to your app's Apple developer portal can download this certificate from within the Certificates, Identifiers & Profiles section of the dashboard
    • You must export this file as a P12 and upload it (along with the associated password) to Adjust in your app's Platforms settings (see below). This grants us permission to use push notifications in your app.
  • Bundle ID entered within your app's Platforms settings

Export an iOS push services certificate

To find and export an existing certificate, follow these steps in the Keychain Access app.

  1. Select the Certificates category.
  2. Right-click on the relevant Apple Push Services certificate. Do not include its private key or any other certificates.
  3. Select Export "Apple Push Services: your.bundle.id".
  4. Name your export.
  5. Select Personal Information Exchange (.p12) from the File Format drop-down menu.
  6. Select Save.
  7. Optional: Enter a password. If you enter a password, you will need to include it when uploading this file in the Adjust dashboard.
  8. Select OK.

If you create a new certificate, use one of the following types:

  • Apple Push Notification service SSL (Sandbox).
  • Apple Push Notification service SSL (Sandbox & Production).

To successfully upload a certificate to the Adjust Dashboard, it must use CN=Apple Push Services.

Warning:
Please notice that the following type of certificate does not work:
macOS Apple Push Notification service SSL (Production)

Upload your iOS push services certificate to your Adjust account

In the Adjust dashboard

  1. Navigate to your app and select your app options caret (^).
  2. Select All Settings > Platforms.
  3. Select APNS.
  4. Select SELECT CERTIFICATE FILE.
  5. Locate your certificate file and select Open.
  6. If you entered a password when creating your certificate, enter it in the PASSWORD field.
  7. Select SAVE.

Renew your iOS push notification certificate

Push services certificates expire one year after creation. For uninterrupted tracking of uninstalls and reinstalls, you will need to ensure that your certificate is renewed before it expires. Adjust will send you a reminder email two weeks prior to the certificate expiry. When you receive this email, follow these steps:

In the Apple developer portal

  1. Select Account at the top right of the home screen.
  2. Select Certificates, Identifiers & Profiles.
  3. Select the plus (+) icon at the top right of the screen.
  4. Under Production, check Apple Push Notification service SSL (Sandbox & Production).
  5. Select Continue.
  6. Select your app ID from the App ID drop-down menu.
  7. Select Continue.
  8. Follow the instructions to create a CSR file.
  9. Select Continue.
  10. Upload your newly created CSR file by selecting the Choose File button.
  11. Select Continue.
  12. Select Download.
  13. Open the newly downloaded certificate file from your downloads list or folder to add it to your Keychain Access.
  14. Follow the instructions to upload your iOS push services certificate to your Adjust account.

Track uninstalls and reinstalls on Android

Adjust’s app uninstall and reinstall tracking relies on silent push notifications to determine if an app is installed on a device. Developer instructions for configuring your app for uninstall and reinstall tracking can be found below. If you have already configured your app and Adjust SDK for push notifications using Firebase Cloud Messaging, you can skip to how to find your FCM server key.

Note:
You must configure your app for push notifications through Firebase Cloud Messaging (FCM). Google Cloud Messaging (GCM) is not supported.

Requirements

Find your FCM server key

In your Firebase console

  1. Select the settings (gear) icon > Project settings.
  2. Select CLOUD MESSAGING.
  3. Locate your Server key token.

Add your FCM server key to your Adjust account

In the Adjust dashboard

  1. Navigate to your app and select your app options caret (^).
  2. Select All Settings > Platforms.
  3. Select Firebase Cloud Messaging.
  4. Enter or paste your FCM key into the FCM KEY field.
  5. Select SAVE.

Uninstall and reinstall FAQs

How does Adjust report when my app was uninstalled?

What is a silent push notification?

How does Adjust manage push tokens and silent push notifications?

How often does Adjust send silent push notifications to my app?

How will uninstall and reinstall tracking appear in my dashboard?

What is a reattribution reinstall?

Why do uninstalls tested in the sandbox environment not appear in my dashboard?

How can I receive uninstall and reinstall activity from Adjust?