Comienza a usar Firebase In-App Messaging

En esta guía de inicio rápido, verás cómo configurar Firebase In-App Messaging y enviar tu primer mensaje.


Antes de comenzar

Si aún no lo has hecho, agrega Firebase a tu proyecto de Android.

Agrega el SDK de Firebase In-App Messaging a tu proyecto

En el archivo Gradle del módulo (nivel de la app) (generalmente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), agrega la dependencia de la biblioteca de In-App Messaging para Android. Te recomendamos usar Firebase Android BoM para controlar las versiones de las bibliotecas.

Para usar In-App Messaging, debes habilitar Google Analytics en tu proyecto de Firebase y agregar el SDK de Firebase para Google Analytics a tu 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")
}

Cuando usas Firebase Android BoM, tu app siempre usará versiones compatibles de las bibliotecas de Firebase para Android.

(Alternativa)  Agrega dependencias de la biblioteca de Firebase sin usar la BoM

Si eliges no usar la Firebase BoM, debes especificar cada versión de la biblioteca de Firebase en su línea de dependencia.

Ten en cuenta que, si usas múltiples bibliotecas de Firebase en tu app, es muy recomendable que uses la BoM para administrar las versiones de las bibliotecas para garantizar que todas las versiones sean compatibles. 

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")
}
 ¿Buscas un módulo de biblioteca específico de Kotlin? A partir de octubre de 2023 (Firebase BoM 32.5.0), tanto los desarrolladores de Kotlin como los de Java pueden depender del módulo de la biblioteca principal (para obtener más información, consulta las Preguntas frecuentes sobre esta iniciativa).

Envía un mensaje de prueba

Obtén el ID de instalación de tu app

Para ahorrar energía, Firebase In-App Messaging solo recupera los mensajes desde el servidor una vez al día. Esta acción puede dificultar las pruebas, de manera que Firebase console te permite especificar un dispositivo de prueba que muestra mensajes según la demanda.

Ese dispositivo de prueba se determina mediante un ID FirebaseInstallations o FID. Para encontrar el FID de la app de prueba, busca el siguiente registro de nivel “Info” en el Logcat de Android Studio:

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

Envía un mensaje a tu dispositivo de prueba

Una vez que hayas iniciado tu app en el dispositivo de prueba y tengas su ID de instalación (FID) Firebase, puedes probar la configuración de Firebase In-App Messaging enviando un mensaje de prueba:

  1. En Firebase console, abre la página Mensajería.
  2. Si esta es tu primera campaña, haz clic en Crear la primera campaña.
    1. Selecciona Mensajes desde la app de Firebase y haz clic en Crear.
  3. De lo contrario, en la pestaña Campañas, haz clic en Campaña nueva.
    1. Selecciona In-App Messaging.
  4. Ingresa un Título para tu primer mensaje.
  5. Haz clic en Probar en el dispositivo
  6. Ingresa el ID de instalación de Firebase de tu app en el campo Agregar un ID de instalación.
  7. Haz clic en Probar para enviar el mensaje.

Firebase In-App Messaging envía el mensaje de prueba en cuanto haces clic en Probar. Para ver el mensaje, debes cerrar la app y volver a abrirla en el dispositivo de prueba.

Para confirmar si el dispositivo es de prueba, busca el siguiente mensaje de registro:

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