Creación de elementos de datos

Obtenga información sobre cómo crear elementos de datos en etiquetas para contenido, comercio y datos de identidad en 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 digitalData en el 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 utilizando Comando sendEvent de XDM. 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 utilizar 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 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 el complemento Extensión de capa de datos Google en 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 utiliza la funcionalidad integrada en la configuración de flujo de datos denominada Preparación de datos para la recopilación de datos y omite la asignación de variables de capa de datos a XDM en 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 Sitio de demostración de Luma capa de datos:

  1. Ir a Elementos de datos y seleccione Añadir elemento de datos (o Crear nuevo elemento de datos si no hay elementos de datos existentes en la propiedad etiqueta )

    Crear elemento de datos

  2. Asigne un nombre al elemento de datos page.pageInfo.pageName.

  3. Utilice el Variable 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 de minúsculas y Limpiar texto para estandarizar el caso y eliminar espacios superfluos

  5. Salir None como el Duración del almacenamiento ya que este valor es diferente en cada página

  6. Seleccionar Guardar

    Elemento de datos Nombre de página

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 asignado a digitalData.product.0.productInfo.sku

  • product.productInfo.title asignado a digitalData.product.0.productInfo.title

  • cart.orderId asignado a digitalData.cart.orderId

  • product.category uso del 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 mediante 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 mediante 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 Variable JavaScript el tipo de elemento de datos trata las referencias de matriz como puntos en lugar de corchetes, por lo que hacer referencia al elemento de datos username 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 elementos de datos muy fáciles de crear.

Para crear el elemento de datos Variable para XDM, debe vincularlo al esquema creado en la variable Configuración de un esquema lección:

  1. Seleccionar Añadir 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 el SDK web de Adobe Experience Platform como el Extensión

  4. Seleccione el Variable como el Tipo de elemento de datos

  5. Seleccionar XDM como el propiedad

  6. Seleccione el Sandbox en el que ha creado el esquema

  7. Seleccione el adecuado Esquema, 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 Añadir 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 el SDK web de Adobe Experience Platform como el Extensión

  4. Seleccione el Variable como el Tipo de elemento de datos

  5. Seleccionar datos como el propiedad

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

  7. Seleccionar Guardar

    Elemento de datos 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 un futuro Creación de reglas de etiquetas lección, aprenderá cómo Variable Los elementos de datos de 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 este Entrada de discusión de la comunidad Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4