Dados e estado calculado

A ACDL (Adobe Client Data Layer) mescla todos os objetos de dados que você envia por push em um único objeto chamado estado computado. Qualquer script pode ler o estado calculado a qualquer momento com getState(). Você pode enviar todos os seus dados de uma só vez ou em vários pequenos envios de scripts diferentes. O estado calculado é o mesmo de qualquer maneira.

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({ page: { title: "Getting started" } });
window.adobeDataLayer.push({ component: { "hero-1": { title: "Learn more", link: "learn-more.html" } } });
window.adobeDataLayer.push({ page: { language: "en" } });

Após esses envios por push, adobeDataLayer.getState() retorna o seguinte objeto:

{
  "page": {
    "title": "Getting started",
    "language": "en"
  },
  "component": {
    "hero-1": {
      "title": "Learn more",
      "link": "learn-more.html"
    }
  }
}

Os objetos de evento também podem transportar dados. A ACDL mescla todas as chaves em um objeto de evento, exceto event e eventInfo, que nunca são armazenadas no estado computado. Consulte Eventos.

Regras de mesclagem merge-rules

Quando você envia dados, o ACDL compara cada chave no objeto enviado com o estado calculado:

Valor enviado
Resultado no estado calculado
Uma chave que não existe no estado calculado
Adiciona a chave e seu valor.
Um objeto, em que o estado calculado também mantém um objeto
Mescla os dois objetos. As chaves que você não pressionar manterão seus valores atuais. Essa regra se aplica a todos os níveis de aninhamento.
Uma string, número ou booleano
Substitui o valor atual.
Uma matriz
Substitui o valor atual. Consulte Matrizes.
null ou undefined
Exclui a chave. Consulte Excluir dados.

Por exemplo, o segundo push abaixo altera apenas page.title. A chave page.language mantém seu valor:

adobeDataLayer.push({ page: { title: "Home", language: "en" } });
adobeDataLayer.push({ page: { title: "Products" } });
adobeDataLayer.getState("page");
// { title: "Products", language: "en" }

Excluir dados delete

Para excluir uma chave, envie null ou undefined por push como seu valor:

adobeDataLayer.push({ page: { title: "Products", language: "en" }, user: { id: "123" } });
adobeDataLayer.push({ page: { language: null }, user: null });
adobeDataLayer.getState();
// { page: { title: "Products" } }

A exclusão da última chave dentro de um objeto deixa um objeto vazio. Para excluir o objeto também, envie null por push para o próprio objeto.

adobeDataLayer.push({ page: { title: null } });
adobeDataLayer.getState();
// { page: {} }

Os ouvintes que usam a opção path são chamados quando você exclui a chave nesse caminho ou em qualquer objeto que a contenha.

Matrizes arrays

Uma matriz é armazenada como um valor único. Quando você envia um array para uma chave que já contém um array, o ACDL substitui todo o array. Para adicionar um item, insira a matriz completa com o novo item:

adobeDataLayer.push({ cart: { skus: ["a-100", "b-200"] } });
adobeDataLayer.push({ cart: { skus: ["a-100", "b-200", "c-300"] } });
adobeDataLayer.getState("cart.skus");
// ["a-100", "b-200", "c-300"]

O ACDL remove null e undefined entradas das matrizes que você envia por push:

adobeDataLayer.push({ cart: { skus: ["a-100", null, "c-300"] } });
adobeDataLayer.getState("cart.skus");
// ["a-100", "c-300"]
NOTE
O ACDL 2.x combina arrays por posição em vez de substituí-los. Na 2.x, ["c"] por ["a", "b"] resultará em ["c", "b"]. Para obter o mesmo resultado em ambas as versões, sempre envie o array completo.

Alterar o tipo de um valor change-type

Você pode substituir um objeto por uma string, um número, um booleano ou uma matriz. No entanto, na ACDL 3.x, o envio de um objeto para uma chave que atualmente contém uma string, um número, um booleano ou uma matriz não substitui o valor. Se o valor atual for 0, false, ou uma cadeia de caracteres vazia, a chave será excluída.

Para alterar um valor para um objeto, exclua a chave primeiro e, em seguida, empurre o objeto:

adobeDataLayer.push({ product: "a-100" });
adobeDataLayer.push({ product: null });
adobeDataLayer.push({ product: { sku: "a-100", price: 25 } });
adobeDataLayer.getState("product");
// { sku: "a-100", price: 25 }

Para evitar essa situação, mantenha o tipo de cada chave consistente no design da camada de dados.

Tipos de valor value-types

Use valores compatíveis com JSON na camada de dados: cadeias de caracteres, números, booleanos, null, objetos simples e matrizes. O ACDL converte outros tipos de objetos à medida que eles são mesclados:

Valor
Armazenado como
Objeto de Date
Um objeto vazio ({}). Armazenar datas como sequências de caracteres, como new Date().toISOString(), ou como números.
Função
Um objeto vazio ({}).
Map ou Set
Um objeto vazio ({}).
Uma ocorrência de uma classe
Um objeto simples que contém somente as propriedades enumeráveis da própria instância.
Objetos vazios, matrizes vazias, cadeias vazias, 0 e false
Armazenado como está.

Enviar somente objetos simples. A ACDL rejeita outros valores, como sequências, números e arrays, quando você os envia diretamente. Consulte push().

Cópias, não referências copies

O estado calculado é independente dos objetos que você envia. Alterar um objeto após enviá-lo não altera o estado calculado:

const page = { title: "Home" };
adobeDataLayer.push({ page: page });
page.title = "Changed";
adobeDataLayer.getState("page.title");
// "Home"

Da mesma forma, getState() retorna uma cópia. A alteração do objeto retornado não altera a camada de dados. Para alterar o estado calculado, sempre empurre a alteração.

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