Comment importer ou exporter des règles de redirection en masse ?
L'importation de règles est un moyen productif d'ajouter de nombreuses règles à la fois. redirection.io prend en charge plusieurs formats d'importation, adaptés à divers usages.
- Le CSV de règles de redirection vous permet d'importer des règles de redirection définies dans des fichiers
.csv. Ce fichier peut contenir des marqueurs, que vous pouvez utiliser dans le formulaire de création de règle. - L'importation CSV de balises méta est conçue pour importer en masse des règles de balises méta à l'aide d'un fichier
.csv. - L'import JSON vous permet d'importer en masse tous les types de règles, en utilisant un format exhaustif pour vos règles.
Import CSV de règles de redirection
L'écran d'importation est accessible depuis l'écran "Liste des règles" :
- Sélectionnez un fichier CSV contenant les redirections que vous souhaitez configurer. L'outil d'importation aide à définir le rôle de chaque colonne, l'ordre des colonnes n'est donc pas important.
- L'étape Marqueurs permet de définir les propriétés des chaînes de marqueurs qui ont été incluses dans le fichier. Chaque occurrence d'une chaîne de marqueur sera remplacée par un marqueur redirection.io
- À l'étape "Exécuter l'importation", vous pouvez choisir d'ignorer les erreurs dans le fichier importé. Si cet interrupteur est coché, l'outil d'importation fera de son mieux pour importer toutes les règles qu'il est possible et sûr de créer, et il ignorera les erreurs ou les avertissements. Si l'interrupteur n'est pas coché, l'importation sera plus stricte et échouera complètement même s'il n'y a qu'une seule erreur.
- Une fois démarrée, la durée de l'importation dépend du nombre de règles à importer - cela prend généralement quelques secondes, mais peut prendre plusieurs minutes s'il y a des dizaines de milliers de règles. S'il y a des erreurs dans le fichier d'importation, l'outil d'importation permettra de télécharger un fichier CSV contenant les lignes erronées, afin que vous puissiez les corriger et essayer à nouveau d'importer le fichier de redirections.
Format du fichier d'import
L'outil d'importation de redirection.io est plutôt flexible et permissif. Voici quelques conseils à connaître :
- l'ordre des colonnes n'a pas d'importance ;
- le CSV peut inclure une ligne d'en-tête, ou non ;
- les importations peuvent inclure des marqueurs ;
- le fichier CSV peut également être utilisé pour créer des réponses 404 ou 410.
L'ordre des colonnes n'est pas important
La seule exigence pour les fichiers importés est le format du fichier, qui doit être un fichier CSV valide.
Une fois que vous avez sélectionné le fichier à importer, l'outil d'importation affiche les 100 premières lignes du fichier. Il permet d'ignorer la première ligne (s'il s'agit d'une ligne d'en-tête) et de définir le rôle de chaque colonne. Les rôles de colonnes qui peuvent être mappés sont : URL source, URL cible, Code de statut, Priorité, Balises. Ces colonnes peuvent apparaître dans n'importe quel ordre dans le fichier CSV.
Les trois colonnes suivantes sont obligatoires :
- URL source* : C'est l'URL qui déclenchera une réponse de redirection. Il peut s'agir d'une URL commençant par
/ou://ouhttp://ouhttps:// - URL cible* : C'est l'URL vers laquelle l'utilisateur sera redirigé. Il peut s'agir d'une URL commençant par
/ou://ouhttp://ouhttps:// - Code de statut* : C'est le code de statut à utiliser pour la redirection. Assurez-vous de choisir un code de statut de redirection valide
Il peut y avoir deux colonnes facultatives :
- Priorité : une valeur numérique pour définir la priorité de la règle. Les règles de priorité plus élevée prendront le pas sur celles de priorité inférieure
- Balises : balises séparées par des virgules à associer à la règle
Le fichier CSV peut inclure une ligne d'en-tête, ou non
Le fichier importé peut contenir une ligne d'en-tête, ou non. Lors de l'importation, vous pouvez modifier les options d'importation pour ignorer la première ligne. Ainsi, ces deux fichiers sont valides pour exécuter une importation :
Source URL;Target URL;Status Code
/some-source;/some-target;302
/this-is-not-found;;404
/this-is-gone;;410
et
/some-source;/some-target;302
/this-is-not-found;;404
/this-is-gone;;410
Les fichiers importés peuvent définir des marqueurs
Les marqueurs sont une excellente fonctionnalité de redirection.io pour créer des règles qui peuvent être appliquées à de nombreuses URL à la fois.
À la troisième étape de l'importation des règles, vous pouvez définir quelles chaînes doivent être remplacées par un marqueur. Par exemple, vous pourriez importer le fichier CSV suivant :
Source URL;Target URL;Status Code;Priority;Tags
/products/[CATEGORY_NAME];/shop/[CATEGORY_NAME];301;10;shop,category
/products/[CATEGORY_NAME]/[PRODUCT_ID]-[PRODUCT_NAME].html;/shop/[PRODUCT_ID]-[PRODUCT_NAME];301;10;shop,product
/products/[ANYTHING];/shop;302;1;shop
Des chaînes spécifiques ont été utilisées dans le fichier CSV d'exemple :
[CATEGORY_NAME][PRODUCT_ID][PRODUCT_NAME]
Ces chaînes sont des espaces réservés qui sont remplis lors de l'importation avec les marqueurs redirection.io. Cela peut être fait directement à la 3ème étape du formulaire d'importation, ou dans la configuration des templates de marqueurs si vous pensez que ces marqueurs seront fréquemment utilisés dans votre projet :
Une fois l'importation exécutée, trois règles seront créées avec les marqueurs configurés :
Publiez les règles, et elles seront appliquées à votre site web en quelques secondes.
Les imports peuvent également définir des actions 404 et 410
L'outil d'importation a été conçu pour aider à importer de grandes collections de redirections, mais il peut également être utilisé pour créer des règles avec des actions de code de status personnalisé, par exemple pour renvoyer une 404 ou une 410. Il vous suffit d'ajouter une colonne "Code de statut" dans le fichier CSV :
Source URL;Target URL;Status Code
/some-source;/some-target;302
/this-is-not-found;;404
/this-is-gone;;410
Importer des ensembles de règles très volumineux
L'outil d'importation a été conçu pour importer de très grands fichiers de redirection. Le nombre de règles qui peuvent être créées avec une seule importation dépend de la taille de chaque URL, mais vous pouvez vous attendre à pouvoir charger environ 500 000 règles de redirection avec une seule importation, et cela devrait prendre environ 10 minutes pour se terminer.
Lors de l'importation de fichiers de redirection volumineux, nous vous conseillons de cocher l'interrupteur "Ignorer les erreurs d'importation". S'il y a des erreurs dans le fichier, vous pourrez télécharger un fichier CSV à la fin de l'importation, ne contenant que les lignes avec des erreurs. Une fois corrigé, vous pourrez réimporter ce fichier pour que votre plan de redirection soit complété dans les plus brefs délais.
Import CSV de règles de balises méta
Comme pour l'import CSV de redirections, l'importation de balises méta est possible via un fichier CSV. Le processus est fondamentalement le même :
- Sélectionnez un fichier CSV contenant les balises méta que vous souhaitez configurer. L'outil d'importation aide à définir le rôle de chaque colonne, l'ordre des colonnes n'est donc pas important.
- À l'étape suivante, cliquez sur le bouton "Démarrer l'importation" et, après quelques secondes, vous devriez voir les règles nouvellement créées apparaître sous la liste des règles. Publiez-les, et les balises méta de votre site web seront mises à jour !
Format du fichier CSV des balises méta
Le fichier importé peut contenir une ligne d'en-tête, ou non, et l'ordre des colonnes n'a pas d'importance. Votre fichier CSV peut même inclure des colonnes que vous ne souhaitez pas importer. Lors de l'importation, vous pouvez ajuster les options d'importation pour ignorer la première ligne.
Voici un exemple de fichier CSV valide pour l'importation de balises méta. Bien sûr, vous pouvez y inclure plus de colonnes :
URL,Title,Description,Tags
/products/gaming-chairs,Gaming Chairs,Comfortable and stylish gaming chairs.,"furniture, gaming, chairs"
/products/laptop-bags,Laptop Bags,Protect your laptop with our durable bags.,"laptop, bags, accessories"
/products/smartphones,,Find the latest smartphones with cutting-edge technology.,"electronics, smartphones, tech"
/products/sports-watches,Sports Watches,Stay active with our sports watch collection.,"sports, watches, accessories"
/products/wireless-earbuds,Wireless Earbuds,Experience premium sound with our wireless earbuds.,"electronics, earbuds, wireless"
Pour faciliter la lecture, voici à quoi ressemble le contenu de ce fichier :
| URL | Title | Description | Tags |
|---|---|---|---|
| /products/gaming-chairs | Gaming Chairs | Comfortable and stylish gaming chairs. | furniture, gaming, chairs |
| /products/laptop-bags | Laptop Bags | Protect your laptop with our durable bags. | laptop, bags, accessories |
| /products/smartphones | Find the latest smartphones with cutting-edge technology. | electronics, smartphones, tech | |
| /products/sports-watches | Sports Watches | Stay active with our sports watch collection. | sports, watches, accessories |
| /products/wireless-earbuds | Wireless Earbuds | Experience premium sound with our wireless earbuds. | electronics, earbuds, wireless |
Comme la cellule Title pour l'URL /products/smartphones est vide, la règle créée pour cette URL ne contiendra aucune modification de la balise <title>.
Limites des fichiers importés
La limite de taille des fichiers d'importation est assez élevée et dépend principalement de la taille des URL définies dans le fichier. Vous devriez pouvoir importer plusieurs centaines de milliers de règles avec un seul fichier. Si cela ne fonctionne pas, veuillez diviser l'importation en plusieurs fichiers plus petits.
Import JSON
L'import JSON est à la fois plus complet et plus compliqué que les fonctions d'importation CSV. Ce format d'importation vous permet de créer des règles avancées, incluant tous les types de déclencheurs et d'actions pris en charge par redirection.io. D'un autre côté, il peut être un peu délicat à écrire et nécessitera sans aucun doute l'intervention d'un développeur.
Pour faire simple, la syntaxe prise en charge pour le fichier d'import JSON est la même que celle des payloads de l'API publique de redirection.io.
Un bon point de départ, si vous souhaitez écrire un fichier d'importation de règles JSON, est d'abord d'exporter votre projet en JSON, de modifier le fichier ainsi téléchargé avant de le réimporter.
- Sous "Paramètres" > "Règles", localisez le bloc "Export & import de l'ensemble de règles".
- Cliquez sur le bouton "Exporter l'ensemble de règles en fichier json"
- Modifiez ce fichier
- Importez-le en utilisant le bouton "Importer l'ensemble de règles"
Associer des balises aux règles importées
Par défaut, redirection.io suggère d'associer une balise horodatée aux règles créées par une importation. Vous pouvez ajouter d'autres balises si vous le souhaitez. Nous vous recommandons d'associer toujours des balises aux règles importées, afin de faciliter la gestion des règles dans votre ensemble de règles à l'avenir. Par exemple, si vous souhaitez trouver toutes les règles créées par une importation, il vous suffit de sélectionner la bonne balise dans la liste des règles. Les supprimer, afin de pouvoir les remplacer par une version plus à jour, sera une opération facile.
Exports des logs et des règles
redirection.io permet d'exporter les logs ou les règles sous forme de fichiers CSV. Dans la liste des logs ou dans la liste des règles, choisissez les colonnes à afficher, utilisez les filtres de votre choix, et cliquez sur l'icône "Exporter", en haut à droite de la liste. Cela déclenchera le téléchargement d'un fichier CSV contenant les colonnes choisies, en utilisant les bons filtres.
