Solução de problemas da camada de dados de clientes Adobe

Use esta página para diagnosticar problemas comuns com a Adobe Client Data Layer (ACDL). A maioria das verificações usa o console do desenvolvedor do navegador.

Inspecionar a camada de dados inspect

Execute os seguintes comandos no console:

Comando
Resultado
adobeDataLayer.version
A versão da ACDL, como "3.0.1". Se for undefined, ACDL não foi carregado.
adobeDataLayer.getState()
O estado computado.
adobeDataLayer
O histórico de dados e objetos de evento, na ordem em que foram processados.

Para assistir aos eventos enquanto eles ocorrem, adicione um ouvinte temporário:

adobeDataLayer.addEventListener("adobeDataLayer:event", function(event) {
  console.log("ACDL event:", event.event, event);
}, { scope: "future" });

Mensagens do console console-messages

Mensagem
Causa e solução
The following item cannot be handled by the data layer because it does not have a valid format: ...
Algo empurrou um valor que não é um objeto simples ou uma função, como uma string ou uma matriz. Encontre o código que envia por push o valor mostrado na mensagem. Consulte Itens inválidos.
Adobe Client Data Layer v... has already been imported/initialized on this page. You may be erroneously loading it a second time.
A biblioteca foi carregada mais de uma vez. A primeira cópia continua funcionando. Remova a cópia extra. Consulte Carregar a biblioteca apenas uma vez.
TypeError: adobeDataLayer.getState is not a function (ou addEventListener, removeEventListener)
O código chamou um método ACDL antes da biblioteca ser carregada. Chame-o a partir de uma função que você pressiona. Consulte Chamar métodos com segurança.
ReferenceError: structuredClone is not defined
O navegador é anterior ao compatível com ACDL 3.x. Consulte Requisitos do navegador.
TypeError: Cannot read properties of null (reading 'event')
Código enviado por push null ou undefined.
RangeError: Maximum call stack size exceeded
Um ouvinte envia algo que se aciona. Consulte Evitar repetições infinitas.

O texto das mensagens de erro do JavaScript varia ligeiramente entre os navegadores. Por exemplo, o Safari relata ReferenceError: Can't find variable: structuredClone.

A ACDL não carrega not-loaded

Se adobeDataLayer.version for undefined, verifique o seguinte:

  • A biblioteca não está na página. Verifique o painel de rede para adobe-client-data-layer.min.js ou para sua biblioteca de marcas se a extensão de marca carregar ACDL. Certifique-se de que a Política de segurança de conteúdo permita o script.
  • adobeDataLayernão é uma matriz. Se outro script definir window.adobeDataLayer como algo diferente de uma matriz antes de o ACDL ser carregado, o ACDL não será anexado a ele.
  • Um script substituiu a matriz. Códigos como window.adobeDataLayer = []; substituem a camada de dados por uma matriz nova e vazia, que perde os métodos ACDL, o estado calculado e todos os ouvintes. Sempre usar window.adobeDataLayer = window.adobeDataLayer || [];. Consulte Criar a matriz de camada de dados.
  • Uma função na fila apresentou um erro. Se uma função que foi enviada antes do carregamento do ACDL gerar um erro, ele aparecerá no console e os itens que foram enfileirados após essa função serão perdidos. Detectar erros dentro das funções que você pressiona.

Um ouvinte não é executado listener-not-called

Verifique o seguinte:

  • O nome do evento não corresponde. Os nomes de eventos diferenciam maiúsculas de minúsculas e devem corresponder exatamente, incluindo espaços.
  • O evento foi enviado por push antes da adição do ouvinte, que usa o escopo future. Usar o escopo all padrão. Consulte Escopo.
  • O histórico foi limpo antes da adição do ouvinte, portanto não há nada a ser repetido. Consulte Limpar o histórico.
  • A opção path filtra o push. Um ouvinte com um caminho é executado somente para envios por push que incluem esse caminho. Consulte Caminho.
  • O ouvinte nunca foi adicionado. Se o argumento do ouvinte não for uma função ou o escopo não for válido, o ACDL não adicionará o ouvinte. Em vez disso, chaves como on e handler aparecem em adobeDataLayer.getState().
  • A mesma função já está registrada para o evento. A ACDL ignora o segundo registro, mesmo com opções diferentes.
  • Um ouvinte anterior emitiu um erro para o mesmo push, que interrompe os ouvintes restantes. Verifique se há erros no console.
  • O push não é um evento. Um objeto cujo valor event está ausente, vazio ou não é uma cadeia de caracteres é tratado como dados. Ele aciona adobeDataLayer:change ouvintes, não ouvintes de eventos.

Um ouvinte é executado com mais frequência do que o esperado listener-called-too-often

  • Ele repete eventos anteriores. Com o escopo all padrão, um novo ouvinte é executado para eventos correspondentes que já estão no histórico. Esse comportamento é esperado. Use o escopo future se os eventos anteriores já tiverem sido manipulados.
  • Foi adicionado mais de uma vez. O código que é executado repetidamente e passa uma nova função anônima sempre adiciona um novo ouvinte a cada vez. Use uma função nomeada. Consulte Usar funções nomeadas.
  • Ele usa um caminho. Um ouvinte com um caminho é executado para cada push que inclui o caminho, mesmo se o valor não tiver sido alterado.

Dados ausentes ou incorretos no estado calculado state-issues

  • O valor foi enviado por push como event ou eventInfo. Essas chaves não são armazenadas no estado calculado. Enviar dados em outras chaves.
  • Uma matriz perdeu itens. Enviar uma matriz substitui toda a matriz. Empurre a matriz completa. Consulte Matrizes.
  • Um objeto não substituiu uma cadeia de caracteres, um número ou um booleano. Exclua a chave primeiro, enviando por push null e depois por push o objeto. Consulte Alterar o tipo de um valor.
  • Uma data ou função tornou-se um objeto vazio. Armazenar datas como sequências de caracteres ou números. Consulte Tipos de valor.
  • Uma alteração feita no resultado de getState() não teve efeito. getState() retorna uma cópia. Em vez disso, pressione a alteração.
  • getState()com um caminho retorna undefined. Verifique a ortografia de cada chave no caminho. Use pontos para índices de matriz, como items.0.sku, não colchetes. Consulte Obter um valor em um caminho.

Itens ausentes no histórico history-issues

  • As funções e os itens inválidos não são mantidos. Somente objetos de dados e objetos de evento são mantidos. Consulte Após carregamentos de ACDL: um histórico.
  • Um ouvinte emitiu um erro. Quando um ouvinte emite um erro, o item que o acionou atualiza o estado calculado, mas não é adicionado ao histórico.
  • Uma chamada push() continha vários tipos de itens. Encaminhe cada item em uma chamada separada. Consulte Enviar um item por chamada.
  • O histórico foi limpo, por exemplo, pela ação Limpar histórico da camada de dados na extensão de marca.
recommendation-more-help
experience-platform-help-collection