Canais de notificação
Os canais de notificação são uma forma de organizar notificações por push que foram adicionadas com o Android O. A partir do O, todas as notificações por push devem ter um canal de notificação que indique o tipo de mensagem (por exemplo, “notificações de chat” ou “notificações de seguidores”). Seus usuários podem então controlar aspectos de suas notificações (por exemplo, adiar, configurações de som/vibração ou desativar, etc.) com base em canais individuais.
Transição para o Android O
Os canais de notificação só podem ser criados no código do seu app e não podem ser criados programaticamente no dashboard da Braze. Recomendamos que sua equipe de engenharia trabalhe com seus profissionais de marketing para garantir que os canais de notificação desejados sejam adicionados corretamente ao dashboard.
A partir do Android O, as notificações por push exigem um canal válido para serem exibidas. Se o seu app tem como alvo o Android O ou posterior, você deve usar a versão 2.1.0 ou posterior do SDK da Braze. Sua equipe de desenvolvimento deve definir os canais que você deseja usar, bem como as configurações de notificação sugeridas (por exemplo, importância, som, luzes) para cada canal no código do seu app. Você pode encontrar a documentação para desenvolvedores do Android aqui e a documentação para desenvolvedores da Braze aqui.
O Android suporta localização para nomes de canais, então no código do seu app, você pode associar um ID de canal a múltiplas traduções de um nome de canal.
Depois que esses canais forem criados, seus engenheiros precisarão repassar os IDs de canal associados para sua equipe de marketing. Sua equipe deve inserir os nomes e IDs dos canais no dashboard da Braze para uso em suas Campaigns e Canvas.
Para adicionar um canal ao dashboard da Braze, navegue até o criador de push para Android, selecione o campo de canais de notificação e então selecione “gerenciar canais”.
Somente usuários com permissões que incluem “gerenciar apps” poderão gerenciar canais.
Canal padrão do SDK
O Android exige um canal válido para exibir notificações por push no nível de API 26 (Android O) ou posterior. O SDK da Braze para Android 2.1.0 inclui um canal padrão chamado “General”, que será criado e usado se você não especificar canais adicionais no dashboard ou se tentar enviar para um canal inválido. Você pode renomear esse rótulo no SDK e fornecer uma descrição do canal. Recomendamos que você considere isso para proporcionar uma melhor experiência ao usuário.
Depois que um canal é adicionado ao seu app, você pode optar por removê-lo. No entanto, os consumidores sempre poderão ver o número de canais que você removeu. O dashboard da Braze não inclui suporte para criação programática de canais — os canais devem ser criados e definidos no código do seu app para proporcionar uma experiência integrada.
Novamente, recomendamos que você se coordene com sua equipe de engenharia para garantir uma transição tranquila para o direcionamento ao Android O.
Canal de fallback do dashboard
A Braze permite que você especifique um canal de fallback do dashboard. O objetivo do canal de fallback do dashboard é fornecer um ID de canal para mensagens push legadas sem seleção explícita de canal. Definimos uma seleção de canal como a escolha de um canal no nosso criador de push para Android.
Mensagens que não tiverem um canal selecionado serão enviadas com o ID do canal de fallback do dashboard. Quando você alterar seu canal de fallback do dashboard, qualquer mensagem que não tenha um canal explicitamente selecionado será enviada com o ID do novo canal de fallback.
Aqui está um exemplo do comportamento esperado do canal de fallback do dashboard:
Seu canal de fallback do dashboard é chamado “Marketing” e você tem 10 mensagens push para Android para as quais nunca selecionou um canal. Essas campanhas estão sendo enviadas pelo canal “Marketing” porque o canal “Marketing” é o canal de fallback do dashboard.
Além disso, você tem 15 mensagens que selecionou para enviar pelo canal “Social Notifications” e cinco mensagens que selecionou para enviar pelo canal “Marketing”.
Você então decide alterar seu canal padrão do dashboard de “Marketing” para “Updates”.
Nessa situação, todas as 10 campanhas sem seleção de canal que anteriormente eram enviadas pelo canal “Marketing” agora serão enviadas pelo canal “Updates”, porque essas mensagens são enviadas pelo canal de fallback. As 15 mensagens que eram enviadas pelo canal “Social Notifications” continuarão sendo enviadas pelo canal “Social Notifications”. As cinco mensagens que eram enviadas pelo canal “Marketing” continuarão sendo enviadas pelo canal “Marketing”.
No caso de um ID de canal inválido ser fornecido à Braze (como se você fornecer um ID de canal que seus desenvolvedores não criaram no SDK), a notificação será entregue pelo canal padrão do seu SDK. Portanto, recomendamos fortemente que você teste seus canais de notificação pelo dashboard da Braze durante o desenvolvimento.
Para entender melhor o comportamento esperado dos canais, consulte a tabela a seguir:
| Cenário | Resultado |
|---|---|
| Empresa ABC atualiza para um SDK que suporta Android O Empresa ABC não adiciona nenhum canal ao dashboard da Braze Empresa ABC não renomeia o canal padrão do SDK |
Notificações por push enviadas para dispositivos Android O criarão um canal chamado “General” e as notificações serão enviadas pelo canal “General” |
| Empresa XYZ atualiza para um SDK que suporta Android O Empresa XYZ não adiciona nenhum canal ao dashboard da Braze Empresa XYZ renomeia o canal padrão do SDK para “Marketing” |
Notificações por push enviadas para dispositivos Android O criarão um canal chamado “Marketing” e as notificações serão enviadas pelo canal “Marketing” |
| Empresa LMN atualiza para um SDK que suporta Android O Empresa LMN define dois canais no código do app, “Promotions” e “Order Updates” Empresa LMN adiciona os IDs dos canais “Promotions” e “Order Updates” ao dashboard da Braze Empresa LMN designa “Promotions” como o canal de fallback do dashboard Empresa LMN renomeia o canal padrão do SDK para “Marketing” |
Notificações por push enviadas para dispositivos Android O não criarão um canal A menos que o profissional de marketing especifique explicitamente que as notificações devem ser enviadas pelo canal “Order Updates” ou “Marketing”, todas as notificações criadas antes dos canais serem adicionados ao dashboard serão enviadas pelo canal “Promotions” O canal padrão do SDK, “Marketing”, só é criado e usado se a empresa tentar enviar uma notificação por um ID de canal inválido ou se for explicitamente selecionado |
| Empresa HIJ atualiza para o Android O, mas não atualiza o SDK da Braze para Android para a versão 2.1.0 ou posterior | Notificações enviadas para usuários com Android O ou posterior não aparecerão |
Adicionando canais ao dashboard da Braze
- Abra qualquer Campaign ou Canvas que inclua um push para Android e clique em Edit Campaign.
- Navegue até o criador de mensagens push para Android.
- Clique em Manage Notification Channels. Quaisquer canais adicionados aqui estarão disponíveis globalmente para todas as Campaigns e Canvas. Você deve ter permissões de “Manage Apps” para seu espaço de trabalho para gerenciar canais.
Quando você aplica um canal de notificação a uma Campaign ou etapa do Canvas específica, a contagem de Usuários contatáveis (localizada na etapa de Público-alvo) para push Android não parecerá mudar. No entanto, somente os usuários inscritos no canal de notificação selecionado verão a mensagem, e a análise de dados da sua campanha (como cliques) será medida com base nesse público.
- Clique em Add Notification Channel.
- Insira o nome e o ID do canal de notificação que você deseja adicionar.
- Repita as etapas 4 e 5 para cada canal de notificação que você deseja adicionar.
- Pressione Save para salvar suas alterações.
Especificando seu canal de fallback
Seu canal de fallback é o canal que a Braze tentará usar para enviar sua mensagem Android se você não tiver selecionado um canal para a mensagem. As únicas Campaigns e Canvas que terão mensagens Android sem seleção de canal são Campaigns e Canvas que foram criadas antes de sua equipe adicionar canais ao dashboard da Braze. Se você alterar seu canal de fallback, a mudança será aplicada globalmente a todas as Campaigns e Canvas sem uma seleção explícita de canal.
- Abra qualquer Campaign ou Canvas existente.
- Navegue até o criador de push para Android.
- Selecione Manage Notification Channels após expandir as opções de canal de notificação.
- Adicione o canal ao dashboard (se ainda não tiver sido adicionado).
- Selecione o botão de rádio ao lado do canal que você deseja designar como canal de fallback.
- Salve suas alterações. Suas alterações serão aplicadas globalmente.
Adicionando canais às suas mensagens push para Android
- Navegue até o criador de push para Android em qualquer Campaign ou Canvas.
- Selecione o canal que você deseja usar no menu suspenso. Se você não tiver um menu suspenso, mas sim a seguinte visualização, será necessário adicionar canais antes de selecioná-los para campanhas.
