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

Vous pouvez créer des propriétés qui renseignent les données en fonction des calculs d'autres propriétés. Grâce aux propriétés calculées, vous pouvez définir des équations personnalisées en fonction d'autres propriétés. Avec les propriétés résumées, vous pouvez calculer automatiquement le minimum, le maximum, la somme, le nombre et la moyenne pour une propriété pour les fiches pertinentes.

Par exemple, vous pouvez créer :

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

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é calculée ou résumée :

• Dans votre compte HubSpot, cliquez sur 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 données de base de votre propriété, puis cliquez sur le Type de champ onglet.
• Pour créer une équation personnalisée ou une équation de temps écoulé, sélectionnez Calcul comme type de champ. Sélectionnez le Type de propriété calculée que vous souhaitez utiliser depuis le menu déroulant :
  • É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.

• • 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.
  • Temps depuis/jusqu’à (BÊTA) : calculez les valeurs en fonction d’une propriété et du temps écoulé depuis ou jusqu’à la date d’aujourd’hui. En savoir plus sur la création de ce type de propriété de calculée .
• Pour créer une propriété qui calcule le minimum, le maximum, le nombre, la somme ou la moyenne, sélectionnez Résumé. Cliquez sur le menu déroulant Type de regroupement et sélectionnez le type de formule que vous souhaitez créer. Découvrez-en davantage sur la création de ces types de propriétés.

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 tous les enregistrements associés à cet objet ou pour des libellés d'association spécifiques ,, , y compris les associations avec le même objet.

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 regroupement 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.
• Si vous sélectionnez Currency comme format pour une propriété de transaction, la propriété utilisera par défaut le format Company currency de votre compte. Pour utiliser la devise de chaque fiche d'informations d'une transaction, sélectionnez la case à cocher Utiliser la devise de la fiche d'informations plutôt que la devise de l'entreprise. L'utilisation d'une devise de fiche d'informations n'a d'incidence que sur l'affichage de la valeur et n'entraîne pas l'application automatique d'un taux de change.

• Sélectionnez l'objet associé et la propriété de la fiche d'informations associée pour calculer la propriété en conséquence. 
• Pour effectuer un calcul basé uniquement sur les fiches d'informations à un libellé spécifique, cliquez sur Sélectionner les libellés d'associations, puis sélectionnez les libellés que vous souhaitez inclure.
• 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.

Remarque : les valeurs de durée brutes sont stockées en millisecondes. Si vous utilisez une propriété calculée de durée dans d'autres outils HubSpot (filtres, formules de propriété calculée), vous devrez peut-être utiliser des valeurs en millisecondes.

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.

Si vous essayez de créer une propriété basée sur la date d'aujourd'hui, découvrez comment utiliser le temps relatif dans les propriétés et les filtres.

• 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 Calcul.

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é.
• Sur un enregistrement (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 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).

Vous pouvez créer votre équation personnalisée avec des opérateurs arithmétiques, des opérateurs de comparaison, des opérateurs logiques, des instructions conditionnelles et d'autres fonctions. Ces équations peuvent renvoyer des valeurs numériques, booléennes, des chaînes ou des dates. Découvrez-en davantage sur les opérateurs et les fonctions disponibles et sur le formatage de vos formules. 

Pour créer une propriété de calcul d'équation personnalisée :

• Cliquez sur le menu déroulant Type de propriété calculée, puis sélectionnez Équation personnalisée.
• 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.

Remarque : Le type de sortie sélectionné doit correspondre au type de sortie affiché en haut à droite de l'éditeur, sinon vous ne pourrez pas créer la propriété. Pour les propriétés renvoyant une date, vous pouvez utiliser le type de sortie sous forme de date ou de nombre qui détermine comment les valeurs sont affichées (cela signifie que le format de nombre affiche la date en millisecondes, tandis que le format de date affiche la date formatée).

• Si vous avez sélectionné le type de sortie 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.
  • Si vous sélectionnez Devise comme format de nombre pour une propriété, la propriété utilisera le format de votre compte Société devise par défaut. Pour utiliser la devise de chaque fiche d'informations d'une transaction, sélectionnez la case à cocher Utiliser la devise de la fiche d'informations plutôt que la devise de l'entreprise.

Remarque : L'utilisation d'une devise de fiche d'informations n'a d'incidence que sur l'affichage de la valeur et n'entraîne pas l'application automatique d'un taux de change. Pour ajouter un taux de change, vous pouvez inclure les fonctions exchange_rate ou dated_exchange_rate dans votre équation.

• 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.
• Pour prévisualiser le résultat de votre formule, cliquez sur Tester la formule.

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. Dans cette situation, on peut utiliser les fonctions if et is_known pour fixer la valeur à 0 à la place.

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

Syntaxe d'équation personnalisée

Dans l'éditeur de formules, 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 et revoir quelques exemples de formules couramment utilisé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, les nombres, les constantes booléennes et les constantes de date 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.

• Date littérale : une date en millisecondes. Par exemple : 1698508800000.

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 une valeur interne de Test_score, vous devez la saisir dans l'éditeur sous la forme [properties.Test_score].

Lors de l'utilisation des propriétés de l'énumération dans une équation (par exemple, sélection déroulante, sélection radio) :

• Les valeurs sont considérées comme des chaînes et doivent donc être placées entre guillemets. Par exemple : "subscriber".
• Vous devez utiliser le nom interne des options de propriété. Par exemple : "appointmentscheduled".

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.

Exemples

Vous trouverez ci-dessous des exemples de formules basées sur des cas d'utilisation courants.

• Vous pouvez configurer des instructions « if else », y compris des instructions avec des conditions multiples et des fonctions internes :
  • if([properties.number] < 4, "less than four", "more than four")
  • if([properties.number] < 4, if([properties.other_number] < 2, "both true", "one true"), "not true")
  • concatenate(if([properties.number] < 4, "less", "more"), " than four")
• À partir d'une propriété de nombre dans une formule personnalisée, vous pouvez inclure les fonctions if et is_known pour définir la valeur à 0 lorsque la propriété de nombre est vide. Par exemple : if(is_known([properties.number]), [properties.number], 0).
• Lorsque vous utilisez une devise de fiche d'informations dans une formule, pour ajouter un taux de change, vous pouvez inclure les fonctions exchange_rate ou dated_exchange_rate dans votre équation. Par exemple : [properties.amount] * exchange_rate('CAD').