Como configurar o In-app Messaging no Firebase
O In-app Messaging é uma ferramenta poderosa para aumentar o engajamento, promover campanhas e orientar o usuário em ações específicas.
1. Criando uma nova campanha
Para iniciar uma campanha de In-App Messaging, siga os passos abaixo no console do Firebase:
Acesse a aba "Messaging" no painel lateral do Firebase.
Clique no botão "Nova Campanha" e selecione a opção "Mensagens no app".
Configure o Estilo e Conteúdo (texto, cores e imagens) conforme o planejado.
Dica de Performance: Na etapa de anexar imagens, prefira utilizar links hospedados em plataformas como o VTEX Assets. Isso garante melhor desempenho de carregamento e compatibilidade.
Siga as etapas padrão de Segmentação, Programação e Eventos Principais, de forma semelhante à configuração de uma Push Notification.
2. Tipos de Direcionamento e Configuração
No In-App Messaging, existem dois tipos de direcionamentos que funcionam de forma independente:
A. Direcionamento por Clique (Ação do Botão)
Define para onde o usuário será levado ao interagir com a mensagem.
Como configurar: No campo "Ação do botão", insira a URL da página de destino (Deep Link ou link externo).
B. Direcionamento para Exibição (Evento de Disparo)
Define o momento exato em que a mensagem aparecerá para o usuário baseando-se em seu comportamento.
Como configurar: Na opção de Programação, configure os eventos de disparo desejados (ex:
add_to_cart).Ajuste Importante: É fundamental remover o evento padrão
on_foregroundpara que a mensagem não apareça genericamente sempre que o app for aberto.
Requisito Técnico: Para que o direcionamento por evento funcione, o envio de eventos via Measurement Protocol deve estar desativado, mantendo-se ativo apenas o envio via Firebase Analytics. Isso garante que o Firebase processe os gatilhos corretamente.
3. Realizando Testes em Dispositivos Específicos
Para testar o layout e o comportamento antes de publicar, você precisará acessar o Modo Debug do aplicativo.
(Caso não tenha acesso ao Modo Debug, solicite ao suporte a inclusão do seu e-mail como usuário de teste).
No console do Firebase (etapa "Estilo e Conteúdo"), preencha os campos obrigatórios para habilitar o botão "Testar no dispositivo".
Pressione o dedo sobre o ID para copiá-lo (o app copiará o texto para a área de transferência, mesmo sem exibir um aviso de confirmação).
De volta ao Firebase, clique em "Testar no dispositivo" (à direita na seção de visualização).
Cole o ID no campo "Adicionar um ID de instalação" e clique em "Testar".
Validação: Feche e abra o aplicativo novamente para visualizar o pop-up de teste.
Observações e Limitações
Versão do App: Esta funcionalidade exige o Firebase Analytics SDK e versão do aplicativo igual ou superior à 12.80.0.
Segmentação por Plataforma: Devido a uma limitação do Firebase, cada campanha pode ser configurada para apenas uma plataforma por vez. Para alcançar usuários de Android e iOS, é necessário criar duas campanhas separadas.
Ativação Google Cloud: Para utilizar a funcionalidade pela primeira vez, entre em contato com o suporte para solicitar a ativação das notificações de In-App no Google Cloud.