Etiquetas de Google Floodlight

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

La versión del servidor de Tag Manager te permite mover las etiquetas de ventas y contador de Google Floodlight de la página web al servidor. Si mueves estas etiquetas al servidor, se reducirá la cantidad de código que debes ejecutar en la página y se mejorarán los tiempos de carga de la página.

Antes de comenzar

Antes de poder mover etiquetas a tu servidor, asegúrate de tener 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 configures 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 del Vinculador de conversiones, sigue estos pasos:

  1. En el lugar de trabajo del contenedor de servidor, abre el menú Etiquetas en el lado izquierdo de la página.
  2. Haz clic en Nueva 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. Detalles de la etiqueta del Vinculador de conversiones

Paso 2: Configura las etiquetas de Floodlight

Google Tag Manager admite las etiquetas de venta de Floodlight y Floodlight Counter en el contenedor del servidor.

Floodlight Counter

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 Nueva 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. Para recopilar los valores necesarios para la configuración de 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.
    • Cadena de la etiqueta del grupo: En la tabla 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. También se encuentra como el valor de type= en un fragmento de etiqueta de Floodlight generado.
    • Cadena de la etiqueta de actividad: En la tabla Actividad, identifica la actividad con la que deseas trabajar y busca la cadena de la etiqueta de actividad en una columna a la derecha. También se encuentra como el valor de cat= en un fragmento de etiqueta de Floodlight generado.

  5. Establece el método de recuento deseado:

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

  6. Abre la ventana Elegir 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.

    Diálogo Choose trigger con el activador Todas las páginas destacado

  8. Ingresa un nombre de etiqueta y haz clic en Guardar.

    Captura de pantalla en la que se muestra el campo de nombre de la etiqueta de contador de Floodlight cambiado a etiqueta de contador de Floodlight

Floodlight Sales

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 Nueva para agregar una etiqueta nueva.

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

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

  4. Para recopilar los valores necesarios para la configuración de 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 la 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.
    • Cadena de la etiqueta del grupo: En la tabla 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. También se encuentra como el valor de type= en un fragmento de etiqueta de Floodlight generado.
    • Cadena de la etiqueta de actividad: En la tabla Actividad, identifica la actividad con la que deseas trabajar y busca la cadena de la etiqueta de actividad en una columna a la derecha. También se encuentra como el valor de cat= en un fragmento de etiqueta de Floodlight generado.

  5. Establece el método de recuento deseado:

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

  6. Abre la ventana Elegir 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 de etiqueta y haz clic en Guardar.

Opcional: Configura las conversiones avanzadas

Si no usas las conversiones avanzadas, avanza al paso Valida tu 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 de código
Método de recopilación Recopila automáticamente los 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 con código.		 Especifica determinadas propiedades de CSS o variables de JavaScript para recopilar datos proporcionados por el usuario.

Si necesitas controlar el formato de datos y la codificación hash, opta por la configuración con código.		 Agrega a tu sitio web un fragmento de código que envíe datos del cliente con codificación hash para establecer coincidencias.
Este método es la mejor opción para maximizar la precisión de las conversiones avanzadas, ya que te permite enviar datos con un formato coherente cada vez que se activa tu etiqueta de conversión.
Complejidad Sencillo Media Complejo
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. Establece Tipo en 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. En el campo relevante de datos del usuario que deseas proporcionar a través de las conversiones avanzadas, agrega una variable nueva o existente.

  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. Nota: 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 un nombre a la variable Datos proporcionados por el usuario, 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 (en ese caso, Google les aplicará dicha codificación antes de que lleguen a los servidores) o datos con codificación hash previa. Si decides enviar datos con codificación hash, codifique los datos con el formato SHA256 hexadecimal. En cualquier caso, proporciona al menos uno de los siguientes campos: email o phone_ number.
Para enviar datos sin codificación 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 codificados con 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 para 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 una implementación de la capa de datos que supone que tú mismo escribiste una función hash, que se ejecuta de manera 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 relevante de datos del usuario que deseas proporcionar, haz clic en el menú desplegable y selecciona Nueva variable.
  5. En Elegir un tipo de variable, selecciona Variable de capa de datos.
  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 un nombre a la variable Datos proporcionados por el usuario, por ejemplo, My user-defined data.
  9. Haz clic en Guardar.

Asigna la variable a la etiqueta de Google

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

  4. Guarde sus cambios. Tu etiqueta debería verse de la siguiente manera:

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

Configura la etiqueta de Floodlight del servidor

En tu contenedor de servidor, habilita las conversiones avanzadas configurando la etiqueta de ventas de Floodlight o Floodlight Counter.

alt_text

Los datos proporcionados por el usuario te permiten mejorar la precisión de tus mediciones con datos de origen proporcionados por el usuario y cifrados con codificación hash provenientes de tu sitio web. Para implementar esto, primero debes aceptar las condiciones y las políticas relacionadas con los datos proporcionados por el usuario en tu cuenta de Search Ads 360.

Si deseas incluir datos proporcionados por el usuario para las conversiones avanzadas de sitios web, la información de identificación personal (PII) se debe enviar desde el sitio web (contenedor del cliente), que, a su vez, se envía desde el contenedor del servidor. Si no quieres que la PII se envíe con una etiqueta específica, usa "Transformaciones" para ocultar la PII de las etiquetas seleccionadas.

Opcional: Valor de los ingresos

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

Para crear una variable nueva, 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 quieres usar un valor de una base de datos de Firestore, crea una variable de &lcub;&lcub;búsqueda de Firestore&rcub;&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 usar la variable en la etiqueta de ventas de Floodlight, sigue estos pasos:

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

  3. En la sección Parámetros únicos, sigue estos pasos:

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

    Seguimiento de ventas de Floodlight con el valor de los 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

Para configurar campos personalizados para Floodlight, agrega x-dc- al comienzo de un nombre de parámetro:

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

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

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

  4. Guarda la etiqueta.

gtag.js

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

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

Paso 3: Valida tu configuración

Una vez que comiences a enviar datos con el contenedor de servidor, puedes seguir estos pasos para verificar si funciona correctamente:

  1. Abre tu sitio web.
  2. En el contenedor de servidor de Google Tag Manager, selecciona Vista previa. Se iniciará Tag Assistant y se cargará el contenedor del 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 Console, se muestran los errores que se produjeron durante la transmisión de datos al contenedor del servidor. Verifica si hay errores y corrígelos.

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

Próximos pasos

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