Export et import
Exporter liens et clics en CSV, migrer depuis Linkly/Bitly, et réimporter un fichier “Export” — dans les paramètres du projet.
Où trouver
Onglet “Paramètres” du projet → éléments distincts “Export” et “Import” dans le menu de gauche. Les deux portent sur le projet actuel.
- Ouvrir le projet dans l’espace de travail.
- Aller à l’onglet “Paramètres”.
- Choisir “Exporter” pour télécharger ou “Importer” pour envoyer un CSV.
Paramètres du projet : “Export” et “Import” dans le menu latéral.
Plan et limites
Export et import sont disponibles sur les plans avec une limite quotidienne de transfert. Sur FREE et FREE+, les sections affichent un message de substitution suggérant une mise à niveau.
- La limite quotidienne additionne le volume de tous les envois et téléchargements du jour, pas le nombre de tentatives.
- Un projet ne peut exécuter qu’un seul export et un seul import à la fois.
- Un fichier d’export terminé est conservé brièvement (généralement jusqu’à 24 heures) — téléchargez-le juste après la fin.
- Un CSV envoyé directement dans le navigateur a une limite de taille. Les très gros fichiers ne peuvent pas être envoyés ainsi.
ATTENTION : dépasser la limite quotidienne fait échouer un nouvel export ou import. Attendez le jour suivant ou changez de plan.
Exporter les liens
La section “Liens” construit un tableau des liens courts du projet : noms, destinations, sous-domaines, balises, statuts et total des clics.
- “Paramètres” → “Export” → section “Liens”.
- Définir les filtres : dossier, balises (l’une ou toutes), inclure les liens archivés.
- Cliquer sur “Suivant” → cocher les colonnes nécessaires (un jeu de base est sélectionné par défaut).
- Choisir CSV ou TSV et, si besoin, compression GZIP.
- Lancer l’export → attendre la fin → cliquer sur “Télécharger”.
| Colonne | Ce que cela signifie |
|---|---|
| `short_name` | Nom court (id) — obligatoire pour l’import |
| `long_url` | URL de destination principale |
| `long_url_2`, `long_url_3`… | Destinations de redirection supplémentaires lorsqu’il y en a plusieurs |
| `subdomain` | Sous-domaine du projet (vide — aucun) |
| `description` | Description ou titre du lien |
| `tags` | Balises séparées par des virgules |
| `is_active`, `is_archived` | Statut : actif ou archivé |
| `agg_total_clicks` | Total des clics issus des analyses |
| `has_password` | Indicateur “Protégé par mot de passe” (le mot de passe lui-même n’est pas exporté) |
Un fichier “Export” peut être réimporté dans le même projet ou un autre — les colonnes correspondent au format “Notre CSV”.
Choix des colonnes pour l’export des liens.
Progression de l’export et bouton de téléchargement.
Exporter les clics et sauvegarde complète
“Clics” exporte l’historique des redirections pour une période choisie. “Sauvegarde complète” est un ZIP avec liens et clics dans un seul fichier.
- “Clics” : choisir une période (24 heures, 7 jours, 30 jours ou personnalisée). Inclure éventuellement les clics de bots.
- Cocher les colonnes : heure, pays, appareil, champs UTM, referrer et autres.
- “Sauvegarde complète” : définir les mêmes filtres de liens plus la période de clics — un ZIP pour archive ou migration.
- L’export des stats de clics détaillées n’est possible que dans la rétention de votre plan. Au-delà, vous n’obtenez que les totaux.
- Dans l’export des clics, vous pouvez exclure les bots des totaux tout en les marquant dans les lignes.
- Une sauvegarde complète est utile avant de grands changements de projet.
Export des clics : période et colonnes.
Import : choisir un format
Dans “Import”, choisir la source du fichier. Le système affiche les colonnes attendues et peut détecter automatiquement le format.
| Format | Quand choisir |
|---|---|
| Notre CSV | Un fichier “Export” KKOROCHE ou votre modèle avec short_name, long_url… |
| Linkly | CSV ou export depuis Linkly : slug, url, name, domain, password… |
| Bitly | CSV depuis Bitly (Destination URL, Custom Link) ou export API (long_url, custom_bitlink, title) |
| Linkly (clics) | Résumé quotidien des clics — met à jour uniquement les stats des liens existants ; ne crée pas de nouveaux liens |
| Détection auto | Le système détecte le format (le nôtre, Linkly ou Bitly) à partir des en-têtes de la première ligne |
- Choisir un format adapté.
- Déposer un CSV (ou .csv.gz) dans la zone d’envoi ou cliquer sur “Choisir un fichier”.
- Après l’envoi, ouvrir “Correspondance des champs” — vérifier que vos colonnes correspondent aux champs KKOROCHE.
- Configurer les options d’import, lancer la validation, puis importer.
Formats d’import disponibles et zone de dépôt de fichier.
Import : correspondance des champs
“Correspondance des champs” affiche les premières lignes de votre fichier. “Nom court” et “URL longue” sont obligatoires.
- À gauche — champs KKOROCHE, à droite — vos colonnes CSV. Glisser une colonne du fichier sur un champ ou choisir dans la liste.
- Pour Linkly en général : slug → nom court, url → URL longue, name → description, domain → sous-domaine.
- Pour Bitly en général : custom_bitlink ou Custom Link → nom court, long_url ou Destination URL → URL longue, title → description.
- Si un lien a plusieurs destinations de redirection, ajouter long_url_2, long_url_3, et ainsi de suite.
- Avec “Détection auto”, après l’envoi le système indique quel format il a reconnu (le nôtre, Linkly ou Bitly).
- Les correspondances vides n’effacent pas les valeurs par défaut du format choisi — ne changez que ce qu’il faut.
- Les erreurs de correspondance sont surlignées dans la même fenêtre.
- La colonne targets_json sert à l’import JSON avancé des cibles. En général, utilisez long_url et long_url_N.
Correspondance des colonnes CSV aux champs KKOROCHE avec aperçu des données.
Import : paramètres et pré-vérification
Avant de lancer, vous pouvez activer la création de dossiers, l’association de sous-domaine, l’ignorance des lignes supprimées, et une simulation sans enregistrement.
| Paramètre | À quoi ça sert |
|---|---|
| Créer des dossiers | Si le fichier a une structure de dossiers, créer les dossiers manquants dans le projet |
| Associer le sous-domaine | Lier les liens aux sous-domaines du projet par nom depuis le fichier |
| Ignorer les supprimés | Ne pas importer les lignes marquées comme supprimées dans le fichier source |
| En cas d’erreur | “Continuer” — ne pas s’arrêter aux erreurs de ligne ; “Arrêter” — interrompre à la première erreur |
| Vérification (pré-estimation) | Pré-estimation : si les limites du plan suffisent, si les sous-domaines requis existent, et le volume total |
| Simulation | Tester l’import sans enregistrer — voir seulement ce qui se passerait |
- Après la correspondance des champs, ouvrir “Paramètres d’import”.
- Si besoin, créer les sous-domaines manquants à partir de la liste affichée après la vérification.
- Lancer “Vérifier” → corriger les avertissements → cliquer sur “Importer”.
ATTENTION : la pré-vérification ne scanne pas le fichier pour les doublons. Si le projet a déjà les mêmes noms courts, ces lignes sont ignorées, pas remplacées.
Paramètres d’import et bouton de vérification.
Résultat et erreurs
Après la fin de l’import ou de l’export, un résumé affiche créés, mis à jour, ignorés et erreurs. Un statut court apparaît aussi en haut de la section.
- Si un nom court existe déjà dans le projet, la ligne est ignorée comme doublon. Le rapport inclut un avertissement correspondant.
- Si tout le fichier est composé de doublons, vous voyez “Rien créé” avec une explication claire.
- Pour les erreurs de ligne, vous pouvez télécharger un journal d’erreurs (errors.ndjson.gz) avec le problème et la cause par ligne.
- Export : en cas de succès — “Télécharger”. Import : résumé sans fichier (sauf le journal d’erreurs le cas échéant).
Résultat de l’import : créés, ignorés et avertissements.
Boucle complète : export → import
Le CSV issu de “Export” du lien est le moyen recommandé pour sauvegarder et déplacer des liens entre projets d’un même compte.
- Exporter “Liens” avec les colonnes par défaut (short_name, long_url, subdomain, description, tags…).
- Dans un autre projet, ouvrir “Import” → choisir “Notre CSV” ou “Détection auto” → envoyer le fichier.
- La correspondance des champs se remplit automatiquement. Activez “Créer des dossiers” et “Associer le sous-domaine” si besoin.
- Lancer la vérification, puis importer. Les noms courts existants sont ignorés — pour actualiser les données, modifiez les liens manuellement ou supprimez les anciens avant l’import.
Les mots de passe ne sont pas transférés depuis l’export (seul un indicateur « a un mot de passe »). Définissez un nouveau mot de passe dans les paramètres du lien si besoin.