Atualizando para Android 13

Este guia descreve as alterações relevantes introduzidas no Android 13 (2022) e as etapas de upgrade necessárias para a integração de seu SDK da Braze para Android.

Consulte a documentação do desenvolvedor do Android 13 para obter um guia de migração completo.

Android 13 Braze SDK

Para se preparar para o Android 13, faça o upgrade do SDK da Braze para a versão mais recente (v21.0.0+). Ao fazer isso, você terá acesso ao nosso novo recurso de push primer “sem código”.

Alterações no Android 13

Permissão de push

O Android 13 introduz uma grande mudança na forma como os usuários gerenciam os apps que enviam notificações por push. No Android 13, os apps precisam obter permissão antes que as notificações por push possam ser exibidas.

Essa nova permissão segue um padrão semelhante ao push do iOS e da web, em que você tem apenas uma tentativa de obter a permissão. Se um usuário escolher Don't Allow ou dispensar o prompt, seu app não poderá solicitar a permissão novamente.

Observe que os apps recebem uma isenção para usuários que já tinham as notificações por push ativadas antes de atualizar para o Android 13. Esses usuários continuarão elegíveis para receber push quando atualizarem para o Android 13 sem precisar solicitar permissão.

Momento do prompt de permissão

Direcionando para o Android 13

Apps direcionados ao Android 13 podem controlar quando solicitar a permissão e exibir o prompt nativo de push.

Se o usuário fizer upgrade do Android 12 para o 13, seu app já estiver instalado e você já estiver enviando push, o sistema concederá automaticamente a nova permissão de notificação a todos os apps elegíveis. Em outras palavras, esses apps podem continuar enviando notificações aos usuários, e os usuários não verão um prompt de permissão em tempo de execução.

Para mais detalhes, consulte a documentação do desenvolvedor do Android sobre os efeitos nas atualizações de apps existentes.

Direcionando para o Android 12 ou anterior

Se o seu app ainda não direciona para o Android 13, quando um novo usuário no Android 13 instalar seu app, ele verá automaticamente um prompt de permissão de push quando o app criar seu primeiro canal de notificação (via notificationManager.createNotificationChannel). Usuários que já possuem seu app instalado e depois fazem upgrade para o Android 13 nunca verão um prompt e receberão automaticamente a permissão de push.

Nota

O SDK da Braze v23.0.0 cria automaticamente um canal de notificação padrão caso ainda não exista um quando uma notificação por push é recebida. Se você não direcionar para o Android 13, isso fará com que o prompt de permissão de push seja exibido, o que é necessário para mostrar a notificação.

Preparando-se para o Android 13

É altamente recomendável que seu app direcione para o Android 13 para controlar quando os usuários são solicitados a conceder permissão de push.

Direcionar para o Android 13 permite otimizar suas taxas de aceitação de push solicitando permissão aos usuários em momentos mais apropriados, proporcionando uma melhor experiência de usuário em como e quando seu app solicita a permissão de push.

Para começar a usar nosso novo recurso de push primer “sem código”, faça o upgrade do SDK para Android para a versão mais recente (v23.0.0+).