> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/analytics/broken-links.md).

# Liens cassés

Trouvez les URL de votre site publié qui renvoient une erreur 404 et corrigez-les grâce aux redirections suggérées

{% hint style="info" %}
Broken links est en version bêta et disponible avec le forfait de site Ultimate.
{% endhint %}

Broken links trouve les URL de votre site publié que les visiteurs atteignent mais qui n’existent plus. Pour chaque URL cassée, GitBook détermine quelle page le visiteur cherchait probablement et suggère une redirection que vous pouvez activer en un clic, afin que les visiteurs n’aboutissent plus sur des pages 404.

Dans la barre latérale de votre site, accédez à **Améliorer → Liens cassés**.

## Fonctionnement

GitBook audite régulièrement chaque site publié sur un forfait qui inclut Broken links. Chaque audit suit ces étapes :

1. Analyse le trafic de votre site au cours des 30 derniers jours et collecte les URL qui ont renvoyé une erreur 404. Une URL doit avoir été consultée au moins trois fois pour être prise en compte. Le bruit généré par les robots et les scanners, comme les requêtes vers `/wp-admin` ou les `.php` fichiers, est ignoré.
2. Fusionne les URL similaires, écarte celles déjà couvertes par une redirection active ou qui se résolvent à nouveau parce qu’une page existe désormais à cet emplacement, puis classe le reste par nombre de visites. Les 60 URL cassées les plus visitées passent à l’étape suivante.
3. Analyse le contenu publié pour trouver la page que chaque visiteur cherchait probablement. Si toute une section a été déplacée, GitBook regroupe les URL cassées sous une seule suggestion générique, telle que `/v1/*`. Si aucune page ne correspond, GitBook l’indique et vérifie à nouveau cette URL après 30 jours.
4. Crée une redirection suggérée pour chaque URL cassée qui a une correspondance claire, avec une brève explication du choix de cette page et un niveau de gravité basé sur le trafic reçu par l’URL.

Un site est audité au maximum une fois par jour. Chaque audit recommence à partir de votre trafic actuel, et les URL résolues disparaissent, de sorte qu’un site ayant plus de 60 URL cassées les traite au fil d’audits successifs, en commençant par les plus visitées. Les URL cassées que GitBook n’a pas pu associer à une page sont également conservées comme éléments à examiner, avec la raison et les pages prises en compte, afin que vous puissiez décider si elles nécessitent une nouvelle page plutôt qu’une redirection.

Les liens cassés s’appuient sur [Redirections du site](https://gitbook.com/docs/documentation/fr/publish/site-redirects.md). Consultez d’abord cette page si vous ne connaissez pas les redirections.

## Les deux vues

Broken links comporte deux vues, entre lesquelles vous pouvez basculer depuis les onglets de l’en-tête :

* **Résultats** répertorie les URL cassées trouvées par GitBook et les redirections suggérées, que vous pouvez examiner.
* **Analyser** affiche le rapport complet des URL cassées issu des données analytiques de votre site, y compris les URL pour lesquelles aucune suggestion n’est encore disponible.

## Examen des résultats

La vue **Résultats** commence par un récapitulatif des 30 derniers jours :

| Carte                           | Ce qu'elle affiche                                        |
| ------------------------------- | --------------------------------------------------------- |
| **Visites sur des URL cassées** | Le nombre de réponses 404 renvoyées par votre site.       |
| **Visiteurs touchés**           | Le nombre de visiteurs uniques ayant rencontré une 404.   |
| **Redirections suggérées**      | Le nombre de suggestions ouvertes en attente de révision. |

La liste affiche chaque résultat avec son statut, son niveau de gravité et un titre décrivant l’URL cassée et, lorsque GitBook en a trouvé une, la page vers laquelle elle devrait renvoyer. Les résultats avec une correction suggérée sont affichés en premier.

### Gravité

La gravité reflète la quantité de trafic qu’une URL cassée reçoit, par rapport aux autres URL cassées de votre site.

La gravité comporte trois niveaux :

* **Élevée** : au moins 20 visites au cours des 30 derniers jours, et l’une des cinq URL cassées les plus consultées de votre site.
* **Moyenne** : une URL qui reçoit un trafic régulier.
* **Faible** : une URL consultée seulement quelques fois au cours des 30 derniers jours.

### Recherche, filtrage et tri

Saisissez une URL, ou une partie de celle-ci, dans le champ de recherche pour trouver un résultat précis. Utilisez la barre de filtres pour affiner les résultats selon leur **Statut** ou leur **Gravité**. Par défaut, la liste affiche uniquement les résultats **Ouverts** , triés par gravité. Choisissez le tri **Récemment mis à jour** pour afficher les modifications les plus récentes en premier. Si vous ouvrez un résultat puis revenez en arrière, votre recherche, vos filtres et votre tri sont conservés.

## Correction d’une URL cassée

1. Sélectionnez un résultat dans la liste pour ouvrir ses détails.
2. Consultez la section **Motivation** . Elle explique quelle page GitBook a associée à l’URL cassée et pourquoi. La liste des **Pages associées** contient des liens vers les pages concernées.
3. Cliquez sur **Créer une redirection**.
4. La boîte de dialogue **Ajouter une redirection** s’ouvre avec les champs **Chemin source** et **destination** déjà remplis à partir de la suggestion. Modifiez-les selon vos besoins, par exemple en choisissant **Redirection permanente** si l’ancienne URL ne sera jamais rétablie.
5. Cliquez sur **Activer la redirection** pour l’activer immédiatement, ou **Enregistrer comme brouillon** pour la publier plus tard depuis les paramètres de redirection de votre site.

Lorsque vous activez une redirection dont la source correspond à un problème ouvert, celui-ci est automatiquement marqué comme **Résolu**. Enregistrer la redirection comme brouillon laisse le problème ouvert jusqu’à la mise en ligne de la redirection.

La redirection est ajoutée aux redirections de votre site. Vous pouvez la modifier ou la supprimer à tout moment depuis **Paramètres → Redirections**, ou en cliquant sur **Gérer les redirections** en haut de l’écran.

{% hint style="info" %}
La création de redirections nécessite des droits d’administrateur sur le site, et la modification du statut d’un résultat nécessite des droits de modification. Les actions que vous ne pouvez pas utiliser apparaissent désactivées, avec une explication.
{% endhint %}

### Suggestions génériques

Lorsque plusieurs URL rompues partagent un préfixe et appartiennent toutes à la même section déplacée, GitBook suggère une redirection générique unique, telle que `/v1/*` au lieu d’une redirection par URL. La boîte de dialogue de redirection préremplie a l’option **Remplacer le caractère générique par le texte correspondant** activée, de sorte que `/v1/installation` est dirigée vers le chemin correspondant à la nouvelle destination. Consultez [Redirections du site](https://gitbook.com/docs/documentation/fr/publish/site-redirects.md) pour savoir comment fonctionnent les redirections génériques.

## Ignorer un résultat

Si une suggestion ne convient pas, ou si l’URL rompue n’a pas besoin d’être redirigée, ouvrez le problème et cliquez sur **Ignorer**. Il passe à l’état **Rejeté** et disparaît de la liste par défaut. Vous pouvez le retrouver en filtrant par **État**, puis le rétablir avec **Désarchiver**.

Vous pouvez également modifier directement le statut d’un résultat depuis la liste ou la page de détails à l’aide du menu de statut :

| Statut      | Signification                                              |
| ----------- | ---------------------------------------------------------- |
| **Ouvrez**  | Le résultat attend d’être examiné.                         |
| **Résolue** | Une redirection a été créée, ou l’URL se résout à nouveau. |
| **Rejeté**  | Vous avez choisi d’ignorer le résultat.                    |

Les résultats sont également résolus automatiquement lorsque le prochain audit constate que l’URL cassée se résout à nouveau, soit parce qu’une page existe de nouveau à cet emplacement, y compris une page traduite, soit parce qu’une redirection active la couvre.

## Analyse des URL cassées

La vue **Analyser** affiche toutes les URL ayant renvoyé une erreur 404 pendant la période sélectionnée, que GitBook ait ou non une suggestion pour celles-ci. Il peut s’agir d’URL mal saisies, de liens obsolètes sans redirection ou de liens indésirables. Utilisez cette vue pour trouver les URL rompues qui nécessitent une nouvelle page plutôt qu’une redirection, ou pour découvrir d’où provient le trafic vers des URL rompues.

Le rapport comprend ces cartes :

* **Visites des URL rompues**, **Visiteurs concernés**, et **URL distinctes** pour la période sélectionnée, avec une évolution au fil du temps.
* **Principales URL rompues**, classées par nombre de visites.
* **URL rompues par dimension**, qui permet de regrouper le trafic vers les URL rompues par **Domaine référent**, **URL rompue**, **Référent complet**, **Pays**, ou **Appareil**. Le regroupement par domaine référent est le moyen le plus rapide de trouver un site externe qui pointe vers une URL obsolète et de distinguer un véritable lien obsolète du bruit généré par les robots d’exploration.
* **Erreurs 404 dues au contenu adaptatif**, si votre site utilise du contenu adaptatif. Il s’agit des visiteurs qui ont atteint une page existante, mais qu’une condition les a empêchés de voir. Ils sont exclus des problèmes, car une redirection ne serait d’aucune utilité.

Vous pouvez filtrer le rapport à l’aide des mêmes filtres que pour le reste de vos [statistiques du site](https://gitbook.com/docs/documentation/fr/analytics/insights.md), notamment par section, langue, pays, appareil et référent.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/analytics/broken-links.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
