Créer des propriétés calculées et résumées

Vous pouvez créer des propriétés qui renseignent les données en fonction des calculs 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. Les propriétés calculées permettent d'établir des équations basées sur le temps écoulé entre, jusqu'à ou depuis les valeurs d'une propriété, ou de créer des équations personnalisées basées sur les propriétés d'un objet. 

Remarque : Votre compte peut utiliser des noms personnalisés pour chaque objet (par exemple, compte au lieu d’entreprise). Ce document fait référence aux objets par leur nom par défaut HubSpot.

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 ; 
• Une propriété de transaction qui calcule le temps écoulé depuis l'ouverture de la transaction.

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

Créez des propriétés de regroupement basées sur les propriétés des 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é des 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 associations d’objets identiques.

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.

1. Dans votre compte HubSpot, cliquez sur l'icône Paramètres settings dans la barre de navigation principale.

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

3. 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.

4. Saisissez les informations de base concernant votre propriété, puis cliquez sur l’onglet Type de champ.
5. Sélectionnez Résumé.
6. 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é.
7. 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.
8. Si vous sélectionnez Devise comme format pour une propriété de transaction, la propriété utilisera par défaut la devise de l’entreprise de votre compte. Pour utiliser la devise de chaque fiche d’informations de 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 affecte uniquement la façon dont la valeur est affichée et n’appliquera pas automatiquement un taux de change.
9. Sélectionnez l'objet associé et la propriété de la fiche d'informations associée pour calculer la propriété en conséquence. 
10. 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.
11. Pour ajouter des conditions supplémentaires, cliquez sur Ajouter une condition. Lorsque des conditions supplémentaires sont configurées, celles-ci doivent être remplies pour que la propriété soit calculée (par exemple, si Montant > de la transaction la plus récente est égal à 1 000 et Probabilité de la >transaction = 80). Vous pouvez configurer jusqu’à 50 conditions par propriété de résumé.
    • 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 Enregistrer.
12. 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.

Créer des propriétés calculées Délai entre, Depuis le ou Jusqu'à

Vous pouvez créer des propriétés qui calculent le temps entre deux dates ou qui suivent le temps écoulé depuis ou jusqu'à une date, selon les valeurs de date ou des propriétés du sélecteur de date et heure. Les propriétés Délai entre ne sont prises en charge que pour les propriétés du même objet.

Par exemple :

• Créez une propriété Délai entre pour calculer le temps entre le moment où le propriétaire d'un ticket a été attribué et le moment où le ticket a été fermé.
• Créez une propriété Depuis le pour suivre la durée d'ouverture d'une transaction.
• Créez une propriété Jusqu'à pour suivre la durée jusqu'à laquelle un client doit conclure.

Pour créer une propriété dont les valeurs affichent l'heure relative en fonction de la date du jour plutôt que d'une valeur de propriété, découvrez comment créer une propriété de sélection de date et heure relative/date et heure. Vous pouvez également créer une propriété d’heure fixe à l’aide d’une équation personnalisée.

Pour créer des propriétés Délai entre, Depuis le ou Jusqu'à :

1. Dans votre compte HubSpot, cliquez sur l'icône Paramètres settings dans la barre de navigation principale.

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

3. 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.

4. Saisissez les informations de base pour votre propriété , puis cliquez sur l'onglet Type de champ.
5. Sélectionnez Calcul comme type de champ.
6. Cliquez sur le menu déroulant Type de propriété calculée, puis sélectionnez le type et configurez le calcul :
   • Délai entre : sélectionnez les propriétés Date de début et Date de fin.
   • Depuis le : sélectionnez la propriété du sélecteur de date et d'heure dont la valeur sera la date de début. La date de fin sera toujours la date du jour.
   • Jusqu'à : sélectionnez la propriété du sélecteur de date et d'heure dont la valeur sera la date de fin. La date de début sera toujours la date du jour.
7. Pour Durée entre les propriétés uniquement, pour ajouter une condition supplémentaire, cliquez sur Ajouter une condition. Lorsque des conditions supplémentaires sont configurées, celles-ci doivent être remplies pour que la propriété soit calculée (par exemple, si Montant > de la transaction la plus récente est égal à 1 000 et Probabilité de la >transaction = 80).
   • 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 Enregistrer.
8. Cliquez sur Créer. Une fois créé, le type de champ affiché de la propriété sera Calcul. À l'avenir, vous ne pourrez plus choisir entre Délai entre, Depuis le ou Jusqu'à, mais vous pouvez sélectionner des propriétés différentes de date de début ou de fin.

Le comportement suivant est attendu lors de l'affichage des valeurs de durée :

• 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é.
• La valeur affichée sera en secondes, minutes, heures, jours, mois ou années en fonction de seuils spécifiques. Les seuils pour les unités sont les suivants :
  • 2,5 ans ou plus s'affichera en années.
  • 3 mois ou plus s'affichera en mois.
  • 1 jour ou plus s'affichera en jours.
  • 2,5 heures ou plus s'affichera en heures.
  • 2,5 minutes ou plus s'affichera en minutes.
  • Moins de 2,5 minutes s'affichera en secondes.

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.

Créer des propriétés calculées d'équation personnalisées

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, de chaîne, de date ou d’heure. Découvrez-en davantage sur les opérateurs et fonctions disponibles ainsi que sur le formatage de vos formules. Vous pouvez également consulter des exemples de formules couramment utilisées.

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

1. Dans votre compte HubSpot, cliquez sur l'icône Paramètres settings dans la barre de navigation principale.

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

3. 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.

4. Saisissez les informations de base concernant votre propriété, puis cliquez sur l’onglet Type de champ.
5. Sélectionnez Calcul comme type de champ.
6. Cliquez sur le menu déroulant Type de propriété calculée, puis sélectionnez Équation personnalisée.
7. 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, Date ou Date Heure.

Remarque : Le type de résultat sélectionné doit correspondre au type de résultat affiché dans l’angle supérieur droit de l’éditeur, sinon vous ne pouvez 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).

8. 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 numérique pour une propriété de transaction, la propriété utilisera par défaut la devise de l’entreprise de votre compte. Pour utiliser la devise de chaque fiche d’informations de transaction, sélectionnez la case à cocher Utiliser la devise de la fiche d’informations plutôt que la devise de l’entreprise .

9. 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 l’équation, sélectionnez Propriétés, puis sélectionnez une propriété. Vous pouvez créer des équations personnalisées uniquement à l’aide des propriétés de l’objet pour lequel vous créez la propriété.
10. 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.
11. Pour prévisualiser le résultat de votre formule, cliquez sur Tester la formule.
12. Cliquez sur Créer. Une fois créé, le type de champ affiché de la propriété sera Calcul.

Syntaxe d'équation personnalisée

• Syntaxe littérale : à l’aide de données littérales, vous pouvez ajouter des chaînes de texte, des nombres et des valeurs vrai ou faux à 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 le score du test propriété , qui a une valeur interne de Test_score, vous devez le saisir dans l'éditeur sous la forme [properties.Test_score].
  • Lors de l’utilisation de propriétés d’énumération dans une équation (par exemple, sélection déroulante, bouton radio), les valeurs sont considérées comme des chaînes et doivent donc être placées entre guillemets (« par exemple, "subscriber"« ) et you doit également utiliser le nom interne des options de propriété (par exemple, "appointmentscheduled").
  • Lors de l’utilisation de propriétés de date dans une équation, les valeurs sont stockées au format UTC minuit en millisecondes.
  • Lors de l’utilisation de propriétés de date et d’heure dans une équation, les valeurs sont stockées en tant qu’epoch UTC en millisecondes. Cette valeur s’affiche en fonction de votre fuseau horaire. Cela signifie que les utilisateurs de fuseaux horaires différents verront des valeurs différentes.

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.

Analyser des exemples d’équations personnalisées

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

Utiliser des fonctions if else

Vous pouvez configurer des fonctions if else, y compris des fonctions soumises à plusieurs conditions et dans des fonctions.

Par exemple, vous pouvez créer un calcul pour libeller les transactions actives. Ce qui suit ne renverra Vrai que si le statut d’une transaction est actif et que le montant est supérieur à zéro.

• if([properties.amount] < 0 && [properties.dealstage] == "qualifiedtobuy", "True", "False")

Exécuter les calculs de valeurs nulles 

Lorsque vous utilisez des propriétés numériques dans une formule personnalisée, vous pouvez inclure les if fonctions et is_known pour définir la valeur à 0 lorsque la propriété numérique est vide. De cette façon, votre calcul s’effectue quelle que soit la propriété contenant une valeur nulle. Par exemple :

•  if(is_known([properties.number]), [properties.number], 0).
  
  

Ajouter le taux de change au calcul d’une devise

Lorsque vous utilisez une devise d’enregistrement dans une formule, pour ajouter un taux de change, vous pouvez inclure les exchange_rate fonctions ou dated_exchange_rate dans votre équation. Par exemple :

• [properties.amount] * exchange_rate('CAD').

Créer un calcul d’heure fixe 

Vous pouvez configurer un calcul pour obtenir le temps fixe entre deux dates. Par défaut, la valeur brute est renvoyée en millisecondes. Vous pouvez utiliser la division et la round_nearest fonction pour formater en heures, jours, etc. et éliminer les décimales dans la valeur finale. Par exemple, ce qui suit renverra une valeur de jour fixe :

• round_nearest((((((([properties.closedate]-[properties.createdate]) / 1000) / 60) ) /60) /24), 0).

Remarque : Il est recommandé d’être précis lors de la saisie du nom et de la description de la propriété. De cette façon, les utilisateurs sont informés du temps calculé (par exemple, heures ou jours).