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.
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.
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
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.
-
En la interfaz de Journey Optimizer, abra el menú Canales > Configuración general > Configuraciones de canal y luego seleccione Crear configuración de canal.
-
Introduzca un nombre y una descripción (opcional) para la configuración. Por ejemplo,
LumaInAppMessaging
yChannel 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-
. -
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).
-
Seleccione el canal mensajería en la aplicación.
-
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.
-
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. -
Introduzca los ID de la aplicación para la plataforma que desea admitir.
-
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.
-
En la IU de recopilación de datos, seleccione Datastreams y su secuencia de datos, por ejemplo Luma Mobile App.
-
Seleccione
-
En la pantalla Datastreams >
-
Para guardar la configuración de su secuencia de datos, seleccione Guardar.
Instalación de la extensión Journey Optimizer tags
Para que la aplicación funcione con Journey Optimizer, debe actualizar la propiedad de etiquetas.
- Vaya a Etiquetas > Extensiones > Catálogo.
- Abra su propiedad, por ejemplo Luma Mobile App Tutorial.
- Seleccione Catálogo.
- Busque la extensión Adobe Journey Optimizer.
- 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.
-
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.
-
Vaya a Luma > Luma > AppDelegate en el navegador del proyecto Xcode.
-
Asegúrese de que
AEPMessaging
forme parte de su lista de importaciones.import AEPMessaging
-
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 ]
-
En Android Studio, asegúrese de que aepsdk-messaging-android forme parte de las dependencias de build.gradle.kts en Android
-
Vaya a Android
-
Asegúrese de que
com.adobe.marketing.mobile.Messaging
forme parte de su lista de importaciones.import import com.adobe.marketing.mobile.Messaging
-
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
-
Revise la sección instrucciones de configuración para conectar el simulador o dispositivo a Assurance.
-
En la IU de Assurance, seleccione Configurar.
-
Seleccione el botón
-
Seleccione Guardar.
-
Seleccione Mensajería en la aplicación en el panel de navegación izquierdo.
-
Seleccione la ficha Validación. Confirme que no está recibiendo ningún error.
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.
-
En la interfaz de usuario de Journey Optimizer, seleccione Campañas en el carril izquierdo.
-
Seleccione Crear campaña.
-
En el cuadro de diálogo Crear su campaña, seleccione
-
En la pantalla Campaign - AAAA-MM-DD HHSS UTC+XX:XX:
-
En la ficha Propiedades:
- Escriba un nombre para la campaña. Por ejemplo,
Luma Mobile In-App Campaign
. - Si lo desea, añada una descripción.
- Escriba un nombre para la campaña. Por ejemplo,
-
Seleccione la ficha Acción.
-
Debajo de Mostrar mensaje si, seleccione
-
En el menú desplegable Configuración de mensajes en la aplicación, seleccione su configuración. Por ejemplo, LumaInAppMessaging.
-
Seleccione
-
En el diálogo déclencheur de mensajes en la aplicación:
-
Seleccione Inicio de la aplicación y seleccione Seguimiento de la acción en el menú desplegable.
-
Seleccione
-
Seleccione Acción y es igual que en los menús desplegables.
-
Escriba
in-app
. -
Seleccione
-
Seleccione Datos de contexto del menú desplegable e indique
showMessage
. -
Seleccione es igual que en el menú desplegable y escriba
true
. -
Seleccione Listo.
-
-
-
En la pantalla de definición de campaña principal, seleccione la pestaña Content.
-
Habilitar formato avanzado.
-
Seleccione Modal como diseño de mensajería. En el diálogo Cambiar diseño, seleccione Cambiar diseño.
-
En la ficha Contenido.
- Escriba
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png
para la URL multimedia. - Escriba un encabezado, por ejemplo
Welcome to this Luma In-App Message
y un cuerpo, por ejemploTriggered by pushing that button in the app...
.
- Escriba
-
Seleccione la ficha Configuración.
- Seleccionar Personalizar tamaño en Mensaje.
- Deshabilitar Ajustar al contenido.
- Establezca Altura en 75%.
-
-
-
Seleccione Revisar para activar. Para editar de manera opcional cualquiera de las configuraciones de Contenido, Propiedades, Acciones o más, seleccione
-
En la pantalla Revisar para activar (nombre de campaña), seleccione Activar.
-
Después de un tiempo, verás tu nombre de campaña con el estado Activo en la lista 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.
-
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ónMobileCore.track
, en función de los parámetrosaction
ydata
.code language-swift // Send trackAction event MobileCore.track(action: action, data: data)
-
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"]) }
-
Vaya a Android
fun sendTrackAction(action: String, data: Map<String, String>?)
y agregue el código siguiente, que llama a la funciónMobileCore.track
, en función de los parámetrosaction
ydata
.code language-kotlin // Send trackAction event MobileCore.track(action, data)
-
Vaya a Android
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.
-
Vuelva a compilar y ejecute la aplicación en el simulador o en un dispositivo físico desde Xcode con
-
Vaya a la ficha Configuración.
-
Pulse Mensaje en la aplicación. Verá que el mensaje en la aplicación aparece en la aplicación.
-
Vuelva a compilar y ejecute la aplicación en el simulador o en un dispositivo físico desde Android Studio con
-
Vaya a la ficha Configuración.
-
Pulse Mensaje en la aplicación. Verá que el mensaje en la aplicación aparece en la aplicación.
Validación de la implementación en Assurance
Puede validar los mensajes en la aplicación en la interfaz de usuario de Assurance.
-
Revise la sección instrucciones de configuración para conectar el simulador o dispositivo a Assurance.
-
Seleccione Mensajería en la aplicación.
-
Seleccione Lista de eventos.
-
Seleccione una entrada de Mostrar mensaje.
-
Inspeccione el evento sin procesar, especialmente
html
, que contiene el diseño y el contenido completos del mensaje en la aplicación.
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.
Siguiente: Crear y mostrar ofertas