Comenzar con Firebase In-App Messaging

Esta guía de inicio rápido te muestra como configurar Firebase In-App Messaging y enviar tu primer mensaje.

ios
android

Antes de comenzar

ios

Antes de comenzar, debes configurar lo siguiente en el entorno:

  • Una app con Firebase habilitado: si todavía no lo has hecho, agrega Firebase a tu proyecto de iOS.
  • Xcode 9.2 o versión superior: Firebase In-App Messaging requiere una versión relativamente reciente de Xcode para ejecutarse. Puedes encontrar la versión más reciente de Xcode en el sitio de Xcode de Apple.
  • CocoaPods 1.4.0 o versión superior: Firebase In-App Messaging usa CocoaPods para administrar las dependencias en iOS. Puedes instalarla desde el sitio de CocoaPods.
android

Para comenzar, es necesario que tu app cumpla con dos requisitos:

  • Firebase habilitado: si todavía no lo has hecho, agrega Firebase a tu proyecto de Android.
  • SDK mínimo de Android de 16 o superior: Comprueba tu nivel de app build.gradle para minSdkVersion, que se debe establecer en 16 como mínimo.

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

ios

Para comenzar, agrega los archivos del marco de trabajo del SDK de Firebase In-App Messaging. Para ello, agrega el CocoaPods de Firebase In-App Messaging con estos pasos:

  1. Abre una nueva ventana de terminal y navega hasta el directorio del proyecto de Xcode.
  2. Abre tu Podfile y agrega las líneas destacadas:
    # Uncomment the next line to define a global platform for your project
    # platform :ios, '9.0'
    
    target 'YourProject' do
    # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
    use_frameworks!
    
    # Pods for YourProject
    pod 'Firebase'
    pod 'Firebase/InAppMessagingDisplay'
    end
  3. Desde tu terminal, instala las dependencias del pod:
    pod install
  4. Abre el proyecto de tu app en Xcode:
    open YOUR-PROJECT.xcworkspace
  5. Importa el módulo de Firebase en tu UIApplicationDelegate, si aún no lo has hecho:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  6. Además, configura una instancia compartida de FirebaseApp, normalmente en el método application:didFinishLaunchingWithOptions: de tu app, si aún no lo has hecho:
    Swift
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    Objective-C
    // Use Firebase library to configure APIs
    [FIRApp configure];
  7. Compila y ejecuta tu app.
android

Incluye el SDK en tus archivos de compilación

Agrega la dependencia In-App Messaging a tu nivel de aplicación build.gradle:

// ...
dependencies {
    // ...

    // Add the In-App Messaging depencency:
    implementation 'com.google.firebase:firebase-inappmessaging-display:17.0.0'

    // Check that your Firebase dependency is up-to-date:
    implementation 'com.google.firebase:firebase-core:16.0.1'
}

Enviar un mensaje de prueba

Obtener el ID de instancia de tu app

Para conservar la potencia, 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 demanda.

ios

Ese dispositivo de prueba lo determina un FirebaseInstanceID. Encuentra el ID de instancia de tu app de prueba mediante la ejecución del argumento del comando de tiempo de ejecución -FIRDebugEnabled y la búsqueda de la siguiente línea en los registros de la consola de Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Instance ID YOUR_APP_ID
android

Ese dispositivo de prueba lo determina un FirebaseInstanceId. Encuentra el ID de instancia de tu app de prueba con solo revisar el Logcat en Android Studio del siguiente registro de nivel “Info”:

I/FIAM.Headless: Starting InAppMessaging runtime with Instance ID YOUR_APP_ID

Enviar un mensaje a tu dispositivo de prueba

Una vez que hayas iniciado tu app en el dispositivo de prueba y tengas su ID de instancia, puedes probar la configuración de Firebase In-App Messaging mediante el envío de un mensaje de prueba:

  1. En Firebase console, abre In-App Messaging.
  2. Una vez allí, haz clic en Campaña nueva.
  3. Ingresa un Título para tu primer mensaje.
  4. Haz clic en Probar en tu dispositivo.
  5. Ingresa el ID de instancia de tu app en el campo Agregar un ID de instancia.
  6. Haz clic en Probar para enviar el mensaje.

Firebase In-App Messaging envía tu mensaje tan pronto haces clic en Probar. Para verlo, cierra y, luego, vuelve a abrir la app en tu dispositivo de prueba.

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.