Neste guia de início rápido, mostramos como configurar o Firebase In-App Messaging e enviar sua primeira mensagem.
Antes de começar
Adicione o Firebase ao seu projeto do Android caso ainda não tenha feito isso.
Adicione o SDK do Firebase In-App Messaging ao seu projeto
No arquivo Gradle do módulo (nível do app) (geralmente <project>/<app-module>/build.gradle.kts
ou <project>/<app-module>/build.gradle
), adicione a dependência da biblioteca do In-App Messaging para Android. Recomendamos o uso do
Firebase Android BoM
para controlar o controle de versões da biblioteca.
Para usar In-App Messaging, você precisa ativar Google Analytics no seu projeto do Firebase e adicione o SDK do Firebase para Google Analytics ao seu app.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.4.0")) // Add the dependencies for the In-App Messaging and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-inappmessaging-display") implementation("com.google.firebase:firebase-analytics") }
Com a Firebase Android BoM, seu app sempre vai usar versões compatíveis das bibliotecas do Firebase para Android.
(Alternativa) Adicionar dependências das bibliotecas do Firebase sem usar o BoM
Se você preferir não usar o Firebase BoM, especifique cada versão das bibliotecas do Firebase na linha de dependência correspondente.
Se você usa várias bibliotecas do Firebase no app, recomendamos utilizar o BoM para gerenciar as versões delas, porque isso ajuda a garantir a compatibilidade de todas as bibliotecas.
dependencies { // Add the dependencies for the In-App Messaging and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-inappmessaging-display:21.0.0") implementation("com.google.firebase:firebase-analytics:22.1.2") }
Enviar uma mensagem de teste
Receber o ID de instalação do app
Para economizar energia, o Firebase In-App Messaging só recupera mensagens do ao servidor uma vez por dia. Isso pode dificultar o teste, então O console Firebase permite especificar um dispositivo de teste que mostra mensagens sob demanda.
Esse dispositivo de teste é determinado por um ID
FirebaseInstallations
ou FID.
Encontre o FID do seu aplicativo de teste ao verificar o
log de nível "Info" no Android Studio:
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
Enviar uma mensagem para seu dispositivo de teste
Depois de iniciar o app no dispositivo de teste e receber o ID de instalação do Firebase (FID, na sigla em inglês), envie uma mensagem de teste para testar a configuração do Firebase In-App Messaging:
- No console do Firebase, abra a página Mensagens.
- Se esta for sua primeira campanha, clique em Criar sua primeira campanha.
- Selecione Mensagens no app do Firebase e clique em Criar.
- Caso contrário, na guia Campanhas, clique em Nova campanha.
- Selecione Mensagens no app.
- Digite um Título para sua primeira mensagem.
- Clique em Testar no dispositivo.
- Insira o ID de instalação Firebase do seu app no campo Adicionar um ID de instalação.
- Clique em Testar para enviar a mensagem.
Firebase In-App Messaging envia sua mensagem de teste assim que você clica em Testar. Para ver a mensagem, feche e abra novamente o app no dispositivo de teste.
Para confirmar se o dispositivo é de teste, procure a seguinte mensagem de registro:
I/FIAM.Headless: Setting this device as a test device