> 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, allez à **Améliorer → Broken links**. ## Fonctionnement GitBook audite régulièrement chaque site publié sur un forfait qui inclut Broken links. Chaque audit suit ces étapes : 1. Examine les 30 derniers jours de trafic vers votre site et collecte les URL qui ont renvoyé une 404. Une URL doit avoir été sollicitée au moins trois fois pour être prise en compte, et le bruit provenant des robots et des scanners, comme les requêtes pour `/wp-admin` ou `.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. Lit votre 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 recontrôle 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. Broken links s’appuie sur [Redirections du site](/docs/documentation/fr/publish/site-redirects.md). Lisez-le d’abord si vous n’êtes pas familier avec 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, prêtes à être examinées. * **Analyser** affiche le rapport complet des URL cassées issu des analyses de votre site, y compris les URL qui n’ont pas encore de suggestion. ## Examen des résultats La **Résultats** la vue commence par un résumé 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 visitées de votre site. * **Moyen**: une URL avec un trafic régulier. * **Faible**: une URL sollicitée seulement à quelques reprises au cours des 30 derniers jours. ### Recherche, filtrage et tri Saisissez une URL, ou une partie d’URL, dans le champ de recherche pour trouver un résultat précis. Utilisez la barre de filtres pour affiner les résultats par **Statut** ou **Gravité**. Par défaut, la liste n’affiche que les **Ouvrez** résultats, triés par gravité. Passez le tri à **Récemment mis à jour** pour voir d’abord les dernières modifications. Ouvrir un résultat puis revenir en arrière conserve votre recherche, vos filtres et votre tri. ## Correction d’une URL cassée 1. Sélectionnez un résultat dans la liste pour ouvrir ses détails. 2. Lisez le **Motivation** section. Elle explique quelle page GitBook a associée à l’URL cassée et pourquoi. La **Pages associées** liste renvoie vers les pages concernées. 3. Cliquez sur **Créer une redirection**. 4. La **Ajouter une redirection** la boîte de dialogue s’ouvre avec le **Chemin source** et **contenu de destination** déjà renseigné à partir de la suggestion. Modifiez ce que vous voulez, par exemple choisissez **Redirection permanente** si l’ancienne URL ne doit jamais revenir. 5. Cliquez sur **Activer la redirection** pour l’activer immédiatement, ou **Enregistrer en 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 résultat ouvert, le résultat est automatiquement marqué comme **Résolue**. Enregistrer la redirection comme brouillon laisse le résultat 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 cassées partagent un préfixe et appartiennent toutes à la même section déplacée, GitBook suggère une seule redirection générique, telle que `/v1/*` au lieu d’une redirection par URL. La boîte de dialogue de redirection préremplie a **Remplacer le joker par le texte correspondant** activé, donc `/v1/installation` est envoyé vers le chemin correspondant sous la nouvelle destination. Voir [Redirections du site](/docs/documentation/fr/publish/site-redirects.md) pour savoir comment fonctionnent les redirections génériques. ## Ignorer un résultat Si une suggestion n’est pas correcte, ou si l’URL cassée n’a pas besoin de redirection, ouvrez le résultat et cliquez sur **Ignorer**. Il passe à **Rejeté** et disparaît de la liste par défaut. Vous pouvez le retrouver en filtrant sur **Statut**, et le faire revenir avec **Réafficher**. 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 **Analyser** la vue affiche chaque URL qui a renvoyé une 404 pendant la période sélectionnée, que GitBook ait ou non une suggestion à son sujet. Il peut s’agir d’URL mal saisies, de liens obsolètes sans redirection ou de liens indésirables. Servez-vous-en pour trouver les URL cassées qui ont besoin d’une nouvelle page plutôt que d’une redirection, ou pour voir d’où provient le trafic cassé. Le rapport comprend ces cartes : * **Accès à des URL cassées**, **Visiteurs touchés**, et **URL distinctes** pour la période sélectionnée, avec une tendance dans le temps. * **Principales URL cassées**, classées par nombre d’accès. * **URL cassées par dimension**, ce qui vous permet de regrouper le trafic cassé par **Domaine du référent**, **URL cassée**, **Référent complet**, **Pays**, ou **Appareil**. Regrouper par domaine du référent est le moyen le plus rapide de trouver un site externe qui renvoie vers une URL obsolète, et de distinguer un véritable lien obsolète du bruit généré par les robots d’exploration. * **404 causées par un contenu adaptatif**, si votre site utilise du contenu adaptatif. Il s’agit de visiteurs arrivés sur une page qui existe mais qu’une condition les a empêchés de voir. Ils sont exclus des résultats, car une redirection n’aiderait pas. Vous pouvez filtrer le rapport à l’aide des mêmes filtres que le reste de votre [les analyses du site](/docs/documentation/fr/analytics/insights.md), y compris la section, la langue, le pays, l’appareil et le 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=&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.