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

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")
}
Está procurando um módulo de biblioteca específico do Kotlin? A partir de outubro de 2023 (Firebase BoM 32.5.0), os desenvolvedores Kotlin e Java poderão depender do módulo da biblioteca principal. Para mais detalhes, consulte Perguntas frequentes sobre essa iniciativa).

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:

  1. No console do Firebase, 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. Insira 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 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