Connecter HubSpot et Google BigQuery (BETA)

• Dans le tableau, sélectionnez les autorisations suivantes et cliquez sur Add :

bigquery.datasets.create
bigquery.datasets.get
bigquery.datasets.getIamPolicy
bigquery.jobs.create
bigquery.tables.create
bigquery.tables.createIndex
bigquery.tables.createSnapshot
bigquery.tables.createTagBinding
bigquery.tables.delete
bigquery.tables.deleteIndex
bigquery.tables.deleteSnapshot
bigquery.tables.update
bigquery.tables.get
storage.buckets.get
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list

• Cliquez sur Créer. 

3. Attribuer le rôle personnalisé au compte Cloud Storage Service

• Cliquez sur le menu de navigation de gauche et sélectionnez Cloud Storage > Buckets. 
• Sélectionnez un seau  à configurer. 
• Cliquez sur l'onglet Permissions.
• Dans l'onglet View by principals, cliquez sur Grant access. 

• Dans le panneau de droite, dans le champ Nouveaux principaux , saisissez le nom du compte de service Google indiqué à l’étape 1.
• Dans la section Attribuer des rôles , cliquez sur le menu déroulant et sélectionnez Personnalisé > <role> . Où <role> le rôle IAM personnalisé a-t-il été créé à l’étape 2. 
• Cliquez sur Enregistrer. Le compte Google Service sera ajouté au rôle Storage Object Viewer . 

4. Accorder au compte Google BigQuery généré par HubSpot les permissions de modifier les tables BigQuery

• Cliquez sur le menu de navigation de gauche et sélectionnez IAM & Admin > IAM. 
• Cliquez sur Grant Access.
• Dans le panneau de droite, dans le champ Nouveaux principaux , saisissez le nom du compte de service Google indiqué à l’étape 1.
• Dans la section Attribuer des rôles , cliquez sur le menu déroulant et sélectionnez Personnalisé > <role> . Où <role> le rôle IAM personnalisé a-t-il été créé à l’étape 2. 

5. Installation complète dans HubSpot

• Dans votre compte HubSpot, cliquez sur Continuer vers Connected Apps. 

• Dans la boîte de dialogue, cochez les cases, puis cliquez sur Autoriser et installer. 

Format de données pour la synchronisation entre HubSpot et Google BigQuery

Données disponibles pour la synchronisation

Vous pouvez synchroniser les données suivantes de HubSpot vers Google BigQuery : 

• Objets : objets standard et personnalisés, tels que les contacts, les entreprises, les tickets ou les produits.
• Enregistrements : enregistrements d'objets individuels. 
• Associations : tous les types d'associations et les enregistrements associés.
• Événements : données d'événements pour les événements standard de HubSpot et les événements comportementaux personnalisés. 
• Listes : Listes de contacts et d'entreprises HubSpot.
• Propriétaires : propriétaires enregistrés. 
• Pipelines : pipelines de transactions et de tickets et étapes du pipeline. 
• Propriétés : propriétés et leurs valeurs sur les enregistrements de l'objet, y compris l'historique des propriétés. 

Les données d'objets de différents types sont organisées et disponibles de deux manières :

• Individu : ehaque type d'objet est stocké dans sa propre table et ne comporte que des enregistrements du même type d'objet. Par exemple, objects_contacts ne contient que des enregistrements de contacts.
• Combiné :Tous les enregistrements de tous les types d'objets sont combinés en un seul objet de la base de données. Ainsi, lors de l'interrogation, vous devez spécifier un filtre tel que "WHERE objectTypeId='0-1'"

Un ID sera attribué aux objets personnalisés au moment de leur création. Ceux-ci seront identifiés comme 2-unique_ID. Par exemple, 2-12345. 

objets_x tables

Chaque type d'objet disponible, y compris les objets personnalisés, possède son propre tableau. Ces tableaux sont nommés selon le format OBJECTS_<object type name> où <object type name> est l'étiquette de la forme plurielle de objecttype(si le type d'objet n'a pas de forme plurielle, <object type name> sera l'étiquette de la forme singulière du nom du type d'objet concaténé avec "S").

Vous trouverez ci-dessous une liste complète des types d'objets HubSpot disponibles, une brève description des données qu'ils représentent et les tables correspondantes.

object_with_object_properties

Ce tableau contient des données provenant de vos enregistrements HubSpot. Vous pouvez obtenir une ligne pour chaque enregistrement d'un type d'objet (par exemple, tous les enregistrements de contacts dans le type d'objet contacts). 

object_properties_history

Ce tableau contient les valeurs historiques des propriétés. Pour les contacts, elle contient les 45 valeurs les plus récentes. Pour tous les autres objets, elle contient les 20 valeurs les plus récentes. Le tableau comporte une ligne pour chaque valeur historique de la propriété. La valeur actuelle d'une propriété est déterminée par l'horodatage UPDATEDAT le plus récent dans l'historique de la propriété.

Questions sur les associations

Comme les données relatives aux objets, les données relatives aux associations sont organisées de deux manières :

• Individuel : Chaque type d'association est stocké dans sa propre table et ne contient que les enregistrements de ce type. Par exemple, associations_contacts_to_deals contient uniquement des enregistrements d'association entre les objets contact et transaction. T
• Combiné : tous les enregistrements pour tous les types d'association sont combinés dans un seul tableau.

associations_x_to_y 

Chaque type d'association a sa propre vue, étiquetée comme associations_<association type name>, par exemple associations_contacts_to_deals.  

association_definitions

Ce tableau contient des informations sur tous les types d'association disponibles entre les objets HubSpot, avec une ligne par type d'association.

property_definitions

Ce tableau contient des informations sur les propriétés des objets  et les propriétés des événements dans votre compte HubSpot. Les propriétés d’événement comprennent des événements standards, tels que les ouvertures d’e-mails et les clics, ainsi que des propriétés d’événements comportementaux personnalisés. Ces informations peuvent être utiles pour définir les valeurs figurant dans les données object_properties et events.

Évènements

Les événements comprennent des événements HubSpot standard et des événements comportementaux personnalisés. Chaque événement a son propre tableau, étiqueté comme suit : events_eventname.

object_and_event_type_definitions

Ce tableau contient les définitions de tous les objets et événements disponibles dans votre compte HubSpot.

Fréquence de synchronisation et organisation des données

Synchronisation des données quotidienne entre HubSpot et Google BigQuery à 0900 UTC +0. Un dossier sera créé pour chaque jour où les données sont synchronisées, avec plusieurs sous-dossiers pour chaque tableau. Les sept dernières synchronisations seront disponibles sur la plateforme Google Cloud et les tables dans BigQuery seront mises à jour pour pointer vers le dernier vidage de panier.

Chacun des tableaux suivants sera disponible sous la forme d'un dossier contenant des fichiers CSV compressés :

ASSOCIATIONS
ASSOCIATION_DEFINITIONS
EVENTS_[Event name]
LISTS
LIST_MEMBERSHIPS
OBJECTS
OBJECT_AND_EVENT_TYPE_DEFINITIONS
OBJECT_PROPERTIES
OBJECT_PROPERTIES_HISTORY
OBJECT_WITH_OBJECT_PROPERTIES
OWNERS
OWNER_TEAM
PIPELINES
PIPELINE_STAGES
PROPERTY_DEFINITIONS
TEAMS