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 utilice recorridos (consulte la Notificaciones push de Journey Optimizer lección), 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, tal 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 ha configurado su entorno como parte de la mensajería push de Journey Optimizer En esta lección, 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. Desde el Interfaz de recopilación de datos, seleccione Superficies de 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. Introduzca una Nombre para la configuración, por ejemplo Luma App Tutorial .

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

  5. Introduzca el ID del paquete de la aplicación móvil en ID de aplicación (ID de paquete de iOS) field. 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 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 seleccione la secuencia de datos, por ejemplo Luma Mobile App.

  2. Seleccionar Más para Experience Platform y seleccione Editar Editar en el menú contextual.

  3. En el Datastreams > Carpeta > Adobe Experience Platform pantalla, asegúrese de 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 la secuencia de datos, seleccione Guardar.

    Configuración de flujo 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 la propiedad, por ejemplo Luma Mobile App Tutorial.
  3. Seleccionar Catálogo.
  4. Busque la variable Adobe Journey Optimizer extensión.
  5. Instale la extensión de.

Cuándo solamente uso de mensajes en la aplicación, en Instalar extensión o Configurar extensión, no es necesario configurar nada. Sin embargo, si ya ha seguido la Notificaciones push En esta lección del tutorial, verá esto para el Desarrollo entorno, el Conjunto de datos de evento de experiencia de seguimiento push AJO conjunto de datos está seleccionado en Conjunto de datos de evento lista.

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 Instalación de SDK sección.

NOTE
Si ha completado la Instalación de SDK , el SDK ya está instalado y puede omitir este paso.
  1. En Xcode, asegúrese de que Mensajería AEP se añade 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. Asegurar AEPMessaging forma parte de su lista de importaciones.

    import AEPMessaging

  4. Asegurar Messaging.self forma 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 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 Plus botón situado junto a Mensajería en la aplicación.

  4. Seleccione Guardar.
    guardar

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

  6. Seleccione el Validación pestaña. 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, va a utilizar las API principales genéricas e independientes de la extensión de Mobile (consulte API genéricas principales 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 IU de Journey Optimizer, seleccione Campañas desde el carril izquierdo.

  2. Seleccionar Crear campaña.

  3. En el Crear campaña pantalla:

    1. Seleccionar Mensaje en la aplicación y seleccione una superficie de aplicación de la Superficie de aplicación , por ejemplo Luma Mobile App.

    2. Seleccionar Crear

      Propiedades de campaña

  4. En la pantalla Campaign definition, en Propiedades, introduzca un Nombre para la campaña, por ejemplo Luma - In-App Messaging Campaign, y a 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 el Mensaje en la aplicación pantalla:

    1. Seleccionar Modal como el Diseño del mensaje.

    2. Entrar https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png para el URL de medios.

    3. Introduzca una Header, por ejemplo Welcome to this Luma In-App Message e introduzca un Cuerpo, por ejemplo Triggered by pushing that button in the app....

    4. Entrar Descartar como el Texto de #1 de botón (principal).

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

    6. Seleccionar Revisar para activar.

      Editor en la aplicación

  7. En el Revise para activar (Luma, campaña de mensajería en la aplicación) pantalla, seleccione Editar en el Programación mosaico.
    Revisar programación seleccionar Programación

  8. De nuevo en Luma - In-App Messaging Campaign pantalla, seleccione Editar Editar déclencheur.

  9. En el 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 eliminar Evento de inicio de aplicación, seleccione Cerrar .

    2. Uso Añadir Añadir 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 la variable Acción igual a in-app y el Datos de contexto con la acción es un par de valor clave de "showMessage" : "true".

  10. De nuevo en Luma - In-App Messaging Campaign pantalla, seleccione Revisar para activar.

  11. En el Revise para activar (Luma, campaña de mensajería en la aplicación) pantalla, seleccione Activar.

  12. Ya ve su Luma - In-App Messaging Campaign con estado Activo en el Campañas lista.
    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. Ir a Luma > Luma > Utils > MobileSDK en el navegador del proyecto Xcode. Busque el func sendTrackAction(action: String, data: [String: Any]?) y agregue el siguiente código, que llama a la función MobileCore.track función, según los parámetros action y data.

    code language-swift
    // Send trackAction event
    MobileCore.track(action: action, data: data)
    
  2. Ir a Luma > Luma > Views > General > ConfigView en el Navegador de proyectos 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 mediante Reproducir .

  2. Vaya a la Configuración pestaña.

  3. Tocar 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 instrucciones de configuración para conectar el simulador o dispositivo a Assurance.
  2. Seleccionar Mensajería en la aplicación.
  3. Seleccionar Lista de eventos.
  4. Seleccione una Mostrar mensaje entrada.
  5. Inspect el evento sin procesar, especialmente el html, que contiene el diseño completo y el contenido 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 este Entrada de discusión de la comunidad Experience League.

Siguiente: Creación y visualización de ofertas

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