Solución de problemas de la capa de datos del cliente Adobe
Utilice esta página para diagnosticar problemas comunes con la capa de datos del cliente de Adobe (ACDL). La mayoría de las comprobaciones utilizan la consola para desarrolladores del explorador.
Inspeccionar la capa de datos inspect
Ejecute los siguientes comandos en la consola:
Comando
Resultado
adobeDataLayer.versionLa versión de ACDL, como
"3.0.1". Si es undefined, ACDL no se ha cargado.adobeDataLayer.getState()El estado calculado.
adobeDataLayerEl historial de datos y objetos de evento, en el orden en que se procesaron.
Para ver los eventos a medida que ocurren, agregue un oyente temporal:
adobeDataLayer.addEventListener("adobeDataLayer:event", function(event) {
console.log("ACDL event:", event.event, event);
}, { scope: "future" });
Mensajes de consola console-messages
Mensaje
Causa y solución
The following item cannot be handled by the data layer because it does not have a valid format: ...Algo insertó un valor que no es un objeto sin formato ni una función, como una cadena o una matriz. Busque el código que inserta el valor mostrado en el mensaje. Ver elementos no válidos.
Adobe Client Data Layer v... has already been imported/initialized on this page. You may be erroneously loading it a second time.La biblioteca se cargó más de una vez. La primera copia sigue funcionando. Elimine la copia adicional. Ver Cargar la biblioteca solo una vez.
TypeError: adobeDataLayer.getState is not a function (o addEventListener, removeEventListener)Código llamado método ACDL antes de cargar la biblioteca. Llámelo desde una función que inserte en su lugar. Ver métodos de llamada seguros.
ReferenceError: structuredClone is not definedEl explorador es anterior a lo que admite ACDL 3.x. Consulte Requisitos del explorador.
TypeError: Cannot read properties of null (reading 'event')Código insertado
null o undefined.RangeError: Maximum call stack size exceededUn oyente empuja algo que se déclencheur a sí mismo. Ver Evitar bucles interminables.
La redacción de los mensajes de error de JavaScript varía ligeramente entre los exploradores. Por ejemplo, Safari informa ReferenceError: Can't find variable: structuredClone.
ACDL no se carga not-loaded
Si adobeDataLayer.version es undefined, compruebe lo siguiente:
- La biblioteca no está en la página. Compruebe el panel de red de
adobe-client-data-layer.min.jso la biblioteca de etiquetas si la extensión de etiqueta carga ACDL. Asegúrese de que la directiva de seguridad de contenido permite el script. adobeDataLayerno es una matriz. Si otro script establecewindow.adobeDataLayeren algo distinto a una matriz antes de que se cargue ACDL, ACDL no se adjuntará al mismo.- Un script reemplazó la matriz. Un código como
window.adobeDataLayer = [];reemplaza la capa de datos por una nueva matriz vacía, lo que provoca la pérdida de los métodos ACDL, el estado calculado y todos los agentes de escucha. Usar siemprewindow.adobeDataLayer = window.adobeDataLayer || [];. Consulte Crear la matriz de capa de datos. - Una función en cola generó un error. Si una función que se insertó antes de cargar ACDL genera un error, este aparece en la consola y los elementos que se pusieron en cola después de esa función se pierden. Detecte los errores dentro de las funciones que inserta.
Un oyente no se ejecuta listener-not-called
Compruebe lo siguiente:
- El nombre del evento no coincide. Los nombres de evento distinguen entre mayúsculas y minúsculas y deben coincidir exactamente, incluidos los espacios.
- El evento se insertó antes de que se agregara el agente de escucha y el agente de escucha usa el ámbito
future. Usar el ámbitoallpredeterminado. Consulte Ámbito. - El historial se borró antes de que se agregara el oyente, por lo que no hay nada que reproducir. Ver Borrar el historial.
- La opción
pathfiltra la notificación push. Un oyente con una ruta de acceso solo se ejecuta para los mensajes push que incluyen esa ruta de acceso. Consulte Ruta. - El agente de escucha nunca se agregó. Si el argumento del agente de escucha no es una función o el ámbito no es válido, ACDL no agrega el agente de escucha. En su lugar, claves como
onyhandleraparecen enadobeDataLayer.getState(). - Ya se ha registrado la misma función para el evento. ACDL ignora el segundo registro, incluso con opciones diferentes.
- Una escucha anterior produjo un error en la misma notificación push, lo que detiene a los oyentes restantes. Compruebe si hay errores en la consola.
- La inserción no es un evento. Un objeto cuyo valor
eventfalta, está vacío o no es una cadena se trata como datos. Almacena en déclencheur aadobeDataLayer:changeoyentes, no detectores de eventos.
Un oyente se ejecuta con más frecuencia de lo esperado listener-called-too-often
- Reproduce eventos anteriores. Con el ámbito predeterminado
all, se ejecuta un nuevo agente de escucha para los eventos coincidentes que ya están en el historial. Este comportamiento es predecible. Utilice el ámbitofuturesi ya se han controlado los eventos anteriores. - Se agregó más de una vez. Código que se ejecuta repetidamente y pasa una nueva función anónima cada vez que agrega un nuevo agente de escucha. Utilice una función con nombre. Consulte Usar funciones con nombre.
- Utiliza una ruta de acceso. Un oyente con una ruta se ejecuta para cada inserción que incluye la ruta, incluso si el valor no ha cambiado.
Faltan datos o estos son incorrectos en el estado calculado state-issues
- El valor se insertó como
eventoeventInfo. Estas claves no se almacenan en el estado calculado. Inserte datos con otras claves. - Una matriz perdió elementos. Al insertar una matriz, se reemplaza toda la matriz. Inserte la matriz completa. Ver Matrices.
- Un objeto no reemplazó una cadena, un número o un booleano. Primero elimine la clave insertando
nully después inserte el objeto. Consulte Cambiar el tipo de un valor. - Una fecha o función se convirtió en un objeto vacío. Almacene las fechas como cadenas o números. Consulte Tipos de valor.
- Un cambio realizado en el resultado de
getState()no tuvo ningún efecto.getState()devuelve una copia. Presione el cambio en su lugar. getState()con una ruta devuelveundefined. Compruebe la ortografía de cada tecla de la ruta. Utilice puntos para índices de matriz, comoitems.0.sku, no corchetes. Ver Obtener un valor en una ruta.
Faltan elementos en el historial history-issues
- No se conservan las funciones y los elementos no válidos. Solo se conservan los objetos de datos y los objetos de evento. Ver Después de cargar ACDL: un historial.
- Un oyente ha devuelto un error. Cuando un oyente emite un error, el elemento que lo ha activado actualiza el estado calculado, pero no se añade al historial.
- Una llamada de
push()contenía varios tipos de elementos. Insertar cada elemento en una llamada independiente. Ver Insertar un elemento por llamada. - El historial se borró, por ejemplo, con la acción Borrar historial de la capa de datos de la extensión de la etiqueta.
recommendation-more-help
experience-platform-help-collection