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

# Analysez votre documentation

> Utilisez la commande mint analytics pour consulter le trafic, les requêtes de recherche, les retours utilisateurs et les conversations de l'assistant IA directement depuis votre terminal.

La commande `mint analytics` vous donne accès aux [analytiques de votre documentation](/fr/optimize/analytics) depuis le terminal. Cela est utile pour générer des rapports d'analytique via des scripts, acheminer des données vers d'autres outils et effectuer des vérifications rapides sans ouvrir le tableau de bord.

<div id="prerequisites">
  ## Prérequis
</div>

Vous devez vous connecter pour utiliser les commandes d'analytique. Exécutez `mint login` pour vous authentifier avec votre compte Mintlify.

Consultez [Prévisualisation locale](/fr/cli/preview#log-in-for-search-and-assistant) pour plus de détails sur l'authentification.

<div id="view-key-metrics">
  ## Consulter les métriques clés
</div>

Affichez un résumé des vues, visiteurs, recherches, retours et utilisation de l'assistant :

```bash theme={null}
mint analytics stats
```

Utilisez des flags pour filtrer par plage de dates ou page :

* `--from` : Date de début au format `YYYY-MM-DD`. Par défaut, 7 jours en arrière.
* `--to` : Date de fin au format `YYYY-MM-DD`. Par défaut, aujourd'hui.
* `--page` : Filtrer sur une page spécifique.

```bash Example analytics stats flags theme={null}
mint analytics stats --from 2025-01-01 --to 2025-01-31
mint analytics stats --page /quickstart
```

<div id="view-search-analytics">
  ## Consulter les analytiques de recherche
</div>

Consultez ce que vos utilisateurs recherchent, avec le nombre de résultats et les taux de clics :

```bash theme={null}
mint analytics search
```

Utilisez des flags pour filtrer par chaîne de recherche ou par page :

* `--query` : Filtrer par sous-chaîne de requête de recherche.
* `--page` : Filtrer sur une page spécifique.

```bash Example analytics search flags theme={null}
mint analytics search --query "authentication"

mint analytics search --page /api-reference
```

<div id="view-feedback">
  ## Consulter les retours
</div>

Consultez les retours soumis par les utilisateurs sur les pages de votre documentation :

```bash theme={null}
mint analytics feedback
```

Utilisez des flags pour agréger les retours par page ou filtrer par retours de code :

* `--type` : Agréger les retours par page ou extrait de code. Par défaut, page.
* `--page` : Filtrer sur une page spécifique.

```bash Example analytics feedback flags theme={null}
mint analytics feedback --type page
mint analytics feedback --type code
```

<div id="view-assistant-conversations">
  ## Consulter les conversations de l'assistant
</div>

Listez les conversations récentes et les catégories de conversations de l'assistant IA :

```bash theme={null}
mint analytics conversation list
mint analytics conversation buckets list
```

Chaque liste inclut un ID pour chaque entrée. Transmettez cet ID à la commande `view` correspondante pour voir les détails complets :

```bash theme={null}
mint analytics conversation view <conversation-id>
mint analytics conversation buckets view <bucket-id>
```

<div id="choose-an-output-format">
  ## Choisir un format de sortie
</div>

Toutes les commandes d'analytique utilisent par défaut la sortie `plain`, séparée par des tabulations et adaptée à l'acheminement vers d'autres outils. Utilisez `--format` pour modifier la sortie :

```bash theme={null}
mint analytics stats --format table    # Tableau mis en forme avec couleurs
mint analytics stats --format json     # JSON brut
mint analytics stats --format graph    # Graphique à barres horizontal
```

La CLI détecte automatiquement les environnements d'agents IA comme Claude Code ou les terminaux non interactifs et utilise par défaut la sortie JSON.

<div id="set-defaults-with-config">
  ## Définir des valeurs par défaut avec config
</div>

Pour éviter de répéter les flags courants, définissez des valeurs par défaut avec `mint config`. La configuration est enregistrée dans `~/.config/mintlify/config.json`.

Lorsque vous exécutez `mint login`, la CLI définit la clé `subdomain`. Si vous avez plusieurs déploiements, la CLI vous invite à en choisir un. Vous pouvez modifier la valeur par défaut à tout moment avec `mint config set subdomain <subdomain>`.

Clés de configuration disponibles :

| Clé         | Description                                                                                   |
| ----------- | --------------------------------------------------------------------------------------------- |
| `subdomain` | Sous-domaine par défaut pour les commandes d'analytique. Défini par la commande `mint login`. |
| `dateFrom`  | Date de début par défaut pour les requêtes d'analytique (`YYYY-MM-DD`).                       |
| `dateTo`    | Date de fin par défaut pour les requêtes d'analytique (`YYYY-MM-DD`).                         |

```bash Example configs theme={null}
mint config set subdomain my-docs
mint config set dateFrom 2025-01-01
```

Une fois définis, les commandes d'analytique utilisent automatiquement ces valeurs :

```bash theme={null}
# Utilise le sous-domaine et dateFrom configurés sans flags
mint analytics stats
```

Pour consulter ou effacer une valeur, exécutez :

```bash theme={null}
mint config get subdomain
mint config clear subdomain
```