PostHog

Rastrea vistas de página, eventos personalizados y grabaciones de sesión con PostHog.

PostHog es una plataforma de analítica de productos de código abierto que te da control total sobre tus datos. Boltdocs inyecta el fragmento JavaScript de PostHog automáticamente cuando lo configuras.

Propiedad	Tipo	Predeterminado	Descripción
`apiKey`	`string`	✓	Tu clave API del proyecto PostHog (ej: `'phc_xxx'`)
`host`	`string`	`'https://us.i.posthog.com'`	Host de la API de PostHog. Usa `'https://eu.i.posthog.com'` para la nube de la UE
`capturePageview`	`boolean`	`true`	Capturar vistas de página automáticamente
`capturePageleave`	`boolean`	`true`	Capturar eventos de salida de página automáticamente
`sessionRecording`	`boolean`	`false`	Habilitar grabación de sesión
`autocapture`	`boolean`	`false`	Habilitar captura automática de clics

integrations: {
  analytics: {
    posthog: {
      apiKey: 'phc_xxxxxxxxxxxxxxxxxxxx',
    },
  },
}

Si tu instancia de PostHog está en la región de la UE:

integrations: {
  analytics: {
    posthog: {
      apiKey: 'phc_xxxxxxxxxxxxxxxxxxxx',
      host: 'https://eu.i.posthog.com',
    },
  },
}

integrations: {
  analytics: {
    posthog: {
      apiKey: 'phc_xxxxxxxxxxxxxxxxxxxx',
      sessionRecording: true,
    },
  },
}

Evento	Descripción
`$pageview`	Se ejecuta en cada navegación de página (incluyendo navegación del lado del cliente)
`$pageleave`	Se ejecuta cuando el usuario abandona una página

Puedes rastrear eventos personalizados usando el hook useTrackEvent():

tsx

import { useTrackEvent } from 'boltdocs'

export function MyComponent() {
  const trackEvent = useTrackEvent()

  const handleClick = () => {
    trackEvent('button_click', {
      button_id: 'downloadPdf',
      button_location: 'sidebar',
    })
  }

  return <button onClick={handleClick}>Descargar PDF</button>
}

Accede a la API completa de analítica:

tsx

import { useAnalytics } from 'boltdocs'

function MyComponent() {
  const { trackEvent, trackPageView } = useAnalytics()

  // Rastrear un evento personalizado
  trackEvent('search', { query: 'instalación' })

  // Rastrear una vista de página manualmente
  trackPageView('/docs/guides/getting-started/instalación', 'Instalación')
}

Rastreo simplificado de vistas de página:

tsx

import { useTrackPageView } from 'boltdocs'

function DocPage({ title, path }) {
  const trackPageView = useTrackPageView()

  useEffect(() => {
    trackPageView(path, title)
  }, [path, title])
}

Rastrea eventos arbitrarios:

tsx

import { useTrackEvent } from 'boltdocs'

function SearchBox() {
  const trackEvent = useTrackEvent()

  return (
    <input
      onChange={(e) => {
        trackEvent('search_input', { query: e.target.value })
      }}
    />
  )
}

PostHog soporta la exclusión de captura de datos. Puedes usar la API de PostHog para respetar el consentimiento del usuario:

tsx

import { useEffect } from 'react'

function ConsentHandler({ hasConsent }) {
  useEffect(() => {
    if (window.posthog) {
      if (hasConsent) {
        window.posthog.opt_in_capturing()
      } else {
        window.posthog.opt_out_capturing()
      }
    }
  }, [hasConsent])

  return null
}

Verifica que la clave API sea correcta (comienza con phc_)
Revisa la consola del navegador en busca de errores
Usa el panel de Eventos en Vivo de PostHog para ver eventos en tiempo real

Los scripts de PostHog solo se inyectan en compilaciones de producción. Ejecuta boltdocs build && boltdocs preview para probar localmente.

Las vistas de página se rastrean automáticamente en la navegación. No llames a trackPageView manualmente a menos que sea necesario.

Asegúrate de que integrations.analytics.posthog.apiKey sea una cadena no vacía.

Jesús Alcalá

Last updated on October 18, 2026

PostHog

Referencia de Configuración

Ejemplo Mínimo

Nube de la UE

Con Grabación de Sesión

Qué se Rastrea

Eventos Automáticos

Eventos Personalizados

Usando los Hooks

`useAnalytics()`

`useTrackPageView()`

`useTrackEvent()`

Respetando la Privacidad del Usuario

Solución de Problemas

Los eventos no aparecen

Los scripts no aparecen en desarrollo

Vistas de página duplicadas

Errores de compilación

Was this page helpful?