Este guia de início rápido mostra como configurar o Firebase In-App Messaging e enviar sua primeira mensagem.
Antes de você começar
Adicione o Firebase ao seu projeto Android , caso ainda não o tenha feito.
Adicione o SDK do Firebase In-App Messaging ao seu projeto
No arquivo Gradle do seu módulo (nível de aplicativo) (geralmente <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle ), adicione a dependência para o In- Biblioteca de mensagens do aplicativo para Android. Recomendamos usar o Firebase Android BoM para controlar o controle de versão da biblioteca.
Para usar mensagens no aplicativo, você deve ativar o Google Analytics em seu projeto do Firebase e adicionar o SDK do Firebase para Google Analytics ao seu aplicativo.
dependencies {
// Import the BoM for the Firebase platform
implementation(platform("com.google.firebase:firebase-bom:32.8.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")
}
Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.
(Alternativa) Adicionar dependências da biblioteca Firebase sem usar o BoM
Se você optar por não usar o Firebase BoM, deverá especificar cada versão da biblioteca do Firebase em sua linha de dependência.
Observe que se você usa várias bibliotecas do Firebase no seu aplicativo, é altamente recomendável usar a BoM para gerenciar as versões da biblioteca, o que garante que todas as versões sejam compatíveis.
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:20.4.1")
implementation("com.google.firebase:firebase-analytics:21.6.1")
}
Envie uma mensagem de teste
Obtenha o ID de instalação do seu aplicativo
Para economizar energia, o Firebase In-App Messaging recupera mensagens do servidor apenas uma vez por dia. Isso pode dificultar os testes, 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 verificando o Logcat no Android Studio para obter o seguinte registro de nível `Info`:
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
Envie uma mensagem para seu dispositivo de teste
Depois de iniciar seu aplicativo no dispositivo de teste e obter o ID de instalação do Firebase (FID), você poderá testar a configuração do Firebase In-App Messaging enviando uma mensagem de teste:
- No console do Firebase, abra a página Mensagens .
- Se esta for sua primeira campanha, clique em Criar sua primeira campanha .
- Selecione Mensagens no aplicativo do Firebase e clique em Criar .
- Caso contrário, na guia Campanhas , clique em Nova campanha .
- Selecione Mensagens no aplicativo .
- Insira um título para sua primeira mensagem.
- Clique em Testar no dispositivo
- Insira o ID de instalação do Firebase do seu aplicativo 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 Test . Para ver a mensagem, você precisa fechar e reabrir o aplicativo no seu dispositivo de teste.
Para confirmar se o seu dispositivo é um dispositivo de teste, procure a seguinte mensagem de registro:
I/FIAM.Headless: Setting this device as a test device