Ingesta de datos mediante el SDK para móviles
En esta guía de inicio rápido se explica cómo puede introducir datos de seguimiento de aplicaciones móviles directamente en Adobe Experience Platform mediante el SDK y el Edge Network de Adobe Experience Platform Mobile. A continuación, utilice esos datos en Customer Journey Analytics.
Para lograrlo, debe llevar a cabo lo siguiente:
-
Configurar un esquema y un conjunto de datos en Adobe Experience Platform para definir el modelo (esquema) de los datos que desea recopilar y dónde recopilar realmente los datos (conjunto de datos).
-
Configurar una secuencia de datos para configurar Adobe Experience Platform Edge Network con el fin de enrutar los datos recopilados al conjunto de datos configurado en Adobe Experience Platform.
-
Use etiquetas para configurar fácilmente reglas y elementos de datos con los datos de su aplicación móvil. A continuación, asegúrese de que los datos se envíen a la secuencia de datos configurada en Adobe Experience Platform Edge Network.
-
Implementar y validar. Debe disponer de un entorno donde pueda iterar el desarrollo de etiquetas y, una vez validado todo, publicarlo en su entorno de producción.
-
Configurar una conexión en Customer Journey Analytics. Esta conexión debe incluir (al menos) su conjunto de datos de Adobe Experience Platform.
-
Configurar una vista de datos en Customer Journey Analytics para definir las métricas y las dimensiones que desea utilizar en Analysis Workspace.
-
Configurar un proyecto en Customer Journey Analytics para crear sus informes y visualizaciones.
Configurar un esquema y un conjunto de datos
Para ingerir datos en Adobe Experience Platform, primero debe definir qué datos desea recopilar. Todos los datos ingeridos en Adobe Experience Platform deben cumplir una estructura estándar y desnormalizada para que las funciones y características consecutivas puedan reconocerlos y actuar en consecuencia. El modelo de datos de experiencia (XDM) es el marco de trabajo estándar que proporciona una estructura en forma de esquemas.
Una vez definido un esquema, se utilizan uno o más conjuntos de datos para almacenar y administrar la recopilación de datos. Un conjunto de datos es una construcción de almacenamiento y administración para una colección de datos (normalmente una tabla) que contiene un esquema (columnas) y campos (filas).
Todos los datos ingeridos en Adobe Experience Platform deben cumplir un esquema predefinido para que se puedan conservar como conjunto de datos.
Configurar un esquema
Desea realizar un seguimiento de algunos datos mínimos de los perfiles mediante la aplicación móvil, por ejemplo, el nombre de la escena o la identificación.
Primero debe definir un esquema que modele estos datos.
Para configurar el esquema:
-
En la interfaz de usuario de Adobe Experience Platform, en el carril izquierdo, seleccione Esquemas en ADMINISTRACIÓN DE DATOS.
-
Seleccione Crear esquema.
. -
En el paso Seleccionar una clase del asistente Crear esquema:
-
Seleccione Evento de experiencia.
note info INFO Se usa un esquema de Experience Event para modelar el comportamiento de un perfil (como el nombre de la escena, el botón secundario para agregar al carro de compras). Se utiliza un esquema de perfil individual para modelar los atributos del perfil (como nombre, correo electrónico o sexo). -
Seleccione Siguiente.
-
-
En el paso Nombre y revisión del asistente Crear esquema:
-
Escriba un nombre para mostrar en el esquema y (opcional) una Descripción.
-
Seleccione Finalizar.
-
-
En la pestaña Estructura del esquema de ejemplo:
-
Seleccione + Agregar en Grupos de campos.
Los grupos de campos son colecciones reutilizables de objetos y atributos que le permiten ampliar fácilmente su esquema.
-
En el cuadro de diálogo Agregar grupos de campos, seleccione el grupo de campos ExperienceEvent del SDK de AEP Mobile de la lista.
Puede seleccionar el botón de vista previa para ver una vista previa de los campos que forman parte de este grupo de campos, como
application > name
.Seleccione Atrás para cerrar la vista previa.
-
Seleccione Agregar grupos de campos.
-
-
Seleccione + junto al nombre del esquema en el panel Estructura.
-
En el panel Propiedades del campo, escriba
identification
como Nombre del campo, Identificación como Nombre para mostrar, seleccione Objeto como Tipo y seleccione ExperienceEvent Core v2.1 como Grupo de campos.note note NOTE Si ese grupo de campos no está disponible, busque otro grupo de campos que contenga campos de identidad. O cree un nuevo grupo de campos y agregue nuevos campos de identidad (como ecid
,crmId
y otros que necesite) al grupo de campos y seleccione ese nuevo grupo de campos.El objeto de identificación agrega capacidades de identificación al esquema. En su caso, quiere identificar los perfiles que utilizan su aplicación móvil mediante el ID de Experience Cloud y la dirección de correo electrónico. Hay muchos otros atributos disponibles para rastrear la identificación de su persona (por ejemplo, ID de cliente, ID de fidelidad).
Seleccione Aplicar para agregar este objeto al esquema.
-
Seleccione el campo ECID en el objeto de identificación que acaba de agregar y seleccione Identidad, Identidad principal y ECID en la lista de Área de nombres de identidad en el panel derecho.
Está especificando la identidad de Experience Cloud como la identidad principal que el servicio de identidad de Adobe Experience Platform puede utilizar para combinar (unir) el comportamiento de los perfiles con el mismo ECID.
Seleccione Aplicar. Verá que aparece un icono de huella digital en el atributo de ECID.
-
Seleccione el campo de correo electrónico en el objeto de identificación que acaba de añadir y seleccione Identidad y Correo electrónico en la lista de Área de nombres de identidad del panel Propiedades de campo.
Está especificando la dirección de correo electrónico como otra identidad que el servicio de identidad de Adobe Experience Platform puede utilizar para combinar (unir) el comportamiento de los perfiles.
Seleccione Aplicar. Verá que aparece un icono de huella digital en el atributo de correo electrónico.
Seleccione Guardar.
-
Seleccione el elemento raíz del esquema que muestra el nombre del esquema y, a continuación, seleccione el conmutador Perfil.
Se le pedirá que habilite el esquema para el perfil. Tras la habilitación, cuando los datos se incorporan en conjuntos de datos basados en este esquema, los datos se combinan en el perfil del cliente en tiempo real.
Consulte Habilitar el esquema para utilizarlo en el perfil del cliente en tiempo real para obtener más información.
note important IMPORTANT Una vez guardado un esquema habilitado para perfil, ya no se puede deshabilitar para perfil. -
Seleccione Guardar para guardar el esquema.
Ha creado un esquema mínimo que modela los datos que puede capturar desde su aplicación móvil. El esquema permite identificar perfiles mediante la identidad de Experience Cloud y la dirección de correo electrónico. Al habilitar el esquema para el perfil, se garantiza que los datos capturados desde la aplicación móvil se añadan al perfil del cliente en tiempo real.
Junto a los datos de comportamiento, también puede capturar datos de atributos de perfil desde la aplicación móvil (por ejemplo, detalles de perfiles suscritos a un boletín informativo).
Para capturar datos de perfil, debería hacer lo siguiente:
-
Crear un esquema basado en la clase Perfil individual XDM.
-
Agregar el grupo de campos Profile Core v2 al esquema.
-
Agregar un objeto de identificación basado en el grupo de campos Profile Core v2.
-
Defina el ID de Experience Cloud como identificador principal y el correo electrónico como identificador.
-
Habilitar el esquema para el perfil
Consulte Crear y editar esquemas en la interfaz de usuario para obtener más información sobre cómo agregar y quitar grupos de campos y campos individuales a un esquema.
Configurar un conjunto de datos
Con el esquema, ha definido el modelo de datos. Ahora tiene que definir la construcción para almacenar y administrar esos datos mediante conjuntos de datos.
Para configurar un conjunto de datos:
-
En la interfaz de usuario de Adobe Experience Platform, en el carril izquierdo, seleccione Conjuntos de datos en ADMINISTRACIÓN DE DATOS.
-
Seleccione Crear conjunto de datos.
-
Seleccione Crear conjunto de datos a partir de esquema.
-
Seleccione el esquema creado anteriormente y, después, Siguiente.
-
Asigne un nombre al conjunto de datos y (opcionalmente) proporcione una descripción.
-
Seleccione Finalizar.
-
Seleccione el conmutador Perfil.
Se le pedirá que habilite el conjunto de datos para el perfil. Una vez habilitado, el conjunto de datos enriquece los perfiles de clientes en tiempo real con sus datos ingeridos.
note important IMPORTANT Solo puede habilitar un conjunto de datos para un perfil cuando el esquema, al que se adhiere el conjunto de datos, también esté habilitado para el perfil.
Consulte Guía de la interfaz de usuario de conjuntos de datos para obtener más información sobre cómo ver, previsualizar, crear o eliminar un conjunto de datos. Y cómo habilitar un conjunto de datos para el perfil del cliente en tiempo real.
Configurar una secuencia de datos
Una secuencia de datos representa la configuración del lado del servidor al implementar los SDK web y móvil de Adobe Experience Platform. Al recopilar datos con los SDK de Adobe Experience Platform, los datos se envían a Adobe Experience Platform Edge Network. Es la secuencia de datos la que determina a qué servicios se reenvían los datos.
En la configuración, desea que los datos que recopila de la aplicación móvil se envíen al conjunto de datos en Adobe Experience Platform.
Para configurar la secuencia de datos, debe hacer lo siguiente:
-
En la interfaz de usuario de Adobe Experience Platform, seleccione Secuencias de datos desde RECOPILACIÓN DE DATOS en el carril izquierdo.
-
Seleccione Nueva secuencia de datos.
-
Asigne un nombre y describa su secuencia de datos. Seleccione el esquema en la lista Esquema de eventos.
-
Seleccione Guardar.
-
Seleccione Agregar servicio.
-
En la pantalla Agregar servicio, debe hacer lo siguiente:
-
Seleccione Adobe Experience Platform en la lista Servicio.
-
Asegúrese de que Habilitado esté seleccionado.
-
Seleccione su conjunto de datos en la lista Conjunto de datos de evento.
-
Deje los demás ajustes y seleccione Guardar para guardar la secuencia de datos.
-
El conjunto de datos ya está configurado para reenviar los datos recopilados desde la aplicación móvil al conjunto de datos en Adobe Experience Platform.
Consulte la Información general sobre secuencias de datos para obtener más información sobre cómo configurar una secuencia de datos y cómo gestionar datos confidenciales.
Usar etiquetas
Para implementar código en el sitio para recopilar datos, utilice la función Etiquetas de Adobe Experience Platform. Esta solución de administración de etiquetas le permite implementar código de junto con otros requisitos de etiquetado. Las etiquetas ofrecen una integración perfecta con Adobe Experience Platform mediante la extensión del SDK móvil de Adobe Experience Platform.
Crear una etiqueta
-
En la interfaz de usuario de Adobe Experience Platform, en el carril izquierdo, seleccione Etiquetas en RECOPILACIÓN DE DATOS.
-
Seleccione Nueva propiedad.
Asigne un nombre a la etiqueta y seleccione Móvil. Seleccione Guardar para continuar.
Configurar una etiqueta
Después de crear la etiqueta, debe configurarla con las extensiones correctas y configurar los elementos de datos y las reglas según cómo quiera rastrear el sitio y enviar datos a Adobe Experience Platform.
Para configurarla, seleccione la etiqueta recién creada en la lista de Propiedades de la etiqueta.
Extensiones
Añada la extensión del Edge Network de Adobe Platform a la etiqueta para asegurarse de que puede enviar datos a Adobe Experience Platform (a través de su secuencia de datos).
Para crear y configurar la extensión del SDK de Adobe Experience Platform Mobile:
-
Seleccione Extensiones en el carril izquierdo. Verá que las extensiones Mobile Core y Profile ya están disponibles.
-
Seleccione Catálogo en la barra superior.
-
Busque o desplácese hasta la extensión Edge Network de Adobe Experience Platform y seleccione Instalar en el panel derecho para instalarla.
-
Seleccione la zona protegida y la secuencia de datos que ha creado anteriormente para su Entorno de producción, (opcionalmente) su Entorno de ensayo y su Entorno de desarrollo.
-
Escriba su dominio de Edge Network debajo de Configuración de dominio. Normalmente se utiliza
<organizationName>.data.adobedc.net
. -
Seleccione Guardar.
Consulte Configuración de la extensión de Edge Network de Adobe Experience Platform para obtener más información.
También desea configurar las siguientes extensiones adicionales del catálogo:
- Identidad.
- Assurance de AEP.
- Consentimiento.
Consulte Configurar una propiedad de etiqueta en el tutorial de la aplicación móvil para Experience Platform para obtener más información sobre las extensiones y su configuración.
Elementos de datos
Los Data Elements son los componentes básicos del diccionario de datos (o mapa de datos). Utilice Data Elements para recopilar, organizar y entregar datos a través de la tecnología de marketing y publicidad. Puede configurar elementos de datos en la etiqueta de que se lean desde datos o eventos de aplicaciones móviles y que se puedan utilizar para enviar datos a Adobe Experience Platform.
Por ejemplo, desea recopilar el nombre del operador de la aplicación móvil.
Para definir un elemento de datos de nombre de operador:
-
Seleccione Elementos de datos en el carril izquierdo.
-
Seleccione Agregar elemento de datos.
-
En el cuadro de diálogo Crear elemento de datos, haga lo siguiente:
-
Asigne un nombre al elemento de datos como, por ejemplo,
Carrier Name
. -
Seleccione Mobile Core de la lista Extension.
-
Seleccione Nombre de operador de la lista Tipo de elemento de datos.
-
Seleccione Guardar.
-
Puede crear tantos elementos de datos como desee y utilizarlos en reglas.
Reglas
Las etiquetas de Adobe Experience Platform siguen un sistema basado en reglas. Buscan la interacción de usuarios y datos asociados. Cuando se cumplen los criterios descritos en las reglas, la regla activa la extensión, script o el código del lado del cliente identificados. Puede utilizar reglas para enviar datos (como un objeto XDM) a Adobe Experience Platform mediante la extensión de Edge Network de Adobe Experience Platform.
Por ejemplo, desea enviar datos de evento cuando se utiliza la aplicación móvil (en primer plano) y cuando no se utiliza la aplicación móvil (devuelta al segundo plano).
Para definir una regla, debe hacer lo siguiente:
-
Seleccione Reglas en el carril izquierdo.
-
Seleccione Crear nueva regla.
-
En el cuadro de diálogo Crear regla, haga lo siguiente:
-
Asigne un nombre a la regla como, por ejemplo,
Application Status
. -
Seleccione + Agregar, bajo Eventos.
-
En el cuadro de diálogo Configuración de evento, haga lo siguiente:
-
Seleccione Mobile Core de la lista Extension.
-
Seleccione Primer plano de la lista Tipo de evento.
-
Seleccione Conservar cambios.
-
-
Haz clic en junto a Núcleo móvil - Primer plano.
-
Seleccione Mobile Core de la lista Extension.
-
Seleccione Background de la lista Event Type.
-
Seleccione Conservar cambios.
-
-
Haga clic en Agregar debajo de ACCIONES. En el cuadro de diálogo Configuración de acción, haga lo siguiente:
-
Seleccione Edge Network de Adobe Experience Platform de la lista Extension.
-
Seleccione Reenviar evento al Edge Network de la lista Tipo de acción.
-
Seleccione Conservar cambios.
-
-
La regla debe tener el siguiente aspecto:
-
Seleccione Guardar.
-
Lo anterior es solo un ejemplo de definición de una regla que envía datos XDM, que contienen el estado de la aplicación, a la red de Adobe Edge y a Adobe Experience Platform.
Puede utilizar las reglas de varias formas en la etiqueta para manipular las variables (mediante los elementos de datos).
Consulte Reglas para obtener más información.
Compilar y publicar una etiqueta
Después de haber definido elementos de datos y reglas, debe compilar y publicar la etiqueta. Al crear una compilación de biblioteca, debe asignarla a un entorno. Las extensiones, reglas y elementos de datos de la compilación se compilan y colocan en el entorno asignado. Cada entorno proporciona un código incrustado único que le permite integrar su compilación asignada en el sitio.
Para compilar y publicar una etiqueta, debe hacer lo siguiente:
-
Seleccione Flujo de publicación en el carril izquierdo.
-
Seleccione Seleccionar una biblioteca de trabajo, seguido de Agregar biblioteca….
-
En el cuadro de diálogo Crear biblioteca, haga lo siguiente:
-
Asigne un nombre a la biblioteca.
-
Seleccione Desarrollo (desarrollo) en la lista Entorno.
-
Seleccione + Agregar todos los recursos modificados.
-
Seleccione Guardar y compilar para desarrollo.
La etiqueta se guardará y se compilará para su entorno de desarrollo. Un punto verde indica que la compilación de la etiqueta se ha realizado correctamente en el entorno de desarrollo.
-
-
Puede seleccionar … para recompilar la biblioteca o moverla a un entorno de ensayo o producción.
Las etiquetas de Adobe Experience Platform admiten flujos de trabajo de publicación simples o complejos que deben adaptarse a la implementación del Edge Network de Adobe Experience Platform.
Consulte la Información general de la publicación para obtener más información.
Recuperar el código de una etiqueta
Finalmente, debe utilizar la etiqueta dentro de la aplicación móvil que desea rastrear.
Para obtener instrucciones de código que expliquen cómo configurar la aplicación móvil y utilizar la etiqueta en la aplicación:
-
Seleccione Entornos en el carril izquierdo.
-
En la lista de entornos, seleccione el botón de instalación correcto.
En el cuadro de diálogo Instrucciones de instalación móvil, seleccione la plataforma adecuada (iOS, Android). A continuación, utilice el botón Copiar situado junto a cada uno de los fragmentos de código relevantes que desee utilizar para configurar e inicializar su aplicación móvil:
-
Seleccione Cerrar.
En lugar del código para el entorno de desarrollo, podría haber seleccionado otro entorno (ensayo, producción) en función de dónde se encuentre en el proceso de implementación del SDK móvil de Adobe Experience Platform.
Consulte Entornos para obtener más información.
Implementar y validar
Ahora puede implementar el código en su aplicación móvil. Cuando se implementa, la aplicación móvil empieza a recopilar datos en Adobe Experience Platform.
Valide la implementación, corrija lo que sea necesario y, una vez sea correcta, impleméntela en el entorno de ensayo y producción utilizando la función de flujo de trabajo de publicación de Etiquetas.
Consulte Tutorial de implementación de Adobe Experience Cloud en aplicaciones móviles para obtener información mucho más detallada.
Configurar una conexión
Para utilizar los datos de Adobe Experience Platform en Customer Journey Analytics, se crea una conexión que incluye los datos resultantes de la configuración del esquema, el conjunto de datos y el flujo de trabajo.
Una conexión le permite integrar conjuntos de datos de Adobe Experience Platform en Workspace. Para informar sobre estos conjuntos de datos, primero debe establecer una conexión entre conjuntos de datos en Adobe Experience Platform y Workspace.
Para crear la conexión:
-
En la interfaz de usuario de Customer Journey Analytics, seleccione Conexiones en la barra de navegación superior.
-
Seleccione Crear nueva conexión.
-
En la pantalla Conexión sin título, haga lo siguiente:
Asigne un nombre a la conexión y descríbala en Configuración de la conexión.
Seleccione la zona protegida correcta en la lista Zona protegida de Configuración de datos y seleccione el número de eventos diarios en la lista Número medio de eventos diarios.
Seleccione Agregar conjuntos de datos.
En el paso Seleccionar conjuntos de datos, en Agregar conjuntos de datos, haga lo siguiente:
-
Seleccione los conjuntos de datos que creó anteriormente u otros conjuntos de datos relevantes que desee incluir en su conexión (por ejemplo, datos de eventos de experiencia de seguimiento push y datos de perfil push de Adobe Journey Optimizer)
-
Seleccione Siguiente.
En el paso Configuración de conjuntos de datos, en Agregar conjuntos de datos, haga lo siguiente:
-
Para cada conjunto de datos:
-
Seleccione un ID de persona entre las identidades disponibles de los esquemas del conjunto de datos en Adobe Experience Platform.
-
Seleccione la fuente de datos correcta en la lista Tipo de fuente de datos. Si especifica Otro, agregue una descripción para la fuente de datos.
-
Establezca Importar todos los datos nuevos y Datos existentes del relleno del conjunto de datos según sus preferencias.
-
-
Seleccione Agregar conjuntos de datos.
Seleccione Guardar.
-
Consulte Información general sobre conexiones para obtener más información sobre cómo crear y administrar una conexión y cómo seleccionar y combinar conjuntos de datos.
Configurar una vista de datos
Una vista de datos es un contenedor específico de Customer Journey Analytics que le permite determinar cómo interpretar los datos de una conexión. Especifica todas las dimensiones y métricas disponibles en Analysis Workspace y de qué columnas obtienen esos datos las dimensiones y métricas. Las vistas de datos se definen a fin de prepararse para la creación de informes en Analysis Workspace.
Para crear la vista de datos:
-
En la interfaz de usuario de Customer Journey Analytics, seleccione Vistas de datos en la barra de navegación superior.
-
Seleccione Crear nueva vista de datos.
-
En el paso Configurar, haga lo siguiente:
Seleccione la conexión en la lista Conexión.
Asigne un nombre y (opcionalmente) describa su conexión.
Seleccione Guardar y continuar.
-
En el paso Componentes, haga lo siguiente:
Agregue cualquier campo de esquema o componente estándar que quiera incluir en los cuadros de componentes MÉTRICAS o DIMENSIONES.
Seleccione Guardar y continuar.
-
En el paso Configuración, haga lo siguiente:
Configuración de
Deje la configuración tal como está y seleccione Guardar y finalizar.
Consulte Información general de las vistas de datos para obtener más información sobre cómo crear y editar una vista de datos, qué componentes están disponibles para usar en la vista de datos y cómo usar la configuración de filtro y sesiones.
Configurar un proyecto
Analysis Workspace es una herramienta de navegador flexible que le permite compilar análisis y compartir perspectivas rápidamente, en función de los datos. Los proyectos de Workspace se usan para combinar componentes, tablas y visualizaciones de datos para crear un análisis y compartirlo con cualquier persona de su organización.
Para crear un proyecto:
-
En la interfaz de usuario de Customer Journey Analytics, seleccione Proyectos en la barra de navegación superior.
-
Seleccione Proyectos en el panel de navegación izquierdo.
-
Seleccione Crear proyecto.
Seleccione Proyecto en blanco.
-
Seleccione la vista de datos en la lista.
.
-
Para crear su primer informe, empiece a arrastrar y soltar dimensiones y métricas en la tabla de forma libre en el panel Por ejemplo, arrastre
Events
como métricas yPush Title
como dimensión, desglosado porEvent Type
para obtener una descripción general de las notificaciones push para su aplicación móvil y de lo que les ha sucedido.
Consulte Información general de Analysis Workspace para obtener más información sobre cómo crear proyectos y compilar su análisis mediante componentes, visualizaciones y paneles.