> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-justin-client-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PostHog

> Intégrez PostHog à votre site de documentation Mintlify pour suivre les analyses produit, l’usage des fonctionnalités et le comportement utilisateur.

Ajoutez ce qui suit à votre fichier `docs.json` pour envoyer des données d’analytics à PostHog.

Vous n’avez besoin d’inclure `apiHost` que si vous auto‑hébergez PostHog. Par défaut, Mintlify achemine les événements vers votre projet PostHog via le proxy `https://ph.mintlify.com`.

<CodeGroup>
  ```json Options d’Analytics dans docs.json theme={null}
  "integrations": {
      "posthog": {
          "apiKey": "YOUR_POSTHOG_PROJECT_API_KEY",
          "apiHost": "optional",
          "sessionRecording": true
      }
  }
  ```

  ```json Exemple theme={null}
  "integrations": {
      "posthog": {
          "apiKey": "phc_TXdpocbYTeZVm5VJmMzHTMrCofBQu3e0kN7HGMNGTVW"
      }
  }
  ```
</CodeGroup>

<div id="configuration-options">
  ### Options de configuration
</div>

<ParamField path="apiKey" type="string" required>
  La clé d’API de votre projet PostHog. Doit commencer par `phc_`.
</ParamField>

<ParamField path="apiHost" type="string">
  L’URL de votre instance PostHog. Requise uniquement si vous auto‑hébergez PostHog. Par défaut : `https://ph.mintlify.com` (le proxy PostHog de Mintlify).
</ParamField>

<ParamField path="sessionRecording" type="boolean" default="true">
  Activer ou désactiver l’enregistrement de session. Définissez la valeur sur `false` pour désactiver l’enregistrement de session tout en laissant les Analytics activés.
</ParamField>

<div id="session-recordings">
  ## Enregistrements de session
</div>

Les enregistrements de session sont activés par défaut lorsque vous configurez PostHog. Pour désactiver les enregistrements de session tout en laissant les Analytics activées, définissez `sessionRecording` sur `false` dans votre configuration.

```json Disable session recordings theme={null}
"integrations": {
    "posthog": {
        "apiKey": "phc_your-key",
        "sessionRecording": false
    }
}
```

Vous devez ajouter l’URL de votre site de documentation à l’option « Authorized domains for recordings » de PostHog avant de pouvoir recevoir des enregistrements de sessions. L’option permettant d’ajouter votre URL se trouve dans les paramètres du projet de PostHog.
