Saltar al contenido
hg.Héctor GarridoCiencia de datos · Estadística · Ingeniería de datos
← Volver al blog
Portafolio RAG

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.

Analytics de Comportamiento: Entendiendo Cómo Navegan los Usuarios Mi 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)

  1. Microsoft Clarity para heatmaps y grabaciones de sesión (script en index.html, 15 min)
  2. 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)

  1. Eventos custom para interacciones clave:
  2. Chatbot RAG: queries realizadas, respuestas expandidas, fuentes clickeadas
  3. Proyectos: cuáles se expanden, cuáles generan clic en el repo
  4. Blog: tags más filtrados, posts leídos completos vs abandonados
  5. Contacto: formulario iniciado vs enviado (tasa de conversión)
  6. 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)

  1. PostHog para funnels de conversión (Home → Proyectos → Contacto)
  2. A/B testing de variantes del Hero o layout de proyectos
  3. 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 /privacy explicando 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-ga4 para 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.