Uninstall Tracking for iOS

This article covers how to configure uninstall tracking for your iOS application, and how to test to ensure that your app does not take any unwanted automatic actions upon receiving a Braze uninstall tracking push.

Uninstall Tracking utilizes background push notifications with a Braze flag in the payload. For more information, see our Uninstall Tracking page in our User Guide.

Step 1: Enabling Background Push

Make sure that you have enabled the “Remote notifications” option from the “Background Modes” section of your Xcode project’s Capabilities tab. For additional details, refer to our documentation on Silent Push Notifications.

Step 2: Checking for Braze Background Push

Braze uses background push notifications to collect uninstall tracking analytics. Follow the instructions here to ensure that your application does not take any unwanted actions upon receiving Braze’s uninstall tracking notifications.

Step 3: Test from the Dashboard

To ensure that your app does not take any unwanted automatic actions upon receiving a Braze uninstall tracking push, send yourself a test push from the dashboard. This test push will not update your User Profile.

1. On the Campaigns page, create a Push Notification campaign and select iOS Push as your platform.
   
   
2. On the Additional Message Settings page,
   • Add the key appboy_uninstall_tracking with corresponding value true
   • Check Add Content-Available Flag
     
     
     
     
3. Use the Preview Message page to send yourself a test uninstall tracking push.
   
   
   
   
4. Check that your app does not take any unwanted automatic actions upon receiving the push.

Step 4: Enable Uninstall Tracking

Follow the instructions for enabling uninstall tracking using our article on Uninstall Tracking.