Saltar al contenido principal

Instalación con Script Manual

Banner activo en cinco minutos, sin dependencias externas y con cambios futuros sin tocar código si eliges el modo recomendado. A continuación verás dónde va el snippet en tu sitio y cómo decidir entre los dos modos de configuración disponibles.

Requisitos previos

  • Acceso al código HTML de tu sitio (o a la plantilla del tema)
  • Una cuenta en Consentiam y un sitio creado en el dashboard
  • Tu API Key (la encuentras en Dashboard → Sitios → Instalación)

El snippet

En el dashboard, dentro de tu sitio, ve a la pestaña Instalación y copia el snippet del bloque Script Manual. Pégalo justo después de la etiqueta de apertura <head> de tu sitio, antes de cualquier otro script.

El snippet tiene esta forma (el contenido exacto lo genera el dashboard con tu API Key):

<script>
window.__TI__ = { key: 'TU_API_KEY', url: 'https://www.consentiam.eu', cdn: 'https://cdn.consentiam.eu' };
</script>
<script src="https://cdn.consentiam.eu/stub.js" async></script>

Importante: copia siempre el snippet desde el dashboard. No lo escribas a mano — el dashboard genera la versión correcta según tu plan y configuración.

Dos modos de configuración

El dashboard ofrece dos modos de instalación. Ambos usan el mismo método (el snippet en el <head>); la diferencia es de dónde obtiene el banner su configuración:

ModoCómo obtiene la configuraciónAl cambiar la configuración del banner
Automático RecomendadoEl banner pide su configuración al servidor de Consentiam.Los cambios del dashboard se aplican solos. No tocas el snippet.
OptimizadoLa configuración va incrustada en el propio snippet (sin petición al servidor).Tienes que volver a copiar el snippet actualizado y pegarlo en tu sitio.

¿Cuándo usar cada modo?

Usa Automático (por defecto)

Es la opción recomendada para casi todos los sitios. Configuras el banner una vez en el dashboard y cualquier cambio futuro (colores, textos, categorías) se aplica sin tocar el código de tu sitio.

Usa Optimizado solo si la latencia es crítica

Con la configuración incrustada, el banner se renderiza sin esperar ninguna petición al servidor. Ganas unos milisegundos. A cambio, cada vez que cambies la configuración del banner tienes que volver a copiar el snippet y pegarlo en tu sitio. Solo merece la pena si esa diferencia de latencia es importante para ti y asumes ese mantenimiento manual.

Antes de instalar: tu sitio necesita un enlace a la Política de Cookies. Es obligatorio según la normativa AEPD, y el dashboard deshabilita el botón de copiar el snippet hasta que lo configures. Sigue la guía de enlaces legales obligatorios.

Documentación relacionada

Instalación con Script Manual | Documentación | Consentiam | Consentiam