Comienza a usar Firebase In-App Messaging

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


Antes de comenzar

Antes de comenzar, asegúrate de agregar Firebase a tu proyecto de Apple.

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

Usa Swift Package Manager para instalar y administrar las dependencias de Firebase.

  1. En Xcode, con tu proyecto de app abierto, navega a File > Add Packages.
  2. Cuando se te solicite, agrega el repositorio del SDK de Firebase para plataformas de Apple:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Elige la biblioteca In-App Messaging.
  4. Agrega la marca -ObjC a la sección Other Linker Flags de la configuración de compilación de tu destino.
  5. Para usar In-App Messaging, debes habilitar Google Analytics en tu proyecto de Firebase y agrega el SDK de Firebase para Google Analytics a tu app. Puedes seleccionar ya sea la biblioteca sin la colección del IDFA o con la colección del IDFA.
  6. Cuando termines, Xcode comenzará a resolver y descargar automáticamente tus dependencias en segundo plano.

Ahora inicializa el SDK en tu app:

  1. Importa el módulo de Firebase en tu struct App o UIApplicationDelegate si aún no lo has hecho:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Además, configura una instancia compartida de FirebaseApp, generalmente en el inicializador de tu App o en el método application(_:didFinishLaunchingWithOptions:) del delegado de tu app, si no lo has hecho:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Compila y ejecuta tu app.

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 del una vez al día. Esto puede dificultar las pruebas, por lo que La consola de Firebase te permite especificar un dispositivo de prueba que muestra mensajes según demanda.

Ese dispositivo de prueba se determina mediante un ID de instalación de Firebase proporcionado por el Servicio de instalaciones de Firebase. Para encontrar el ID de instalación de tu app de prueba, ejecuta la app con el Argumento del comando de entorno de ejecución -FIRDebugEnabled:

  1. Con el proyecto de Xcode abierto, selecciona Product > Scheme > Edit scheme en la barra de menú superior.
  2. Abre la pestaña Arguments en el diálogo emergente.
  3. Haz clic en + Add items en Arguments Passed On Launch.
  4. Escribe “-FIRDebugEnabled” en el campo que acabas de crear.
  5. Haz clic en Close 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 Firebase 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 ID de instalación de Firebase (FID); puedes probar tu Firebase In-App Messaging configuración enviando un mensaje de prueba:

  1. En la consola de Firebase, abre la página Mensajes.
  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 del Firebase de tu app en el Campo Agrega 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:

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.