Cómo conectar PostHog para ver las analíticas de tu sitio

Equipo de Sokku
Cómo conectar PostHog para ver las analíticas de tu sitio

Esta guía te lleva paso a paso para activar las métricas de tráfico de tu sitio (visitas, visitantes, páginas más vistas) y verlas dentro de tu Backoffice. Toma unos 5 minutos y la cuenta de PostHog es gratis hasta 1.000.000 de eventos por mes.

1. Creá tu cuenta y proyecto

  1. Entrá a posthog.com y registrate.
  2. Al crear el proyecto, elegí la región (US o EU). Anotá cuál elegiste ya que define los “hosts” de los pasos siguientes.

2. Conseguí las credenciales (son 4 datos)

  1. Project API Key (para registrar las visitas): en Settings → Project → Project API Key. Empieza con phc_…
  2. Personal API Key (para leer las métricas en el backoffice): en Settings → Personal API Keys → Create personal API key. Empieza con phx_… Guardala apenas la creás: no se vuelve a mostrar.
  3. Project ID: el número que aparece en la URL de tu proyecto, o en Settings → Project.
  4. Región / hosts: si elegiste US, usá https://us.i.posthog.com (ingesta) y https://us.posthog.com (app). Si elegiste EU, reemplazá “us” por “eu”.

3. Cargá las variables en el sitioEstos valores se configuran como variables de entorno en el host del proyecto web. Si no administrás el deploy, pasale la siguiente información al administrador.

  • NEXT_PUBLIC_POSTHOG_KEY → tu Project API Key (phc_…)
  • NEXT_PUBLIC_POSTHOG_HOST → host de ingesta (https://us.i.posthog.com)
  • POSTHOG_PERSONAL_API_KEY → tu Personal API Key (phx_…)
  • POSTHOG_PROJECT_ID → el Project ID
  • POSTHOG_HOST → host de la app (https://us.posthog.com)

Después de guardarlas, volvé a desplegar el sitio para que tomen efecto.

4. Verificá

  1. Navegá tu sitio publicado para generar algunas visitas.
  2. Entrá al Backoffice → Dashboard → Analítica: en unos minutos vas a ver visitas, visitantes únicos y las páginas más vistas.

💡 Si todavía no cargaste las claves, la pestaña Analítica muestra un mensaje de “configurá PostHog”. La Personal API Key nunca se expone al público: solo se usa del lado del servidor.