Creación de elementos de datos
Aprenda a crear elementos de datos en etiquetas para datos de contenido, comercio e identidad en el sitio de demostración de Luma. A continuación, rellene los campos del esquema XDM con la extensión del SDK web de Adobe Experience Platform Variable data element type.
Objetivos de aprendizaje
Al final de esta lección, puede hacer lo siguiente:
- Comprender diferentes enfoques para asignar una capa de datos a XDM
- Creación de elementos de datos para capturar datos
- Asignación de elementos de datos a un objeto XDM
Requisitos previos
Tiene una comprensión de lo que es una capa de datos y ha completado las lecciones anteriores en el tutorial:
digitalData
del sitio de Luma. Para ver la capa de datos, abra la consola de desarrollador y escriba digitalData
para ver la capa de datos completa disponible.
Enfoques de capa de datos
Existen varias formas de asignar datos de la capa de datos al XDM mediante la funcionalidad de etiquetas de Adobe Experience Platform. A continuación se presentan algunas ventajas y desventajas de tres enfoques diferentes. Si lo desea, es posible combinar los siguientes enfoques:
- Implementación de XDM en la capa de datos
- Asignación a XDM en etiquetas
- Asignar a XDM en el conjunto de datos
Implementación de XDM en la capa de datos
Este método implica utilizar el objeto XDM completamente definido como estructura para la capa de datos. A continuación, asigne toda la capa de datos a un elemento de datos de objeto XDM en las etiquetas. Si la implementación no utiliza un administrador de etiquetas, este método puede ser ideal porque puede enviar datos a XDM directamente desde la aplicación mediante el comando XDM sendEvent. Si utiliza etiquetas, puede crear un elemento de datos de código personalizado que capture toda la capa de datos como un objeto JSON de paso al XDM. A continuación, asigne el JSON de paso a través al campo de objeto XDM en la acción Enviar evento.
A continuación se muestra un ejemplo del aspecto que tendría la capa de datos al utilizar el formato de capa de datos del cliente de Adobe:
code language-json |
---|
|
Pros
- Elimina los pasos adicionales para reasignar a variables de capa de datos a XDM
- Puede ser más rápido de implementar si su equipo de desarrollo web también posee el comportamiento digital de etiquetado
Contras
- Dependencia total del equipo de desarrollo y el ciclo de desarrollo para actualizar qué datos se transfieren a XDM
- Flexibilidad limitada, ya que XDM recibe la carga útil exacta de la capa de datos
- No se pueden utilizar las características de etiquetas integradas, como raspado, persistencia o características para implementaciones rápidas
- Es más difícil usar la capa de datos para píxeles de terceros (pero quizá quieras mover estos píxeles a reenvío de eventos!
- No es posible transformar los datos entre la capa de datos y XDM
Asignación de capas de datos en etiquetas
Este método implica la asignación de variables de capa de datos individuales U objetos de capa de datos a elementos de datos en etiquetas y, finalmente, a XDM. Este es el enfoque tradicional para la implementación mediante un sistema de administración de etiquetas.
Pros
- El enfoque más flexible, ya que puede controlar variables individuales y transformar datos antes de que llegue a XDM
- Puede utilizar déclencheur de etiquetas de Adobe y la funcionalidad de raspado para pasar datos a XDM
- Puede asignar elementos de datos a píxeles de terceros del lado del cliente
Contras
- Se tarda tiempo en reconstruir la capa de datos como elementos de datos
Asignar a XDM en el conjunto de datos
Este método usa funcionalidad integrada en la configuración del flujo de datos llamada Preparación de datos para la recopilación de datos y omite la asignación de variables de capa de datos a XDM en las etiquetas.
Pros
- Flexible, ya que puede asignar variables individuales al XDM
- Capacidad para calcular nuevos valores o transformar tipos de datos de una capa de datos antes de que pase a XDM
- Aproveche una IU de asignación para asignar campos de los datos de origen a XDM con una IU de apuntar y hacer clic
Contras
- No se pueden usar variables de capa de datos como elementos de datos para píxeles de terceros del lado del cliente, pero se pueden usar con el reenvío de eventos
- No se puede utilizar la funcionalidad de raspado de la función de etiquetas de Adobe Experience Platform
- La complejidad del mantenimiento aumenta si se asigna la capa de datos tanto en etiquetas como en flujos de datos
Creación de elementos de datos para capturar la capa de datos
Antes de crear el objeto XDM, cree el siguiente conjunto de elementos de datos para la capa de datos Luma demo site:
-
Vaya a Elementos de datos y seleccione Agregar elemento de datos (o Crear nuevo elemento de datos si no hay elementos de datos existentes en la propiedad de etiqueta)
-
Asigne un nombre al elemento de datos
page.pageInfo.pageName
. -
Utilice la variable de JavaScript tipo de elemento de datos para señalar a un valor de la capa de datos de Luma:
digitalData.page.pageInfo.pageName
-
Marque las casillas de Forzar valor en minúsculas y Limpiar texto para estandarizar el caso y eliminar espacios superfluos
-
Deje
None
como la configuración de Duración del almacenamiento, ya que este valor es diferente en cada página -
Seleccionar Guardar
Cree estos elementos de datos adicionales siguiendo los mismos pasos:
-
page.pageInfo.server
asignado adigitalData.page.pageInfo.server
-
page.pageInfo.hierarchie1
asignado adigitalData.page.pageInfo.hierarchie1
-
user.profile.attributes.username
asignado adigitalData.user.0.profile.0.attributes.username
-
user.profile.attributes.loggedIn
asignado adigitalData.user.0.profile.0.attributes.loggedIn
-
product.productInfo.sku
se asignó adigitalData.product.0.productInfo.sku
-
product.productInfo.title
se asignó adigitalData.product.0.productInfo.title
-
cart.orderId
se asignó adigitalData.cart.orderId
-
product.category
usa el código personalizado tipo de elemento de datos y el siguiente código personalizado para analizar la dirección URL del sitio para la categoría de nivel superior:code language-javascript var cat = location.pathname.split(/[/.]+/); if (cat[5] == 'products') { return (cat[6]); } else if (cat[5] != 'html') { return (cat[5]); }
-
cart.productInfo
con el siguiente código personalizado:code language-javascript var cart = digitalData.cart.cartEntries; var cartItem = []; cart.forEach(function(item, index, array){ cartItem.push({ "SKU": item.sku }); }); return cartItem;
-
cart.productInfo.purchase
con el siguiente código personalizado:code language-javascript var cart = digitalData.cart.cartEntries; var cartItem = []; cart.forEach(function(item, index, array){ var qty = parseInt(item.qty); var price = parseInt(item.price); cartItem.push({ "SKU": item.sku, "quantity": qty, "priceTotal": price }); }); return cartItem;
digitalData.user[0].profile[0].attributes.username
no funcionará.Creación de elementos de datos variables para XDM y objetos de datos
Los elementos de datos que acaba de crear se utilizarán para crear un objeto XDM (para aplicaciones de Platform) y un objeto de datos (para Analytics, Target y Audience Manager). Estos objetos tienen sus propios elementos de datos especiales llamados Variable, que son muy fáciles de crear.
Para crear el elemento de datos Variable para XDM, vincúlelo al esquema que creó en la lección Configurar un esquema:
-
Seleccionar Agregar elemento de datos
-
Asigne un nombre al elemento de datos
xdm.variable.content
. Se recomienda añadir el prefijo "xdm" a los elementos de datos específicos de XDM para organizar mejor la propiedad de etiqueta -
Seleccione Adobe Experience Platform Web SDK como extensión
-
Seleccione la variable como tipo de elemento de datos
-
Seleccione XDM como propiedad
-
Seleccione la zona protegida en la que creó el esquema
-
Seleccione el esquema apropiado, en este caso
Luma Web Event Data
-
Seleccionar Guardar
A continuación, cree el elemento de datos Variable para el objeto de datos:
-
Seleccionar Agregar elemento de datos
-
Asigne un nombre al elemento de datos
data.variable
. Se recomienda incluir el prefijo "data" en los elementos de datos específicos del objeto de datos para organizar mejor la propiedad de etiqueta -
Seleccione Adobe Experience Platform Web SDK como extensión
-
Seleccione la variable como tipo de elemento de datos
-
Seleccione datos como propiedad
-
Seleccione las soluciones de Experience Cloud que desee implementar como parte de este tutorial
-
Seleccionar Guardar
Al final de estos pasos, debe tener los siguientes elementos de datos creados:
cart.orderId
data.variable
cart.productInfo
xdm.variable.content
cart.productInfo.purchase
page.pageInfo.hierarchie1
page.pageInfo.pageName
page.pageInfo.server
product.category
product.productInfo.sku
product.productInfo.title
user.profile.attributes.loggedIn
user.profile.attributes.username
Con estos elementos de datos en su lugar, está listo para empezar a enviar datos al Edge Network de Platform con una regla de etiquetas. Pero primero, aprenda a recopilar identidades con el SDK web.