Por qué enviamos la atribución en menos de 2KB

Una cifra habitual en la mayoría de las etiquetas de analítica + atribución en 2026: entre 30 y 80KB comprimidos con gzip, a menudo ejecutándose en la ruta crítica de la página. La etiqueta de atribución de cyrqle está limitada a menos de 2KB comprimidos con gzip, con verificación estricta en CI. Aquí te explicamos por qué ese límite importa, cómo lo aplicamos y qué dejamos fuera a propósito.

Por qué importa el tamaño

Tres motivos:

1. Presupuesto de rendimiento. La puntuación de Lighthouse del sitio de una marca es una cifra real que equipos reales optimizan. Enviar una etiqueta de atribución que consume 50KB de su presupuesto de rendimiento es algo a lo que se resisten, y con razón. No queremos ser lo que las marcas tengan que posponer o cargar de forma diferida.
2. Riesgo de bloqueo. Las etiquetas más pesadas son bloqueadas con más frecuencia por adblockers, el ITP de los navegadores, y proxies corporativos. Un script de 2KB que existe principalmente para disparar un evento se mantiene por debajo de la mayoría de esos umbrales.
3. Superficie de errores. Menos código, menos formas de que la etiqueta se comporte mal en la página de checkout de otra persona.

Cómo aplicamos el límite

Dos verificaciones de CI, ambas bloqueantes en el merge del PR:

1. El tamaño comprimido con gzip de la etiqueta se mide en cada build. El PR falla si supera los 2KB.
2. Las dependencias en tiempo de ejecución de la etiqueta están fijadas por una regla de no-importaciones-de-terceros. Añadir una librería a la etiqueta pasa por una revisión de arquitectura.

Qué hay dentro de esos 2KB

• El parser de URL que extrae el ID del creador, el ID del clúster y el ID de campaña de la URL entrante o de la cookie.
• La escritura en el almacenamiento local a nivel de sesión que persiste el contexto de atribución durante la duración de la sesión del comprador.
• El disparo del evento de conversión que emite al edge endpoint de cyrqle en el checkout o cualquier evento que la marca haya configurado.
• Manejo mínimo de errores para los casos en los que se deniega el acceso al almacenamiento local.

Qué dejamos fuera a propósito

• Analítica de propósito general. Esto no es un mapa de calor, ni una repetición de sesión, ni un grabador de clics. Usa tus herramientas existentes para eso.
• Resolución de identidad. Sin fingerprinting, sin seguimiento entre sitios. La etiqueta funciona enteramente con datos first-party que la marca ya posee.
• Framework de pruebas A/B. Problema distinto, herramienta distinta.
• Peticiones externas antes de que se dispare la conversión. Sin prefetch, sin ping de calentamiento. La etiqueta no se ejecuta a menos que haya un evento de conversión que enviar.

Qué permite esto

La etiqueta es lo bastante pequeña como para que una marca pueda instalarla en su página de mayor tráfico sin tener que negociar con su equipo de rendimiento. Ese es el objetivo. Atribución que vive en el sitio de la marca, propiedad de la marca, y que no requiere disculpas.

Cuando la atribución se vuelve invisible desde el punto de vista del rendimiento, deja de ser una concesión y empieza a ser algo predeterminado.