Le chargeur lit deux colonnes dans votre fichier : l'adresse et l'alias souhaité. Tout le reste — groupe, étiquettes, paramètres UTM — se définit une seule fois pour le lot entier dans le formulaire, et non ligne par ligne.

C'est le point à connaître avant d'assembler le fichier. Le format, les plafonds et la moitié des raisons pour lesquelles des lignes échouent ensuite en découlent.

Ci-dessous : comment bâtir un fichier qui passe d'un bloc, que faire quand les liens ont besoin de paramètres différents, combien de lignes partent en une fois, et comment lire le rapport lorsqu'une partie des liens ne se crée pas.

Quel fichier le chargeur accepte

Un CSV ou un simple fichier texte suffit. L'analyse est tolérante, et quelques détails vous épargneront des manipulations.

Le séparateur est détecté automatiquement. Le chargeur regarde la première ligne et retient, parmi la virgule, le point-virgule et la tabulation, celui qui revient le plus souvent. Cela compte, car Excel en locale française enregistre les CSV avec des points-virgules, et un tel fichier n'a pas à être retravaillé. Un export de Google Sheets séparé par des virgules convient tout autant, de même qu'une colonne copiée directement depuis un tableur, qui arrive séparée par des tabulations.

La ligne d'en-tête est facultative. Si la première ligne commence par url, alias ou link, elle est considérée comme un en-tête et reste hors du lot. Sans en-tête, la première colonne est l'adresse et la seconde l'alias.

Une seule colonne convient. Une liste d'adresses, une par ligne, sans aucun séparateur, est acceptée telle quelle.

url;alias
https://example.com/catalogue/soldes/chaussures-2026;chaussures
https://example.com/catalogue/soldes/sacs-2026;sacs
https://example.com/catalogue/soldes/manteaux-2026

Une adresse contenant une virgule doit être mise entre guillemets. C'est le comportement normal du CSV, mais c'est précisément là que trébuchent les exports comportant des paramètres :

"https://example.com/recherche?tags=soldes,nouveau";soldes-nouveau

Sans les guillemets, la ligne se scinde à cette virgule et un morceau de l'adresse se retrouve dans l'alias. Un guillemet doublé à l'intérieur d'une valeur ("") désigne un guillemet littéral — là encore, du CSV standard.

Les lignes vides sont ignorées, inutile donc de nettoyer les sauts de ligne en fin de fichier.

Les alias peuvent être laissés vides de façon sélective : le troisième lien de l'exemple n'en a pas, un code sera généré pour lui. Mélanger des lignes avec et sans alias est permis.

Quand les liens ont besoin de paramètres différents

Groupe, étiquettes et paramètres UTM s'appliquent au lot entier d'un coup. Commode lorsque vous chargez un catalogue ou un envoi ; contraignant dès que la liste couvre plusieurs campagnes.

Deux contournements qui tiennent.

Inscrire les paramètres directement dans les adresses. Les balises UTM sont de simples paramètres de requête : elles peuvent donc différer à chaque ligne si vous les ajoutez dans les adresses elles-mêmes :

url
https://example.com/a?utm_source=newsletter&utm_campaign=juin
https://example.com/b?utm_source=telegram&utm_campaign=juin

Composer cette colonne dans un tableur tient à une formule de concaténation.

Découper en plusieurs lots. Un lot par campagne : chacun avec ses étiquettes et son groupe, et vous lirez ensuite les statistiques par groupe au lieu de démêler une longue liste. Cette voie reste généralement plus propre quand les campagnes sont peu nombreuses.

Combien de liens partent en une fois

Il y a trois limites, de natures différentes.

Combien
Lignes dans un chargement 1000
Chargements simultanés 3
Liens dans une requête à l'API 100

Si le fichier compte plus de mille lignes, découpez-le : les lignes au-delà de la limite n'entreront tout simplement pas dans le chargement. Trois chargements simultanés, c'est un plafond sur les traitements inachevés, non un quota journalier : dès que l'un se termine, vous pouvez lancer le suivant.

Le volume mensuel est une autre affaire et dépend de la formule. Sur l'offre gratuite, le raccourcissement en masse n'existe pas du tout. Pro autorise 100 liens par mois, de quoi l'essayer sur une liste réelle et savoir si le volume vous est nécessaire. Premium n'a pas de plafond mensuel, mais un plafond journalier de 30 000 liens s'applique.

Pourquoi une partie des lignes ne se crée pas

Une mauvaise ligne n'annule pas le lot. Le chargement va jusqu'au bout et chaque ligne porte son propre sort. Il y a trois états, et les distinguer est utile parce qu'ils se corrigent différemment.

Rejetée à la validation. La ligne n'a pas passé les contrôles, et cela se voit juste après l'analyse du fichier, avant tout raccourcissement. Le plus souvent une adresse mal formée, un alias trop long, ou n'importe quoi là où une URL devrait se trouver.

Non créée. La ligne était correcte, mais le lien n'a pas abouti — par exemple parce que l'alias demandé était déjà pris.

Créée. C'est fait, le lien court figure en face de la ligne.

Causes courantes et ce qu'il faut en faire :

Ce que l'on voit Ce dont il s'agit Ce qu'il faut faire
Ligne rejetée, l'adresse paraît correcte schéma absent — example.com au lieu de https://example.com ajouter https:// par formule sur toute la colonne
Une ligne sur deux rejetée adresses avec virgules non mises entre guillemets encadrer les valeurs, ou enregistrer le fichier avec des points-virgules
Un morceau du lien s'est retrouvé dans l'alias même cause : la ligne s'est scindée au séparateur même correctif
Alias tronqué alias plus long qu'autorisé raccourcir à 10 caractères
Non créée, alias pris ce code existe déjà changer l'alias ou laisser le champ vide
Moins de lignes chargées que n'en contient le fichier le fichier dépasse 1000 lignes découper le fichier

Une habitude qui paie : faites d'abord passer les dix premières lignes du fichier. Un problème systématique de l'export — mauvais schéma, mauvais séparateur, une colonne en trop — se manifeste sur dix lignes exactement comme sur mille, mais se démêle bien plus vite.

Si la liste est produite par du code

Quand les liens sont préparés par votre logiciel et non par une personne devant un tableur, il existe une méthode par lots dans l'API : jusqu'à 100 liens en une requête, avec une réponse par élément reprenant la même répartition entre créés, non créés et rejetés.

Un détail peu évident s'y cache, sur lequel on tombe facilement. Un lot consomme le quota de requêtes par lien, et non comme une requête unique. Un lot de 100 liens retire 100 unités. Sinon la méthode par lots deviendrait un moyen de contourner la limitation de fréquence, et un client pourrait créer des milliers de liens par minute. Si le quota restant ne couvre pas le lot entier, la requête est rejetée en bloc et rien n'est créé — le reste se vérifie donc avant l'envoi, pas après.

Les paramètres communs fonctionnent comme dans le formulaire : le bloc defaults est fusionné dans chaque ligne, et les champs de la ligne le remplacent. Une valeur vide dans la ligne signifie « non précisé », la valeur vient donc de defaults, exactement comme une cellule vide dans un export. Le point de terminaison et le schéma de réponse sont décrits dans la documentation de l'API.

Que faire de la liste obtenue

Les liens courts issus d'un lot ne diffèrent en rien de ceux créés un à un : chacun a ses statistiques de clics, sa géographie et ses sources. Si vous avez affecté un groupe commun au lot, lire les statistiques par ce groupe est commode — on voit comment le catalogue entier ou l'envoi entier a travaillé comme un tout.

Si le fonctionnement même du raccourcissement vous intéresse avant d'aller plus loin, il est décrit dans l'article sur le fonctionnement des raccourcisseurs de liens. Deux gestes se rentabilisent justement sur les grandes listes : utiliser votre propre domaine, puisque sur un lot de mille liens le nom de domaine croise le lecteur mille fois ; et poser les balises avant le chargement plutôt qu'après, car modifier les paramètres UTM de mille liens déjà créés coûte plus cher que de préparer une colonne balisée dans le tableur.

En bref

Bâtissez un fichier d'une ou deux colonnes, les adresses portant le schéma https://, les valeurs contenant des virgules entre guillemets. Fixez les paramètres communs sur le lot ; ceux qui varient, inscrivez-les dans les adresses ou répartissez-les sur plusieurs chargements. Testez sur dix lignes, chargez ensuite le reste et lisez le rapport ligne par ligne.

La rubrique elle-même et l'ordre pas à pas se trouvent sur la page raccourcir des liens en masse ; le chargement en masse est disponible sur les formules payantes, un premier lot demande donc un compte Pro ou supérieur.