Getting Started with iOS Uninstall Tracking

You can set up Singular to track uninstalls for your iOS app. Uninstall tracking is available with Singular iOS SDK 8.x and above, and to start using it you will need to update your app.

Setting Up Uninstall Tracking

To start tracking uninstalls:

1. Integrate (or update to) Singular iOS SDK 8.X

For instructions on upgrading your SDK, see our iOS SDK integration guide.

2. Update your iOS app to support Apple push notifications and pass the APNS device token to the Singular SDK

Singular requires an Apple Push Notification Certificate to enable uninstall tracking for iOS. If this is your first time setting up push notifications for your iOS app, see Apple's documentation. Once your app supports Apple push notifications, follow the Singular iOS SDK Implementation Guide to enable the Singular SDK to track uninstalls.

Note: In accordance with Apple's policies, your app's users will be asked to opt in to receive push notifications. Singular will only be able to track uninstalls for users who have opted in. In the future, Singular will support tracking how many of your installed users can be included in uninstall tracking.

3. Add your Apple Push Notification Certificate to your iOS application page in Singular

 To retrieve your certificate and upload it into Singular:

  1. Create and download an Apple Push Notification SSL certificate: In your Apple developer account, navigate to Certificates, Identifiers & Profiles >  Identifiers > App IDs. In your Application Services View, you can configure push notifications for both your Development and Production builds.

    Note that while you can use your Development certificate for your own internal testing, Singular uninstall tracking requires the Production SSL certificate to be used with your live app.

  2. Generate a PEM (.p12) file from your Keychain: After you've downloaded your certificate, double-click on it to add it to your Mac Keychain, where it is paired with a private key.

    Select both the certificate and private key, right click, and export to a .p12 file with a meaningful name.

  3. Upload your .p12 file into your iOS apps' application page under Uninstall Tracking, and enter in the password for your .p12 certificate from above.

    Screen_Shot_2017-12-21_at_10.16.31_AM.png

A few important points to keep in mind: 

  • Singular use of Apple push notification services does not actually cause a push notification to appear for the end-user
  • Uninstall tracking is only available for users who have enabled push notifications for your app
  • Uninstalls are tracked as events in Singular and as a result do not remove the attribution link from the originating Install or Re-engagement source. This may result in uninstall rates of higher than 100%, since a user may uninstall an app multiple times in their lifetime.
Was this article helpful?
0 out of 0 found this helpful