Envío de datos de capa de datos del cliente de Adobe con Web SDK

La capa de datos del cliente de Adobe (ACDL) recopila datos y eventos en la página, pero no los envía a ninguna parte. Para enviarlos a Adobe Experience Platform Edge Network, conecte los eventos ACDL a Web SDK de una de las siguientes maneras:

  • Biblioteca JavaScript: Su propio código escucha eventos ACDL y llama al comando sendEvent de Web SDK.
  • Extensiones de etiquetas: Las reglas de etiquetas utilizan la extensión ACDL para almacenar en déclencheur eventos ACDL y la extensión Web SDK para enviar los datos.

Cada sección de esta página muestra ambos enfoques.

Requisitos previos prerequisites

El código del sitio inserta los datos y los eventos que desea enviar. Los ejemplos de esta página utilizan la siguiente inserción para cada vista de página:

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({
  event: "page view",
  page: { title: "Home", language: "en" }
});

También necesitará lo siguiente, según su enfoque:

Biblioteca de JavaScript

El código base de Web SDK pone en cola los comandos hasta que se carga la biblioteca, y ACDL pone en cola los elementos hasta que se carga la biblioteca. Debido a estas colas, puede agregar el código de esta página en cualquier lugar después del código base de Web SDK, independientemente de qué biblioteca se cargue primero.

Extensiones de etiquetas

Elija cómo asignar los datos mapping

Web SDK envía datos en dos objetos. Elija una o ambas:

Objeto
Funcionamiento de la asignación
Úselo cuando
xdm
Puede generar un objeto que coincida con el esquema XDM a partir de valores de capa de datos, en el código o en una regla de etiqueta.
Desea tener un control total sobre la carga útil o la capa de datos ya se parece a su esquema.
data
Los valores de la capa de datos se envían tal cual. Los asigna a XDM en el conjunto de datos con Preparación de datos para la recopilación de datos.
Desea mantener la lógica de asignación fuera del código de página y las reglas de etiquetas, o varios sitios comparten una capa de datos bien controlada.

Elija la procedencia de los valores value-sources

Cuando un evento ACDL crea un déclencheur para el código o la regla, puede leer los valores de la capa de datos desde dos lugares:

Fuente
Biblioteca de JavaScript
Extensiones de etiquetas
Contiene
El objeto insertado
event.page.title, donde event es el argumento del oyente
%event.message.page.title%
Solo el objeto que activó el evento.
El estado calculado
adobeDataLayer.getState("page.title")
Un elemento de datos de estado calculado de la capa de datos con la ruta page.title
Todos los datos se han combinado desde cada notificación push hasta el momento.

Utilice el objeto insertado para valores que describan el propio evento, como el producto en una adición al carro de compras. Utilice el estado calculado para los valores insertados anteriormente, como los detalles del usuario. Cuando se ejecuta el código o la regla, el estado calculado ya incluye los datos de la notificación push que la activó. Ver Qué reciben los oyentes y Usar los datos insertados en las reglas.

Envío de datos XDM xdm

Los siguientes ejemplos envían una vista de página con el título de página del objeto insertado.

Biblioteca de JavaScript

Escuche el evento y llame a sendEvent:

code language-js
window.adobeDataLayer = window.adobeDataLayer || [];

function sendPageView(event) {
  alloy("sendEvent", {
    xdm: {
      eventType: "web.webpagedetails.pageViews",
      web: {
        webPageDetails: {
          name: event.page.title,
          pageViews: { value: 1 }
        }
      }
    }
  });
}

window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("page view", sendPageView);
});

Para todas las opciones de escucha, consulte addEventListener().

Extensiones de etiquetas
  1. Crear un elemento de datos Variable con la extensión Web SDK. Seleccione XDM y, a continuación, seleccione su zona protegida y esquema. Este ejemplo asigna un nombre al elemento de datos XDM variable.

  2. Cree una regla y añada un evento:

    • Extensión: Capa de datos del cliente de Adobe
    • Tipo de evento: Inserción de capa de datos
    • Déclencheur en: Eventos con nombre específico, con el nombre de evento page view
    • Ámbito de tiempo: Todos
  3. Añada una acción que rellene el objeto XDM:

    • Extensión: Adobe Experience Platform Web SDK
    • Tipo de acción: Actualizar variable
    • Elemento de datos: XDM variable
    • Establezca web.webPageDetails.name en %event.message.page.title% y establezca web.webPageDetails.pageViews.value en 1.
  4. Añada una acción que envíe el evento:

    • Extensión: Adobe Experience Platform Web SDK
    • Tipo de acción: Enviar evento
    • Tipo: web.webpagedetails.pageViews
    • XDM: %XDM variable%
  5. Guarde la regla, añádala a una biblioteca y cree la biblioteca.

Para ver todas las opciones de evento, consulte Inserción de capa de datos.

Cada vez que el sitio inserta un evento page view, el código o la regla enviará una vista de página a Edge Network.

Envíe interacciones del mismo modo. Por ejemplo, para una inserción como { event: "cart add", eventInfo: { sku: "HT105" } }, escuche o déclencheur en cart add y lea el producto de eventInfo. Para ver los campos XDM que describen las interacciones comerciales, consulte Recopilar información de comercio, productos y pedidos.

Envío de la capa de datos para su asignación en el conjunto de datos data

Para asignar en la secuencia de datos en lugar de en el código o las reglas, envíe valores de capa de datos en el objeto data e incluya un XDM eventType para que el evento se clasifique correctamente.

Biblioteca de JavaScript
code language-js
function sendWithDataPrep(event) {
  alloy("sendEvent", {
    xdm: { eventType: "web.webpagedetails.pageViews" },
    data: this.getState()
  });
}

window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("page view", sendWithDataPrep);
});

Dentro de una escucha ACDL, this hace referencia a la capa de datos, por lo que this.getState() devuelve el estado calculado. Para enviar solo una parte, pase una ruta de acceso, como this.getState("page").

Extensiones de etiquetas
  1. Cree un elemento de datos de estado calculado de la capa de datos con la extensión ACDL. Seleccione Todo el estado calculado o seleccione Ruta específica e introduzca la ruta de los datos que desea enviar. Este ejemplo asigna un nombre al elemento de datos ACDL state.

  2. Cree una regla con el mismo evento push de capa de datos que en Enviar datos XDM.

  3. Agregue una acción Enviar evento desde la extensión Web SDK:

    • Tipo: web.webpagedetails.pageViews
    • Datos: %ACDL state%
  4. Guarde la regla, añádala a una biblioteca y cree la biblioteca.

A continuación, en el conjunto de datos, asigne los campos que envíe al esquema XDM. Consulte Preparación de datos para la recopilación de datos. Los datos que no asigna y que ningún servicio configurado lee no se almacenan. Al enviar todo el estado calculado también aumenta el tamaño de cada solicitud, por lo que en las páginas con una capa de datos grande, envíe solo las partes que asigne.

Aplicaciones de una sola página spa

En una aplicación de una sola página, la página permanece abierta mientras el visitante ve muchas páginas virtuales y la capa de datos history sigue creciendo. Inserte un evento page view para cada vista de página virtual y borre el historial después de enviarlo. Borrar el historial no cambia el estado calculado ni elimina los agentes de escucha y las reglas.

Biblioteca de JavaScript

Borre el historial al final del listener de vista de página:

code language-js
function sendPageView(event) {
  alloy("sendEvent", { /* ... */ });
  this.length = 0;
}

Ver Borrar el historial.

Extensiones de etiquetas
Agregue una acción Borrar historial de la capa de datos de la extensión ACDL como la última acción de la regla de vista de página.

Intervalos y duplicados timing

Siga estas prácticas para que cada evento se envíe exactamente una vez:

  • Usar el ámbito all. Es la opción predeterminada en ambos enfoques: la opción scope en JavaScript y la configuración Time scope en las etiquetas. Envía eventos que se insertaron antes de que el oyente o la regla empezaran a escuchar, como una vista de página que se insertó antes de que se cargara el script o la biblioteca de etiquetas. Use future solo si otra parte de la implementación ya envió los eventos anteriores. Consulte Ámbito.
  • Envíe cada evento desde un lugar. Si su propio código y una regla de etiqueta envían el mismo evento de capa de datos, Adobe lo recibirá dos veces.
  • Biblioteca JavaScript: use funciones con nombre y agregue cada agente de escucha una vez. ACDL ignora un segundo registro de la misma función para el mismo evento. Sin embargo, si el código que se ejecuta repetidamente pasa una nueva función anónima cada vez, ACDL agrega un nuevo agente de escucha cada vez y cada evento se envía más de una vez.
  • Extensiones de etiquetas: déclencheur en nombres de eventos específicos. Regla que genera déclencheur en Todos los cambios de datos que se ejecutan para cada inserción de datos, lo que puede enviar muchos más eventos de lo esperado.
recommendation-more-help
experience-platform-help-collection