Comece a usar o recurso "Mensagens no app" do Firebase

Veja neste guia de início rápido como configurar o recurso Firebase In-App Messaging e como 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 Firebase In-App Messaging SDK 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 recurso 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, é necessário ativar 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:34.11.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 o 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:22.0.2")
    implementation("com.google.firebase:firebase-analytics:23.2.0")
}

Enviar uma mensagem de teste

Receber o ID de instalação do app

Para economizar energia, Firebase In-App Messaging só recupera notificações do servidor uma vez por dia. Isso pode dificultar o teste. Por isso, o Firebase console permite especificar um dispositivo de teste que exibe mensagens sob demanda.

Esse dispositivo de teste é determinado por um FirebaseInstallations ID 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 Firebase ID de instalação (FID), envie uma mensagem para testar a Firebase In-App Messaging configuração:

  1. No Firebase console, abra a página Mensagens.
  2. Se esta for sua primeira campanha, clique em Criar sua primeira campanha.
    1. Selecione Mensagens no app do Firebase e clique em Criar.
  3. Caso contrário, na guia Campanhas, clique em Nova campanha.
    1. Selecione Mensagens no app.
  4. Digite um Título para sua primeira mensagem.
  5. Clique em Testar no dispositivo.
  6. Digite o ID de instalação Firebase do seu app no campo Adicionar um ID de instalação.
  7. Clique em Testar para enviar a mensagem.

Firebase In-App Messaging envia sua notificação 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