Import CSV. Leads & Deals

Quand utiliser l'import CSV

L'import CSV est votre meilleur allié dans trois situations :

• Migration depuis un autre outil : Vous quittez un CRM ou un outil de tracking concurrent et voulez récupérer votre historique
• Import de données historiques : Vous avez des mois (voire des années) de données dans des fichiers Excel ou Google Sheets
• CRM non supporté nativement : Metrikia intègre nativement 6 CRM. Si le vôtre n'en fait pas partie, l'import CSV est la solution

> Astuce pro : Même si votre CRM est supporté nativement, l'import CSV reste utile pour charger des données historiques antérieures à la date de connexion de l'intégration.

Import de leads

Téléchargez le template

Rendez-vous dans Paramètres > Import > Leads et cliquez sur Télécharger le template CSV. Le fichier contient les colonnes attendues avec des exemples.

Champs requis

Un lead doit avoir au minimum l'un de ces identifiants :

• Email (recommandé, meilleure précision de déduplication)
• Téléphone (format international ou national français accepté)
• Prénom + Nom (si ni email ni téléphone disponible)

Champs optionnels

Champ	Format attendu	Exemple
firstName	Texte	Jean
lastName	Texte	Dupont
email	Email valide	jean@example.com
phone	E.164 ou national	+33612345678 ou 0612345678
source	Texte libre	Meta Ads
status	new / qualified / converted / lost	qualified
createdAt	ISO 8601	2025-06-15
Champs personnalisés	Texte, nombre ou date	Toute colonne supplémentaire

Processus d'upload

• Glissez-déposez votre fichier CSV (ou cliquez pour parcourir)
• Metrikia affiche un aperçu des 5 premières lignes
• L'interface de mapping de colonnes s'ouvre (voir section dédiée)
• Validez le mapping et lancez l'import
• Une barre de progression affiche l'avancement en temps réel
• À la fin, un rapport d'import résume : lignes importées, mises à jour, ignorées, erreurs

Import de deals

Champs requis

Champ	Description
Lead (email)	Email du lead associé. Metrikia retrouve le lead existant par matching
Valeur du deal	Montant en euros (avec ou sans décimales)
Statut	open / won / lost

Champs optionnels

Champ	Format attendu
Lignes de deal (line items)	Nom et montant de chaque ligne
Échéancier de paiement	Dates et montants des paiements prévus
Closer assigné	Email du closer dans votre équipe
Date de création	ISO 8601
Date de clôture	ISO 8601

> Astuce pro : Importez toujours vos leads AVANT vos deals. Un deal doit être rattaché à un lead existant. Si le lead référencé par email n'existe pas, la ligne sera en erreur.

Logique de déduplication

C'est la fonctionnalité la plus puissante de l'import CSV. Metrikia ne crée pas de doublons, il reconnaît les leads existants grâce au hachage PII (Personally Identifiable Information).

Comment ça fonctionne

Metrikia utilise HashedPii pour comparer les données importées avec les leads existants :

• Hash email (score : 1.0) : L'email est normalisé (minuscules, suppression des points Gmail, gestion du +alias) puis hashé. C'est l'identifiant le plus fiable.

• Hash téléphone (score : 0.8) : Le numéro est normalisé au format E.164 pour la France : préfixe +33, suppression du 0 initial. Ainsi, 0612345678, +33612345678 et 06 12 34 56 78 sont reconnus comme le même numéro.

• Hash nom (score : 0.6) : Le nom est normalisé via le translitérateur ICU NFD : les accents sont supprimés, la casse est harmonisée. Jean-François et jean francois matchent.

Scoring de correspondance

Metrikia calcule un score de correspondance (LeadMatchScore) basé sur les hashes disponibles :

• Email seul : score 1.0 → Match
• Téléphone seul : score 0.8 → Match
• Nom seul : score 0.6 → Pas de match (sous le seuil)
• Téléphone + Nom : score 1.4 → Match

Le seuil de correspondance est 0.8. Au-dessus, le lead existant est mis à jour. En dessous, un nouveau lead est créé.

Mapping de colonnes

Détection automatique

Metrikia reconnaît automatiquement les noms de colonnes courants :

Votre colonne	Champ Metrikia détecté
email, e-mail, courriel	Email
nom, last_name, lastname	Nom
prénom, prenom, first_name	Prénom
téléphone, telephone, phone	Téléphone
date, created_at, date_creation	Date de création

Mapping manuel

Pour les colonnes non reconnues, l'interface de mapping vous permet de :

• Associer chaque colonne à un champ Metrikia
• Créer un champ personnalisé à la volée
• Ignorer une colonne (ne pas l'importer)

Bonnes pratiques

• Testez avec 10 lignes d'abord. Importez un petit échantillon pour vérifier que le mapping et la déduplication fonctionnent correctement avant de lancer l'import complet.

• Incluez l'email pour la meilleure précision. L'email est l'identifiant le plus fiable pour la déduplication (score 1.0). Sans email, Metrikia doit s'appuyer sur le téléphone ou le nom, moins précis.

• Utilisez le format de date ISO 8601 (YYYY-MM-DD). Les formats ambigus comme 01/02/2025 (janvier ou février ?) provoquent des erreurs.

• Valeurs monétaires en euros avec décimales (1500.00) ou en centimes (150000). Metrikia détecte et convertit automatiquement.

• Encodage UTF-8 obligatoire. Si votre fichier vient d'Excel, exportez en "CSV UTF-8" pour préserver les accents et caractères spéciaux.

Résolution de problèmes

Erreurs courantes

Erreur	Cause	Solution
"Format de date invalide"	Date au format DD/MM/YYYY ou MM/DD/YYYY	Convertir en YYYY-MM-DD
"Numéro de téléphone invalide"	Numéro avec espaces ou tirets non standards	Utiliser le format +33XXXXXXXXX
"Lead non trouvé pour le deal"	L'email du deal ne correspond à aucun lead	Importer les leads d'abord
"Doublon inattendu"	Même personne avec email différent et pas de téléphone	Ajouter le téléphone pour améliorer le matching
"Encodage incorrect"	Caractères spéciaux corrompus (é au lieu de é)	Réexporter en UTF-8 depuis Excel

> Astuce pro : Après un import massif, consultez le rapport d'import dans Paramètres > Import > Historique. Vous y trouverez le détail ligne par ligne des créations, mises à jour et erreurs. C'est le meilleur moyen de vérifier que vos données sont propres.