Instalación de la capa de datos del cliente de Adobe

La instalación de la capa de datos del cliente de Adobe (ACDL) consta de dos partes:

  1. Cree la matriz de capa de datos en cada script que se inserte en ella, de modo que el código funcione independientemente de si ACDL se ha cargado o no todavía.
  2. Cargue la biblioteca ACDL una vez por página mediante uno de los métodos de instalación.

Creación de la matriz de capas de datos initialize

Agregue la línea siguiente antes de cualquier código que inserte en la capa de datos:

window.adobeDataLayer = window.adobeDataLayer || [];

Esta línea crea la matriz si no existe y la mantiene si existe. Inclúyala en cada script que inserte en la capa de datos, no solo en la primera. Las secuencias de comandos se pueden cargar en cualquier orden y la línea garantiza que cada secuencia de comandos se inserte en la misma matriz sin sobrescribirla.

Después de esta línea, inserte datos, eventos y funciones con push():

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({ page: { title: "Home" } });

Hasta que se carga ACDL, push() es el método de matriz de JavaScript estándar y la matriz funciona como una cola. Cuando se carga ACDL, procesa los elementos en cola en orden. Ver Cola e historial.

IMPORTANT
ACDL siempre utiliza el nombre global adobeDataLayer. La biblioteca no admite otros nombres. La extensión de etiqueta puede hacer que un segundo nombre haga referencia a la misma capa de datos.

Elegir un método de instalación methods

Cargue ACDL en cada página con uno de los siguientes métodos:

Método
Úselo cuando
Extensión de etiqueta
Las etiquetas se utilizan en Adobe Experience Platform. La extensión puede cargar ACDL por usted.
Etiqueta de script
Desea alojar el archivo de biblioteca usted mismo y añadirlo a sus plantillas de página.
npm
Puede crear el JavaScript del sitio con un paquete.
Adobe Experience Manager
Su sitio utiliza la versión 2.9.0 o posterior de los componentes principales de AEM.

Extensión de etiqueta tags

La extensión de etiqueta de capa de datos del cliente de Adobe carga ACDL cuando se carga la biblioteca de etiquetas, a menos que la página ya la cargue. No es necesario que agregue la biblioteca a las plantillas de página. El código del sitio aún necesita crear la matriz de capas de datos y enviar datos. Consulte Configurar la extensión de capa de datos del cliente de Adobe.

Etiqueta de script script

Descargue la biblioteca desde npm (consulte npm) y aloje adobe-client-data-layer.min.js en su sitio. A continuación, cárguelo en el <head> de cada página con los atributos async y defer:

<script src="/js/adobe-client-data-layer.min.js" async defer></script>

Los exploradores compatibles con async ejecutan el script en cuanto se descarga sin bloquear la página. Como ACDL procesa todo lo que se puso en cola antes de cargarse, los datos están seguros aunque otros scripts inserten primero en la capa de datos.

El siguiente ejemplo muestra una página en la que un script en línea y un script externo insertan en la capa de datos antes de que se cargue ACDL:

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>My page</title>
    <script src="/js/myscripts.js" defer></script>
    <script>
      window.adobeDataLayer = window.adobeDataLayer || [];
      window.adobeDataLayer.push({ page: { title: "My page" } });
    </script>
    <script src="/js/adobe-client-data-layer.min.js" async defer></script>
  </head>
  <body>
    <h1>My page</h1>
  </body>
</html>

El script externo /js/myscripts.js también crea la matriz antes de insertar:

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({ user: { loggedIn: false } });

Las CDN npm públicas, como unpkg y jsDelivr, también sirven para el archivo de biblioteca. Si lo carga desde una CDN de terceros, fije una versión exacta en la URL para que el archivo no cambie sin su conocimiento.

npm npm

Instale el paquete:

npm install @adobe/adobe-client-data-layer

El paquete contiene un script de explorador en dist/adobe-client-data-layer.min.js. Copie ese archivo en su sitio y cárguelo con una etiqueta de script, o importe el archivo en su JavaScript agrupado:

import "@adobe/adobe-client-data-layer/dist/adobe-client-data-layer.min.js";

El script no exporta nada. Cuando se ejecuta, configura window.adobeDataLayer.

NOTE
En ACDL 3.x, importe la ruta de archivo que se muestra arriba. El paquete 3.x no define un punto de entrada, por lo que import "@adobe/adobe-client-data-layer" falla.

Adobe Experience Manager aem

La versión 2.9.0 y posteriores de los componentes principales de AEM incluyen ACDL como biblioteca de cliente y los datos y eventos push de los componentes principales para cada componente. Ver Uso de la capa de datos del cliente de Adobe con los componentes principales.

Si el sitio de AEM también usa la extensión de etiquetas ACDL, desactive la opción Cargar la biblioteca de capa de datos del cliente de Adobe si está ausente de la extensión para que solo AEM cargue la biblioteca. Consulte Configurar la extensión de capa de datos del cliente de Adobe.

Cargar la biblioteca solo una vez load-once

Cargue ACDL una vez por página. Si se carga una segunda copia, se registra la siguiente advertencia en la consola del explorador y no se cambia la capa de datos:

Adobe Client Data Layer v3.0.1 has already been imported/initialized on this page. You may be erroneously loading it a second time.

La primera copia sigue ejecutándose, por lo que los datos y los oyentes siguen funcionando. Elimine el duplicado para evitar la descarga adicional. Los duplicados son comunes cuando una plantilla de página y la extensión de etiqueta cargan la biblioteca.

Compruebe la instalación verify

Abra la consola del desarrollador del explorador en una página que cargue ACDL y ejecute los siguientes comandos:

adobeDataLayer.version     // For example, "3.0.1"
adobeDataLayer.getState()  // The computed state of everything pushed so far

Si adobeDataLayer.version es undefined, ACDL no se ha cargado en la página. Ver Solución de problemas.

Actualización de 2.x a 3.x upgrade

Los componentes principales de Adobe Experience Manager cargan ACDL 2.x de forma predeterminada, por lo que muchos sitios siguen ejecutando 2.x. Revise los cambios siguientes antes de actualizar a la versión 3.x. Para ver todas las versiones, consulte las notas de la versión en GitHub.

ACDL 3.0 reemplazó su biblioteca de utilidades interna con características de navegador integradas. El archivo es mucho más pequeño, pero los requisitos y algunos comportamientos de combinación cambiaron:

Área
2.x
3.x
Requisitos del explorador
Se admiten exploradores más antiguos
Requiere structuredClone() y JavaScript moderno. Consulte Requisitos del explorador.
Tamaño de archivo (minificado)
Unos 33 KB
Aproximadamente 6 KB
Insertar una matriz en una clave que ya contiene una matriz
Combina las matrices por posición. Insertar ["c"] sobre ["a", "b"] resulta en ["c", "b"].
Reemplaza la matriz. Insertar ["c"] sobre ["a", "b"] resulta en ["c"]. Ver Matrices.
Insertar un objeto en una clave que contenga una cadena, un número o un valor booleano
Reemplaza el valor por el objeto.
No reemplaza el valor de. Consulte Cambiar el tipo de un valor.
Notación de corchetes en getState() rutas, como items[0].sku
Admitido
No compatible. Usar notación de puntos, como items.0.sku. Ver getState().
npm package entry point
import "@adobe/adobe-client-data-layer" carga la biblioteca.
Importe la ruta del archivo. Ver npm.

Pruebe la implementación después de actualizar, especialmente el código que inserta matrices o cambia el tipo de un valor.

recommendation-more-help
experience-platform-help-collection