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
sendEventde 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:
- ACDL está instalado en sus páginas.
- El código base Web SDK y la biblioteca están instalados, y Web SDK está configurado con una secuencia de datos.
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.
- La extensión ACDL está instalada y configurada en su propiedad de etiquetas.
- La extensión de Web SDK está instalada y configurada con un conjunto de datos.
Elija cómo asignar los datos mapping
Web SDK envía datos en dos objetos. Elija una o ambas:
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:
event.page.title, donde event es el argumento del oyente%event.message.page.title%adobeDataLayer.getState("page.title")page.titleUtilice 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.
Escuche el evento y llame a sendEvent:
| code language-js |
|---|
|
Para todas las opciones de escucha, consulte addEventListener().
-
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. -
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
-
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.nameen%event.message.page.title%y establezcaweb.webPageDetails.pageViews.valueen1.
-
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%
-
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.
| code language-js |
|---|
|
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").
-
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. -
Cree una regla con el mismo evento push de capa de datos que en Enviar datos XDM.
-
Agregue una acción Enviar evento desde la extensión Web SDK:
- Tipo:
web.webpagedetails.pageViews - Datos:
%ACDL state%
- Tipo:
-
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.
Borre el historial al final del listener de vista de página:
| code language-js |
|---|
|
Ver Borrar el historial.
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ónscopeen 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. Usefuturesolo 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.
Páginas relacionadas related
- Comando
sendEventy acción Enviar evento: todas las opciones de Web SDK para enviar eventos. addEventListener()y inserción de capa de datos: todas las opciones para escuchar eventos ACDL.