Extensión de la capa de datos de Google (Beta)

IMPORTANTE

Esta extensión está actualmente en fase beta y no se ha probado completamente en fase de producción.

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 de ayuda de capa de datos.

La biblioteca Helper proporciona una funcionalidad similar impulsada por eventos al Adobe Client Data Dayer (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 la de la Extensión ACDL.

Vencimiento

La versión 1.0.x de la extensión es una versión beta. Esta extensión no se ha probado completamente en producción.

Instalación

Para instalar la extensión, vaya al catálogo de extensiones en la interfaz de usuario del Experience Platform o en la de la 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 cada vez que la biblioteca de etiquetas se carga en el sitio web.

Vista de extensión

Al configurar la extensión (durante la instalación de la extensión o seleccionando Configurar en el catálogo de extensiones) debe 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 la biblioteca, la extensión crea una en su lugar.

NOTA

No importa si Google o el código de Adobe se cargan primero y crean la capa de datos. Ambos sistemas crearán la capa de datos si no está presente o utilizarán la capa de datos existente.

De forma predeterminada, la capa de datos utiliza el nombre predeterminado de Google dataLayer.

Eventos

La extensión permite detectar cambios (eventos) dentro de la capa de datos. Un evento puede ser cualquiera de los siguientes:

  • Eventos de etiqueta (como la biblioteca que se está cargando)
  • Eventos de JavaScript
  • Datos insertados en la capa de datos con la variable event palabra clave.

Es importante comprender el uso de la variable event keyword cuando los datos se insertan en una capa de datos de Google, de forma similar a la capa de datos del cliente de Adobe. La variable event cambia el comportamiento de la capa de datos de Google y, por lo tanto, el comportamiento de la extensión se actualiza en consecuencia.

Las secciones siguientes describen los diferentes tipos de eventos que la extensión puede detectar.

Escuche todos los empujones a la capa de datos

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

Escuchar pulsaciones excluyendo eventos

Si selecciona esta opción, la extensión de escucha si hay algo que se inserte en la capa de datos, excluyendo eventos.

El oyente seguiría el siguiente ejemplo de evento push:

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, la extensión de 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

Si desea escuchar un evento específico, seleccione esta opción para que el detector de eventos rastree los eventos que coincidan 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"})

También puede usar una cadena regex para hacer coincidir los nombres de evento. Por ejemplo, configurar myEvent\d rastrearía eventos que comienzan con myEvent seguido de un dígito:

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

Acciones

Las secciones siguientes describen las diferentes acciones que puede realizar la extensión cuando se incluyen en una regla.

Insertar en la capa de datos

Esta acción lleva el contenido JSON a la propia capa de datos, lo que permite utilizar elementos de datos directamente en las cargas JSON. Dentro del editor JSON proporcionado, puede hacer referencia a elementos de datos mediante notación de porcentaje (por ejemplo, %dataElementName%).

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

Restablecimiento de Google DL a estado calculado

NOTA

Esta acción está disponible a partir de la versión 1.0.5.

Esta acción restablece la capa de datos. Si se utiliza en una regla que procesa un cambio en la 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

La extensión proporciona un elemento de datos único que accede a la capa de datos mediante una clave (por ejemplo, page.url en el fragmento anterior).

El elemento de datos puede proporcionar cualquiera de las siguientes opciones:

  • Un valor específico de la capa de datos (por ejemplo, page.url)
  • Toda la matriz de capas de datos (campo de clave vacía)
  • Valores de un evento de capa de datos mediante el uso de la clave (si la variable event palabra clave se ha utilizado)
  • El objeto de evento completo (campo de clave vacío)

La extensión siempre da prioridad a la información del evento. Si una capa de datos event se está procesando, los valores siempre se leen desde ese evento. Si una event no está presente, los valores se leen desde la capa de datos directa en su lugar.

Información adicional

Encontrará información adicional en la README DEL PROYECTO y en los cuadros de diálogo de evento y elemento de datos de la extensión.

En esta página