Comprendre les mappages de champs de synchronisation de vos données
Dernière mise à jour: octobre 28, 2024
Disponible avec le ou les abonnements suivants, sauf mention contraire :
Tous les produits et les abonnements |
Toutes les applications de synchronisation de données ont un ensemble de mappages de champs qui permettent de maintenir la synchronisation des données entre HubSpot et votre application tierce. Pour connaître les mappages par défaut disponibles pour une application, consultez la page d'inscription del'application sur la place de marché.
Si vous avez un abonnement payant à Operations Hub, vous pouvez créer et personnaliser les mappages des champs de synchronisation des données
Examinez ci-dessous comment les propriétés HubSpot se synchronisent avec les champs des applications tierces, et vice versa :
Propriétés HubSpot | ✔ | Champs d'applications tierces |
Texte | ✔ | Texte |
Nombre | ✔ | Nombre |
Sélectionneur de dates | ✔ | Sélectionneur de dates |
Date et heure | ✔ | Date et heure |
Sélectionneur de dates | ✔ | Date et heure |
Date et heure | ✔ | Sélectionneur de dates |
Une seule case à cocher | ✔ | Booléen |
Case d'option | ✔ | Case d'option |
Menu déroulant | ✔ | Liste de sélection |
En outre, les champs suivants de votre application tierce peuvent être mappés d'une manière unidirectionnelle à n'importe quel champ de texte HubSpot :
- Nombre
- Sélectionneur de dates
- Date et heure
- Une seule case à cocher
- Dans la plupart des applications, c'est également le cas pour les champs propriétaires.
Les types de propriété HubSpot suivants peuvent être mappés dans un sens en tant que texte vers les champs de texte de votre application tierce (certains d'entre eux peuvent être mappés dans les deux sens vers différents types de champs dans votre application tierce)
- Nombre
- Sélectionneur de dates
- Date et heure
- Une seule case à cocher
- Plusieurs cases à cocher
- Calcul (nombre)
- Score (nombre)
Remarque : toutes les propriétés de sélection déroulante ne peuvent pas être synchronisées dans les deux sens entre HubSpot et votre application tierce. Dans ce cas, la propriété de sélection de la liste déroulante ne peut être mappée que d'une seule manière, sous forme de texte, dans le champ de texte de votre application tierce.
Pour certaines applications tierces, HubSpot n'est pas en mesure de modifier les champs pour les raisons suivantes :
- Limitations de l'API de l'application tierce.
- Champs en lecture seule dans l'application tierce.
Dans ce cas, ces champs seront mis en correspondance dans un seul sens entre HubSpot et votre application tierce.
Examiner les mappages de champs de synchronisation des données par défaut
Certains types de propriété ont des règles et des considérations supplémentaires. Examinez ci-dessous les exigences spécifiques de certains mappages de champs par défaut.
Propriétés du nom
HubSpot dispose de propriétés de contact distinctes pour le prénom et le nom. Si votre application tierce n'a qu' une seule propriété pour le nom du contact, la synchronisation des données considérera le premier mot du nom complet comme le Prénom dans HubSpot, et tout ce qui vient après le premier espace sera synchronisé avec la propriété Nom.
Application tierce | HubSpot |
Nom complet : John Jacob Jingleheimer Schmidt | Prénom : John Nom de famille : Jacob Jingleheimer Schmidt |
Remarque : les mappages de champ pour les propriétés First Name et Last Name doivent être activés pour que le nom du contact soit correctement synchronisé entre HubSpot et votre application tierce.
Propriétés du propriétaire
Les propriétaires des enregistrements d'objets sont synchronisés à l'aide de la propriété E-mail . S'il n'y a pas d'adresse e-mail, HubSpot utilisera le champ Nom pour ces propriétaires. Les propriétaires d'enregistrements doivent être configurés en tant qu'utilisateurs à la fois dans HubSpot et dans votre application tierce pour que la synchronisation des données fonctionne. Si un utilisateur existe dans une application et pas dans l'autre, les données ne seront pas synchronisées.
Si vous avez un abonnement payant Operations Hub vous pouvez associer le champ Propriétaire de votre application tierce à n'importe quelle propriété utilisateur personnalisée de HubSpot.
Propriétés de la sélection déroulante
Lorsqu'une synchronisation est créée pour la première fois entre HubSpot et votre application tierce, HubSpot synchronisera toutes les valeurs et options de la propriété déroulante à ce moment-là. HubSpot ne mettra pas automatiquement à jour les propriétés de la liste déroulante lorsque de nouvelles options sont ajoutées. Pour mettre à jour les propriétés de la liste déroulante, vous devez enregistrer et relancer la synchronisation entre HubSpot et votre appli tierce.
Lorsqu'une synchronisation est créée pour la première fois entre HubSpot et votre application tierce, HubSpot synchronisera toutes les valeurs et options de la propriété "dropdown/multiple checkbox" à ce moment-là. HubSpot ne mettra pas automatiquement à jour les propriétés lorsque de nouvelles options sont ajoutées. Pour mettre à jour les propriétés des cases à cocher déroulantes/multiples, vous devez enregistrer et relancer la synchronisation entre HubSpot et votre application tierce.
Propriétés Adresse, Pays et Région
HubSpot structure la propriété Street Address comme une propriété de type texte à une ligne, et la propriété Country/Region comme une propriété de type liste déroulante. En raison de divergences dans la façon dont les autres applications acceptent le formatage de ces propriétés, les propriétés d'adresse peuvent être synchronisées en tant que mappages à sens unique de l'application tierce à HubSpot.
Mappages d'association
En activant les mappings d'association, vous synchroniserez toutes les associations d'enregistrements de HubSpot à votre application tierce, et vice versa. Par exemple, les contacts seront associés à leurs enregistrements respectifs de sociétés ou de transactions. Pour empêcher les associations de se faire, désactivez le mappage d'association. Les correspondances d'associations ne peuvent pas être modifiées ou supprimées.
Numéro de téléphone
Certaines applications stockent plusieurs valeurs pour une propriété sous des libellés différents. Par exemple, une seule propriété Téléphone aura plusieurs libellés pour "Travail", "Domicile", et "Mobile". En revanche, HubSpot dispose des trois propriétés de contact par défaut suivantes : Numéro de téléphone, numéro de téléphone portable et numéro de fax.
Si un enregistrement est créé dans HubSpot par l'application tierce, le numéro de téléphone qui est listé en premier dans l'application tierce sera synchronisé avec la propriété Numéro de téléphone dans HubSpot. Tout numéro de téléphone supplémentaire ne sera pas synchronisé, à moins qu'il ne soit libellé comme mobile ou fax. Dans ce cas, ils seront synchronisés avec les propriétés Numéro de téléphone mobile et Numéro de fax respectivement.
Tant qu'il existe un numéro de téléphone correspondant dans HubSpot et dans l'autre application, le numéro de téléphone de cet enregistrement est considéré comme synchronisé entre HubSpot et l'application tierce.
Si aucun des numéros de téléphone ne correspond, HubSpot suivra la logique des paramètres de conflit de la synchronisation. Si la synchronisation est définie par défaut sur HubSpot, le numéro de téléphone sera ajouté à la liste des numéros de téléphone dans l'application tierce. Si la synchronisation se fait par défaut avec l'application tierce, le numéro de téléphone dans HubSpot sera remplacé par le numéro figurant en premier dans votre application tierce.
Lorsque HubSpot crée un nouvel enregistrement dans votre application tierce, le Libell de travail sera appliqué par défaut.
Unités opérationnelles
Si vous disposez du module complémentaire Business Units, vous pouvez établir une correspondance de champ bidirectionnelle entre la propriété Business Units dans HubSpot et n'importe quelle case à cocher multiple personnalisée ou n'importe quel champ de texte dans l'application tierce.
Les étapes de l'opération, le statut du ticket ou le statut de la commande
Pour synchroniser les propriétés deal stage, ticket status ou order status, le champ correspondant dans votre champ tiers doit correspondre au Libellé de la propriété HubSpot. Par exemple, si votre étape de transaction dans HubSpot est Closed Won (Sales Pipeline), le champ de votre application tierce doit refléter le même libellé.