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:
null ou undefinedPor 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"]
["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:
Date{}). Armazenar datas como sequências de caracteres, como new Date().toISOString(), ou como números.{}).Map ou Set{}).0 e falseEnviar 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.