Guía de instalación para Astro

Añade Velo a Astro

Instala el banner de cookies de Velo y Google Consent Mode v2 en Astro con una línea en tu layout compartido. Con acceso de administrador a la web, la mayoría de las instalaciones llevan unos minutos. Si usas Google Tag Manager, esta página también explica esa vía.

Instrucciones y fuentes de las imágenes revisadas el 7 de noviembre de 2026.

Funciona con las plataformas con las que creas tus webs

WordPressShopifyWebflowWixHubSpotPrestaShopDrupalBigCommerceShopwareNext.jsAstroSquare

Qué necesitas en Astro

Antes de empezar

  • Dónde. src/layouts/Layout.astro → head
  • Plan. Cualquier proyecto de Astro
  • Se activa. Tras tu próximo despliegue
  • Tiempo habitual. Unos cinco minutos

Cuando ya está en marcha

  • Tu banner sigue los valores por defecto que has fijado para la región de cada visitante.
  • Las etiquetas esperan hasta que el visitante ha elegido.
  • Cada elección queda registrada, y Consent Mode v2 se la pasa a tus etiquetas de Google.
CMConsent Mode v2GPCGlobal Privacy ControlUERGPDUSLeyes estatales de EE. UU.

Dos formas de instalar Velo en Astro

Elige la vía que encaje con la forma en que tu web ya carga sus etiquetas. Las dos acaban con el mismo banner y las mismas señales.


Pega una línea en tu layout

Añade el fragmento de tu web al head de todas las páginas, publica y pruébalo en la web en producción. Si tus etiquetas de medición ya van por Google Tag Manager, usa mejor la vía que tienes más abajo.

¿Usas Tag Manager? Olvídate del código

Si ya tienes Google Tag Manager en tu web, esta es la forma más fácil de añadir Velo. No tienes que tocar código, son cuatro pasos cortos y todas tus etiquetas quedan en un solo sitio.

Unos cinco minutosTiempo habitual de instalación en Astro
Tras tu próximo despliegueCuándo se activa el banner
1,500Sesiones al mes en el plan Free, para una web
Si usas ClientRouter, Astro sustituye todo el body de la página en cada navegación, y eso elimina el banner y el botón que lo vuelve a abrir. Añade el segundo script corto del paso 2 y los dos se quedan. Sin ClientRouter, cada enlace es una carga completa de página y ese script no hace falta.
!
Ojo con estoInstalación en Astro
Ver todas las plataformas compatibles

Todo lo que necesita una configuración de consentimiento

El mismo banner, los mismos registros y los mismos análisis en todos los planes. Pro añade webs ilimitadas, análisis ilimitados y tu propio logo.


Tu banner pregunta en el idioma del visitante y sigue los valores por defecto que has fijado para su región.

Cada elección queda registrada, y Consent Mode v2 se la pasa a tus etiquetas de Google.


Google Consent Mode v2Modo avanzado en todos los planes, con una plantilla de Google Tag Manager.
Reglas según el país del visitanteConsentimiento explícito donde la ley lo pide, y reglas más estrictas para hasta 60 países.
Leyes de privacidad de EE. UU.Un banner de exclusión con la opción “No vender ni compartir”.
Global Privacy ControlLas señales GPC se respetan en todos los planes.
Rechazar, tan fácil como aceptarRechazar está junto a aceptar en la primera capa.
El idioma del visitanteSegún su navegador, con tus propios textos del banner en cada idioma.
Diseños y temasEsquina, barra o caja centrada, con tus colores, en claro u oscuro.
Haz tests A/B de tu bannerPrueba de 2 a 8 versiones del banner a la vez.
Registro de consentimientosCada decisión se guarda 3 años, con búsqueda de comprobantes por ID.
Panel de consentimientoTasas de aceptación y rechazo en periodos de 7 a 90 días.
Análisis de cookies y rastreadoresCategorías a partir de firmas conocidas, más sugerencias de IA que apruebas tú.
Bloqueo de scriptsLos scripts esperan a su categoría de consentimiento antes de ejecutarse.

Pega una línea en tu layout

Añade el fragmento de tu web al head de todas las páginas, publica y pruébalo en la web en producción. Si tus etiquetas de medición ya van por Google Tag Manager, usa mejor la vía que tienes más abajo.

Copia la línea

Copia desde tu panel de Velo el fragmento de instalación completo de esta web. El ejemplo de abajo solo muestra el formato: sustituye your-site-id antes de usarlo. Deja el endpoint de la API tal como te lo da el panel.

Fragmento de ejemplo
<script src="https://cdn.veloconsent.com/v1/velo.js" data-api="https://app-staging.veloconsent.com" data-velo-site="your-site-id" async></script>

Pégala en tu layout compartido

Abre el layout que comparten todas las páginas, normalmente src/layouts/Layout.astro. Pega tu fragmento completo de Velo dentro de <head>, encima de cualquier etiqueta de analítica o publicidad, y añade is:inline a la etiqueta script para que Astro la deje tal cual. Si el layout usa <ClientRouter />, Astro sustituye el body en cada navegación y eso elimina el banner. Para conservarlo, añade en el mismo head un script is:inline que guarde #velo-banner-host y #velo-reopener-host en astro:before-swap y los añada a document.body en astro:after-swap. Después, compila y despliega.

Astro · layout compartido
<!-- src/layouts/Layout.astro: the layout every page shares -->
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <!-- Paste the complete Velo snippet from your dashboard here, then add is:inline. -->
    <script is:inline src="https://cdn.veloconsent.com/v1/velo.js"
            data-api="https://app-staging.veloconsent.com"
            data-velo-site="your-site-id" async></script>

    <!-- Only if this layout uses <ClientRouter />: keeps the banner across page swaps. -->
    <script is:inline>
      document.addEventListener('astro:before-swap', () => {
        window.veloHosts = [...document.querySelectorAll('#velo-banner-host, #velo-reopener-host')];
      });
      document.addEventListener('astro:after-swap', () => {
        document.body.append(...window.veloHosts);
      });
    </script>
  </head>
  <body>
    <slot />
  </body>
</html>
Referencia de configuración cotejada con la documentación de la plataforma. No es una captura del panel de administración. Referencia de configuración verificada · 7 de noviembre de 2026. Documentación de la plataforma ↗

Publica y compruébalo en producción

Guarda y publica el cambio siguiendo los pasos de tu plataforma que tienes arriba, y vacía la caché de la web o del CDN. Abre la URL publicada en una sesión nueva del navegador. Comprueba que el banner aparece donde lo exigen tus reglas por región, prueba a aceptar y a rechazar, y verifica que los valores por defecto y las actualizaciones del consentimiento se aplican antes de que se ejecuten tus etiquetas de medición. Confirma que tu web aparece como instalada en el panel de Velo.

El banner de Velo con su aspecto por defecto. El texto, los colores y los ajustes por región de tu banner pueden ser distintos.

¿Usas Tag Manager? Olvídate del código

Si ya tienes Google Tag Manager en tu web, esta es la forma más fácil de añadir Velo. No tienes que tocar código, son cuatro pasos cortos y todas tus etiquetas quedan en un solo sitio.

La guía completa de Tag Manager

Añade Velo a Tag Manager

Abre la plantilla de Velo, pulsa Add to workspace y elige tu contenedor. Abrir la plantilla de Velo ↗

Pega el ID de tu web

En Tag Manager, abre Tags y pulsa New. Pulsa Tag Configuration, elige Velo CMP y pega el ID de tu web. Lo encontrarás en tu panel de Velo. Deja todo lo demás como está.

Haz que cargue primero

Pulsa Triggering, elige Consent Initialization – All Pages y pulsa Save. Así Velo arranca antes que tus otras etiquetas.

Publica y compruébalo

Pulsa Submit y luego Publish. Preview no basta para poner Velo en marcha. Después abre tu web en una ventana privada, prueba el banner y comprueba que tu web aparece como instalada en tu panel de Velo.

O deja que lo haga un agente

Copia el prompt y pégalo en Claude, ChatGPT, Cursor o el asistente que ya uses. Lleva todo lo que hay en esta página: las dos vías, el orden en que tienen que cargar las etiquetas y las comprobaciones que demuestran que funciona.

Instalar con IA

El prompt

Pega este prompt en tu asistente y pásale el ID de tu web y, desde tu panel de Velo, el fragmento de instalación completo o los ajustes de GTM.

Prompt de instalación · Astro
Instala Velo en Astro.

Guía actual: https://veloconsent.com/astro

Antes de tocar nada, consigue en el panel de Velo el ID de mi web y el fragmento de instalación completo, o la configuración de GTM. Comprueba qué herramienta de consentimiento y qué etiquetas de medición hay ya en la web.

Elige una sola vía de instalación:
A. Si la web ya usa Google Tag Manager, añade la plantilla Velo CMP (publicada por veloconsent) desde la Community Template Gallery. Configura el ID de mi web, el tema y el endpoint de la API con los datos del panel. Revisa las opciones avanzadas: ads_data_redaction y url_passthrough vienen desactivadas por defecto. Usa el activador Consent Initialization – All Pages y comprueba el consentimiento en Preview antes de publicar. Pasos completos: https://veloconsent.com/google-tag-manager

B. Instalación directa: En el layout que comparten todas las páginas, normalmente src/layouts/Layout.astro, pega tu fragmento completo de Velo dentro de <head>, encima de cualquier etiqueta de analítica o publicidad, y añade is:inline a la etiqueta script para que Astro la deje tal cual. Si el layout usa <ClientRouter />, Astro sustituye el body en cada navegación y eso elimina el banner: en el mismo head, añade un script is:inline que guarde #velo-banner-host y #velo-reopener-host en astro:before-swap y los añada a document.body en astro:after-swap. Compila y despliega.

Respeta el código que no tenga que ver con Velo. No instales Velo dos veces ni dejes valores de consentimiento por defecto que choquen entre sí. No des por hecho que ponerlo en el head o cargarlo en async garantiza por sí solo el orden de las etiquetas.

Revisa la web publicada en una sesión nueva. Comprueba el banner según las reglas por región configuradas, los valores de consentimiento iniciales, las actualizaciones al aceptar y al rechazar, y el evento velo_consent_update. Comprueba que las etiquetas que no son de Google siguen las categorías que tienen asignadas. Prueba una segunda página y cualquier checkout que vaya por separado. Confirma que las señales llegan al panel de Velo.

Cuéntame qué has cambiado, dónde y qué ha dado cada comprobación. Dime si te ha faltado algún acceso o si hay alguna comprobación que no hayas podido hacer.
¿Usas un agente que lee páginas web? Pásale veloconsent.com/llms.txt y /install.md y tendrá el mismo contexto en texto plano.

Del blog

Notas sobre banners de cookies, Consent Mode y los datos que se pierden entre medias.


¿Necesitan las webs canadienses Consent Mode v2?
V
Blog de Velo11 de noviembre de 2026

Google Consent Mode v2 en Velo: novedades

2 de noviembre de 2026Leer el artículo

Cómo configurar Google Consent Mode v2 en Shopify

2 de septiembre de 2026Leer el artículo

Preguntas frecuentes sobre Velo en Astro

¿Para qué webs de Astro sirve?

Cualquier proyecto de Astro con un layout compartido, ya sea estático o renderizado en servidor, porque la etiqueta va en el HTML que genera el layout. Hemos probado los pasos en Astro 7 con salida estática.

¿Tengo que añadir is:inline?

Es la opción segura. Astro ya deja tal cual cualquier script con atributos distintos de src, así que el fragmento queda intacto de todos modos, e is:inline lo hace explícito. Deja los atributos data exactamente como aparecen en tu panel.

El banner desaparece cuando hago clic en un enlace.

Es ClientRouter, que sustituye el body de la página cuando los visitantes navegan. Añade el segundo script del paso 2 al mismo head, y el banner y el botón que lo vuelve a abrir pasan a cada página nueva. transition:persist de Astro no sirve aquí, porque Velo añade esos elementos cuando la página ya ha cargado.

Mi web tiene más de un layout.

Pon el fragmento en el layout base que envuelven los demás. Si tus layouts no comparten ninguno, añádelo a cada uno. Velo ignora una segunda copia en la misma página, pero comprueba que el banner aparece en todas las secciones de la web.

¿Ralentizará mi web?

El fragmento del panel carga de forma asíncrona. Como con cualquier script, mide cómo afecta a tu web y revisa el orden de las etiquetas: la carga asíncrona, por sí sola, no garantiza que los valores de consentimiento por defecto se apliquen antes que el resto de etiquetas.

¿Puede hacerlo por mí un asistente de IA?

Sí. Copia el prompt de Instalar con agentes, justo debajo, y pégalo en Claude, ChatGPT, Cursor o el asistente que ya uses. Incluye los pasos de esta página, el orden en que tienen que cargar las etiquetas y las comprobaciones que el agente tiene que hacer antes de darte el trabajo por terminado.

Gratis para una web

Banner, análisis y registros de consentimiento para una web, gratis. Pro desde €7 al mes, más IVA, para webs ilimitadas.