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 general information, see uninstall tracking 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. Refer to our silent push notification documentation for additional details.
Step 2: Checking for Braze background push
Braze uses background push notifications to collect uninstall tracking analytics. Ensure that your application does not take any unwanted actions upon receiving Braze’s uninstall tracking notifications.
Step 3: Test from the dashboard
Next, 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 Settings page, add the key
appboy_uninstall_trackingwith corresponding value
trueand check Add Content-Available Flag.
- Use the Preview page to send yourself a test uninstall tracking push.
- Check that your app does not take any unwanted automatic actions upon receiving the push.
These testing 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.