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:

Valor insertado
Resultado en el estado calculado
Una clave que no existe en el estado calculado
Agrega la clave y su valor.
Un objeto, donde el estado calculado también contiene un objeto
Combina los dos objetos. Las claves que no inserte conservarán sus valores actuales. Esta regla se aplica en todos los niveles de anidación.
Una cadena, un número o un valor booleano
Reemplaza el valor actual.
Una matriz
Reemplaza el valor actual. Ver Matrices.
null o undefined
Elimina la clave. Ver Eliminar datos.

Por 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"]
NOTE
ACDL 2.x combina matrices por posición en lugar de reemplazarlas. En 2.x, insertar ["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:

Valor
Almacenado como
Objeto de Date
Un objeto vacío ({}). Almacene las fechas como cadenas, como new Date().toISOString(), o como números.
Función
Un objeto vacío ({}).
Map o Set
Un objeto vacío ({}).
Instancia de una clase
Objeto sin formato que contiene únicamente las propiedades enumerables propias de la instancia.
Objetos vacíos, matrices vacías, cadenas vacías, 0 y false
Se almacena tal cual.

Insertar 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.

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