Instala FIGI en un sitio HTML
Instalación en cualquier sitio propio: dónde va el script, cómo mostrar uno o varios assets, sitios de una sola página y verificación.
Guía pública: puedes compartirla con tu equipo técnico.
Esta guía sirve para cualquier sitio en el que puedas editar el HTML: un sitio propio, un generador estático o un framework.
Antes de empezar
- Copia el código del asset desde FIGI (Activación digital → Despliegue). Tiene un
divy unscript, como se explica en Instala los assets de FIGI en tu sitio. - Pídele a un administrador de FIGI que agregue tu dominio en Sitios autorizados, por ejemplo
https://www.tu-sitio.com.
1. Pega el script una vez por página
Pégalo justo antes de </body> en la plantilla general del sitio:
<script src="https://figi.video/embed/v1/figi.js" data-figi-key="TU-CLAVE" async></script>Usa la línea exacta que copiaste de FIGI. El atributo async evita que el script frene la carga de tu página.
2. Pon el div donde quieres el asset
<div data-figi-feed="ID-DE-TU-SLIDER"></div>Para mostrar varios assets en la misma página, repite el div con el ID de cada uno y deja un solo script:
<div data-figi-feed="ID-DEL-SLIDER-1"></div>
<div data-figi-feed="ID-DEL-SLIDER-2"></div>
<script src="https://figi.video/embed/v1/figi.js" data-figi-key="TU-CLAVE" async></script>3. Si tu sitio es de una sola página
Si el sitio cambia de ruta sin recargar (React, Vue, Angular, Next.js con navegación del lado del cliente), el script solo monta los assets que existen cuando carga. Después de cada cambio de ruta, monta los nuevos:
document.querySelectorAll("[data-figi-feed]:not([data-figi-state])").forEach(function (element) {
element.setAttribute("data-figi-state", "loading");
window.figi.mount(element, element.getAttribute("data-figi-feed"));
});window.figi.mount devuelve una promesa con una función para desmontar el asset, útil si tu framework destruye el componente.
Verifica
- Recarga la página. El asset aparece en unos segundos.
- Con las herramientas de desarrollo (F12), el div tiene que tener
data-figi-state="ready". Si diceunavailable, el atributodata-figi-reasonexplica la causa. - En la pestaña Red, las solicitudes a
/api/public/eventstienen que responder 202. Si responden 403, falta autorizar el dominio.
Ventas y seguridad
- Para registrar ventas en la página de confirmación, sigue Registra las ventas.
- Si tu sitio usa una política de seguridad de contenido, revisa los dominios en Política de seguridad de contenido (CSP).
Para otros problemas, mira Problemas comunes en la guía general.
Más guías de Instalación en tu sitio
- Instala los assets de FIGI en tu sitioGuía para equipos técnicos: qué código pegar, cómo autorizar el dominio, cómo verificar la instalación y cómo resolver los problemas más comunes.
- Instala FIGI en ShopifyDónde pegar el script y el asset en un tema de Shopify, cómo verificarlo y qué revisar si no aparece.
- Instala FIGI en VTEXCómo agregar el script y el asset en una tienda VTEX IO o VTEX CMS, cómo verificarlo y qué revisar si no aparece.
- Instala FIGI en TiendanubeDónde pegar el script y el asset en el código del tema de Tiendanube, cómo verificarlo y qué revisar si no aparece.
- Instala FIGI en WooCommerceCómo cargar el script en WordPress, mostrar el asset en páginas y productos, verificarlo y evitar problemas con la caché.
- Eventos de FIGI para GTMGuía para equipos de marketing: qué eventos empuja FIGI al dataLayer, con qué campos, y cómo armar activadores y etiquetas en Google Tag Manager.