BêtaConnecter HubSpot à Google BigQuery

Synchronisez les données de Google BigQuery avec les objets du CRM HubSpot, tels que les contacts, les entreprises, les transactions, les associations et d’autres données de votre compte.

Les sections ci-dessous expliquent comment autoriser l’application Google BigQuery, puis configurer les paramètres de synchronisation entre votre compte Google Cloud et HubSpot.

Connecter et configurer l’intégration Google BigQuery

Pour connecter votre compte Google BigQuery à HubSpot :

1. Dans votre compte HubSpot, cliquez sur l'icône Marketplace dans la barre de navigation principale, puis sélectionnez Marketplace HubSpot.
2. Cliquez sur la barre de recherche et saisissez Google BigQuery.
3. Cliquez sur Google BigQuery depuis la page de listing.
4. Cliquez sur Installer.
5. Cliquez sur Poursuivre la configuration.

Vous serez redirigé vers l’outil d’intégration de données , où un panneau latéral vous guidera lors de la synchronisation des données entre vos comptes HubSpot et BigQuery, en fonction des indications que vous souhaitez synchroniser :

• Google BigQuery → HubSpot : configurez la synchronisation de BigQuery vers HubSpot.
• HubSpot → Google BigQuery : configurez la synchronisation de HubSpot vers BigQuery.

Synchronisez les données Google BigQuery avec votre compte HubSpot

Pour envoyer des données Google BigQuery à HubSpot, ajoutez et configurez un nouvel utilisateur avec les rôles requis dans votre compte BigQuery :

1. Dans le panneau de droite, sélectionnez Google BigQuery → HubSpot.
2. Copiez l’e-mail du compte de service Google généré par HubSpot.

3. Dans votre compte Google Cloud, accédez aux paramètres IAM de votre projet, créez un nouvel utilisateur avec l’e-mail de compte de service que vous avez copié depuis HubSpot, puis ajoutez les rôles BigQuery Data Viewer et BigQuery Job User pour l’utilisateur nouvellement créé.

4. Copiez l’ID du projet depuis votre compte Google Cloud.
5. De retour dans HubSpot, collez l’ID de projet, puis cliquez sur Tester la connexion.
6. Une fois la connexion vérifiée, cliquez sur Suivant pour terminer la configuration.

Synchronisez les données HubSpot avec votre compte Google BigQuery

Pour envoyer des données HubSpot à Google BigQuery, vous devez configurer un utilisateur disposant des autorisations requises dans votre compte Google Cloud, tout en spécifiant le projet GCP associé et l’URI du compartiment GCS.

Remarque : Vous aurez besoin d’un accès administrateur Google Cloud au projet GCP où l’ensemble de données BigQuery sera hébergé, et d’un compartiment Google Cloud Storage (GCS) où HubSpot préparera les fichiers Parquet.

1. Dans le panneau de droite, sélectionnez HubSpot → Google BigQuery.
2. Copiez l’e-mail du compte de service Google généré par HubSpot.

3. Dans votre compte Google Cloud, accédez aux paramètres IAM de votre projet, créez un nouvel utilisateur avec l’e-mail du compte de service que vous avez copié depuis HubSpot, puis ajoutez les rôles BigQuery Data Viewer, BigQuery Job User et Storage object owner pour l’utilisateur nouvellement créé.
   

4. Copiez l’ID du projet depuis votre compte Google Cloud.
5. De retour dans HubSpot, collez l’ID de projet.
6. Ajoutez l’URI de votre compartiment Google Cloud Storage (GCS) :
   • L’URI du compartiment GCS doit suivre la structure suivante :gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • Les tables externes BigQuery sont créées dans un jeu de données dédié dans le projet GCP et suivent le format suivant :hubspot_data_set_{hubId}
   • Les données sont écrites dans le compartiment GCS et les tables associées font référence à des fichiers parquet dans GCS.
   • Pour en savoir plus sur la création de groupes GCS, consultez la documentation de Google.
7. Cliquez sur Tester la connexion.
8. Une fois la connexion vérifiée, cliquez sur Suivant.
9. Sélectionnez les cases à cocher à côté des sources de données que vous souhaitez synchroniser (par exemple, Contacts, Associations, Événements, etc.).
10. Configurez la fréquence et la planification de la synchronisation.
11. Cliquez sur Commencer la synchronisation.

Synchronisation du moniteur

Après avoir configuré la synchronisation entre vos comptes, vous pouvez consulter l’état et l’historique de la synchronisation à partir de la page des détails de la synchronisation :

1. Dans votre compte HubSpot, rendez-vous dans Gestion des données > Intégration des données.
2. Sous Surveiller les synchronisations de vos imports &, cliquez sur l’onglet Synchronisations des applications .
3. Cliquez sur la barre de recherche et recherchez Google BigQuery.
4. Cliquez sur Google BigQuery. Veuillez noter que plusieurs entrées peuvent apparaître si vous avez configuré la synchronisation dans les deux sens.
5. Sur la page des détails de la synchronisation, vous pouvez gérer et consulter vos paramètres et votre historique de synchronisation :
   • Pour archiver ou modifier les détails de synchronisation, dans l’angle supérieur droit, cliquez sur Actions , puis sélectionnez l’option correspondante.
   • Pour déclencher immédiatement une synchronisation, dans l’angle supérieur droit, cliquez sur Synchroniser maintenant.
   • Les fiches d’informations synchronisées, les associations et les erreurs sont résumées en haut de la page.
   • Les activités de synchronisation récentes s’afficheront dans le tableau. Cliquez sur l’onglet Historique de synchronisation pour consulter les tentatives et les finalisations de synchronisation spécifiques. Vous pouvez filtrer par plages de dates spécifiques ou par statut de synchronisation.

États de synchronisation et gestion des erreurs

Le tableau ci-dessous présente les statuts de synchronisation possibles :

Si une synchronisation échoue :

• Un statut Échec apparaîtra sur la page des détails de la synchronisation, ainsi que des informations sur les tableaux dont la synchronisation a réussi ou échoué.
• Aucune donnée n’est partiellement écrite en cas d’échec : les tableaux BigQuery ne sont mis à jour que lorsqu’une synchronisation est terminée.
• La prochaine synchronisation planifiée réessayera automatiquement une synchronisation complète.
• Vous pouvez déclencher une resynchronisation manuellement à tout moment à partir de la page des détails de la synchronisation.

Liste d’autorisations réseau

La synchronisation des données HubSpot avec des fournisseurs tiers comme BigQuery est acheminée via les adresses IP proxy de HubSpot. Ces plages IP sont utilisées par d’autres intégrations HubSpot, telles que la synchronisation des données et les webhooks.

Si votre organisation restreint l’accès entrant à vos ressources GCP, vous devez ajouter les plages CIDR suivantes à votre liste d’inclusion en fonction de votre hublet HubSpot :

Découvrez comment savoir où sont hébergées les données de votre compte HubSpot .

Limites de la version bêta

Conservez les limitations suivantes à l’esprit pendant cette version bêta :

• Fréquence de synchronisation : seul un ensemble limité de fréquences de synchronisation est disponible, y compris une, toutes les 6 heures, toutes les 12 heures, quotidiennement, hebdomadairement et mensuellement. Vous pouvez à tout moment déclencher manuellement une resynchronisation à partir de la page des détails de la synchronisation dans HubSpot.
• Un export par type de données : chaque type d’objet, chaque type d’événement ou toute paire d’association ne peut être exporté que dans une seule configuration de synchronisation par compte HubSpot.
  
  • Par exemple, si les contacts sont déjà exportés vers une destination BigQuery, ils ne peuvent pas être ajoutés à une seconde configuration tant que la destination initiale n’est pas archivée.
  • Cela évite les pipelines de données en double et garantit un centre unique d’informations par type de données dans votre entrepôt de données.
• Prise en charge limitée des données sensibles : vous pouvez stocker et synchroniser des données sensibles avec votre compte HubSpot, mais vous ne pouvez pas synchroniser des données sensibles avec votre compte BigQuery.
• Aucune prise en charge de object_x_views : la synchronisation de l’objet object_x_views avec BigQuery n’est actuellement pas prise en charge. Utilisez object_with_object_properties, ou associez objects pour object_properties obtenir des vues équivalentes par fiche d’informations.

Étapes suivantes

Après avoir connecté l’intégration BigQuery et configuré vos paramètres de synchronisation, découvrez le schéma des tableaux synchronisés dans BigQuery.