Ir a la consola

Comenzar con Firebase In-App Messaging

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

Antes de comenzar

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 una versión superior: Firebase In-App Messaging usa CocoaPods para administrar las dependencias en iOS. Puedes instalarlo desde el sitio de CocoaPods.

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

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.

Envía 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.

A ese dispositivo de prueba lo determina un FirebaseInstanceID. Para encontrar el ID de instancia de tu app de prueba, ejecuta la app con el argumento del comando del entorno de ejecución -FIRDebugEnabled, como se indica a continuación:

  1. Con el proyecto de Xcode abierto, selecciona Producto > Esquema > Editar esquema… en la barra de menú superior.
  2. Abre la pestaña Argumentos en el cuadro de diálogo emergente.
  3. Haz clic en + Agregar artículos en Argumentos pasados al inicio.
  4. Escribe “-FIRDebugEnabled” en el campo que acabas de crear.
  5. Haz clic en Cerrar y ejecuta la app.

Cuando la app se abra, busca 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

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 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 vuelve a abrir la app en tu dispositivo de prueba.