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.

Adicionar 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 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 seu app. 

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.12.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:22.0.3")
    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, 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 (FID) do Firebase, envie uma mensagem para testar a configuração do Firebase In-App Messaging:

  1. No console do Firebase, acesse DevOps e engajamento > Mensagens.

  2. Inicie o fluxo de trabalho para configurar uma nova campanha:

    • Se esta for sua primeira campanha:

      1. Clique em Criar sua primeira campanha.
      2. Selecione Mensagens no app do Firebase e clique em Criar.

    • Se você já criou campanhas:

      1. Na guia Campanhas, clique em Nova campanha.
      2. Selecione Mensagens no app.

  3. Digite um Título para sua primeira mensagem.

  4. Clique em Testar no dispositivo.

  5. Digite o ID de instalação do Firebase Firebase do seu app no campo Adicionar um ID de instalação.

  6. Clique em Testar para enviar a mensagem. Ele será enviado imediatamente.

  7. Para ver a mensagem no dispositivo de teste, feche e abra novamente o app.

Para confirmar se o dispositivo é de teste, procure a seguinte mensagem de registro:

I/FIAM.Headless: Setting this device as a test device