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 {modal="regular"}

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 para notificaciones push. 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

  • Cree una configuración de canal en Journey Optimizer.
  • 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.

Creación de una configuración de canal

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.

  2. Introduzca un nombre y una descripción (opcional) para la configuración. Por ejemplo, LumaInAppMessaging y Channel for in-app messaging.

    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 con 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. Por ejemplo: Segmentación push.

  6. Seleccione la plataforma para la que desea definir la configuración. Esta configuración 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 envía a ambas, independientemente de la plataforma seleccionada en la configuración del canal.
  7. Introduzca los ID de la aplicación para la plataforma que desea admitir.

    Crear una configuración de canal {modal="regular"}

  8. Seleccione Enviar para guardar los cambios.

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 {modal="regular"}

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. 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.
iOS
  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
    ]
    
Android
  1. En Android Studio, asegúrese de que aepsdk-messaging-android forme parte de las dependencias de build.gradle.kts en Android ChevronDown > Gradle Scripts. Ver Gradle.

  2. Vaya a Android ChevronDown app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication en el navegador de proyectos de Android Studio.

  3. Asegúrese de que com.adobe.marketing.mobile.Messaging forme parte de su lista de importaciones.

    import import com.adobe.marketing.mobile.Messaging

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

    code language-kotlin
    val extensions = listOf(
        Identity.EXTENSION,
        Lifecycle.EXTENSION,
        Signal.EXTENSION,
        Edge.EXTENSION,
        Consent.EXTENSION,
        UserProfile.EXTENSION,
        Places.EXTENSION,
        Messaging.EXTENSION,
        Optimize.EXTENSION,
        Assurance.EXTENSION
    )
    

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 {modal="regular"}

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

  4. Seleccione Guardar.
    guardar {modal="regular"}

  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 {modal="regular"}

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. Event Hub 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, el centro de eventos gestiona todas las solicitudes e interacciones con el motor de ofertas de Journey Optimizer - Gestión de decisiones.

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

  2. Seleccione Crear campaña.

  3. En el cuadro de diálogo Crear su campaña, seleccione Reloj Programado - Marketing y seleccione Confirmar.

  4. En la pantalla Campaign - AAAA-MM-DD HHSS UTC+XX:XX:

    1. En la ficha Propiedades:

      1. Escriba un nombre para la campaña. Por ejemplo, Luma Mobile In-App Campaign.
      2. Si lo desea, añada una descripción.
    2. Seleccione la ficha Acción.

      1. Debajo de Mostrar mensaje si, seleccione Agregar Agregar acción. En el menú desplegable, seleccione Mensaje en la aplicación.

      2. En el menú desplegable Configuración de mensajes en la aplicación, seleccione su configuración. Por ejemplo, LumaInAppMessaging.

      3. Seleccione Editar Editar déclencheur.

      4. En el diálogo déclencheur de mensajes en la aplicación:

        1. Seleccione Inicio de la aplicación y seleccione Seguimiento de la acción en el menú desplegable.

        2. Seleccione AddCircle Agregar condición.

        3. Seleccione Acción y es igual que en los menús desplegables.

        4. Escriba in-app.

        5. Seleccione AddCircle Agregar condición.

        6. Seleccione Datos de contexto del menú desplegable e indique showMessage.

        7. Seleccione es igual que en el menú desplegable y escriba true.

          Editar déclencheur {modal="regular"}

        8. Seleccione Listo.

    3. En la pantalla de definición de campaña principal, seleccione la pestaña Content.

      1. Habilitar formato avanzado.

      2. Seleccione Modal como diseño de mensajería. En el diálogo Cambiar diseño, seleccione Cambiar diseño.

      3. En la ficha Contenido.

        1. Escriba https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png para la URL multimedia.
        2. 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....

        Contenido de mensaje en la aplicación {modal="regular"}

      4. Seleccione la ficha Configuración.

        1. Seleccionar Personalizar tamaño en Mensaje.
        2. Deshabilitar Ajustar al contenido.
        3. Establezca Altura en 75%.

        Configuración de mensajes en la aplicación {modal="regular"}

  5. Seleccione Revisar para activar. Para editar de manera opcional cualquiera de las configuraciones de Contenido, Propiedades, Acciones o más, seleccione Editar .

  6. En la pantalla Revisar para activar (nombre de campaña), seleccione Activar.

  7. Después de un tiempo, verás tu nombre de campaña con el estado Activo en la lista Campañas.
    Lista de campañas {modal="regular"}

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.

iOS
  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"])
    }
    
Android
  1. Vaya a Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK en el navegador de Android Studio. Busque la función fun sendTrackAction(action: String, data: Map<String, String>?) 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-kotlin
    // Send trackAction event
    MobileCore.track(action, data)
    
  2. Vaya a Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.androi > views > ConfigView.kt en el navegador de Android Studio. Busque el código del botón del controlador onInAppMessageClick y agregue el siguiente código:

    code language-kotlin
    // Setting parameters and calling function to send in-app message
    MobileSDK.shared.sendTrackAction(
        "in-app",
        mapOf("showMessage" to "true")
    )
    

Validar con la aplicación

Puede validar los mensajes en la aplicación desde la propia aplicación.

iOS
  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"}

Android
  1. Vuelva a compilar y ejecute la aplicación en el simulador o en un dispositivo físico desde Android Studio 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 {modal="regular"}

Próximos pasos

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