Etiquetas de Google Floodlight

Este artículo está dirigido a desarrolladores que deseen mover etiquetas de Floodlight de un contenedor web de Tag Manager a un contenedor de servidor.

Tag Manager del servidor te permite mover tus etiquetas de venta y de contador de Google Floodlight de la página web al servidor. Mover estas etiquetas al servidor reducirá la cantidad de código que tienes para ejecutar en la página y ayudará a mejorar los tiempos de carga de la página.

Antes de comenzar

Antes de mover etiquetas a tu servidor, asegúrate de haber hecho lo siguiente:

Paso 1: Configura la etiqueta del vinculador de conversiones

Tu cuenta de Floodlight solo puede enviar datos de conversiones a Google Tag Manager cuando configuras una etiqueta del vinculador de conversiones.

Si ya tienes una etiqueta del Vinculador de conversiones configurada en tu contenedor de servidor, puedes omitir este paso.

Para configurar la etiqueta Vinculador de conversiones, sigue estos pasos:

  1. Desde el lugar de trabajo del contenedor de servidor, abre el menú Etiquetas en el lado izquierdo de la página.
  2. Haz clic en Nuevo para agregar una etiqueta nueva.
  3. Selecciona el tipo de etiqueta Vinculador de conversiones.
  4. Configura el activador que hará que se active la etiqueta del servidor del Vinculador de conversiones.
    En la mayoría de los casos, el activador Todas las páginas es la mejor opción.
  5. Asigna un nombre a la etiqueta y haz clic en Guardar (Save). Detalle de la etiqueta del vinculador de conversiones

Paso 2: Configura etiquetas de Floodlight

Google Tag Manager admite etiquetas de contador de Floodlight y etiquetas de ventas de Floodlight en el contenedor de servidor.

Contador de Floodlight

Para configurar una etiqueta de contador de Floodlight, sigue estos pasos:

  1. En el lugar de trabajo del contenedor de servidor, selecciona el menú Etiquetas en el lado izquierdo de la página.
  2. Haz clic en Nuevo para agregar una etiqueta nueva.

  3. Selecciona el tipo de etiqueta Floodlight Counter.

    Diálogo Elige un tipo de etiqueta con la etiqueta de contador de Floodlight destacada

  4. Si deseas recopilar los valores necesarios para configurar la etiqueta, abre otra ventana del navegador y accede a Campaign Manager 360. Haz clic en Anunciantes y, luego, en el nombre del anunciante. Ingresa estos valores en tu nueva etiqueta de contador de Floodlight de Tag Manager:

    • ID del anunciante: El ID del anunciante aparecerá en la página de detalles del anunciante, justo debajo de su nombre. Este valor también se encuentra como el valor de src= en un fragmento de etiqueta de Floodlight generado.
    • Group Tag String: En la tabla de Actividad, identifica la actividad con la que deseas trabajar y busca la cadena de la etiqueta del grupo que aparece en una columna a la derecha. Esto también se encuentra como el valor de type= en un fragmento generado de la etiqueta de Floodlight.
    • String de la etiqueta de actividad: En la tabla de Actividad, identifica la actividad con la que deseas trabajar y busca la cadena de la etiqueta de actividad que aparece en una columna de la derecha. Esto también se encuentra como el valor de cat= en un fragmento generado de la etiqueta de Floodlight.

  5. Configura el Método de registro deseado:

    • Estándar: Registra todas las conversiones.
    • Único: Cuenta la primera conversión de cada usuario único durante cada día de 24 horas, desde la medianoche hasta la medianoche, hora del este (EE.UU.).
    • Por sesión: Registra una conversión por usuario y por sesión. La duración de la sesión se establece mediante el sitio en el que se implementa la etiqueta de Floodlight.

  6. Abre la ventana Elige un activador.

  7. En el menú Configuración del activador, selecciona un activador. En la mayoría de los casos, Todas las páginas es la mejor opción.

    El diálogo Elegir activador en el que se destaca el activador Todas las páginas

  8. Ingresa un nombre para la etiqueta y haz clic en Guardar.

    Captura de pantalla en la que se muestra el campo Nombre de la etiqueta de contador de Floodlight que se cambió a Etiqueta de contador de Floodlight

Ventas de Floodlight

Para configurar una etiqueta de ventas de Floodlight, sigue estos pasos:

  1. En el lugar de trabajo del contenedor de servidor, selecciona el menú Etiquetas en el lado izquierdo de la página.
  2. Haz clic en Nuevo para agregar una etiqueta nueva.

  3. Selecciona el tipo de etiqueta Ventas de Floodlight. Nota: La etiqueta Ventas de Floodlight recopila de manera automática los siguientes valores del campo de comercio electrónico correspondiente:

    *   Order ID (Transaction ID)
*   Revenue (Value)

  4. Si deseas recopilar los valores necesarios para configurar la etiqueta, abre otra ventana del navegador y accede a Campaign Manager 360. Haz clic en Anunciantes y, luego, en el nombre del anunciante. Ingresa estos valores en tu nueva etiqueta de contador de Floodlight de Tag Manager:

    • ID del anunciante: El ID del anunciante aparecerá en la página de detalles del anunciante, justo debajo de su nombre. Este valor también se encuentra como el valor de src= en un fragmento de etiqueta de Floodlight generado.
    • Group Tag String: En la tabla de Actividad, identifica la actividad con la que deseas trabajar y busca la cadena de la etiqueta del grupo que aparece en una columna a la derecha. Esto también se encuentra como el valor de type= en un fragmento generado de la etiqueta de Floodlight.
    • String de la etiqueta de actividad: En la tabla de Actividad, identifica la actividad con la que deseas trabajar y busca la cadena de la etiqueta de actividad que aparece en una columna de la derecha. Esto también se encuentra como el valor de cat= en un fragmento generado de la etiqueta de Floodlight.

  5. Configura el Método de registro deseado:

    • Estándar: Registra todas las conversiones.
    • Único: Cuenta la primera conversión de cada usuario único durante cada día de 24 horas, desde la medianoche hasta la medianoche, hora del este (EE.UU.).
    • Por sesión: Registra una conversión por usuario y por sesión. La duración de la sesión se establece mediante el sitio en el que se implementa la etiqueta de Floodlight.

  6. Abre la ventana Elige un activador.

  7. En el menú Configuración del activador, selecciona un activador. En la mayoría de los casos, Todas las páginas es la mejor opción.

  8. Ingresa un nombre para la etiqueta y haz clic en Guardar.

Opcional: Configura las conversiones avanzadas

Si no usas conversiones avanzadas, ve a la sección Cómo validar la configuración.

Para configurar las conversiones avanzadas, sigue los pasos que se indican a continuación.

Configura una variable de datos proporcionados por el usuario

Existen 3 formas en las que puedes implementar las conversiones avanzadas en Tag Manager. Solo debes elegir una opción para recopilar los datos proporcionados por el usuario.

Recopilación automática Configuración manual Configuración del código
Método de recopilación Recopila automáticamente datos proporcionados por el usuario en función del código de tu sitio web.

Si necesitas controlar dónde recopilar las entradas, opta por una configuración manual o de código.		 Especifica determinadas propiedades de CSS o variables de JavaScript para recopilar datos proporcionados por el usuario.

Si necesitas controlar el formato de los datos y la codificación hash, habilita la configuración de código.		 Agrega a tu sitio web un fragmento de código que envíe datos del cliente con hash para la segmentación.
Este método es la mejor opción para maximizar la precisión de las conversiones avanzadas, ya que te permite enviar datos con formato coherente cada vez que se activa tu etiqueta de conversión.
Complejidad Simple Medio Compleja
Habilidades No se necesitan habilidades especiales HTML y CSS Desarrollo web

Recopilación automática

  1. En tu contenedor web, abre el menú Variables.
  2. Crea una nueva variable definida por el usuario del tipo Datos proporcionados por el usuario.
  3. Configura el Tipo como Recopilación automática.
  4. Asigna un nombre a la variable, por ejemplo, My user-defined data.
  5. Haz clic en Guardar.

Configuración manual

  1. En tu contenedor web, abre el menú Variables.
  2. Crea una nueva variable definida por el usuario del tipo Datos proporcionados por el usuario.
  3. Establece el Tipo en Configuración manual.

  4. Agrega una variable nueva o existente en el campo de datos relevantes del usuario que deseas proporcionar a través de las conversiones avanzadas.

  5. Para especificar un elemento DOM, crea una Nueva variable > Configuración de la variable > Elemento DOM.

  6. En Método de selección, puedes usar un selector CSS o un ID. Sugerencia: Si tus variables de CSS cambian con frecuencia, agrega un ID de HTML a tu sitio y utiliza la variable de ID.

  7. Ingresa el selector CSS o el nombre de ID. Puedes dejar en blanco el campo Nombre del atributo.

  8. Asigna un nombre a la variable del elemento DOM y guárdala. La pantalla regresará a la configuración de Datos proporcionados por el usuario.

  9. Asigna el nombre Datos proporcionados por el usuario (User-Provided Data), por ejemplo, My user-defined data.

  10. Haz clic en Guardar.

Configuración con código

Paso 1: Identifica y define tus variables de conversiones avanzadas

Puedes enviar datos sin codificación hash, a los que Google aplicará la codificación hash antes de que lleguen a los servidores, o datos que ya tengan codificación hash. Si decides enviar datos con codificación hash previamente, codifica los datos con SHA256 con codificación hexadecimal. En cualquier caso, proporciona al menos uno de los siguientes campos: email o phone_ number.
Para enviar datos sin hash a la capa de datos, haz lo siguiente:

  1. En tu sitio web, almacena los datos proporcionados por el usuario como pares clave-valor en una variable de JavaScript. Por ejemplo:

    var leadsUserData = {
  'email': 'name@example.com',
  'phone_number': '+11234567890',
  'address': {
    first_name: 'John',
    last_name: 'Doe',
    street: '123 Lemon',
    city: 'Some city',
    region: 'CA',
    country: 'US',
    postal_code: '12345',
  },
};

  2. Envía los datos del usuario junto con un evento mediante dataLayer.push(). Por ejemplo:

    <script>
  dataLayer.push({
    'event': 'formSubmitted',
    'leadsUserData': {
      'email': 'name@example.com',
      'phone_number': '+11234567890',
      'address': {
         first_name: 'John',
         last_name: 'Doe',
         street: '123 Lemon',
         city: 'Some city',
         region: 'CA',
         country: 'US',
        postal_code: '12345',
       },
     },
  });
<script>

La variable leadsUserData ahora está disponible en Google Tag Manager.

Para enviar datos con codificación hash previamente a la capa de datos, haz lo siguiente:

  1. En su sitio web, utilice la codificación hash en sus datos proporcionados por el usuario con codificación hexadecimal SHA256. La clave de los datos codificados debe comenzar con sha256_. Por ejemplo:

    {'sha256_email_address':await hashEmail(email.trim()),
}

  2. Envía los datos del usuario junto con un evento mediante dataLayer.push(). En el siguiente ejemplo, se muestra la implementación de una capa de datos en la que se supone que tú mismo escribiste una función de hash, que se ejecuta de forma asíncrona.

    <script>
  dataLayer.push({
    'event': 'formSubmitted',
    'leadsUserData': {
      'sha256_email_address': await hashEmail(email.trim()),
      'sha256_phone_number': await hashPhoneNumber(phoneNumber),
      'address': {
        sha265_first_name: await hashString(firstname),
        sha256_last_name: await hashString(lastname),
        sha256_street: await hashString(streetAddress),
        postal_code: '12345',
       },
     },
  });
<script>

La variable leadsUserData ahora está disponible en Google Tag Manager.

Paso 2: Crea la variable de datos proporcionados por el usuario

  1. En tu contenedor web, abre el menú Variables.
  2. Crea una nueva variable definida por el usuario del tipo Datos proporcionados por el usuario.
  3. Configura el Tipo como Código.
  4. En el campo de datos relevantes del usuario que deseas proporcionar, haz clic en el menú desplegable y selecciona Nueva variable.
  5. En Choose Variable Type, selecciona Data Layer Variable.
  6. En la Variable de capa de datos, haz referencia a tus datos de usuario almacenados. Por ejemplo, leadsUserData
  7. Asigna un nombre a la variable de capa de datos y guárdala. La pantalla regresará a la configuración de Datos proporcionados por el usuario.
  8. Asigna el nombre Datos proporcionados por el usuario (User-Provided Data), por ejemplo, My user-defined data.
  9. Haz clic en Guardar.

Asignar la variable a la etiqueta de Google

  1. En el contenedor web, abre el menú Etiquetas.
  2. Edita la etiqueta de Google que utilizas para enviar datos al servidor de etiquetado.
  3. En Parámetros de configuración, agrega un parámetro de configuración nuevo llamado user_data. Configura el Valor como la variable Datos proporcionados por el usuario, por ejemplo, {{My user-provided data}}.

  4. Guarda los cambios. La etiqueta debería verse de la siguiente manera:

    Captura de pantalla de la configuración final de la etiqueta de Google en la que se hace referencia a la variable de datos proporcionados por el usuario.

Configura la etiqueta de Floodlight del servidor

En el contenedor de servidor, habilita las conversiones avanzadas en la etiqueta de ventas o del contador de Floodlight.

  1. Marca la casilla de verificación Incluir datos proporcionados por el usuario.
    alt_text
  2. Presiona Guardar para guardar los cambios.

Opcional: Valor de ingresos

La etiqueta de ventas de Floodlight usa el parámetro value del evento como el importe predeterminado para calcular los ingresos. Si deseas especificar una base diferente para calcular el valor de los ingresos, debes configurar una variable a fin de extraer datos de tu base de datos y asignarlos a tu etiqueta de ventas de Floodlight.

Para crear una nueva variable, sigue estos pasos:

  1. En el contenedor de servidor, abre el menú Variables.
  2. Crea una nueva variable definida por el usuario para la entrada de datos. Por ejemplo, si deseas usar un valor de una base de datos de Firestore, crea una variable “Firestore Lookup&rcub;”.
  3. Especifica las fuentes de datos de la variable.
  4. Asigna un nombre a la variable, por ejemplo, "Búsqueda de ganancias" y guárdala.

Para utilizar la variable en la etiqueta de ventas de Floodlight, sigue estos pasos:

  1. En tu contenedor de servidor, abre el menú Etiquetas.
  2. Edita la etiqueta Floodlight Sales.

  3. En la sección Parámetros únicos, haz lo siguiente:

    • En Fuente de datos, selecciona Configuración personalizada.
    • En Ingresos, selecciona la variable que creaste antes.
    • En ID de pedido, ingresa un ID o usa una variable para propagar el ID de pedido de forma dinámica.

    Seguimiento de ventas de Floodlight con valor de ingresos

  4. Guarda la etiqueta.

Opcional: Parámetros personalizados

Puedes pasar campos personalizados de tu página web a Google Marketing Platform, como match_id.

Google Tag Manager

Si deseas configurar campos personalizados para Floodlight, antepone x-dc- al nombre de un parámetro:

  1. En el contenedor web, abre el menú Etiquetas.
  2. Edita una etiqueta del evento de GA4 o crea una nueva.

  3. En Parámetros de evento, agrega el nombre del parámetro. Para indicar que se dirige a Floodlight, antepone x-dc-. Por ejemplo, si normalmente envías match_id, cámbialo a x-dc-match_id.

    Configuración de los parámetros de dc- en la etiqueta web de GA4.

  4. Guarda la etiqueta.

gtag.js

Para configurar campos personalizados para Floodlight, antepone x-dc- al nombre del parámetro del evento:

  gtag('event', 'purchase', {
      'x-dc-match_id': [MATCH_ID],
      ...
  })

Paso 3: Valida tu configuración

Cuando comiences a enviar datos con el contenedor de servidor, puedes verificar si funciona correctamente mediante los siguientes pasos:

  1. Abre tu sitio web.
  2. En el contenedor de servidor de Google Tag Manager, selecciona Vista previa. Tag Assistant iniciará y cargará tu contenedor de servidor.
  3. En la pestaña Etiquetas, se muestran todas las etiquetas que se activaron. Asegúrate de verificar si se activó la etiqueta que configuraste.
  4. En la pestaña Consola, se muestran los errores que se produjeron durante la transmisión de datos al contenedor del servidor. Comprueba si hay errores y corrígelos.

Para obtener más ayuda con la depuración de contenedores de Tag Manager, consulta la ayuda de vista previa y depuración.

Próximos pasos

Una vez que la etiqueta de Floodlight funcione según lo previsto, puedes quitar las etiquetas de Floodlight equivalentes de un contenedor web para evitar la duplicación de datos.