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:

IMPORTANT
Los datos de esta lección provienen de la capa de datos 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. capa de datos digitalData

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

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:

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

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 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
IMPORTANT
Como se ha indicado anteriormente, los ejemplos de este tutorial siguen el enfoque Asignar a XDM en etiquetas.

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:

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

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

  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:

  • page.pageInfo.server asignado a
    digitalData.page.pageInfo.server

  • page.pageInfo.hierarchie1 asignado a
    digitalData.page.pageInfo.hierarchie1

  • user.profile.attributes.username asignado a
    digitalData.user.0.profile.0.attributes.username

  • user.profile.attributes.loggedIn asignado a
    digitalData.user.0.profile.0.attributes.loggedIn

  • product.productInfo.sku se asignó a digitalData.product.0.productInfo.sku

  • product.productInfo.title se asignó a digitalData.product.0.productInfo.title

  • cart.orderId se asignó a digitalData.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;
    
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 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:

  1. Seleccionar Agregar elemento de datos

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

  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. Se recomienda incluir el prefijo "data" en los elementos de datos específicos del objeto de datos 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 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 SDK para web de Platform
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
TIP
En una lección futura de Crear reglas de etiquetas, aprenderá cómo los elementos de datos de Variable le permiten apilar varias reglas en etiquetas utilizando Actualizar tipo de acción de variable.

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.

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