Canais de notificação

Os canais de notificação são uma forma de organizar as 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 bate-papo” ou “seguir notificações”). Seus usuários podem então controlar aspectos da notificação (por exemplo, soneca, configurações de ruído/vibração ou desativação, etc.) com base em canais individuais.

Transição para o Android O

Os canais de notificação só podem ser criados no código de seu aplicativo e não podem ser criados programaticamente no painel do Braze. Recomendamos que sua equipe de engenharia trabalhe com os profissionais de marketing para garantir que os canais de notificação desejados sejam adicionados corretamente ao painel.

A partir do Android O, as notificações por push exigem um canal válido para serem exibidas. Se o seu aplicativo for voltado para o Android O ou posterior, você deverá usar o Braze SDK versão 2.1.0 ou posterior. Sua equipe de desenvolvimento deve definir os canais que deseja usar, bem como as configurações de notificação sugeridas (por exemplo, importância, som, luzes) para cada canal no código do aplicativo. Você pode encontrar a documentação do desenvolvedor do Android aqui e a documentação do desenvolvedor do Braze aqui.

Depois que esses canais forem criados, seus engenheiros precisarão passar os IDs de canal associados para a equipe de marketing. Sua equipe deve inserir os nomes e as IDs dos canais no painel do Braze para uso em suas campanhas e Canvases.

Para adicionar um canal ao painel do Braze, navegue até o compositor de push do Android, selecione o campo de canais de notificação e, em seguida, selecione “gerenciar canais”.

Canal padrão do SDK

O Android exige um canal válido para exibir notificações por push no nível 26 da API (Android O) ou posterior. O Braze Android SDK 2.1.0 inclui um canal padrão chamado “General”, que será criado e usado se você não especificar canais adicionais no painel 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 considere essa possibilidade para proporcionar uma melhor experiência ao usuário.

Depois que um canal é adicionado ao seu aplicativo, você pode optar por removê-lo. No entanto, os consumidores sempre poderão ver o número de canais que você [removeu].3 O painel do Braze não inclui suporte para a criação programática de canais - os canais devem ser criados e definidos no código do seu aplicativo para proporcionar uma experiência perfeita.

Novamente, recomendamos que você coordene com sua equipe de engenharia para garantir uma transição perfeita para o Android O.

Canal de fallback do painel

O Braze permite que você especifique um canal de fallback do dashboard. A finalidade do canal de fallback do painel é fornecer uma ID de canal para mensagens push herdadas sem seleção explícita de canal. Definimos uma seleção de canal como a escolha de um canal em nosso compositor de push do Android.

As mensagens que não tiverem um canal selecionado serão enviadas com a ID do canal de fallback do painel. Quando você altera o canal de fallback do painel, qualquer mensagem que não tenha um canal explicitamente selecionado será enviada com a ID do novo canal de fallback.

Aqui está um exemplo do comportamento esperado do canal de fallback do painel:

Seu canal de fallback do painel é chamado de “Marketing” e você tem 10 mensagens push do 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 painel.

Além disso, você tem 15 mensagens que selecionou para enviar por meio do canal “Social Notifications” (Notificações sociais) e cinco mensagens que selecionou para enviar por meio do canal “Marketing”.

Em seguida, você decide alterar o canal padrão do painel de “Marketing” para “Atualizações”.

Nessa situação, todas as 10 campanhas sem seleção de canal que foram enviadas anteriormente pelo canal “Marketing” agora serão enviadas pelo canal “Atualizações” porque essas mensagens são enviadas pelo canal de fallback. As 15 mensagens que foram enviadas pelo canal “Social Notifications” continuarão sendo enviadas pelo canal “Social Notifications”. As cinco mensagens que foram enviadas pelo canal “Marketing” continuarão a ser enviadas pelo canal “Marketing”.

Caso uma ID de canal inválida seja fornecida à Braze (por exemplo, se você fornecer uma ID de canal que seus desenvolvedores não criaram no SDK), enviaremos a notificação por meio de seu canal padrão do SDK. Portanto, recomendamos que você teste seus canais de notificação por meio do painel de controle do Braze durante o desenvolvimento.

Para entender melhor o comportamento esperado dos canais, consulte a tabela a seguir:

Cenário	Resultado
Atualizações da empresa ABC para um SDK compatível com o Android O A empresa ABC não adiciona nenhum canal ao painel de controle do Braze A empresa ABC não renomeia o canal padrão do SDK	As notificações por push enviadas para dispositivos Android O criarão um canal chamado “Geral” e as notificações serão enviadas por meio do canal “Geral”
A empresa XYZ atualiza para um SDK compatível com o Android O A empresa XYZ não adiciona nenhum canal ao painel de controle do Braze A empresa XYZ renomeia o canal padrão do SDK para “Marketing”	As notificações por push enviadas para dispositivos Android O criarão um canal chamado “Marketing” e as notificações serão enviadas por meio do canal “Marketing”
Empresa LMN atualiza para um SDK compatível com o Android O A empresa LMN define dois canais em seu código de aplicativo, “Promoções” e “Atualizações de pedidos” A empresa LMN adiciona as IDs de canal para “Promoções” e “Atualizações de pedidos” ao painel do Braze A empresa LMN designa “Promoções” como o canal de fallback do painel A empresa LMN renomeia seu canal padrão do SDK para “Marketing”	As 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” (Atualizações de pedidos) ou “Marketing”, todas as notificações criadas antes de os canais serem adicionados ao painel serão enviadas pelo canal “Promotions” (Promoções) O canal padrão do SDK, “Marketing”, só é criado e usado se a empresa tentar enviar uma notificação por meio de uma ID de canal inválida ou se for selecionado explicitamente
A empresa HIJ atualiza para o Android O, mas não atualiza o Braze Android SDK para 2.1.0 ou posterior	As notificações enviadas aos usuários que executam o Android O ou posterior não são exibidas

Adicionar canais ao painel de controle do Braze

1. Abra qualquer campanha ou Canvas que inclua um push do Android e clique em Edit Campaign (Editar campanha).
2. Navegue até o compositor de mensagens push do Android.
3. Clique em Manage Notification Channels (Gerenciar canais de notificação). Todos os canais adicionados aqui estarão disponíveis globalmente para todas as campanhas e Canvases. Você deve ter permissões de “Gerenciar aplicativos” em seu espaço de trabalho para gerenciar canais.

Quando você aplica um canal de notificação a uma campanha específica ou a uma etapa do Canvas, sua contagem de usuários alcançáveis (localizada na etapa Público-alvo) para o Android Push não parecerá alterada. No entanto, somente os usuários inscritos no canal de notificação selecionado verão a mensagem, e a análise da sua campanha (como cliques) será medida com base nesse público.

!

4. Clique em Add Notification Channel (Adicionar canal de notificação). 5. Digite o nome e o ID do canal de notificação que você deseja adicionar.

!

6. Repita as etapas 4 e 5 para cada canal de notificação que você deseja adicionar. 7. Pressione Save (Salvar ) para salvar suas alterações.

Especificando seu canal de fallback

Seu canal de fallback é o canal com o qual o Braze tentará enviar sua mensagem Android se você não tiver selecionado um canal para a mensagem. As únicas campanhas e Canvases que terão mensagens Android sem uma seleção de canal são as campanhas e Canvases que foram criadas antes de sua equipe adicionar canais ao painel do Braze. Se você alterar seu canal de fallback, a alteração será aplicada globalmente a todas as campanhas e Canvases sem uma seleção explícita de canal.

1. Abra qualquer campanha ou Canvas existente.
2. Navegue até o compositor de push do Android.
3. Selecione Manage Notification Channels (Gerenciar canais de notificação ) depois de expandir as opções de canal de notificação.
   
   !
   
   
4. Adicione o canal ao painel (se ele ainda não tiver sido adicionado).
5. Selecione o botão de rádio ao lado do canal que você deseja designar como canal de fallback.
6. Salve suas alterações. Suas alterações serão aplicadas globalmente.

Adição de canais às mensagens push do Android

1. Navegue até o compositor de push do Android em qualquer campanha ou tela.
2. Selecione o canal que você gostaria de usar no menu suspenso. Se você não tiver um menu suspenso, mas sim a visualização a seguir, precisará adicionar canais antes de selecioná-los para as campanhas.

!