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 Experience Platform Mobile SDK 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.

Cree una configuración de canal en Journey Optimizer

Para empezar, debe crear una configuración de canal para poder enviar notificaciones de mensajes en la aplicación desde Journey Optimizer.

  1. En la interfaz de Journey Optimizer, abra el menú Canales > Configuración general > Configuraciones de canal y luego seleccione Crear configuración de canal.

    Crear una configuración de canal

  2. Introduzca un nombre y una descripción (opcional) para la configuración.

    note note
    NOTE
    Los nombres deben comenzar por una letra (A-Z). Solo puede contener caracteres alfanuméricos. También puede utilizar caracteres de guion bajo _, punto . y guion -.
  3. Para asignar etiquetas de uso de datos principales o personalizadas a la configuración, puedes seleccionar Administrar acceso. Obtenga más información acerca del Control de acceso de nivel de objeto (OLAC).

  4. Seleccione el canal mensajería en la aplicación.

  5. Seleccione Acciones de marketing para asociar directivas de consentimiento a los mensajes que usan esta configuración. Todas las políticas de consentimiento asociadas con la acción de marketing se aprovechan para respetar las preferencias de los clientes. Más información sobre las acciones de marketing.

  6. Seleccione la plataforma para la que desea definir la configuración. Esto le permite especificar la aplicación de destino para cada plataforma y garantiza una entrega de contenido coherente en varias plataformas.

    note note
    NOTE
    En las plataformas iOS y Android, la entrega se basa únicamente en el ID de aplicación. Si ambas aplicaciones comparten el mismo ID de aplicación, el contenido se enviará a ambas, independientemente de la plataforma seleccionada en la configuración del canal.
  7. Seleccione Enviar para guardar los cambios.

    Configurar el canal en la aplicación

Actualizar configuración de secuencia de datos

Para garantizar que los datos enviados desde su aplicación móvil a 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 en el 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 de 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 Messaging SDK. Si estos pasos no están claros, revise la sección Instalar SDK.

NOTE
Si ha completado la sección Instalar SDK, SDK ya está instalado y puede omitir este paso.
  1. En Xcode, asegúrese de que Mensajería de AEP se agrega 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 el 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 de SDK y las extensiones los pueden utilizar. El centro de eventos de SDK proporciona la estructura de datos principal vinculada a todas las extensiones de SDK de Mobile Platform, 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 de SDK publica y recibe datos de eventos de extensiones registradas para simplificar las integraciones con Adobe y soluciones 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"}

Validación de 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 el 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. Inspeccione 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 Journey Optimizer para Experience Platform Mobile SDK.
Gracias por dedicar su tiempo a conocer Adobe Experience Platform Mobile SDK. 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