# PostHog (/fr/integrations/analytics/posthog)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 682 · updated: 2026-07-30 -->
Related: [Intégrations Analytics](/fr/integrations/analytics/overview.md), [Amplitude](/fr/integrations/analytics/amplitude.md), [Clarity](/fr/integrations/analytics/clarity.md), [Clearbit](/fr/integrations/analytics/clearbit.md), [Fathom](/fr/integrations/analytics/fathom.md), [Google Analytics 4](/fr/integrations/analytics/google-analytics.md)

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>
  <CodeBlockTabs defaultValue="Options d’Analytics dans docs.json" groupId="exemple+options-d-analytics-dans-docs-json">
    <CodeBlockTabsList>
      <CodeBlockTabsTrigger value="Options d’Analytics dans docs.json">
        Options d’Analytics dans docs.json
      </CodeBlockTabsTrigger>

      <CodeBlockTabsTrigger value="Exemple">
        Exemple
      </CodeBlockTabsTrigger>
    </CodeBlockTabsList>

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

    <CodeBlockTab value="Exemple">
      ```json  
      "integrations": {
          "posthog": {
              "apiKey": "phc_TXdpocbYTeZVm5VJmMzHTMrCofBQu3e0kN7HGMNGTVW"
          }
      }
      ```
    </CodeBlockTab>
  </CodeBlockTabs>
</CodeGroup>

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

<ParamField path="apiKey" type="string">
  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 [#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 title="Disable session recordings"
"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.