Transmitir datos a Experience Platform con Web SDK
Creado para:
- Principiante
- Intermedio
- Desarrollador
Obtenga información sobre cómo transmitir datos web a Adobe Experience Platform con SDK web de Platform.
Experience Platform es la columna vertebral de todas las nuevas aplicaciones de Experience Cloud, como Adobe Real-Time Customer Data Platform, Adobe Customer Journey Analytics y Adobe Journey Optimizer. Estas aplicaciones están diseñadas para utilizar Platform Web SDK como el método óptimo de recopilación de datos web.
Experience Platform utiliza el mismo esquema de XDM que creó anteriormente para capturar datos de evento del sitio web de Luma. Cuando esos datos se envían a Platform Edge Network, la configuración del conjunto de datos puede reenviarlos a Experience Platform.
Objetivos de aprendizaje
Al final de esta lección, debe poder:
- Crear un conjunto de datos en Adobe Experience Platform
- Configuración de la secuencia de datos para enviar datos de Web SDK a Adobe Experience Platform
- Habilitar el streaming de datos web para el perfil del cliente en tiempo real
- Validar que los datos hayan llegado tanto al conjunto de datos de Platform como al Perfil del cliente en tiempo real
- Ingesta de datos de programa de fidelización de muestra en Platform
- Crear una audiencia de Platform simple
Requisitos previos
Para completar esta lección, primero debe:
- Tener acceso a una aplicación de Adobe Experience Platform como Real-Time Customer Data Platform, Journey Optimizer o Customer Journey Analytics
- Complete las lecciones anteriores de las secciones Configuración inicial y Configuración de etiquetas de este tutorial.
NOTECrear un conjunto de datos
Todos los datos que se incorporan correctamente a Adobe Experience Platform se conservan dentro del lago de datos como conjuntos 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). Los conjuntos de datos también contienen metadatos que describen varios aspectos de los datos que almacenan.
Vamos a configurar un conjunto de datos para los datos de evento web de Luma:
-
Vaya a la interfaz de Experience Platform o Journey Optimizer
-
Confirme que se encuentra en el entorno limitado de desarrollo que utiliza para este tutorial.
-
Abra Administración de datos > Conjuntos de datos desde el panel de navegación izquierdo
-
Seleccionar Crear conjunto de datos
-
Seleccione la opción Crear conjunto de datos a partir del esquema
-
Seleccione el esquema
Luma Web Event Datacreado en lección anterior y, a continuación, seleccione Siguiente
-
Proporcione un Nombre y una Descripción opcionales para el conjunto de datos. Para este ejercicio, use
Luma Web Event Datay luego seleccione Finalizar
Ahora hay configurado un conjunto de datos para empezar a recopilar datos de su implementación de Platform Web SDK.
Configuración de la secuencia de datos
Ahora puede configurar su secuencia de datos para enviar datos a Adobe Experience Platform. La secuencia de datos es el vínculo entre la propiedad de etiquetas, Platform Edge Network y el conjunto de datos de Experience Platform.
-
Abrir la interfaz de recopilación de datos
-
Seleccione Datastreams en el panel de navegación izquierdo
-
Abra la secuencia de datos que creó en la lección Configurar una secuencia de datos,
Luma Web SDK
-
Seleccionar Agregar servicio
-
Seleccione Adobe Experience Platform como servicio
-
Seleccione
Luma Web Event Datacomo Conjunto de datos de evento -
Seleccione Guardar.
A medida que genera tráfico en el sitio de demostración de Luma asignado a su propiedad de etiquetas, los datos rellenan el conjunto de datos en Experience Platform.
Validación del conjunto de datos
Este paso es fundamental para asegurarse de que los datos hayan llegado al conjunto de datos. Existen dos aspectos para validar los datos enviados al conjunto de datos.
- Validar mediante Experience Platform Debugger
- Validar mediante vista previa del conjunto de datos
- Validar mediante servicio de consultas
Experience Platform Debugger
Estos pasos son más o menos los mismos que realizó en la lección de Debugger. Sin embargo, como los datos solo se enviarán a Platform después de haberlos habilitado en el conjunto de datos, debe generar algunos datos de ejemplo más:
-
Abra el sitio de demostración de Luma y seleccione el icono de extensión Experience Platform Debugger
-
Configure Debugger para que asigne la propiedad de etiqueta a su entorno de desarrollo, tal como se describe en la lección Validar con Debugger
-
Inicie sesión en el sitio de Luma con las credenciales
test@test.com/test -
Vuelva a la página principal de Luma
-
En las señalizaciones de red de Platform Web SDK que muestra Debugger, seleccione la fila "events" para ampliar los detalles en una ventana emergente
-
Busque el "identityMap" en la ventana emergente. Aquí debe ver lumaCrmId con tres claves authenticationState, id y primary
Ahora, los datos deben rellenarse en el conjunto de datos Luma Web Event Data y estar listos para la validación de 'Previsualizar conjunto de datos'.
Previsualización del conjunto de datos
Para confirmar que los datos han llegado al lago de datos de Platform, una opción rápida es usar la característica Vista previa del conjunto de datos. Los datos de Web SDK se envían en microlotes al lago de datos y se actualizan en la interfaz de Platform periódicamente. Los datos generados pueden tardar entre 10 y 15 minutos en mostrarse.
-
En la interfaz de Experience Platform, seleccione Administración de datos > Conjuntos de datos en el panel de navegación izquierdo para abrir el panel Conjuntos de datos.
El panel enumera todos los conjuntos de datos disponibles para su organización. Se muestran los detalles de cada conjunto de datos enumerado, incluido su nombre, el esquema al que se adhiere el conjunto de datos y el estado de la ejecución de ingesta más reciente.
-
Seleccione el conjunto de datos
Luma Web Event Datapara abrir la pantalla Actividad del conjunto de datos.
La pantalla de actividad incluye un gráfico que visualiza la tasa de mensajes que se consumen, así como una lista de lotes correctos y fallidos.
-
En la pantalla Actividad del conjunto de datos, seleccione Previsualizar conjunto de datos cerca de la esquina superior derecha de la pantalla para obtener una vista previa de hasta 100 filas de datos. Si el conjunto de datos está vacío, se desactiva el vínculo de vista previa.
En la ventana de vista previa, la vista jerárquica del esquema para el conjunto de datos se muestra a la derecha.
Consulta de los datos
- En la interfaz de Experience Platform, seleccione Administración de datos > Consultas en el panel de navegación izquierdo para abrir la pantalla Consultas.
- Seleccionar Crear consulta
- En primer lugar, ejecute una consulta para ver todos los nombres de las tablas del lago de datos. Escriba
SHOW TABLESen el editor de consultas y haga clic en el icono de reproducción para ejecutar la consulta. - En los resultados, observe cómo el nombre de la tabla es similar a
luma_web_event_data - Ahora consulte la tabla con una consulta simple que haga referencia a la tabla (tenga en cuenta que, de forma predeterminada, la consulta estará limitada a 100 resultados):
SELECT * FROM "luma_web_event_data" - Después de unos momentos, debería ver registros de muestra de sus datos web.
ERRORINFOHabilitar el conjunto de datos y el esquema para el perfil del cliente en tiempo real
Para los clientes de Real-Time Customer Data Platform y Journey Optimizer, el siguiente paso es habilitar el conjunto de datos y el esquema para el perfil del cliente en tiempo real. La transmisión de datos desde Web SDK será una de las muchas fuentes de datos que fluirán a Platform y desea unir los datos web con otras fuentes de datos para crear perfiles de clientes de 360 grados. Para obtener más información sobre el Perfil del cliente en tiempo real, vea este breve vídeo:
CAUTIONPara habilitar el conjunto de datos:
-
Abra el conjunto de datos que creó,
Luma Web Event Data -
Seleccione Alternancia de perfil para activarla
-
Confirme que quiere habilitar el conjunto de datos
Para habilitar el esquema:
-
Abra el esquema que creó,
Luma Web Event Data -
Seleccione Alternancia de perfil para activarla
-
Seleccione Los datos de este esquema contendrán una identidad principal en el campo identityMap.
IMPORTANTLas identidades principales son necesarias en cada registro enviado al Perfil del cliente en tiempo real. Normalmente, los campos de identidad se etiquetan dentro del esquema. Sin embargo, al utilizar mapas de identidad, los campos de identidad no son visibles dentro del esquema. Este cuadro de diálogo sirve para confirmar que tiene en mente una identidad principal y que la especificará en un mapa de identidad al enviar los datos. Como ya sabe, Web SDK utiliza un mapa de identidad con el ID de Experience Cloud (ECID) como identidad principal predeterminada y un ID autenticado como identidad principal cuando está disponible. -
Seleccionar Habilitar
-
Seleccione Guardar para guardar el esquema actualizado
Ahora el esquema también está habilitado para el perfil.
IMPORTANT- En primer lugar, introduzca algunos datos en los conjuntos de datos.
- Solucionar cualquier problema que surja durante el proceso de ingesta de datos (por ejemplo, problemas de validación o asignación de datos).
- Habilitar los conjuntos de datos y esquemas para el perfil
- Vuelva a ingerir los datos si es necesario
Validación de un perfil
Puede buscar un perfil de cliente en la interfaz de Platform (o de Journey Optimizer) para confirmar que los datos han llegado al Perfil del cliente en tiempo real. Como su nombre sugiere, los perfiles se rellenan en tiempo real, por lo que no hay retraso como con la validación de datos en el conjunto de datos.
Primero debe generar más datos de ejemplo. Repita los pasos anteriores de esta lección para iniciar sesión en el sitio web de Luma cuando esté asignado a la propiedad de etiquetas. Inspeccione la solicitud de Platform Web SDK para asegurarse de que envía datos con lumaCRMId.
-
En la interfaz de Experience Platform, seleccione Cliente > Perfiles en el panel de navegación izquierdo
-
Como el área de nombres de identidad, use
lumaCRMId -
Copie y pegue el valor de
lumaCRMIdpasado en la llamada que inspeccionó en Experience Platform Debugger, en este casob642b4217b34b1e8d3bd915fc65c4452.
-
Si hay un valor válido en el perfil para
lumaCRMId, se rellena un identificador de perfil en la consola:
-
Para ver el perfil del cliente completo para cada ID, seleccione el ID de perfil en la ventana principal.
NOTENota: puede seleccionar el hipervínculo del ID de perfil o, si selecciona la fila, se abrirá un menú de la derecha en el que podrá seleccionar el hipervínculo ID de perfil
Aquí puede ver todas las identidades vinculadas a
lumaCRMId, comoECID.
Ahora ha habilitado Platform Web SDK para Experience Platform (y Real-Time CDP! ¡Y Journey Optimizer! Y Customer Journey Analytics!).
Crear una audiencia evaluada por Edge
Se recomienda completar este ejercicio para los clientes de Real-Time Customer Data Platform y Journey Optimizer.
Cuando los datos de Web SDK se incorporan en Adobe Experience Platform, se pueden ampliar con otras fuentes de datos que haya introducido en Platform. Por ejemplo, cuando un usuario inicia sesión en el sitio de Luma, se construye un gráfico de identidades en Experience Platform y todos los demás conjuntos de datos con perfil habilitado pueden unirse para crear perfiles de cliente en tiempo real. Para ver esto en acción, creará rápidamente otro conjunto de datos en Adobe Experience Platform con algunos datos de fidelidad de ejemplo para que pueda utilizar Perfiles del cliente en tiempo real con Real-Time Customer Data Platform y Journey Optimizer. A continuación, creará una audiencia basada en estos datos.
Crear un esquema de fidelización e introducir datos de ejemplo
Dado que ya ha realizado ejercicios similares, las instrucciones serán breves.
Cree el esquema de fidelización:
-
Creación de un nuevo esquema
-
Elija Perfil individual como clase base
-
Asigne un nombre al esquema
Luma Loyalty Schema -
Agregar el grupo de campos Detalles de fidelización
-
Agregar el grupo de campos Detalles demográficos
-
Seleccione el campo
Person IDy márquelo como Identidad e Identidad principal con el área de nombresLuma CRM IdIdentidad. -
Habilite el esquema para Profile. Si no encuentra la opción Perfil, intente hacer clic en el nombre del esquema en la parte superior izquierda.
-
Guardar el esquema
Para crear el conjunto de datos e introducir los datos de ejemplo:
-
Crear un nuevo conjunto de datos a partir de
Luma Loyalty Schema -
Asigne un nombre al conjunto de datos
Luma Loyalty Dataset -
Habilitar el conjunto de datos para Perfil
-
Descargar el archivo de muestra luma-loyalty-forWeb.json
-
Arrastre y suelte el archivo en el conjunto de datos
-
Confirme que los datos se han introducido correctamente.
Definir una política de combinación activa en Edge
Todas las audiencias se crean con una política de combinación. Las políticas de combinación crean diferentes "vistas" de un perfil, pueden contener un subconjunto de conjuntos de datos y prescriben un orden de prioridad cuando diferentes conjuntos de datos aportan los mismos atributos de perfil. Para ser evaluada en el perímetro de, una audiencia debe usar una política de combinación con que tenga la configuración Política de combinación activa en Edge.
IMPORTANT-
Abra la interfaz de Experience Platform o Journey Optimizer y asegúrese de que está en el entorno de desarrollo que utiliza para el tutorial.
-
Vaya a la página Cliente > Perfiles > Políticas de combinación
-
Abrir la política de combinación predeterminada (probablemente denominada
Default Timebased)
-
Habilitar la configuración Política de combinación activa en Edge
-
Seleccionar Siguiente
-
Sigue seleccionando Siguiente para continuar con los otros pasos del flujo de trabajo y selecciona Finalizar para guardar la configuración
Ahora puede crear audiencias que se evaluarán en Edge.
Crear un público
Las audiencias agrupan perfiles en torno a rasgos comunes. Cree una audiencia sencilla que pueda utilizar en Real-Time CDP o Journey Optimizer:
-
En la interfaz de Experience Platform o Journey Optimizer, vaya a Cliente > Audiencias en el panel de navegación izquierdo
-
Seleccionar Crear audiencia
-
Seleccionar regla de compilación
-
Seleccionar Crear
-
Seleccionar atributos
-
Busque el campo Fidelidad > Nivel y arrástrelo a la sección Atributos
-
Defina la audiencia como usuarios cuyo
tieresgold -
Asigne un nombre a la audiencia
Luma Loyalty Rewards – Gold Status -
Seleccione Edge como método de evaluación
-
Seleccionar Guardar
NOTEComo se trata de una audiencia muy sencilla, podemos utilizar el método de evaluación de Edge. Las audiencias de Edge se evalúan en el perímetro, por lo que en la misma solicitud realizada por Web SDK a Platform Edge Network, podemos evaluar la definición de la audiencia y confirmar inmediatamente si el usuario cumple los requisitos.
NOTE