Datos y estado calculado
La capa de datos del cliente de Adobe (ACDL) combina todos los objetos de datos que inserta en un único objeto denominado estado calculado. Cualquier script puede leer el estado calculado en cualquier momento con getState(). Puede insertar todos los datos a la vez o en muchas inserciones pequeñas desde diferentes scripts. El estado calculado es el mismo en cualquier caso.
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" } });
Después de estos cambios, adobeDataLayer.getState() devuelve el siguiente objeto:
{
"page": {
"title": "Getting started",
"language": "en"
},
"component": {
"hero-1": {
"title": "Learn more",
"link": "learn-more.html"
}
}
}
Los objetos de evento también pueden transportar datos. ACDL combina todas las claves de un objeto de evento excepto event y eventInfo, que nunca se almacenan en el estado calculado. Ver Eventos.
Combinar reglas merge-rules
Al insertar datos, ACDL compara cada clave del objeto insertado con el estado calculado:
null o undefinedPor ejemplo, la segunda inserción a continuación solo cambia page.title. La clave page.language mantiene su valor:
adobeDataLayer.push({ page: { title: "Home", language: "en" } });
adobeDataLayer.push({ page: { title: "Products" } });
adobeDataLayer.getState("page");
// { title: "Products", language: "en" }
Eliminación de datos delete
Para eliminar una clave, inserte null o undefined como su valor:
adobeDataLayer.push({ page: { title: "Products", language: "en" }, user: { id: "123" } });
adobeDataLayer.push({ page: { language: null }, user: null });
adobeDataLayer.getState();
// { page: { title: "Products" } }
Al eliminar la última clave dentro de un objeto, se deja un objeto vacío. Para eliminar también el objeto, inserte null en el propio objeto.
adobeDataLayer.push({ page: { title: null } });
adobeDataLayer.getState();
// { page: {} }
Las escuchas que utilizan la opción path reciben una llamada cuando se elimina la clave de esa ruta de acceso o cualquier objeto que la contenga.
Matrices arrays
Una matriz se almacena como un valor único. Cuando se inserta una matriz en una clave que ya contiene una matriz, ACDL reemplaza toda la matriz. Para agregar un elemento, inserte la matriz completa con el nuevo elemento:
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"]
ACDL elimina null y undefined entradas de las matrices insertadas:
adobeDataLayer.push({ cart: { skus: ["a-100", null, "c-300"] } });
adobeDataLayer.getState("cart.skus");
// ["a-100", "c-300"]
["c"] sobre ["a", "b"] resulta en ["c", "b"]. Para obtener el mismo resultado en ambas versiones, inserte siempre la matriz completa.Cambiar el tipo de un valor change-type
Puede reemplazar un objeto por una cadena, un número, un booleano o una matriz. Sin embargo, en ACDL 3.x, insertar un objeto en una clave que actualmente contiene una cadena, un número, un booleano o una matriz no reemplaza el valor. Si el valor actual es 0, false o una cadena vacía, la clave se elimina en su lugar.
Para convertir un valor en un objeto, elimine primero la clave y, a continuación, inserte el 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 esta situación, mantenga la coherencia del tipo de cada clave en el diseño de la capa de datos.
Tipos de valor value-types
Use valores compatibles con JSON en la capa de datos: cadenas, números, valores booleanos, null, objetos simples y matrices. ACDL convierte otros tipos de objetos a medida que los combina:
Date{}). Almacene las fechas como cadenas, como new Date().toISOString(), o como números.{}).Map o Set{}).0 y falseInsertar solo objetos sin formato. ACDL rechaza otros valores, como cadenas, números y matrices, cuando se insertan directamente. Ver push().
Copias, no referencias copies
El estado calculado es independiente de los objetos que inserta. Cambiar un objeto después de insertarlo no cambia el estado calculado:
const page = { title: "Home" };
adobeDataLayer.push({ page: page });
page.title = "Changed";
adobeDataLayer.getState("page.title");
// "Home"
Del mismo modo, getState() devuelve una copia. Cambiar el objeto devuelto no cambia la capa de datos. Para cambiar el estado calculado, inserte siempre el cambio.