Etiquetas de Google Floodlight

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

Tag Manager del servidor te permite trasladar tus etiquetas de ventas y de contador de Google Floodlight de la página web al servidor. Si trasladas 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 trasladar etiquetas a tu servidor, asegúrate de tener lo siguiente:

Paso 1: Configura la etiqueta de vinculación de conversiones

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

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

Para configurar la etiqueta del vinculador de conversiones , haz lo siguiente:

  1. En el lugar de trabajo del contenedor del 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 vinculador de conversiones del servidor.
    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 de vinculación de conversiones

Paso 2: Configura las etiquetas de Floodlight

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

Floodlight Counter

Para configurar una etiqueta de contador de Floodlight , haz lo siguiente:

  1. En el lugar de trabajo del contenedor del 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 Elegir 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 de anunciante: El ID de anunciante aparecerá en la página de detalles del anunciante , justo debajo de su nombre. Este valor también se muestra como el valor de src= en un fragmento generado de la etiqueta de Floodlight.
    • Cadena de la etiqueta de grupo: En la tabla Actividad, identifica la actividad con la que deseas trabajar y busca la cadena de la etiqueta de grupo que aparece en una columna a la derecha. Este valor también se muestra como el valor de type= en un fragmento de la 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 que aparece en una columna a la derecha. Este valor también se muestra como el valor de cat= en un fragmento de la etiqueta de Floodlight generado.

  5. Establece el método de conteo deseado:

    • Estándar: Registra todas las conversiones.
    • Única: Registra la primera conversión de cada usuario único en el transcurso de las 24 horas del día, de medianoche a medianoche, hora del este (EE.UU.).
    • Por sesión: Registra 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 de selección de activador 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 la etiqueta de contador de Floodlight

Floodlight Sales

Para configurar una etiqueta de ventas de Floodlight , haz lo siguiente:

  1. En el lugar de trabajo del contenedor del 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 Sales. 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 tu nueva etiqueta de contador de Floodlight de Tag Manager:

    • ID de anunciante: El ID de anunciante aparecerá en la página de detalles del anunciante , justo debajo de su nombre. Este valor también se muestra como el valor de src= en un fragmento generado de la etiqueta de Floodlight.
    • Cadena de la etiqueta de grupo: En la tabla Actividad, identifica la actividad con la que deseas trabajar y busca la cadena de la etiqueta de grupo que aparece en una columna a la derecha. Este valor también se muestra como el valor de type= en un fragmento de la 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 que aparece en una columna a la derecha. Este valor también se muestra como el valor de cat= en un fragmento de la etiqueta de Floodlight generado.

  5. Establece el método de conteo deseado:

    • Estándar: Registra todas las conversiones.
    • Única: Registra la primera conversión de cada usuario único en el transcurso de las 24 horas del día, de medianoche a medianoche, hora del este (EE.UU.).
    • Por sesión: Registra 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 con datos del carrito

Puedes configurar tu etiqueta de ventas de Floodlight para enviar conversiones con datos del carrito. Las conversiones con datos del carrito proporcionan detalles específicos de los eventos de conversión a nivel de SKU. Si envías el ID, la etiqueta del feed, el idioma del feed y los datos de productos de Merchant Center, puedes identificar qué artículos se venden bien y cuáles podrían necesitar más asistencia.

Paso 1 de 2: Envía parámetros de datos del carrito a la capa de datos

  1. Crea un array en JSON de ecommerce.purchase.products. Por ejemplo:

        'ecommerce':{
    'purchase':{
        'products': [{
            'id': 'String',
            'price': 'Floating point',
            'quantity': Integer,
            'country': 'String', // Optional
            'accountId': 'String' // Optional
        },
        {
            … // Each SKU (product) in the transaction
            // is in its own array item.
        }]
    }
    }'

  2. Usa el dataLayer.push método para que los datos estén disponibles en la capa de datos de Google Tag Manager.

Paso 2 de 2: Configura la etiqueta de ventas de Floodlight

Datos de eventos

  1. En tu contenedor del servidor, abre la etiqueta de ventas de Floodlight.
  2. En "Informes de productos", selecciona la casilla de verificación Proporcionar datos de ventas a nivel del producto.
  3. Selecciona Datos de eventos en el menú desplegable "Fuente de datos". Google Tag Manager usará automáticamente los datos enviados a la capa de datos en el array ecommerce.purchase.products.
  4. Haz clic en Guardar.

Configuración personalizada

  1. En tu contenedor del servidor, abre la etiqueta de ventas de Floodlight.
  2. En "Informes de productos", selecciona la casilla de verificación Proporcionar datos de ventas a nivel del producto.
  3. Selecciona Configuración personalizada en el menú desplegable "Fuente de datos".
  4. Selecciona una variable dinámica o ingresa un valor de forma manual en los siguientes campos:
    • Datos de productos: La cadena con formato que contiene los datos de productos.
    • ID de Merchant Center: Es el ID de Google Merchant Center del comercio.
    • Etiqueta del feed: Es una etiqueta que identifica el feed específico que se usa en Google Merchant Center.
    • Idioma del feed: Es el idioma del feed, representado con el código ISO 639-1 de 2 letras.
  5. Haz clic en Guardar.

Opcional: Configura las conversiones avanzadas

Si no usas las conversiones avanzadas, ve a 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 con 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 necesita controlar el formato de datos y la codificación hash, habilite 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 su 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 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. En Tipo , establece 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. En Tipo , establece 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 haz clic en Guardar. La pantalla regresará a la configuración de Datos proporcionados por el usuario.

  9. Asigna un nombre a la variable de 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, que Google codificará con hash antes de que lleguen a los servidores, o datos con codificación hash previa. Si decides enviar datos con codificación hash, codifícalos 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 capas de datos que supone que usted mismo escribió 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. En Tipo , establece Código.
  4. En el campo pertinente de datos del usuario que desees 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 haz clic en Guardar. La pantalla regresará a la configuración de Datos proporcionados por el usuario.
  8. Asigna un nombre a la variable de 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 Parámetros de configuración, agrega un nuevo parámetro de configuración llamado user_data. Establece el Valor en la variable de datos proporcionados por el usuario, por ejemplo, {{My user-provided data}}.

  4. Guarda tus 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 la etiqueta de contador de Floodlight.

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, se debe enviar información de identificación personal (PII) desde el sitio web (contenedor del cliente), que, a su vez, se envía desde el contenedor del servidor. Si no deseas que una etiqueta específica envíe la PII, usa "Transformaciones" para redactar 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 asignarla a tu etiqueta de ventas de Floodlight.

Para crear una variable nueva, haz lo siguiente:

  1. En tu contenedor del 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 &lcub;&lcub;Firestore Lookup&rcub;&rcub;.
  3. Especifica las fuentes de datos de la variable.
  4. Asigna un nombre a la variable, por ejemplo, "Profit lookup", y haz clic en Guardar.

Para usar la variable en la etiqueta de ventas de Floodlight, haz lo siguiente:

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

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

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

    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

Para configurar campos personalizados para Floodlight, antepón x-dc- a un nombre de parámetro:

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

  3. En Parámetros del evento, agrega el nombre del parámetro. Para indicar que va a Floodlight, antepón x-dc-. Por ejemplo, si normalmente enviarí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, antepón x-dc- al nombre del parámetro de 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 del servidor, puedes verificar si funciona correctamente siguiendo estos pasos:

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

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.