This guide will continue to update as new Android 13 beta versions are released. Check back here for updates related to Braze compatibility with Android 13. (Last Updated: March 29, 2022)
Android 13 SDK upgrade guide
This guide describes relevant changes introduced in Android 13 (2022) and the required upgrade steps for your Braze Android SDK integration.
Refer to the Android 13 developer documentation for a full migration guide.
Changes in Android 13
Push permission
Android 13 introduces a major change in how users manage apps that send push notifications. In Android 13, apps will be required to obtain permission before push notifications can be shown.
This new permission follows a similar pattern to iOS and Web push, where you only have one attempt to obtain permission. If a user declines push (explicitly or by clicking outside of the prompt), your app cannot ask for permission again.
Note that apps are granted a temporary exemption intended for users who previously had push notifications for that app enabled prior to updating to Android 13. These users will remain eligible to receive push from the app until (A) they explicitly decline the permission prompt when it’s shown (or within system settings), or (B) the app is opened for the first time after a user upgrades to Android 13.
Permission prompt timing
Targeting Android 13
Apps targeting Android 13 can control when to request permission and show the native push prompt. If your user upgrades from Android 12 to 13, your app was previously installed, and you were already sending push, you’ll have temporary permission to show notifications until the user opens your app again after upgrading the device.
Targeting Android 12 or earlier
If your app does not yet target Android 13, then once a user upgrades to Android 13, they will automatically see a push permission prompt when your app creates its first notification channel (via notificationManager.createNotificationChannel
).
Braze automatically creates a default notification channel if one does not already exist when a push notification is received. If you don’t target Android 13, this will cause the push permission prompt to be shown, which is required to show the notification.
Preparing for Android 13
This guide will continue to update as new Android 13 beta versions are released. Check back here for updates related to Braze compatibility with Android 13.
We strongly recommend that you prepare an Android 13 compatible build in time for the Android 13 platform stability milestone.
This will allow you to optimize your push opt-in rates by prompting users at more appropriate times and will lead to a better user experience in how and when your app asks for push permission.