Extensión de capa de datos Google

La extensión de capa de datos de Google le permite utilizar una capa de datos de Google en la implementación de etiquetas. La extensión se puede utilizar de forma independiente o simultánea con las soluciones de Google y con el código abierto de Google Biblioteca auxiliar de capa de datos.

La biblioteca de ayuda proporciona una funcionalidad impulsada por eventos similar a la capa de datos del cliente de Adobe (ACDL). Los elementos de datos, las reglas y las acciones de la extensión de capa de datos de Google proporcionan una funcionalidad similar a las del Extensión ACDL.

Instalación

Para instalar la extensión, vaya al catálogo de extensiones en la IU de recopilación de datos y seleccione Capa de datos de Google.

Una vez instalada, la extensión crea o accede a una capa de datos en cada carga de la biblioteca de etiquetas de Adobe Experience Platform.

Vista de extensión

La configuración de la extensión se puede utilizar para definir el nombre de la capa de datos que consume la extensión. Si no hay ninguna capa de datos con el nombre configurado cuando se carga Adobe Experience Platform Tags, la extensión crea una.

El nombre predeterminado de la capa de datos es Google dataLayer.

Eventos

La extensión le ofrece la posibilidad de escuchar cambios en la capa de datos.

Tipos de eventos de Google

Google admite dos formas de insertar eventos: Google Tag Manager, con el push() método, y Google Analytics 4, usando el gtag() método.

Las versiones de la extensión de capa de datos de Google anteriores a 1.2.1 solo admitían eventos creados por push(), como se muestra en los ejemplos de código de esta página.

Las versiones 1.2.1 y superiores admiten eventos creados con gtag(). Esto es opcional y se puede habilitar en el cuadro de diálogo Configuración de la extensión.

Para obtener más información acerca de push() y gtag() eventos, consulte la Documentación de Google. También se proporciona información en los cuadros de diálogo de configuración y reglas de la extensión.

Escuchar todas las inserciones en la capa de datos

Si selecciona esta opción, el oyente de eventos escucha cualquier cambio realizado en la capa de datos.

Escuchar eventos push excluyendo eventos

Si selecciona esta opción, el oyente de eventos escucha cualquier inserción de datos en la capa de datos, excluyendo los eventos.

El oyente rastrearía los siguientes eventos push de ejemplo:

dataLayer.push({"data":"something"})

El oyente no rastrearía los siguientes eventos push de ejemplo:

dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})

Escuchar todos los eventos

Si selecciona esta opción, el oyente de eventos escucha cualquier evento insertado en la capa de datos.

El oyente rastrearía los siguientes eventos push de ejemplo:

dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})

El siguiente ejemplo de evento push no sería rastreado por el oyente:

dataLayer.push({"data":"something"})

Escuchar un evento específico

En el caso de que especifique un evento, el oyente de eventos rastrea cualquier evento que coincida con una cadena específica.

Por ejemplo, si se establece myEvent al usar esta configuración, el oyente solo rastreará el siguiente evento push:

dataLayer.push({"event":"myEvent"})

Se puede utilizar una regex (ECMAScript / JavaScript) para hacer coincidir nombres de eventos.

Por ejemplo, si se configura 'myEvent\d' se realizará el seguimiento myEvent con un dígito (\d):

dataLayer.push({"event":"myEvent1"})
dataLayer.push({"event":"myEvent2"})

Acciones

Insertar en la capa de datos push-to-data-layer

La extensión le proporciona dos acciones para insertar el JSON en la capa de datos; un campo de texto libre para crear manualmente el JSON que se va a insertar y, a partir de la versión 1.2.0, un cuadro de diálogo de varios campos con valor clave.

Texto libre JSON

La acción de texto libre permite utilizar elementos de datos directamente en el JSON. En el editor JSON, se debe hacer referencia a los elementos de datos mediante notación de porcentaje. Por ejemplo, %dataElementName%.

{
  "page": {
    "url": "%url%",
    "previous_url": "%previous_url%",
    "concatenated_values": "static string %dataElement%"
  }
}

Multicampo clave-valor

El nuevo cuadro de diálogo multicampo clave-valor es una interfaz más fácil de usar que permite configurar una notificación push sin escribir manualmente JSON.

Restablecimiento del estado calculado de Google DL

La extensión le proporciona una acción para restablecer la capa de datos. Si se utiliza en una regla que procesa un cambio de capa de datos de Google, la capa de datos se restablece al estado calculado de la capa de datos en el momento en que se activó la regla. Si la acción se utiliza en una regla que no procesa un cambio en la capa de datos de Google, la acción vacía la capa de datos.

Elementos de datos

El elemento de datos proporcionado se puede utilizar durante la ejecución de una regla activada por un cambio de capa de datos de Google (evento push) o en una regla no relacionada como Library Loaded. En el primer caso, el elemento de datos devuelve un valor tomado del estado calculado en el momento del cambio de la capa de datos. En este último caso, se utiliza el estado calculado en el momento de la ejecución de la regla.

Un conmutador le permite seleccionar si el elemento de datos debe devolver valores de todo el estado calculado o solo de la información de evento (si se utiliza en una regla activada por un cambio de capa de datos).

Por lo tanto, el elemento de datos puede devolver:

Información adicional

Los cuadros de diálogo de elementos de datos y eventos de la extensión contienen información de uso detallada y ejemplos.

Encontrará información general adicional en la LÉAME del proyecto