Analytics de Comportamiento: Entendiendo Cómo Navegan los Usuarios Mi Portafolio
Este artículo técnico te guía en la implementación de analytics de comportamiento en tu portafolio web, desde lo básico hasta lo avanzado. Aprenderás a usar Google Analytics 4 (GA4) para métricas de página y eventos personalizados con `react-ga4` en React. Profundizarás con heatmaps y grabaciones de sesión usando Microsoft Clarity para entender la experiencia del usuario. Finalmente, se introduce PostHog para un análisis de producto completo, permitiéndote optimizar la interacción y el rendimiento de tu portafolio.

Niveles de Profundidad
Nivel 1 — Métricas de página (Google Analytics 4)
El punto de partida es Google Analytics 4 (GA4): un snippet de JavaScript en index.html y obtienes automáticamente páginas vistas, duración de sesión, tasa de rebote, dispositivos, ubicación geográfica y canales de adquisición.
<!-- public/index.html -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-XXXXXXXXXX');
</script>
Ventajas: Gratis, sin límites, dashboard potente, integración con Google Search Console.
Limitación: En una SPA como React, la navegación por react-router no dispara page views automáticamente. Necesitas notificar manualmente los cambios de ruta.
Integración con React Router
La librería react-ga4 resuelve esto:
npm install react-ga4
// src/analytics.js
import ReactGA from 'react-ga4';
export const initGA = () => {
ReactGA.initialize('G-XXXXXXXXXX');
};
export const trackPageView = (path) => {
ReactGA.send({ hitType: 'pageview', page: path });
};
// src/App.js — dentro del componente principal
import { useLocation } from 'react-router-dom';
import { useEffect } from 'react';
import { initGA, trackPageView } from './analytics';
function App() {
const location = useLocation();
useEffect(() => {
initGA();
}, []);
useEffect(() => {
trackPageView(location.pathname + location.search);
}, [location]);
// ...resto del componente
}
Con esto, cada navegación interna (clic en menú, cambio de ruta) se registra como page view en GA4. Esfuerzo: ~30 minutos.
Nivel 2 — Eventos personalizados por componente
Aquí es donde realmente empiezas a entender el comportamiento. En lugar de solo "visitó /ai-search", puedes registrar:
- "Hizo una pregunta al chatbot RAG"
- "Expandió el proyecto blog_project en la sección de proyectos"
- "Filtró posts por el tag
series-temporales" - "Hizo clic en 'Descargar CV'"
- "Envió el formulario de contacto"
// Evento custom en el componente del chatbot
import ReactGA from 'react-ga4';
const handleSearch = async (query) => {
// Trackear el evento
ReactGA.event({
category: 'RAG',
action: 'query',
label: query.substring(0, 100), // primeros 100 chars
});
// ...lógica de búsqueda existente
};
// Evento en el filtro de tags del blog
const handleTagFilter = (tagSlug) => {
ReactGA.event({
category: 'Blog',
action: 'filter_by_tag',
label: tagSlug,
});
// ...navegar al filtro
};
// Evento al hacer clic en un proyecto
const handleProjectClick = (projectName) => {
ReactGA.event({
category: 'Portfolio',
action: 'view_project',
label: projectName,
});
};
Estos eventos aparecen en GA4 → Reportes → Eventos, y puedes crear funnels para ver, por ejemplo, cuántos usuarios que ven los proyectos luego van al formulario de contacto.
Esfuerzo: Medio. Requiere agregar llamadas ReactGA.event() en cada componente que quieras trackear, pero son unas pocas líneas por componente.
Nivel 3 — Heatmaps y grabación de sesiones
Este nivel responde preguntas que los números no pueden: ¿hasta dónde hacen scroll en el Home? ¿Ven la sección de competencias o pasan de largo? ¿El botón de contacto es visible o se pierde?
Microsoft Clarity (recomendado para empezar)
Clarity es gratuito, sin límites de tráfico, y particularmente relevante para un portafolio:
<!-- public/index.html -->
<script type="text/javascript">
(function(c,l,a,r,i,t,y){
c[a]=c[a]||function(){(c[a].q=c[a].q||[]).push(arguments)};
t=l.createElement(r);t.async=1;t.src="https://www.clarity.ms/tag/XXXXXXXXXX";
y=l.getElementsByTagName(r)[0];y.parentNode.insertBefore(t,y);
})(window, document, "clarity", "script");
</script>
Lo que obtienes: - Heatmaps de clics: Mapa visual de dónde hace clic la gente. ¿El botón "Ver CV" recibe clics? ¿Los tags del blog se usan? - Heatmaps de scroll: ¿Qué porcentaje de usuarios llega al final del Home? ¿Los posts se leen completos? - Grabaciones de sesión: Reproducciones reales de cómo navega cada usuario. Invaluable para detectar UX confusa. - Detección de "rage clicks": Clarity detecta automáticamente clics repetitivos frustrados (el usuario hace clic varias veces porque algo no responde).
Esfuerzo: ~15 minutos. Solo pegar el script, sin cambios en React.
Alternativa: Hotjar
Similar a Clarity pero con plan gratuito más limitado (35 sesiones/día). Su diferenciador es la funcionalidad de encuestas in-page (popups que preguntan al usuario su experiencia).
Nivel 4 — Product Analytics completo (PostHog)
Para ir más allá de "qué hacen" hacia "por qué lo hacen y cómo optimizarlo":
PostHog es open-source, self-hosteable, y ofrece:
- Funnels: ¿Cuántos usuarios que llegan al Home terminan enviando un formulario de contacto?
- Retención: ¿Los visitantes vuelven? ¿Con qué frecuencia?
- Feature flags: Probar variantes de componentes sin deploy (¿funciona mejor el Hero con foto o sin foto?)
- A/B testing: Comparar dos versiones de una página y medir cuál convierte mejor
- Session replay: Similar a Clarity pero integrado con el resto de métricas
npm install posthog-js
// src/analytics.js
import posthog from 'posthog-js';
posthog.init('phc_XXXXXXXXXX', {
api_host: 'https://app.posthog.com', // o self-hosted
autocapture: true, // captura clics automáticamente
});
export default posthog;
Con autocapture: true, PostHog registra automáticamente todos los clics, cambios de página y envíos de formularios sin código adicional. Luego puedes refinar con eventos custom.
Esfuerzo: Medio-alto para aprovecharlo bien (funnels, dashboards, feature flags).
Costo: Gratis hasta 1M eventos/mes en cloud, o ilimitado self-hosted.
Comparativa de Herramientas
| Herramienta | Tipo | Costo | Esfuerzo | Privacidad | Ideal para |
|---|---|---|---|---|---|
| Google Analytics 4 | Pageviews + eventos | Gratis | Bajo | Requiere banner cookies (GDPR) | Métricas generales de tráfico |
| Microsoft Clarity | Heatmaps + replay | Gratis, sin límites | Muy bajo | Sin cookies propias | Ver cómo navegan visualmente |
| Plausible | Analytics privacy-first | €9/mes o self-host | Bajo | Sin cookies, GDPR-compliant | Alternativa ética a GA4 |
| Umami | Analytics privacy-first | Self-host gratis | Medio | Sin cookies | Auto-hospedado en tu infra |
| PostHog | Product analytics completo | Free tier 1M eventos | Medio-alto | Self-host disponible | Funnels, A/B tests, todo |
| Hotjar | Heatmaps + encuestas | Gratis (limitado) | Bajo | Requiere consentimiento | Feedback directo del usuario |
Estrategia Propuesta para Este Portafolio
La implementación ideal sería progresiva, en tres fases:
Fase 1 — Visibilidad básica (inmediata)
- Microsoft Clarity para heatmaps y grabaciones de sesión (script en
index.html, 15 min) - GA4 + react-ga4 para page views automáticos por ruta (30 min)
Preguntas que responde: ¿Cuánta gente visita el sitio? ¿Desde dónde? ¿Qué páginas ven? ¿Hasta dónde hacen scroll?
Fase 2 — Eventos por componente (1-2 días)
- Eventos custom para interacciones clave:
- Chatbot RAG: queries realizadas, respuestas expandidas, fuentes clickeadas
- Proyectos: cuáles se expanden, cuáles generan clic en el repo
- Blog: tags más filtrados, posts leídos completos vs abandonados
- Contacto: formulario iniciado vs enviado (tasa de conversión)
- CV: descargas o tiempo de lectura
Preguntas que responde: ¿Qué componentes generan engagement? ¿El chatbot RAG se usa? ¿Los proyectos interesan a los reclutadores?
Fase 3 — Optimización (futuro)
- PostHog para funnels de conversión (Home → Proyectos → Contacto)
- A/B testing de variantes del Hero o layout de proyectos
- Dashboard de métricas de producto
Consideraciones de Privacidad
Un punto importante para un portafolio profesional: mostrar que te importa la privacidad de los usuarios es en sí mismo una señal positiva para un data scientist.
- GDPR/LGPD: Si usas GA4 o Hotjar, necesitas un banner de consentimiento de cookies
- Alternativas sin cookies: Clarity, Plausible, Umami y PostHog (con config) funcionan sin cookies y no requieren banner
- Transparencia: Agregar una página
/privacyexplicando qué se trackea y por qué es una buena práctica
Para un portafolio chileno con audiencia global (reclutadores internacionales), usar herramientas privacy-friendly como Clarity + Plausible es una decisión técnica y ética que se puede destacar.
Relación con la Arquitectura Actual
El sitio ya tiene infraestructura que facilita esta implementación:
- React SPA con react-router: Compatible con
react-ga4para tracking de rutas - Nginx con headers de cache: Los scripts de analytics se cargan async, sin impacto en performance
- react-helmet-async: Ya se usa para SEO; los meta tags por página ayudan a GA4 a categorizar contenido
- Code splitting con React.lazy: Los chunks por página permiten medir tiempos de carga reales por sección
- CI/CD con GitHub Actions: Los scripts de analytics se despliegan automáticamente con cada push
No se requiere ningún cambio en el backend Django. Todo el tracking es client-side.
Conclusión
Instrumentar analytics en una SPA React no es complicado — la versión básica (GA4 + Clarity) se implementa en menos de una hora sin tocar componentes. La versión con eventos custom requiere más trabajo pero da visibilidad precisa sobre qué componentes funcionan.
Para un portafolio orientado a la búsqueda de empleo, la métrica más valiosa no es el tráfico total, sino el funnel de conversión: ¿cuántos visitantes que llegan al Home terminan en la página de contacto o descargando el CV? Esa es la pregunta que estas herramientas pueden responder.
Anterior: Por Qué Implementé Tests Automáticos en Mi Portafolio (Django + React)
Siguiente: Cinco Bugs en Cadena: Una Noche Arreglando el Admin de Django en Producción
Este artículo es parte de la serie "Construyendo un Blog con IA". El código fuente completo está en GitHub.