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.
On the Campaigns page, create a Push Notification campaign and select iOS Push as your platform.
- On the Additional Message Settings page,
- Add the key
appboy_uninstall_trackingwith corresponding value
- Check Add Content-Available Flag
- Add the key
Use the Preview Message page to send yourself a test uninstall tracking push.
- Check that your app does not take any unwanted automatic actions upon receiving the push.
The above steps are a proxy for sending an uninstall tracking push from Braze. If you have badge counts enabled, a badge number will be sent along with the test push, but Braze’s uninstall tracking pushes will not set a badge number on your application.
Step 4: Enable Uninstall Tracking
Follow the instructions for enabling uninstall tracking using our article on Uninstall Tracking.