Ignorer et passer au contenu principal
Avertissement : cet article est le résultat de la traduction automatique, l'exactitude et la fidélité de la traduction ne sont donc pas garanties. Pour consulter la version originale de cet article, en anglais, cliquez ici.

Créer et utiliser des ensembles de données

Dernière mise à jour: novembre 17, 2021

Disponible avec :

Operations Hub Entreprise

Un ensemble de données est une collection de données provenant de votre compte HubSpot qui peut ensuite être utilisée dans des rapports personnalisés. Un ensemble de données peut inclure des propriétés pour les objets CRM et les actifs HubSpot, ainsi que des formules pour calculer vos données si nécessaire. Par exemple, vous pouvez créer un champ pour calculer le revenu récurrent annuel en fonction de la propriété du montant de la transaction. 

La création de plusieurs ensembles de données pour vos équipes signifie que les créateurs de rapports ne devront pas sélectionner leurs sources de données à chaque fois qu'ils doivent créer un rapport. Un jeu de données peut également être mis à jour après sa création, ce qui permet de mettre à jour tous les rapports utilisant ce jeu de données en même temps.

Découvrez ci-dessous comment créer un jeu de données, comment utiliser le jeu de données dans le rapport et les définitions des fonctions disponibles dans l'outil Jeux de données.

Créer un jeu de données

Pour créer un ensemble de données :

  • Dans votre compte HubSpot, accédez à Reports > Datasets.
  • Dans le coin supérieur droit, cliquez sur Créer un ensemble de données.

Vous serez alors dirigé vers l'onglet " Join" du constructeur d'ensembles de données.

Regrouper

Tout d'abord, sélectionnez les sources de données à inclure dans votre ensemble de données. Les sources de données sont les objets, les ressources et les événements pour lesquels vous souhaitez créer un rapport. Cela inclut tous les objets CRM tels que les contacts ou les objets personnalisés, et les actifs tels que les pages et les e-mails du site Web, les conversations, les activités de vente, etc. Vous pouvez sélectionner jusqu'à 5 sources de données par ensemble de données.

La source de données primaire sera le point central de l'ensemble de données, toutes les autres sources de données étant liées à cette source primaire. Pour connecter ces sources de données, HubSpot joint les données en arrière-plan en utilisant le chemin le plus court possible. Les contacts et les transactions, par exemple, sont directement liés et peuvent être sélectionnés sans qu'aucune jointure supplémentaire ne soit nécessaire. 

Cependant, d'autres sources de données ne peuvent pas être associées directement et nécessitent des sources supplémentaires pour joindre les données. Par exemple, si votre source principale est Deals et que vous souhaitez inclure des données sur les articles de blog dans le rapport, HubSpot ne peut relier ces sources qu'à travers les sources Contacts et Activités Web. Ces autres sources seront sélectionnées automatiquement pour rejoindre les données.

  • Pour sélectionner la source de données primaire, cliquez sur le menu déroulant Source de données primaire, puis sélectionnez une source de données  

    datasets-join-tab0
  • Continuez à sélectionner des sources de données supplémentaires. Dans le panneau de droite, vous pouvez visualiser les relations entre les sources de données actuellement sélectionnées.
  • Au fur et à mesure que vous sélectionnez les sources, consultez le volet d' aperçu au bas de l'écran pour avoir un aperçu de vos données. 
  • Après avoir sélectionné vos sources de données, dans le coin supérieur droit, cliquez sur Suivant.

Préparer

Sélectionnez les champs à inclure dans l'ensemble de données. Vous pouvez ajouter des propriétés HubSpot existantes à l'ensemble de données, ainsi que des champs de formule personnalisés.

Ajoutez des propriétés

  • Pour ajouter des propriétés à l'ensemble de données, faites glisser et déposez les propriétés de la barre latérale de gauche dans la section Construire votre ensemble de données.

2021-10-28_11-28-34 (1)

  • Pour renommer une propriété ou afficher un aperçu de ses données, cliquez sur la propriété sous Construire votre ensemble de données, puis saisissez un nouveau nom dans le champ prévu à cet effet sur la droite. Renommer une propriété mettra à jour son nom uniquement dans cet ensemble de données. Cela vous permet de personnaliser la façon dont ces champs apparaissent dans le générateur de rapports, mais n'aura aucun impact sur le nom de la propriété existante.

Ajouter des champs de formule

Les champs de formule sont spécifiques à l'ensemble de données et peuvent être utilisés pour calculer des valeurs basées sur les propriétés de l'ensemble de données. En savoir plus sur la construction de formules à l'aide d'expressions flexibles.

  • Pour créer un champ de formule, cliquez sur Créer un champ de formule

    création d'une formule de données - champ 0
  • À droite, saisissez un nom pour le champ.
  • Dans le champ Formule, saisissez votre formule. Vous pouvez faire référence à des propriétés que vous avez ajoutées à l'ensemble de données ainsi qu'à d'autres propriétés HubSpot en dehors de l'ensemble de données, et utiliser des fonctions pour effectuer des calculs sur la base des propriétés et des données littérales. Vous trouverez ci-dessous de plus amples informations sur la syntaxe et les définitions des formules.
    • Pour saisir manuellement votre formule, commencez à taper dans le champ Formule. Par défaut, HubSpot affiche les options de complétion automatique lorsque vous saisissez du texte. Pour désactiver l'auto-complétion, décochez la case Afficher le guidage de la formule

      dataset-formule-field-auto-complete0
    • Pour insérer une propriété que vous avez ajoutée à l'ensemble de données, cliquez sur le menu déroulant du champ Créé, puis sélectionnez la propriété.
    • Pour insérer une propriété qui n'est pas dans l'ensemble de données, cliquez sur le menu déroulant de la propriété HubSpot, puis sélectionnez la propriété.
    • Pour insérer une fonction, cliquez sur le menu déroulant Fonction, puis sélectionnez une fonction.
options du champ de la formule0
  • Lorsque vous créez des formules, le champ Formule affiche un état de validation. Lorsqu'une formule n'est pas valide, un indicateur d'état rouge s'affiche et vous pouvez cliquer sur Validation pour afficher les détails de l'erreur
    validation du champ de la formule de données0
  • Une fois que vous avez configuré vos champs, cliquez sur Suivant en haut à droite.

Filtrer

Affinez davantage vos données en ajoutant des filtres à vos champs.

Pour ajouter un filtre :

  • Dans la barre latérale gauche, cliquez et faites glisser champs dans les Filtres inactifs inactifs.
  • Cliquez sur un champ pour afficher ses options de filtrage. Sélectionnez un filtre puis cliquez sur Appliquer.
  • Vous pouvez regrouper des filtres en cliquant sur un champ, puis sur le menu déroulantGrouper avec un autre filtre. Sélectionnez un autre filtre actif puis cliquez sur Appliquer.

groupe de données-filtres0

    • Vous pouvez modifier le regroupement des filtres par et ou ou logique en cliquant sur le sélecteur de logique entre les filtres, puis en sélectionnant et ou ou

      ensembles de données-et-ou-filtre0
    • Pour dégrouper des filtres, cliquez sur un filtre, puis sur le menu déroulant Grouper avec un autre filtre. Sélectionnez Aucun, puis cliquez sur Appliquer.
  • Après avoir configuré vos filtres, cliquez sur Suivant.

Analyse

Examinez votre ensemble de données avant de l'enregistrer. 

  • Sous Sources, affichez les sources de données que vous avez sélectionnées. 
  • Sous Champs, affichez les champs de l'ensemble de données. Elle inclut :
    • Champ: le nom du champ.
    • Dérivé : si le champ est un champ HubSpot standard ou un champ calculé personnalisé.
    • Type de données : le type de données contenues dans le champ.
    • Entrée : l'expression du champ.
    • Source : la source des données (par exemple, les contacts).
  • Dans le panneau Aperçu, affichez l'aperçu de vos données. Vous pouvez cliquer sur Afficher les relations du tableau pour voir comment les données sont connectées.
  • Après avoir examiné vos données, enregistrez l'ensemble de données en cliquant sur Enregistrer.
  • Dans le panneau de droite, saisissez un nom et une description pour l'ensemble de données.
  • Cliquez sur Appliquer.

Vous serez alors amené au constructeur de rapport où vous pourrez créer un rapport en fonction de votre ensemble de données.

Afficher et gérer des ensembles de données

Dans le tableau de bord des ensembles de données, vous pouvez afficher et modifier les ensembles de données existants.

  • Dans votre compte HubSpot, accédez à Reports > Datasets.
  • Vous pouvez filtrer vos ensembles de données existants en utilisant les filtres situés en haut du tableau.
  • Pour modifier un ensemble de données, passez la souris sur l'ensemble de données, puis cliquez sur Modifier. Vous serez alors amené à la page des détails de l'ensemble de données.
    • Dans l'onglet Aperçu, affichez un aperçu des données de l'ensemble de données. 
    • Dans l'onglet Métadonnées, affichez les sources de données et les champs inclus dans l'ensemble de données. Elle inclut :
      • Champ: le nom du champ.
      • Dérivé : si le champ est un champ HubSpot standard ou un champ calculé personnalisé.
      • Type de données : le type de données contenues dans le champ.
      • Entrée : la chaîne de caractères utilisée pour amener les données dans le champ.
      • Source : la source des données (par exemple, les contacts).
    • Dans l'onglet Rapports, affichez les rapports qui ont été créés à l'aide de l'ensemble de données.
    • À partir de la page de détails des ensembles de données, vous pouvez également créer un nouveau rapport en utilisant l'ensemble de données en cliquant sur Construire un rapport.

Créer un rapport en utilisant un jeu de données

Une fois qu'un jeu de données a été créé, vous pouvez créer un rapport basé sur ce jeu de données, soit à partir du générateur de rapports, soit à partir de l'outil de création de jeux de données.

  • Pour créer un rapport à partir d'un ensemble de données :
  • Pour créer un rapport à partir du constructeur de rapports personnalisés :
    • Depuis votre compte HubSpot, accédez à Rapports > Rapports.
    • Dans l'angle supérieur droit, cliquez sur Créer un rapport personnalisé.
    • Dans la barre latérale gauche, sélectionnez Générateur de rapports personnalisés.
    • À droite, cliquez sur l'onglet Parcourir les jeux de données pour afficher vos jeux de données existants

      parcourir les bases de données - onglet 0
    • Sélectionnez l' ensemble de données que vous souhaitez utiliser, puis cliquez sur Suivant.

Référence

Syntaxe

Dans une fonction, vous pouvez utiliser des données provenant de propriétés et de champs ou des données littérales. Les données relatives aux propriétés et aux champs seront dynamiques en fonction des sources de données individuelles, tandis que les données littérales sont constantes. Par exemple :

  • 2021-03-05 est une date littérale, qui est constante.
  • [CONTACT.createdate] est une date basée sur une propriété, qui est dynamique pour chaque enregistrement de contact.

Les fonctions peuvent inclure des données littérales et des données de type propriété/champ, pour autant que les types de données soient compatibles avec les arguments requis de la fonction. Par exemple :

DATEDIFF("MONTH", "2021-01-01", "[CONTACT.createdate]")

Découvrez ci-dessous la syntaxe des littéraux et des données de propriétés/champs, ainsi que la manière de les intégrer dans des formules.

Syntaxe littérale

Utilisez les littéraux pour ajouter des chaînes de texte spécifiques et statiques, des chiffres, des valeurs vraies ou fausses et des dates dans vos calculs.

  • Chaîne littérale : texte entouré de guillemets. Par exemple, "My cool string".
  • Chiffre littéral : chiffres sans guillemets. Par exemple, 42.
  • Littéral booléen : vrai ou faux.
  • Date littérale : une chaîne de caractères formatée en tant que "YYY-MM-DD", ou un numéro d'horodatage (par exemple, 1635715904). 

Syntaxe des propriétés

Les références aux propriétés vous permettent d'inclure directement les valeurs des propriétés de vos sources de données sélectionnées. Vous n'avez pas besoin d'ajouter la propriété en tant que champ de l'ensemble de données pour la référencer. 

Utilisez la syntaxe suivante pour référencer les propriétés :

  • Les expressions de référence sont toujours entourées de crochets ( [ et ] ).
  • Les références de propriété spécifient le nom de l'objet ou de l'événement, suivi d'un point et du nom de la propriété interne. Par exemple :
    • [CONTACT.lifecyclestage]
    • [Nom de l'entreprise]
    • [e_hs_scheduled_email_v2.__hs_event_native_timestamp]

Syntaxe des références de champ

Vous pouvez faire référence à des champs dans une formule en entourant le nom du champ de crochets. Par exemple :

    • [Champ 1]
    • [Mon super champ personnalisé]

Vous pouvez faire référence à des champs dans des formules, à condition que les opérateurs et les fonctions de la formule acceptent le type de données du champ. Par exemple, si vous créez un nouveau champ qui contient une chaîne de caractères, vous pouvez faire référence à ce champ dans une fonction qui accepte les chaînes de caractères :

  • Si le champ 1 est [DEAL.name], il contient une valeur de type chaîne de caractères (le nom de l'opération).
  • CONCAT([Champ 1], "Q4") serait valide car il contient deux valeurs de chaîne.
  • CONCAT([DEAL.name], 2012) ne serait pas valide car il contient à la fois une chaîne de caractères et une valeur numérique.

Opérateurs

Vous pouvez utiliser les opérateurs avec des valeurs littérales et des valeurs de propriétés/champs, et les opérateurs sont évalués dans l'ordre standard des opérations PEMDAS. Cela vous permet d'imbriquer les opérateurs en utilisant des parenthèses. Par exemple :

  • Ajout d'un nombre avec une référence de propriété : 1 + [DEAL.amount]
  • Utilisation des parenthèses pour imbriquer des opérations : (1 + 2) * (3 + 4)
Opérateur Description Exemple d'utilisation

+

Ajoutez des chiffres. Renvoie un nombre.

1 + 1
= 2

[DEAL.amount] + 100

-

Soustraire des nombres. Renvoie un nombre.

100 - 1
= 99

EXP(1) - EXP(1)
= 0

WEEKNUM([DEAL.closedate]) - WEEKNUM([DEAL.createdate])

*

Multipliez les nombres. Renvoie un nombre.

2 * 2
= 4

POW(10, 2) * -1
= -100

[DEAL.amount] * 0.5

/

Divisez des nombres. Renvoie un nombre.

10/ 2
= 5

[DEAL.amount] / DATEDIFF("DAY", [DEAL.createdate], [DEAL.closedate])

-

Négation d'un nombre.

-100
= -100

-[montant.DEAL]

&&

Vérifie si les deux valeurs booléennes sont vraies. Renvoie un booléen.

vrai && faux
= faux

CONTAINS("HubSpot", "Hub") && CONTAINS("HubSpot", "Spot")
= true

CONTAINS("HubSpot", "Hub") && CONTAINS("HubSpot", "CRM")
= false

||

Vérifie si l'une ou l'autre de deux valeurs booléennes est vraie. Renvoie un booléen.

vrai || faux
= true

CONTAINS("HubSpot", "Hub") || CONTAINS("HubSpot", "CRM")
= true

CONTAINS("HubSpot", "Sales") && CONTAINS("HubSpot", "Marketing")
= false

!

Négatifie une valeur booléenne. Renvoie une autre valeur booléenne.

!vrai
= false

==

Opérateur d'égalité. Renvoie une valeur booléenne.

==vrai
= vrai

Fonctions numériques

Fonction Définition Arguments Exemple d'utilisation

ABS

Calculer la valeur absolue d'un nombre. Renvoie un nombre.

ABS(nombre)

nombre : le nombre dont il faut prendre la valeur absolue.

ABS(-10)
= 10

ABS(10)
= 10

PLAFOND

Arrondir une valeur décimale à l'entier le plus proche. Renvoie un nombre.

PLAFOND(nombre)

le nombre : le numéro à prendre en compte pour le plafond.

PLAFOND(3.14)
= 4

PLAFOND(EXP(1))
= 3

CEIL(LN([DEAL.amount]))

DIV0

Divise un nombre, mais renvoie zéro lorsque le diviseur est zéro. Renvoie un nombre.

DIV0(dividende, diviseur)

dividende : le nombre à utiliser comme dividende dans l'opération de division.

diviseur : le nombre à utiliser comme diviseur dans l'opération de division, le zéro donnant lieu à une valeur globale nulle

DIV0(5, 2)
= 2.5

DIV0(5, 0)
= 0

DIV0([DEAL.amount], DATEDIFF("DAY", [DEAL.createdate], [DEAL.closedate]))

EXP

Ordinateur Nombre d'Euler élevé à une valeur. Renvoie un nombre.

EXP(exposant)

exponent : l'exposant pour élever le nombre d'Euler à.

EXP(1)
= 2,718281828459045

EXP(0)
= 1

PLANCHER

Arrondir une valeur décimale au nombre entier le plus proche. Renvoie un nombre

FLOOR(nombre)

nombre : l'exposant pour élever le nombre d'Euler.

PLANCHER(3.14)
= 3

PLAFOND(EXP(1))
= 2

FLOOR(LN([DEAL.amount]))

LN

Calculez le logarithme naturel d'une valeur. Renvoie un nombre.

LN(nombre)

nombre : la valeur à prendre en compte pour le logarithme naturel.

LN(1)
= 0

LN(EXP(1))
= 1

LN([DEAL.amount])

LOG

Calculez le logarithme d'une valeur dans une base spécifiée. Renvoie un nombre.

LOG(base, valeur)

base : la base à utiliser pour le calcul du logarithme de la valeur.

valeur : le nombre dont il faut prendre le logarithme.

LOG(10, 1)
= 0

LOG(10, 10)
= 1

LOG(10, [DEAL.amount])

POWER

Augmenter une valeur de base à une puissance spécifiée. Renvoie un nombre.

POWER(base, exposant)

base : le nombre dont il faut calculer la puissance.

exposant : le nombre par lequel on élève la base.

POWER(2, 10)
= 1024

PUISSANCE(100, 0.5)
= 10

POWER([DEAL.hs_arr], 2)

SQRT

Prendre la racine carrée d'un nombre non négatif. Renvoie un nombre.

SQRT(nombre)

nombre : le nombre dont il faut prendre la racine carrée.

SQRT(100)
= 10

SQRT([DEAL.hs_arr])

LARGEUR_BACHETTE

Répartissez les valeurs numériques dans des cases de même largeur. Renvoie le numéro du seau dans lequel se trouve la valeur.

Si la valeur renvoyée est inférieure au minimum, elle renvoie zéro. Si la valeur renvoyée est supérieure au maximum, elle renvoie le nombre de seaux +1.

WIDTH_BUCKET(valeur, minValue, maxValue, bucketCount)

valeur : le nombre à calculer dans le numéro d'emplacement.

minValue : la valeur minimale à partir de laquelle le binning doit commencer.

maxValue : la valeur maximale à atteindre.

bucketCount : le nombre souhaité de cases de largeur égale pour classer les valeurs entre la valeur minimale et la valeur maximale. 

LARGEUR_SEAU(25, 0, 100, 10)
= 3

LARGEUR_SEAU(95, 0, 100, 10)
= 10

LARGEUR_BUCKET(-1000, 0, 100, 10)
= 0

LARGEUR_BUCKET(9999, 0, 100, 10)
= 11

WIDTH_BUCKET([DEAL.amount], 0, 10000, 1000)

Fonctions des chaînes

Fonction Définition Arguments Exemple d'utilisation

CONTIENT

Déterminez si une chaîne de caractères contient une sous-chaîne. Renvoie une valeur booléenne.

CONTAINS("chaîne de caractères", "substring")

string : la valeur de la chaîne à tester.

substring : la valeur à vérifier à l'intérieur de la chaîne.

CONTAINS("HubSpot", "Hub")
= true

CONTAINS("foo", "bar")
= faux

CONTAINS([CONTACT.prénom], "Mike")

CONCAT

Concaténation de deux chaînes de caractères. Renvoie une chaîne de caractères.

CONCAT("chaîne1", "chaîne2")

chaîne1 : la valeur de la chaîne à laquelle la chaîne2 sera ajoutée.

string2 : la valeur de la chaîne à ajouter à string1.

CONCAT("Hub", "Spot")
= "HubSpot"

CONCAT([CONTACT.prénom], CONCAT(" ", [CONTACT.nom de famille]))

LONGUEUR

Calculer la longueur d'une chaîne de caractères. Renvoie un nombre.

LENGTH("chaîne")

string : la valeur de la chaîne de caractères dont il faut calculer la longueur.

LENGTH("HubSpot")
= 7

LENGTH([FEEDBACK_SUBMISSION.hs_content])

TRIM

Supprime les espaces de tête et de queue d'une chaîne de caractères. Renvoie une chaîne de caractères.

TRIM(" chaîne ")

string: la valeur de la chaîne de caractères dont il faut couper les espaces.

TRIM(" Les chats sont géniaux ")
= "Les chats sont géniaux"

Fonctions de date

Fonction Définition Arguments Exemple d'utilisation

DATE_FROM_PARTS

Créez une valeur de date à partir des parties année, mois et jour. Renvoie une date.

DATE_FROM_PARTS(année, mois, jour)

année : la partie année de la date souhaitée.

mois : la partie du mois de la date souhaitée.

jour : la partie jour de la date souhaitée.

DATE_FROM_PARTS(2021, 1, 1)
= 2021-01-01

DATEDIFF

Renvoie le nombre d'unités de temps entre la première valeur de date et la seconde pour une unité de temps spécifiée. Renvoie un nombre.

DATEDIFF("datePart", "date1", "date2")

datePart : l'unité d'année, de trimestre, de mois, de semaine ou de jour à utiliser dans le calcul de la différence. 

date1 : la valeur de la date de départ à soustraire de date2.

date2 : la valeur de la date de fin à laquelle la date1 sera soustraite.

DATEDIFF("JOUR", "2021-01-01", "2021-02-01")
= 31

DATEDIFF("MOIS", "2021-01-01", DATE_FROM_PARTS(2021, 2, 1))
= 1

DATEDIFF("QUARTER", [DEAL.createdate], [DEAL.closedate])

DATEPART

Extrait l'année, le trimestre, le mois, la semaine ou le jour d'une valeur de date. Renvoie un nombre.

DATEPART("datePart", "date")

datePart : l'unité d'année, de trimestre, de mois, de semaine ou de jour à extraire.

date : la valeur de la date dont il faut extraire une partie de la date.

DATEPART("DAY", "2021-03-15")
= 15

DATEPART("MONTH", DATE_FROM_PARTS(2021, 3, 15))
= 3

DATEPART("YEAR", [DEAL.createdate])

DATETRUNC

Tronquez une valeur de date à son année, son trimestre, son mois, sa semaine ou son jour.

DATETRUNC("datePart", "date")

datePart : l'unité d'année, de trimestre, de mois, de semaine ou de jour à tronquer.

date : la valeur de la date à tronquer.

DATETRUNC("ANNÉE", DATE_FROM_PARTS(2021, 3, 15))
= 2021-01-01

DATETRUNC("MOIS", "2021-03-15")
= 2021-03-01

DATETRUNC("DAY", [e_visited_page.__hs_event_native_timestamp])

TIMESTAMP_FROM_PARTS

Créez une valeur d'horodatage à partir des parties année, mois, jour, heure, minute et seconde. Renvoie une valeur de date.

TIMESTAMP_FROM_PARTS(année, mois, jour)

année : la partie année de la date souhaitée.

mois : la partie du mois de la date souhaitée.

jour : la partie jour du jour souhaité. 

TIMESTAMP_FROM_PARTS(2021, 1, 1)
= 2021-01-01

WEEKNUM

Calculer le numéro de semaine dans l'année pour une date. Renvoie un nombre.

WEEKNUM("date")

date : la valeur de la date avec laquelle le numéro de semaine dans une année est calculé.

WEEKNUM("2021-03-15")
= 11

WEEKNUM("1609459200")
= 11

WEEKNUM("[deal.createdate]")

MAINTENANT

Renvoie l'heure actuelle en fonction du fuseau horaire de votre compte. Renvoie une valeur de date.

NOW()

 

MAINTENANT()
= 1633611966314