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.
Adicionar o SDK do Firebase In-App Messaging ao 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 o In-App Messaging, é necessário ativar o Google Analytics no seu projeto do Firebase e adicionar o SDK do Firebase para Google Analytics ao app.
dependencies {
// Import the BoM for the Firebase platform
implementation(platform("com.google.firebase:firebase-bom:33.6.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.1")
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 servidor uma vez por dia. Isso pode dificultar o teste. Por isso, o console do Firebase permite especificar um dispositivo de teste que exibe 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.
O 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