CookieFácil para Desarrolladores — Hub Técnico

Todo lo que necesitas para implementar consentimiento de cookies conforme al RGPD y la LGPD — bloqueo de scripts, Google Consent Mode v2, WordPress y Shopify, con ejemplos de código funcionales.

¿Qué necesita implementar un desarrollador para cumplimiento RGPD/LGPD en cookies?

Tres cosas. Primero, bloquear todos los scripts no esenciales antes del consentimiento usando MutationObserver o reescritura de tipo — ningún script de seguimiento puede ejecutarse hasta que el visitante acepte activamente. Segundo, disparar gtag('consent', 'default', {...}) de forma síncrona antes de que cargue cualquier tag de Google. Tercero, almacenar un registro de consentimiento a prueba de manipulación con fecha, categorías y versión del banner para auditorías de la AEPD y la ANPD.

CookieFácil gestiona las tres automáticamente con un único script tag colocado como el primer elemento en el <head> de tu HTML. Las guías a continuación cubren implementación manual e integraciones específicas para cada plataforma.

Guías de integración

Elige tu método de integración. Cada guía tiene ejemplos de código funcionales.

Implementación JavaScript

Bloqueo de scripts con MutationObserver, reescritura de tipo y gestión del estado de consentimiento. Funciona con cualquier framework o HTML puro.

  • Bloqueo de scripts antes del consentimiento
  • Interceptación de scripts dinámicos
  • API de estado de consentimiento
Leer guía

Google Consent Mode v2

Llamadas gtag() exactas, estado predeterminado denegado, disparadores de actualización y mapeo de categorías hacia señales RGPD/LGPD.

  • Snippet estándar listo para copiar
  • Mapeo categorías → señales GCM
  • wait_for_update explicado
Leer guía

Integración WordPress

Colocación del script via wp_head prioridad 1, compatibilidad con plugins de caché y gestión de scripts de plugins de terceros.

  • Configuración wp_enqueue_script
  • Compatibilidad WP Rocket, LiteSpeed
  • Resolución de conflictos entre plugins
Leer guía

Integración Shopify

Colocación en theme.liquid, ScriptTag API para desarrolladores de apps y soporte Shopify Markets para clientes en Brasil y España.

  • Colocación del script en theme.liquid
  • ScriptTag API para devs de apps
  • Shopify Markets + Brasil/España
Leer guía

Quick start — cualquier plataforma

Pega esto como primer script dentro del tag <head>. Reemplaza TU_SITE_ID con el ID de tu dashboard CookieFácil.

<!-- CookieFácil RGPD/LGPD — debe ser el PRIMER script en <head> -->
<script data-cfasync="false"
        src="https://cdn.cookiefacil.com.br/cdn/cf-banner.min.js?site=TU_SITE_ID"
        async></script>

El atributo data-cfasync="false" evita que Cloudflare Rocket Loader difiera este script.

Preguntas frecuentes — Desarrolladores

  • ¿Qué necesita implementar un desarrollador para cumplimiento RGPD/LGPD en cookies?

    Tres cosas: bloquear todos los scripts no esenciales antes del consentimiento usando MutationObserver o reescritura de tipo, disparar gtag('consent', 'default', {...}) antes de que cargue cualquier tag de Google, y almacenar un registro de consentimiento con fecha, categorías y versión del banner para auditorías de la AEPD, ANPD o cualquier autoridad LATAM.

  • ¿Cómo integrar CookieFácil en un sitio WordPress?

    Usa el plugin oficial CookieFácil en WordPress.org o añade el snippet JavaScript manualmente via wp_head con prioridad 1. El plugin gestiona automáticamente el bloqueo de scripts, compatibilidad con plugins de caché (WP Rocket, LiteSpeed) e integración con Google Consent Mode v2. Instalación en menos de 10 minutos.

  • ¿CookieFácil funciona con Google Tag Manager?

    Sí. El template GTM de CookieFácil configura automáticamente Google Consent Mode v2 con estado predeterminado denegado antes de que cargue cualquier tag. Después de que el visitante acepta, se envía el estado de actualización con las categorías correctas. Compatible con GA4, Google Ads y Meta Pixel vía GTM.

  • ¿Cuál es el impacto en el rendimiento del sitio?

    El script de CookieFácil pesa menos de 20KB minificado y comprimido, servido via CDN Cloudflare con TTL largo. El banner renderiza en menos de 500ms en conexiones móviles 4G. No usa jQuery ni frameworks pesados — solo JavaScript puro optimizado para rendimiento.