Creación y envío de mensajes en la aplicación

Obtenga información sobre cómo crear mensajes en la aplicación para aplicaciones móviles con el SDK móvil de Experience Platform y Journey Optimizer.

Journey Optimizer le permite crear campañas para enviar mensajes en la aplicación a audiencias de destino. Las campañas en Journey Optimizer se utilizan para entregar contenido único a una audiencia específica mediante varios canales. Con las campañas, las acciones se realizan simultáneamente, ya sea de forma inmediata o en función de una programación especificada. Cuando se utilizan recorridos (consulte la lección Notificaciones push de Journey Optimizer), las acciones se ejecutan de forma secuencial.

Arquitectura

Antes de enviar mensajes en la aplicación con Journey Optimizer, debe asegurarse de que las configuraciones y integraciones adecuadas estén implementadas. Para comprender el flujo de datos de mensajería en la aplicación en Journey Optimizer, consulte la documentación.

NOTE
Esta lección es opcional y solo se aplica a los usuarios de Journey Optimizer que buscan enviar mensajes en la aplicación.

Requisitos previos

  • La aplicación se ha creado y ejecutado correctamente con los SDK instalados y configurados.
  • Configure la aplicación para Adobe Experience Platform.
  • Acceso a Journey Optimizer y permisos suficientes como se describe aquí. Además, necesita permisos suficientes para las siguientes funciones de Journey Optimizer.
    • Administrar campañas.
  • Dispositivo o simulador físico de iOS para realizar pruebas.

Objetivos de aprendizaje

En esta lección, debe

  • Crear una superficie de aplicación en AJO.
  • Instale y configure la extensión de etiquetas de Journey Optimizer.
  • Actualice la aplicación para registrar la extensión de etiqueta de Journey Optimizer.
  • Valide la configuración en Assurance.
  • Defina su propia experiencia de campaña y mensaje en la aplicación en Journey Optimizer.
  • Envíe su propio mensaje en la aplicación desde la aplicación.

Configuración

TIP
Si ya configuró su entorno como parte de la lección Mensajería push de Journey Optimizer, es posible que ya haya realizado algunos de los pasos de esta sección de configuración.

Añadir una superficie de aplicación en la recopilación de datos

  1. En la interfaz de recopilación de datos, seleccione Superficies de la aplicación en el panel izquierdo.

  2. Para crear una configuración, seleccione Crear superficie de aplicación.
    inicio de superficie de aplicación

  3. Escriba un Nombre para la configuración, por ejemplo Luma App Tutorial .

  4. En Configuración de aplicaciones móviles, seleccione Apple iOS.

  5. Introduzca el ID del paquete de la aplicación móvil en el campo ID de la aplicación (ID del paquete de iOS). Por ejemplo, com.adobe.luma.tutorial.swiftui.

  6. Seleccione Guardar.

    configuración de superficie de aplicación

Actualizar configuración de secuencia de datos

Para garantizar que los datos enviados desde la aplicación móvil al Edge Network se reenvíen a Journey Optimizer, actualice la configuración de Experience Edge.

  1. En la IU de recopilación de datos, seleccione Datastreams y su secuencia de datos, por ejemplo Luma Mobile App.

  2. Seleccione Más para Experience Platform y seleccione Editar Editar del menú contextual.

  3. En la pantalla Datastreams > Folder > Adobe Experience Platform, compruebe que Adobe Journey Optimizer esté seleccionado. Consulte Configuración de Adobe Experience Platform para obtener más información.

  4. Para guardar la configuración de su secuencia de datos, seleccione Guardar.

    Configuración de secuencia de datos AEP

Instalación de la extensión Journey Optimizer tags

Para que la aplicación funcione con Journey Optimizer, debe actualizar la propiedad de etiquetas.

  1. Vaya a Etiquetas > Extensiones > Catálogo.
  2. Abra su propiedad, por ejemplo Luma Mobile App Tutorial.
  3. Seleccione Catálogo.
  4. Busque la extensión Adobe Journey Optimizer.
  5. Instale la extensión de.

Cuando solo usa mensajes en la aplicación, en Instalar extensión o Configurar extensión, no necesita configurar nada. Sin embargo, si ya ha seguido la lección Notificaciones push del tutorial, verá que para el entorno Desarrollo, el conjunto de datos AJO Push Tracking Experience Event Dataset está seleccionado de la lista Conjunto de datos de evento.

Implementar Journey Optimizer en la aplicación

Como se ha explicado en lecciones anteriores, la instalación de una extensión de etiqueta móvil solo proporciona la configuración. A continuación, debe instalar y registrar el SDK de mensajería. Si estos pasos no están claros, revise la sección Instalar SDK.

NOTE
Si ha completado la sección Instalar SDK, el SDK ya está instalado y puede omitir este paso.
  1. En Xcode, asegúrese de que AEP Messaging se añada a la lista de paquetes en Dependencias del paquete. Consulte Administrador De Paquetes Swift.

  2. Vaya a Luma > Luma > AppDelegate en el navegador del proyecto Xcode.

  3. Asegúrese de que AEPMessaging forme parte de su lista de importaciones.

    import AEPMessaging

  4. Asegúrese de que Messaging.self forme parte de la matriz de extensiones que está registrando.

    code language-swift
    let extensions = [
        AEPIdentity.Identity.self,
        Lifecycle.self,
        Signal.self,
        Edge.self,
        AEPEdgeIdentity.Identity.self,
        Consent.self,
        UserProfile.self,
        Places.self,
        Messaging.self,
        Optimize.self,
        Assurance.self
    ]
    

Validar la configuración con Assurance

  1. Revise la sección instrucciones de configuración para conectar su simulador o dispositivo a Assurance.

  2. En la IU de Assurance, seleccione Configurar.
    configurar clic

  3. Seleccione el botón Más junto a Mensajería en la aplicación.

  4. Seleccione Guardar.
    guardar

  5. Seleccione Mensajería en la aplicación en el panel de navegación izquierdo.

  6. Seleccione la ficha Validación. Confirme que no está recibiendo ningún error.

    Validación en la aplicación

Cree su propio mensaje en la aplicación

Para crear su propio mensaje en la aplicación, debe definir una campaña en Journey Optimizer que almacene en déclencheur un mensaje en la aplicación en función de los eventos que se produzcan. Estos eventos pueden ser:

  • datos enviados a Adobe Experience Platform,
  • eventos de seguimiento principales, como la acción o el estado o la recopilación de datos PII, a través de las API genéricas principales de Mobile,
  • eventos del ciclo vital de la aplicación, como inicio, instalación, actualización, cierre o bloqueo,
  • eventos de geolocalización, como entrar o salir de un punto de interés.

En este tutorial, usará las API principales genéricas e independientes de la extensión de Mobile (consulte API principales genéricas de Mobile) para facilitar el seguimiento de eventos de pantallas de usuario, acciones y datos PII. Los eventos generados por estas API se publican en el centro de eventos del SDK y las extensiones los pueden utilizar. El centro de eventos del SDK proporciona la estructura de datos principal vinculada a todas las extensiones del SDK de la plataforma móvil y mantiene una lista de extensiones registradas y módulos internos, una lista de detectores de eventos registrados y una base de datos de estado compartida.

El centro de eventos del SDK publica y recibe datos de eventos de extensiones registradas para simplificar las integraciones con soluciones de Adobe y de terceros. Por ejemplo, cuando se instala la extensión Optimize, todas las solicitudes e interacciones con el motor de ofertas de Journey Optimizer - Gestión de decisiones se gestionan mediante el centro de eventos.

  1. En la interfaz de usuario de Journey Optimizer, seleccione Campañas en el carril izquierdo.

  2. Seleccione Crear campaña.

  3. En la pantalla Crear campaña:

    1. Seleccione Mensaje en la aplicación y elija una superficie de aplicación en la lista Superficie de aplicación, por ejemplo Luma Mobile App.

    2. Seleccionar Crear

      Propiedades de campaña

  4. En la pantalla de definición de campaña, en Propiedades, escriba un Nombre para la campaña, por ejemplo Luma - In-App Messaging Campaign, y una Descripción, por ejemplo In-app messaging campaign for Luma app.
    Nombre de campaña

  5. Desplácese hacia abajo hasta Acción y seleccione Editar contenido.

  6. En la pantalla Mensaje en la aplicación:

    1. Seleccione Modal como Diseño de mensaje.

    2. Escriba https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png para la URL multimedia.

    3. Escriba un encabezado, por ejemplo Welcome to this Luma In-App Message y un cuerpo, por ejemplo Triggered by pushing that button in the app....

    4. Escriba Descartar como botón #1 texto (principal).

    5. Observe cómo se actualiza la vista previa.

    6. Seleccione Revisar para activar.

      Editor en la aplicación

  7. En la pantalla Revisar para activar (Luma: mensajería en la aplicación), seleccione Editar en el mosaico Programar.
    Revisar horario y seleccionar horario

  8. En la pantalla de Luma - In-App Messaging Campaign, seleccione Editar Editar déclencheur.

  9. En el cuadro de diálogo déclencheur de mensajes en la aplicación , configure los detalles de la acción de seguimiento que almacena en déclencheur el mensaje en la aplicación:

    1. Para quitar evento de inicio de aplicación, seleccione Cerrar .

    2. Use Agregar Agregar condición repetidamente para generar la siguiente lógica para Mostrar mensaje si.

    3. Haga clic en Finalizado.

      lógica de Déclencheur

    Ha definido una acción de seguimiento, donde Action es igual a in-app y Context data con la acción es un par de valor clave de "showMessage" : "true".

  10. En la pantalla Luma - In-App Messaging Campaign, seleccione Revisar para activar.

  11. En la pantalla Revisar para activar (Luma: mensajería en la aplicación), seleccione Activar.

  12. Ves a tu Luma - In-App Messaging Campaign con el estado Activo en la lista Campañas.
    Lista de campañas

Déclencheur del mensaje en la aplicación

Dispone de todos los ingredientes para enviar un mensaje en la aplicación. Lo que queda es cómo almacenar en déclencheur este mensaje en la aplicación.

  1. Vaya a Luma > Luma > Utils > MobileSDK en el navegador del proyecto Xcode. Busque la función func sendTrackAction(action: String, data: [String: Any]?) y agregue el código siguiente, que llama a la función MobileCore.track, en función de los parámetros action y data.

    code language-swift
    // Send trackAction event
    MobileCore.track(action: action, data: data)
    
  2. Vaya a Luma > Luma > Views > General > ConfigView en el navegador del proyecto Xcode. Busque el código del botón Mensaje en la aplicación y añada el siguiente código:

    code language-swift
    // Setting parameters and calling function to send in-app message
    Task {
        MobileSDK.shared.sendTrackAction(action: "in-app", data: ["showMessage": "true"])
    }
    

Validar con la aplicación

  1. Vuelva a compilar y ejecute la aplicación en el simulador o en un dispositivo físico desde Xcode con Play .

  2. Vaya a la ficha Configuración.

  3. Pulse Mensaje en la aplicación. Verá que el mensaje en la aplicación aparece en la aplicación.

    {width="300"}

Validar la implementación en Assurance

Puede validar los mensajes en la aplicación en la interfaz de usuario de Assurance.

  1. Revise la sección instrucciones de configuración para conectar su simulador o dispositivo a Assurance.
  2. Seleccione Mensajería en la aplicación.
  3. Seleccione Lista de eventos.
  4. Seleccione una entrada de Mostrar mensaje.
  5. Inspect devuelve el evento sin procesar, especialmente html, que contiene el diseño y el contenido completos del mensaje en la aplicación.
    Mensaje en la aplicación de Assurance

Pasos siguientes

Ahora debe tener todas las herramientas para empezar a añadir mensajes en la aplicación, cuando corresponda. Por ejemplo, promocionar productos en función de interacciones específicas que esté rastreando en la aplicación.

SUCCESS
Ha habilitado la aplicación para mensajería en la aplicación y ha agregado una campaña de mensajería en la aplicación mediante Journey Optimizer y la extensión de Journey Optimizer para el SDK de Experience Platform Mobile.
Gracias por dedicar su tiempo a conocer el SDK móvil de Adobe Experience Platform. Si tiene preguntas, desea compartir comentarios generales o tiene sugerencias sobre contenido futuro, compártalas en esta publicación de debate de la comunidad de Experience League.

Siguiente: Crear y mostrar ofertas

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b