Files
mintlify[bot] f0cf216f80 docs: translate PostHog key safety clarification (es, fr, zh) (#6920)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-08 00:39:38 +00:00

68 lines
2.5 KiB
Plaintext

---
title: "PostHog"
description: "Integra PostHog en tu documentación de Mintlify para analizar el producto, el uso de funcionalidades y el comportamiento de usuarios con tu API key."
keywords: ["PostHog integration", "product analytics", "feature flags", "self-hosted PostHog"]
boost: 3
---
Añade lo siguiente a tu archivo `docs.json` para enviar Analytics a PostHog.
Solo necesitas incluir `apiHost` si alojas PostHog por tu cuenta. De forma predeterminada, Mintlify envía los eventos a tu proyecto de PostHog a través del proxy `https://ph.mintlify.com`.
<CodeGroup>
```json Opciones de Analytics en docs.json
"integrations": {
"posthog": {
"apiKey": "YOUR_POSTHOG_PROJECT_API_KEY",
"apiHost": "optional",
"sessionRecording": true
}
}
```
```json Ejemplo
"integrations": {
"posthog": {
"apiKey": "phc_TXdpocbYTeZVm5VJmMzHTMrCofBQu3e0kN7HGMNGTVW"
}
}
```
</CodeGroup>
<div id="configuration-options">
### Opciones de configuración
</div>
<ParamField path="apiKey" type="string" required>
La API key de tu proyecto de PostHog. Debe empezar con `phc_`.
Esta clave es un token del lado del cliente pensado para ser público. Es la misma clave que tu navegador envía con cada evento de Analytics. Puedes confirmarla sin problema en el repositorio de tu documentación.
</ParamField>
<ParamField path="apiHost" type="string">
La URL de tu instancia de PostHog. Solo es obligatorio si alojas PostHog por tu cuenta. De forma predeterminada es `https://ph.mintlify.com` (el proxy de PostHog de Mintlify).
</ParamField>
<ParamField path="sessionRecording" type="boolean" default="true">
Activa o desactiva la grabación de sesiones. Establécelo en `false` para desactivar las grabaciones de sesiones y mantener Analytics habilitado.
</ParamField>
<div id="session-recordings">
## Grabaciones de sesiones
</div>
Las grabaciones de sesiones se habilitan de forma predeterminada al configurar PostHog. Para desactivar las grabaciones de sesiones y mantener Analytics habilitado, establece `sessionRecording` en `false` en tu configuración.
```json Disable session recordings
"integrations": {
"posthog": {
"apiKey": "phc_your-key",
"sessionRecording": false
}
}
```
Debes agregar la URL de tu sitio de documentación a la sección "Authorized domains for recordings" de PostHog antes de poder recibir grabaciones de sesión. La opción para agregar tu URL se encuentra en la configuración del proyecto de PostHog.