Créer des propriétés calculées

Les propriétés de calcul dans HubSpot vous permettent de calculer automatiquement le minimum, le maximum, le total, la somme ou la valeur moyenne pour les propriétés sur les fiches d'informations associées ou de configurer des équations personnalisées basées sur d'autres propriétés. 

Par exemple, vous pouvez créer :

• une propriété de contact qui calcule le montant moyen des transactions associées à un contact ; 
• une propriété d'entreprise qui calcule le coût d'acquisition d'un nouveau client sur la base d'une équation personnalisée.

Remarque : En fonction de votre abonnement HubSpot, le nombre de propriétés calculées que vous pouvez créer est limité.

Créer des propriétés calculées

Les propriétés de calcul peuvent être définies en fonction de différents critères, notamment les valeurs des propriétés des fiches d'informations associées, le temps écoulé entre les valeurs de deux propriétés ou vos propres équations personnalisées. Pour créer une propriété de calcul :

• Depuis votre compte HubSpot, accédez à l'icône Paramètres settings dans la barre de navigation principale.

• Dans le menu latéral de gauche, accédez à Propriétés.

• Cliquez sur le menu déroulant Sélectionner un objet, puis sélectionnez Propriétés [objet] pour créer une propriété pour cet objet.

• Saisissez les informations de base concernant votre propriété, puis cliquez sur Suivant.
• Sélectionnez Calcul pour le type de champ. Une fois qu'une propriété Calcul est créée, le type de champ ne peut pas être modifié.
• Cliquez sur Créer un calcul.
• Sélectionnez le Type de propriété calculée que vous souhaitez utiliser depuis le menu déroulant :
  • Min, Max, Nombre, Somme, Moyenne : calculez des valeurs basées sur les propriétés des fiches d'informations associées. Découvrez-en davantage sur la création de ces types de propriétés calculées.
  • Délai entre : calcule des valeurs basées sur le temps entre deux propriétés du sélecteur de date dans le même objet. Découvrez-en davantage sur la création de ce type de propriété de calcul.
  • Arrondi inférieur uniquement, Arrondi supérieur uniquement, Arrondir au plus proche : calculez des valeurs en fonction de l'arrondissement des propriétés de score, de calcul ou de nombre d'un même objet. Découvrez-en davantage sur la création de ce type de propriété de calcul.
  • Équation personnalisée : calculez des valeurs basées sur une équation personnalisée. Découvrez-en davantage sur la création de ce type de propriété de calcul.

Calculer des valeurs selon des propriétés de fiches d'informations associées

Vous pouvez créer des propriétés pour un objet qui seront calculées en fonction de certaines valeurs de propriétés de fiches d'informations associées à cet objet. Vous pouvez effectuer le calcul sur la base de toutes les fiches d'informations associées à cet objet ou pour des libellés d'association spécifiques, y compris les relations parent-enfant des entreprises.

Par exemple, vous pouvez créer une propriété de transaction qui comptabilise le nombre total d'activités de vente enregistrées pour les contacts associés à une transaction avec le libellé Décisionnaire.

• Cliquez sur le menu déroulant Type de propriété calculée et sélectionnez l'un des types suivants :
  • Minimum : affiche la valeur minimum pour la propriété numérique sélectionnée pour les fiches d'informations associées de l'objet sélectionné.
  • Maximum : affiche la valeur maximum pour la propriété numérique sélectionnée pour toutes les fiches d'informations associées de l'objet sélectionné.
  • Nombre : compte le nombre total de fiches d'informations associées de l'objet sélectionné ayant une valeur de propriété de nombre sélectionnée.
  • Somme : additionne les valeurs de la propriété de nombre sélectionnée sur toutes les fiches d'informations associées de l'objet sélectionné.
  • Somme : calcule la moyenne des valeurs de la propriété de nombre sélectionnée sur toutes les fiches d'informations associées de l'objet sélectionné.
• Pour choisir le format des valeurs de la propriété, cliquez sur le menu déroulant Format de nombre, puis sélectionnez l'un des formats suivants : Numéro formaté, Numéro non formaté, Devise, Pourcentage ou Durée.

Veuillez noter : toutes les propriétés de calcul utilisant Devise comme format de nombre utiliseront la Société devisede votre compte. 

• Pour ajouter une condition supplémentaire, cliquez sur Créer une condition. Lorsqu'une condition supplémentaire est configurée, cette condition doit être remplie pour que la propriété soit calculée (par exemple, si Montant de la transaction la plus récente est supérieur à 1 000).
  • Dans le premier menu déroulant, sélectionnez une propriété.
  • Dans le deuxième menu déroulant, sélectionnez un opérateur qui comparera la valeur de la première propriété à un nombre ou à la valeur d'une autre propriété.
  • Dans le troisième menu déroulant, sélectionnez une propriété ou saisissez un nombre qui sera comparé à la première propriété.

• Cliquez sur Créer. Une fois créé, le type de champ affiché de la propriété sera Relatif.

Calculer des valeurs en fonction du temps écoulé entre deux propriétés

Vous pouvez créer des propriétés qui calculent le temps entre deux propriétés de sélection de date sélectionnées dans le même objet. Par exemple, vous pouvez calculer le temps écoulé entre le moment où le propriétaire d'un ticket a été assigné et le moment où le ticket a été fermé. Découvrez-en davantage sur l'affichage des valeurs des propriétés calculées Délai entre.

• Cliquez sur le menu déroulant Type de propriété calculée et sélectionnez Délai entre.
• Cliquez sur les menus déroulants pour sélectionner les propriétés Date de début et Date de fin.

• Pour ajouter une condition supplémentaire, cliquez sur Créer une condition. Lorsqu'une condition supplémentaire est configurée, cette condition doit être remplie pour que la propriété soit calculée (par exemple, si Montant de la transaction la plus récente est supérieur à 1 000).
  • Dans le premier menu déroulant, sélectionnez une propriété.
  • Dans le deuxième menu déroulant, sélectionnez un opérateur qui comparera la valeur de la première propriété à un nombre ou à la valeur d'une autre propriété.
  • Dans le troisième menu déroulant, sélectionnez une propriété ou saisissez un nombre qui sera comparé à la première propriété.
• Cliquez sur Créer. Une fois créé, le type de champ affiché de la propriété sera Relatif.

Le comportement suivant est attendu lors de l'affichage des valeurs des propriétés calculées Délai entre :

• La durée sera affichée différemment dans différents outils HubSpot.
• Pour les propriétés de date sans horodatage, l'heure par défaut utilisée dans le calcul sera minuit (UTC) pour le jour sélectionné.
• Dans un enregistrement d'objet (par exemple, un enregistrement de contact ), la valeur affichée sera exprimée en heures, jours, mois, ou années, et sera arrondie à l'unité supérieure en fonction de seuils spécifiques. Par exemple, si le temps calculé est d'un mois et vingt jours, la valeur affichée sera Un mois, mais si le temps calculé est d'un mois et vingt-sept jours, la valeur affichée sera Deux mois. Les seuils sont les suivants :
  • 45 secondes ou plus sont arrondies à une minute
  • 45 minutes ou plus sont arrondies à une heure
  • 22 heures ou plus sont arrondies à un jour
  • 26 jours ou plus sont arrondis à un mois
  • 11 mois ou plus sont arrondis à un an
• Dans les rapports personnalisés qui utilisent une propriété avec ce type de champ, la valeur affichée sera en jours. Par exemple, si le temps calculé est un an et vingt jours, la valeur affichée sera 385 jours.

Remarque : Dans HubSpot, les valeurs brutes des types de propriété Délai entre et Moyenne seront en millisecondes. Si une équation avec ces valeurs génère une valeur supérieure à celle prévue, utilisez un convertisseur de millisecondes pour convertir selon l'unité de temps voulue.

Calculer des valeurs en fonction de l'arrondi des valeurs des propriétés

Vous pouvez créer des propriétés calculées qui spécifient comment arrondir les valeurs numériques d'autres propriétés. Par exemple, vous pouvez créer une propriété calculée qui arrondit une propriété de commission aux deux décimales les plus proches.

• Cliquez sur le menu déroulant Type de propriété calculée et sélectionnez une option d'arrondi :
  • Arrondi inférieur uniquement : toujours arrondir les valeurs au nombre de décimales spécifié. 
  • Arrondi supérieur uniquement : toujours arrondir les valeurs au nombre de décimales spécifié.
  • Arrondir au plus proche : arrondir les valeurs au nombre de décimales spécifié le plus proche en fonction de la proximité.
• Pour choisir le format des valeurs de la propriété, cliquez sur le menu déroulant Format de nombre, puis sélectionnez l'un des formats suivants : Numéro formaté, Numéro non formaté, Devise, Pourcentage ou Durée.

• Cliquez sur le menu déroulant Choisissez la propriété de la fiche d'informations, puis sélectionnez la propriété contenant les valeurs que vous souhaitez arrondir. Vous pouvez sélectionner n'importe quelle propriété de score, de calcul ou de nombre dans cet objet.
• Dans la zone de texte Décimales à arrondir, saisissez le nombre de décimales auxquelles vous souhaitez que les valeurs soient arrondies.

Remarque : Pour les propriétés monétaires, cette fonction arrondira la valeur à la précision choisie, mais affichera toujours les valeurs sous forme de devise avec le nombre correct de chiffres.

• Pour ajouter une condition supplémentaire, cliquez sur Créer une condition. Lorsqu'une condition supplémentaire est configurée, cette condition doit être remplie pour que la propriété soit calculée (par exemple, si Montant de la transaction la plus récente est supérieur à 1 000).

• • Dans le premier menu déroulant, sélectionnez une propriété.
  • Dans le deuxième menu déroulant, sélectionnez un opérateur qui comparera la valeur de la première propriété à un nombre ou à la valeur d'une autre propriété.
  • Dans le troisième menu déroulant, sélectionnez une propriété ou saisissez un nombre qui sera comparé à la première propriété.
• Cliquez sur Créer. Une fois créé, le type de champ affiché de la propriété sera Calcul.

Calculer des valeurs sur la base d'une équation personnalisée

Vous pouvez également créer des propriétés qui calculent des valeurs en fonction de vos propres critères. Les équations personnalisées ne peuvent être définies que pour les propriétés de nombre au sein du même objet pour lequel vous créez la nouvelle propriété. Par exemple, vous pouvez créer une équation pour calculer le montant de la transaction la plus récente d'une entreprise (Montant de la transaction la plus récente) par rapport au nombre de fois où votre entreprise a contacté l'entreprise (Nombre de fois où l'entreprise a été contactée).

Pour créer votre équation, vous pouvez utiliser les menus déroulants avec des options prédéfinies ou utiliser l'éditeur en mode avancé pour écrire des équations avec des opérateurs arithmétiques, des opérateurs de comparaison, des opérateurs logiques, des instructions conditionnelles et d'autres fonctions. Découvrez-en davantage sur les opérateurs et les fonctions disponibles ainsi que sur le formatage de vos formules.

• Cliquez sur le menu déroulant Type de propriété calculée, puis sélectionnez Équation personnalisée.
• Pour créer une équation avec les options de menu déroulant :
  • Cliquez sur le menu déroulant Format de nombre, puis sélectionnez la manière de formater les valeurs de la propriété. Vous pouvez sélectionner l'un des éléments suivants : Nombre formaté, Nombre non formaté, Devise, Pourcentage ou Durée.

• • Utilisez le menu déroulant pour choisir une propriété numérique ou saisissez un nombre et cliquez sur l'option Constante : [valeur saisie] pour l'ajouter à l'équation.
  • Utilisez le menu déroulant de fonction pour sélectionner une opération : addition (+), soustraction (-), multiplication (*) ou division (/).
  • Pour ajouter une autre fonction à l'équation, cliquez sur Ajouter à l'équation. Vous pouvez également ajouter d'autres fonctions à une partie de l'équation en cliquant sur Développer entre parenthèses.

• Pour créer une équation dans l'éditeur en mode avancé :
  • Cliquez pour activer le bouton Mode avancé.

• • Cliquez sur la liste déroulante Type de résultat, puis sélectionnez le type de résultat que votre calcul renverra. Vous pouvez sélectionner l'un des éléments suivants : Nombre, Booléen, Chaîne ou Date. 
  • Si vous avez sélectionné le type de résultat Nombre, cliquez sur le menu déroulant Format de nombre, puis sélectionnez la manière de formater les valeurs de la propriété. Vous pouvez sélectionner l'un des éléments suivants : Nombre formaté, Nombre non formaté, Devise, Pourcentage ou Durée.

• • Dans l'éditeur, insérez, saisissez ou collez des fonctions et des propriétés pour créer votre équation personnalisée. Découvrez-en davantage sur la syntaxe des équations de calcul personnalisées. Pour insérer des éléments de formule :
    
    • Cliquez sur le menu déroulant Insérer.
    • Pour insérer des fonctions dans votre équation, sélectionnez Fonctions, puis sélectionnez une fonction.
    • Pour insérer des propriétés dans votre équation, sélectionnez Propriétés, puis sélectionnez une propriété. Vous ne pouvez créer des équations personnalisées qu'en utilisant des propriétés du même objet que celui pour lequel vous créez la propriété.

• • Si votre équation comporte des erreurs, cliquez sur [x] erreurs au-dessus de l'éditeur pour voir les raisons des erreurs. Vous ne pourrez pas créer la propriété si votre équation comporte des erreurs non résolues. Découvrez-en davantage sur le formatage de vos équations.

Remarque : Si l'une des propriétés numériques utilisées dans une équation personnalisée n'a aucune valeur ou a une valeur nulle, le calcul ne s'exécutera pas et la valeur de la propriété calculée sera vide. La valeur sera vide même si un nombre constant est inclus dans l'équation.

• Pour ajouter une condition supplémentaire, cliquez sur Créer une condition. Lorsqu'une condition supplémentaire est configurée, cette condition doit être remplie pour que la propriété soit calculée (par exemple, si Montant de la transaction la plus récente est supérieur à 1 000).
  • Dans le premier menu déroulant, sélectionnez une propriété.
  • Dans le deuxième menu déroulant, sélectionnez un opérateur qui comparera la valeur de la première propriété à un nombre ou à la valeur d'une autre propriété.
  • Dans le troisième menu déroulant, sélectionnez une propriété ou saisissez un nombre qui sera comparé à la première propriété.

• Cliquez sur Créer. Une fois créé, le type de champ affiché de la propriété sera Calcul.

Syntaxe d'équation personnalisée

Dans le mode avancé, vous pouvez créer vos propres équations personnalisées en utilisant des données littérales, des données provenant d'autres propriétés, des opérateurs et des fonctions. Vous trouverez ci-dessous la syntaxe permettant d'écrire des équations de calcul personnalisées.

Syntaxe littérale

En utilisant des données littérales, vous pouvez ajouter des chaînes de texte, des nombres et des valeurs true ou false à vos équations. Vous pouvez formater les chaînes de caractères, les nombres et les constantes booléennes de la manière suivante :

• Chaîne littérale : texte entouré de guillemets. Il peut s'agir de guillemets simples ('constant') ou doubles ("constant").

• Chiffre littéral : chiffre sans guillemets. Les nombres constants peuvent être n'importe quel nombre réel et peuvent inclure une notation ponctuelle. Par exemple, 1005 et 1.5589 sont tous deux des nombres constants valides.

• Booléen littéral : les booléens constants peuvent être true ou false.

Syntaxe de propriété

Vous pouvez inclure d'autres propriétés du même objet dans votre équation personnalisée. Si une propriété est insérée dans l'éditeur, elle est automatiquement formatée et validée en tant que partie d'une équation.

Si vous choisissez de saisir ou de coller manuellement une propriété dans l'éditeur, elle doit être formatée comme suit : [properties.{propertyInternalName}]. Par exemple, pour ajouter la propriété Test score qui a la valeur interne Test_score, vous devez la saisir dans l'éditeur sous la forme [properties.Test_score].

Opérateurs

Vous pouvez utiliser des opérateurs dans votre équation pour mettre à jour, évaluer ou comparer des constantes et des valeurs de propriété. Lorsque plusieurs opérateurs sont utilisés, ils suivent l'ordre des opérations PEMDAS. Selon le type de données que vous utilisez, vous pouvez inclure les opérateurs suivants dans vos équations personnalisées.

Fonctions

Vous pouvez utiliser des fonctions dans des formules personnalisées pour calculer des valeurs et effectuer des actions avec vos données. Selon le type de données que vous utilisez, vous pouvez inclure les fonctions suivantes dans vos équations personnalisées.