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.versionA versão da ACDL, como
"3.0.1". Se for undefined, ACDL não foi carregado.adobeDataLayer.getState()adobeDataLayerO 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 definedO 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 exceededUm 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.jsou 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 definirwindow.adobeDataLayercomo 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 usarwindow.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 escopoallpadrã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
pathfiltra 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
onehandleraparecem emadobeDataLayer.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
eventestá ausente, vazio ou não é uma cadeia de caracteres é tratado como dados. Ele acionaadobeDataLayer:changeouvintes, 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
allpadrão, um novo ouvinte é executado para eventos correspondentes que já estão no histórico. Esse comportamento é esperado. Use o escopofuturese 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
eventoueventInfo. 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
nulle 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 retornaundefined. Verifique a ortografia de cada chave no caminho. Use pontos para índices de matriz, comoitems.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