DocumentaciónExperience PlatformTutorial de SDK web

Creación de elementos de datos

Last update: Sun Mar 08 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Principiante
  • Intermedio
  • Desarrollador

Aprenda a crear elementos de datos en etiquetas para datos de contenido, comercio e identidad en el sitio web de demostración de Luma. A continuación, rellene los campos del esquema XDM.

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:

IMPORTANT
Los datos de esta lección provienen de la capa de datos adobeDataLayer del sitio de Luma. Para ver la capa de datos, abra la consola de desarrollador y escriba adobeDataLayer para ver la capa de datos completa disponible. capa de datos adobeDataLayer

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:

  1. Implementación de XDM en la capa de datos
  2. Asignación a XDM en etiquetas
  3. Asignar a XDM en el conjunto de datos
NOTE
Los ejemplos de este tutorial siguen el método Asignar a XDM en etiquetas.

Implementación de XDM en la capa de datos

En este enfoque, los desarrolladores web implementan un objeto XDM completamente definido como la estructura para la capa de datos. A continuación, simplemente asigne toda la capa de datos a un objeto XDM en 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:

Ejemplo de XDM en la capa de datos
code language-json 
window.adobeDataLayer.push({
"eventType": "web.webPageDetails.pageViews",
"web":{
         "webInteraction":{
            "linkClicks":{
               "id":"",
               "value":""
            },
            "URL":"",
            "name":"",
            "region":"",
            "type":""
         },
         "webPageDetails":{
            "pageViews":{
               "id":"",
               "value":"1"
            },
            "URL":"https://luma.enablementadobe.com/",
            "isErrorPage":"",
            "isHomePage":"",
            "name":"luma:home",
            "server":"enablementadobe.com",
            "siteSection":"home",
            "viewName":""
         },
         "webReferrer":{
            "URL":"",
            "type":""
         }
      }
});

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 etiquetado del comportamiento digital

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 es posible que desee mover estos píxeles a reenvío de eventos!)
  • No es posible transformar los datos entre la capa de datos y XDM

Asignación a XDM en etiquetas

Este método implica la asignación de variables de capa de datos individuales 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 de etiquetas
IMPORTANT
Como se ha indicado anteriormente, los ejemplos de este tutorial siguen el enfoque Asignar a XDM en etiquetas.

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

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 usar la funcionalidad de raspado en etiquetas
  • La complejidad del mantenimiento aumenta si se asigna la capa de datos tanto en etiquetas como en flujos de datos
TIP
Capa de datos de Google
Si su organización ya utiliza Google Analytics y tiene el objeto dataLayer tradicional de Google en su sitio web, puede utilizar la extensión de capa de datos de Google en las etiquetas. Esto le permite implementar la tecnología de Adobe más rápido sin tener que solicitar asistencia a su equipo de TI. La asignación de la capa de datos de Google a XDM seguiría los mismos pasos que se describen arriba.

Creación de elementos de datos para capturar la capa de datos

Antes de rellenar campos XDM, primero capture los puntos de datos que necesita como elementos de datos de etiquetas:

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

    Crear elemento de datos

  2. Asigne un nombre al elemento de datos Page Name.

  3. Utilice la variable de JavaScript tipo de elemento de datos para señalar al valor de la capa de datos de Luma: adobeDataLayer.0.page.name

  4. Marque las casillas de Forzar valor en minúsculas y Limpiar texto para estandarizar el caso y eliminar espacios superfluos

  5. Deje None como la configuración de Duración del almacenamiento, ya que este valor es diferente en cada página

  6. Seleccionar Guardar

    Elemento de datos Page Name

Cree estos elementos de datos adicionales siguiendo los mismos pasos:

  • User Id asignado a
    adobeDataLayer.0.user.id

  • User Logged In asignado a
    adobeDataLayer.0.user.loggedIn

  • Ecommerce Product Id se asignó a adobeDataLayer.0.ecommerce.detail.products.0.id

  • Ecommerce Product Name se asignó a adobeDataLayer.0.ecommerce.detail.products.0.name

  • Ecommerce Purchase Id se asignó a adobeDataLayer.0.ecommerce.purchase.actionField.id

  • Ecommerce Product Category usa el código personalizado tipo de elemento de datos y el siguiente código personalizado:

    code language-javascript 
    return adobeDataLayer[0].ecommerce.detail.products[0].category+":"+adobeDataLayer[0].ecommerce.detail.products[0].subcategory;

  • Ecommerce Cart Products con el siguiente código personalizado:

    code language-javascript 
    const cartProducts = adobeDataLayer
.flatMap(evt => Array.isArray(evt?.ecommerce?.cart?.items) ? evt.ecommerce.cart.items : [])
.filter(item => item && item.id && item.name && item.brand)
.map(({ id, name, brand }) => ({ id, name, brand }));

return cartProducts;

  • Ecommerce Purchase Products con el siguiente código personalizado:

    code language-javascript 
    const purchaseEvent = adobeDataLayer.find(e => e.event === "purchase");

const currencyCode = purchaseEvent?.ecommerce?.currencyCode ?? "USD";

const purchasedProducts = (purchaseEvent?.ecommerce?.purchase?.products || []).map(p => {
   const unitPrice = parseFloat(String(p.price).replace(/[^0-9.-]/g, "")) || 0;
   const qty = Number(p.quantity) || 0;

   return {
   SKU: p.id,                       // id -> SKU
   name: p.name,                    // name -> name
   quantity: qty,                   // quantity -> quantity
   priceTotal: unitPrice * qty,     // price -> priceTotal (unit price × quantity)
   currencyCode                     // "USD" -> currencyCode (from ecommerce.currencyCode)
   };
});

return(purchasedProducts);
CAUTION
El tipo de elemento de datos JavaScript variable trata las referencias de matriz como puntos en lugar de corchetes, por lo que hacer referencia al elemento de datos de nombre de usuario como adobeDataLayer[0].page.name 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:

  1. Seleccionar Agregar elemento de datos

  2. Asigne un nombre al elemento de datos XDM Variable. Se recomienda añadir el prefijo "XDM" a los elementos de datos específicos de XDM para organizar mejor la propiedad de etiqueta

  3. Seleccione Adobe Experience Platform Web SDK como extensión

  4. Seleccione la variable como tipo de elemento de datos

  5. Seleccione XDM como propiedad

  6. Seleccione la zona protegida en la que creó el esquema

  7. Seleccione el esquema apropiado, en este caso Luma Web Event Data

  8. Seleccionar Guardar

    Elemento de datos variable para XDM

A continuación, cree el elemento de datos Variable para el objeto de datos:

  1. Seleccionar Agregar elemento de datos

  2. Asigne un nombre al elemento de datos Data Variable.

  3. Seleccione Adobe Experience Platform Web SDK como extensión

  4. Seleccione la variable como tipo de elemento de datos

  5. Seleccione datos como propiedad

  6. Seleccione las soluciones de Experience Cloud que desee implementar como parte de este tutorial

  7. Seleccionar Guardar

    Elemento de datos de variable para el objeto de datos

Al final de estos pasos, debe tener los siguientes elementos de datos creados:

Elementos de datos de la extensión principal
Elementos de datos de la extensión Platform Web SDK
Ecommerce Cart Products
Data Variable
Ecommerce Product Category
XDM Variable
Ecommerce Product Id
Ecommerce Product Name
Ecommerce Purchase Id
Ecommerce Purchase Products
Page Name
User Id
User Logged In

Con estos elementos de datos en su lugar, está listo para empezar a enviar datos a Platform Edge Network con una regla de etiquetas. Pero primero, aprenda a recopilar identidades con Web SDK.

NOTE
Gracias por dedicar su tiempo a conocer Adobe Experience Platform Web SDK. 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