Eventos de FIGI para GTM

Cada vez que alguien ve un asset, mira un video, toca un producto o escanea un QR, FIGI lo registra en su analítica y además lo empuja al dataLayer de la página. Con esos eventos armas activadores en tu Google Tag Manager (GTM) para mandar conversiones a GA4, Meta, TikTok o la herramienta que uses, sin tocar código.

Dónde se empujan los eventos

• En tu sitio: los assets de FIGI empujan los eventos al dataLayer de la página donde pegaste el código. Usan el GTM que tu sitio ya tiene.
• En la landing de tus QR y en el feed público: son páginas de FIGI. Cargan el contenedor de GTM que configures en FIGI; si no configuras uno, usan el GTM de FIGI.

Los nombres de los eventos de la v1 de FIGI se mantienen, con los mismos campos. Si tu GTM ya tenía activadores para eventos como figi_shop_click o figi_video_progress, siguen funcionando.

Configura tu empresa

1. Abre Integraciones

   En FIGI entra a Configuración → Integraciones. Lo ve un administrador de la empresa.

2. Elige qué se empuja

   • Empujar los eventos de FIGI al dataLayer: viene encendido. Si lo apagas, FIGI deja de escribir en el dataLayer, pero sigue midiendo todo en su analítica.
   • Nombre del dataLayer: déjalo en dataLayer salvo que tu sitio use otro nombre en su GTM.
   • Empujar también el formato de ecommerce de GA4: suma los eventos select_item, add_to_cart y purchase (más abajo).

3. Carga tu contenedor en las páginas públicas

   En Contenedor de GTM de tus páginas públicas escribe el ID de tu contenedor, con el formato GTM-XXXXXXX. Se carga en la landing de tus QR y en el feed público. Pulsa Guardar integraciones.

Los cambios se aplican al momento: no hace falta volver a publicar los assets.

Eventos

Los eventos marcados También en la v1 traen los campos que tenía la v1, además de los campos comunes. figi_qr_shell_view mantiene el formato exacto de la v1.

Campos comunes

Todos los eventos figi_ (salvo figi_qr_shell_view) traen estos campos. Si un campo no aplica, por ejemplo la tienda en un asset de tu sitio, llega vacío.

Arma un activador en GTM

Este ejemplo manda a GA4 cada clic en la Acción (CTA), con el SKU del producto.

1. Crea las variables

   En GTM entra a Variables → Nueva → Variable de capa de datos. Crea una por cada campo que quieras usar, por ejemplo figi_product_sku, figi_product_name y figi_video_title.

2. Crea el activador

   Entra a Activadores → Nuevo → Evento personalizado. En Nombre del evento escribe figi_product_click. Si quieres un solo activador para varios eventos, marca Usar coincidencia de expresiones regulares y escribe, por ejemplo, ^figi_(product_click|add_to_cart|purchase)$.

3. Crea la etiqueta

   Crea una etiqueta Google Analytics: evento de GA4, ponle un nombre de evento (por ejemplo figi_product_click) y suma como parámetros las variables del paso 1. Elige el activador del paso 2 y publica el contenedor.

4. Pruébalo

   Abre la Vista previa de GTM en tu sitio y toca un producto de un asset. En el panel de la vista previa aparece figi_product_click con sus campos.

Formato de ecommerce de GA4

Con Empujar también el formato de ecommerce de GA4 encendido, FIGI suma estos eventos con el objeto ecommerce que GA4 entiende sin configurar variables. Antes de cada uno empuja { ecommerce: null } para limpiar el anterior, como recomienda Google.

Cada producto de items trae item_id (el SKU o, si no tiene, el ID de FIGI), item_name, price, quantity, item_list_id e item_list_name. Por ejemplo:

{
  event: "add_to_cart",
  ecommerce: {
    currency: "CLP",
    value: 12990,
    items: [{ item_id: "SB-001", item_name: "Serum vitamina C", price: 12990, quantity: 1 }]
  }
}

Para medirlos, crea una etiqueta de GA4 con el nombre de evento {{Event}} y el activador Evento personalizado con la expresión ^(select_item|add_to_cart|purchase)$.

Sin GTM: el evento figi:event

Si tu sitio no usa GTM, escucha el evento figi:event de la página. Llega con cada evento figi_, aunque el dataLayer esté apagado:

window.addEventListener("figi:event", function (event) {
  var name = event.detail.name;
  var payload = event.detail.payload;
  console.log(name, payload.figi_video_id, payload.figi_product_sku);
});

Pon este código antes del script de FIGI para no perder los primeros eventos.

Compras sin código en la página de gracias

Si tu sitio no llama a figi.purchase, FIGI puede detectar la compra solo. En Configuración → Integraciones activa Detectar compras en la página de gracias:

• Páginas de gracias: una por línea. Basta con que la dirección contenga el texto. Vienen cargadas las de Shopify, WooCommerce, VTEX y Tiendanube (/thank_you, /order-received, /gracias…).
• Ventana de atribución: los productos que la persona tocó en los assets en esos minutos antes de la compra (30 por defecto).

La compra se registra en la moneda de tu empresa, por la suma de esos productos, y llega a GTM como figi_purchase. Si la página llama a figi.purchase, manda esa llamada y FIGI no detecta otra compra.

Cargar tus etiquetas desde FIGI

Si tu sitio no carga tu GTM, GA4, Meta Pixel, TikTok o LinkedIn por su cuenta, FIGI puede cargarlos en las páginas donde está el script de FIGI. Actívalo en Configuración → Integraciones → Cargar mis etiquetas desde FIGI y completa los ID. GA4 se carga solo si no usas GTM.

Si venías de la v1

• Los nombres y los campos de la v1 se mantienen. figi_journey_click ya no existe porque la v2 no tiene recorridos.
• Si en la v1 FIGI cargaba tus etiquetas o detectaba tus compras, la migración deja esas dos opciones activadas.
• Para registrar la compra con el número de pedido, usa figi.purchase como se explica en Instala los assets de FIGI en tu sitio.