DocumentaciónExperience PlatformTutorial de SDK web

Transmitir datos al Experience Platform con SDK web

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

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 el SDK web de Platform como método óptimo de recopilación de datos web.

Diagrama de SDK web y Adobe Experience Platform

Experience Platform utiliza el mismo esquema XDM creado anteriormente para capturar datos de evento del sitio web de Luma. Cuando esos datos se envían al Edge Network de Platform, la configuración del conjunto de datos puede reenviarlos al 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 del SDK web 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.
NOTE
Si no tiene ninguna aplicación de Platform, puede omitir esta lección o continuar leyendo.

Crear 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:

  1. Vaya a la interfaz de Experience Platform o Journey Optimizer

  2. Confirme que se encuentra en el entorno limitado de desarrollo que utiliza para este tutorial.

  3. Abra Administración de datos > Conjuntos de datos desde el panel de navegación izquierdo

  4. Seleccionar Crear conjunto de datos

    Crear esquema

  5. Seleccione la opción Crear conjunto de datos a partir del esquema

    Crear conjunto de datos a partir del esquema

  6. Seleccione el esquema Luma Web Event Data creado en lección anterior y, a continuación, seleccione Siguiente

    Conjunto de datos, seleccione el esquema

  7. Proporcione un Nombre y una Descripción opcionales para el conjunto de datos. Para este ejercicio, use Luma Web Event Data y luego seleccione Finalizar

    Nombre de conjunto de datos

Ahora hay configurado un conjunto de datos para empezar a recopilar datos de su implementación del SDK web de Platform.

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, el Edge Network de Platform y el conjunto de datos del Experience Platform.

  1. Abrir la interfaz de recopilación de datos

  2. Seleccione Datastreams en el panel de navegación izquierdo

  3. Abra la secuencia de datos que creó en la lección Configurar una secuencia de datos, Luma Web SDK

    Seleccione la secuencia de datos del SDK web de Luma

  4. Seleccionar Agregar servicio
    Agregar un servicio al conjunto de datos

  5. Seleccione Adobe Experience Platform como servicio

  6. Seleccione Luma Web Event Data como Conjunto de datos de evento

  7. Seleccione Guardar.

    Configuración de secuencia de datos

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 con 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:

  1. Abra el sitio de demostración de Luma y seleccione la extensión Experience Platform Debugger

  2. 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

    El entorno de desarrollo de Launch que se muestra en Debugger

  3. Inicie sesión en el sitio de Luma con las credenciales test@adobe.com/test

  4. Vuelva a la página principal de Luma

  5. En las señalizaciones de red del SDK web de Platform que muestra Debugger, seleccione la fila "events" para expandir los detalles en una ventana emergente

    SDK web en Debugger

  6. Busque el "identityMap" en la ventana emergente. Aquí debe ver lumaCrmId con tres claves authenticationState, id y primary
    SDK web en Debugger

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 del SDK web 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.

  1. 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.

  2. Seleccione el conjunto de datos Luma Web Event Data para abrir la pantalla Actividad del conjunto de datos.

    Evento web de Luma de 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.

  3. 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.

    Vista previa de conjunto de datos

    En la ventana de vista previa, la vista jerárquica del esquema para el conjunto de datos se muestra a la derecha.

    Vista previa de conjunto de datos 1

Consulta de los datos

  1. En la interfaz de Experience Platform, seleccione Administración de datos > Consultas en el panel de navegación izquierdo para abrir la pantalla de Consultas.
  2. Seleccionar Crear consulta
  3. En primer lugar, ejecute una consulta para ver todos los nombres de las tablas del lago de datos. Escriba SHOW TABLES en el editor de consultas y haga clic en el icono de reproducción para ejecutar la consulta.
  4. En los resultados, observe cómo el nombre de la tabla es similar a luma_web_event_data
  5. 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"
  6. Después de unos momentos, debería ver registros de muestra de sus datos web.
ERROR
Si aparece el error "Tabla no aprovisionada", vuelva a comprobar el nombre de la tabla. También podría ser que el microlote de datos aún no haya aterrizado en el lago de datos. Vuelva a intentarlo en 10-15 minutos.
INFO
Para obtener más información acerca del servicio de consultas de Adobe Experience Platform, consulte Explorar datos en la sección Tutoriales de Platform.

Habilitar 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 el SDK web 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:

https://video.tv.adobe.com/v/31833?learn=on&captions=spa

CAUTION
Al trabajar con su propio sitio web y datos de, recomendamos una validación de datos más sólida antes de habilitarla para el perfil del cliente en tiempo real.

Para habilitar el conjunto de datos:

  1. Abra el conjunto de datos que creó, Luma Web Event Data

  2. Seleccione Alternancia de perfil para activarla

    Alternancia de perfil

  3. Confirme que quiere habilitar el conjunto de datos

    Alternancia de habilitación de perfil

Para habilitar el esquema:

  1. Abra el esquema que creó, Luma Web Event Data

  2. Seleccione Alternancia de perfil para activarla

    Alternancia de perfil

  3. Seleccione Los datos de este esquema contendrán una identidad principal en el campo identityMap.

    note important
    IMPORTANT
    Las 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, el SDK web 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.

  4. Seleccionar Habilitar

    Alternancia de habilitación de perfil

  5. Seleccione Guardar para guardar el esquema actualizado

Ahora el esquema también está habilitado para el perfil.

IMPORTANT
Una vez que un esquema está habilitado para el perfil, no se puede deshabilitar ni eliminar sin restablecer o eliminar toda la zona protegida. Además, los campos no se pueden eliminar del esquema después de este punto.
Al trabajar con sus propios datos, le recomendamos que haga las cosas en el siguiente orden:
  • 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. Inspect usa la solicitud del SDK web de Platform para asegurarse de que envía datos con lumaCRMId.

  1. En la interfaz de Experience Platform, seleccione Cliente > Perfiles en el panel de navegación izquierdo

  2. Como el área de nombres de identidad, use lumaCRMId

  3. Copie y pegue el valor de lumaCRMId pasado en la llamada que inspeccionó en Experience Platform Debugger, en este caso 112ca06ed53d3db37e4cea49cc45b71e.

    Perfil

  4. Si hay un valor válido en el perfil para lumaCRMId, se rellena un identificador de perfil en la consola:

    Perfil

  5. Para ver el perfil del cliente completo para cada ID, seleccione el ID de perfil en la ventana principal.

    note note
    NOTE
    Nota: 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
    Perfil del cliente

    Aquí puede ver todas las identidades vinculadas a lumaCRMId, como ECID.

    Perfil del cliente

Ahora ha habilitado el SDK web de Platform para Experience Platform (y Real-Time CDP! ¡Y Journey Optimizer! ¡Y Customer Journey Analytics!).

Crear un esquema de fidelización e introducir datos de ejemplo

Se espera que los clientes de Real-time Customer Data Platform y Journey Optimizer completen este ejercicio.

Cuando los datos del SDK web 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, cree rápidamente otro conjunto de datos en Adobe Experience Platform con algunos datos de fidelidad de ejemplo para poder utilizar Perfiles del cliente en tiempo real con Real-time Customer Data Platform y Journey Optimizer. Dado que ya ha realizado ejercicios similares, las instrucciones serán breves.

Cree el esquema de fidelización:

  1. Creación de un nuevo esquema

  2. Elija Perfil individual como clase base

  3. Asigne un nombre al esquema Luma Loyalty Schema

  4. Agregar el grupo de campos Detalles de fidelización

  5. Agregar el grupo de campos Detalles demográficos

  6. Seleccione el campo Person ID y márquelo como Identidad e Identidad principal con el área de nombres Luma CRM Id Identidad.

  7. 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.

  8. Guardar el esquema

    Esquema de fidelización

Para crear el conjunto de datos e introducir los datos de ejemplo:

  1. Crear un nuevo conjunto de datos a partir de Luma Loyalty Schema

  2. Asigne un nombre al conjunto de datos Luma Loyalty Dataset

  3. Habilitar el conjunto de datos para Perfil

  4. Descargar el archivo de muestra luma-loyalty-forWeb.json

  5. Arrastre y suelte el archivo en el conjunto de datos

  6. Confirme que los datos se han introducido correctamente.

    Esquema de fidelización

Crear un público

Las audiencias agrupan perfiles en torno a rasgos comunes. Cree una audiencia rápida que pueda utilizar en su campaña web:

  1. En la interfaz del Experience Platform o Journey Optimizer, vaya a Cliente > Audiencias en el panel de navegación izquierdo

  2. Seleccionar Crear audiencia

  3. Seleccionar regla de compilación

  4. Seleccionar Crear

    Crear un público

  5. Seleccionar atributos

  6. Busque el campo Fidelidad > Nivel y arrástrelo a la sección Atributos

  7. Defina la audiencia como usuarios cuyo tier es gold

  8. Asigne un nombre a la audiencia Luma Loyalty Rewards – Gold Status

  9. Seleccione Edge como método de evaluación

  10. Seleccionar Guardar

    Definición de la audiencia

Como 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 el SDK web al Edge Network de Platform, podemos evaluar la definición de la audiencia y confirmar inmediatamente si el usuario cumple los requisitos.

Siguiente:

NOTE
Gracias por dedicar su tiempo a conocer el SDK web de Adobe Experience Platform. 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
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4