Configurer des champs personnalisés depuis votre CRM

Metrikia couvre quatre concepts universels (lifecycle, deal stage, deal amount, date de closing) via l'assistant de mapping CRM. Pour tout le reste, par exemple un montant financé en leasing, un flag "client signé en ligne", une date de premier contact, ouvrez l'étape Champs personnalisés et déclarez ces champs vous-même. La donnée atterrit dans leads.metadata côté Metrikia et reste exploitable par vos vues et exports.

Prérequis

• Votre CRM HubSpot est connecté à Metrikia et une synchronisation initiale a déjà tourné.
• Vous êtes propriétaire ou administrateur du tenant Metrikia.
• Les propriétés HubSpot que vous voulez capturer existent et sont remplies sur au moins un contact.

Étape 1 : Ouvrir l'assistant

1. Allez sur /app/settings, onglet Intégrations.
2. Trouvez votre connexion HubSpot dans Mes connexions.
3. Cliquez sur Configurer le mapping sous la tuile HubSpot.
4. Passez les étapes 1 à 3 si elles sont déjà configurées (champ source, analyse, mapping).
5. Sur l'étape Champs personnalisés (badge "Optionnel" dans le stepper), la liste de vos mappings actifs s'affiche.

Étape 2 : Ajouter un mapping

Dans la section Ajouter un mapping, remplissez les trois champs :

• Champ source CRM : choisissez la propriété HubSpot dans la liste déroulante. Le code technique (par exemple montant_finance) est affiché à côté du libellé.
• Clé métadonnée Metrikia : tapez la clé que Metrikia stockera. Exemple : financed_amount_ht. Lettres minuscules, chiffres, underscores et points uniquement, 60 caractères max.
• Type de valeur : indiquez comment Metrikia doit interpréter la donnée. Cinq types disponibles : 
  • Texte : valeur brute, par exemple "Premium".
  • Montant (€) : Metrikia parse 18 750,00 €, 18750.00, négatifs autorisés, conversion en centimes en interne.
  • Booléen (oui/non) : reconnaît oui, non, true, false, 1, 0.
  • Date : ISO 8601 ou formats courants (2026-03-14, 14/03/2026).
  • Nombre entier : pour scores, durées en mois, etc.

Cliquez Enregistrer. Le mapping apparaît immédiatement dans la table Mappings actifs.

Exemple concret : montant financé

Vous gérez du leasing immobilier et vos dossiers signés portent un montant_finance dans HubSpot. Vous voulez l'exposer dans Metrikia pour vos calculs de mROAS internes :

1. Champ source CRM : montant_finance.
2. Clé métadonnée Metrikia : financed_amount_ht.
3. Type de valeur : Montant (€).
4. Enregistrer.

À partir du prochain contact synchronisé, la valeur est capturée dans leads.metadata.financed_amount_ht côté Metrikia, normalisée en centimes.

Limites

• 100 mappings maximum par intégration. Un compteur en haut de la liste passe en orange à partir de 80, puis en rouge à 95. Si vous atteignez la limite, supprimez un mapping inutilisé.
• Une même propriété source ne peut être mappée qu'une fois. Si le champ que vous cherchez n'apparaît pas dans la liste déroulante, c'est qu'il est déjà mappé.
• Une même clé Metrikia ne peut être réutilisée. Choisissez un nom unique par concept (financed_amount_ht, pas amount réutilisé partout).

Supprimer un mapping

Cliquez sur l'icône poubelle d'une ligne. Une confirmation détaille la conséquence : Metrikia n'extraira plus cette propriété aux prochaines synchronisations, mais les valeurs déjà enregistrées sur vos leads existants restent en place.

Backfill des leads existants

Quand vous ajoutez un nouveau mapping, seuls les contacts modifiés ou créés après l'ajout reçoivent automatiquement la valeur. Pour appliquer rétroactivement à tous vos leads déjà importés, contactez le support Metrikia : l'équipe peut déclencher une resynchronisation complète qui retraverse l'historique HubSpot.

Cas d'erreur fréquents

• "Format invalide" sur la clé : votre clé contient des espaces, des majuscules ou des caractères spéciaux. Remplacez par des underscores, par exemple financed amount devient financed_amount.
• "Ce champ source est déjà mappé" : vous avez déjà créé un mapping pour cette propriété. Cherchez-le dans la table active et modifiez-le si besoin (suppression puis recréation pour changer le type).
• La valeur attendue n'apparaît pas dans le lead : vérifiez que le contact HubSpot a bien la propriété renseignée. Metrikia ne crée pas la clé tant que la valeur source est vide.

Idées et roadmap

Pour proposer un type supplémentaire (par exemple PERCENT, URL, ENUM), passez par Idées et Roadmap dans les paramètres pour qu'on priorise l'évolution.