BetaCollegare HubSpot a Google BigQuery

Sincronizzare i dati di Google BigQuery con gli oggetti di HubSpot CRM, come i contatti, le aziende, le offerte, le associazioni e altri dati dell'account.

Le sezioni seguenti illustrano come autorizzare l'applicazione Google BigQuery e come configurare le impostazioni di sincronizzazione tra l'account Google Cloud e HubSpot.

Collegare e configurare l'integrazione Google BigQuery

Per collegare l'account Google BigQuery a HubSpot:

1. Nel tuo account HubSpot, fai clic sull'icona del Marketplace nella barra di navigazione principale, quindi seleziona Marketplace di HubSpot.
2. Fare clic sulla barra di ricerca e inserire Google BigQuery.
3. Fare clic su Google BigQuery dalla pagina dell'elenco.
4. Fare clic su Installa.
5. Fare clic su Continua l'installazione.

Verrete reindirizzati allo strumento di integrazione dei dati, dove un riquadro laterale vi guiderà nella sincronizzazione dei dati tra i vostri account HubSpot e BigQuery, in base alle indicazioni che desiderate sincronizzare:

• Google BigQuery → HubSpot: configurare la sincronizzazione da BigQuery a HubSpot.
• HubSpot → Google BigQuery: configurare la sincronizzazione da HubSpot a BigQuery.

Sincronizzazione dei dati di Google BigQuery con l'account HubSpot

Per inviare i dati di Google BigQuery a HubSpot, aggiungete e configurate un nuovo utente con i ruoli richiesti nel vostro account BigQuery:

1. Nel riquadro di destra, selezionare Google BigQuery → HubSpot.
2. Copiare l'e-mail dell'account di servizio Google generato da HubSpot.

3. Nel vostro account Google Cloud, andate alle impostazioni IAM del progetto, create un nuovo utente con l'e-mail dell'account di servizio copiato da HubSpot, quindi aggiungete i ruoli BigQuery Data Viewer e BigQuery Job User per l'utente appena creato.

4. Copiate l'ID del progetto dal vostro account Google Cloud.
5. In HubSpot, incollate l'ID del progetto e fate clic su Prova connessione.
6. Una volta verificata la connessione, fare clic su Avanti per completare la configurazione.

Sincronizzare i dati di HubSpot con l'account Google BigQuery

Per inviare i dati di HubSpot a Google BigQuery, è necessario configurare un utente con le autorizzazioni necessarie nel proprio account Google Cloud, oltre a specificare il progetto GCP associato e l'URI del bucket GCS.

Nota bene: è necessario l'accesso dell'amministratore di Google Cloud al progetto GCP in cui risiederà il set di dati di BigQuery e al bucket di Google Cloud Storage (GCS) in cui HubSpot metterà in scena i file Parquet.

1. Nel riquadro di destra, selezionate HubSpot → Google BigQuery.
2. Copiate l'e-mail dell'account di servizio Google generato da HubSpot.

3. Nell'account Google Cloud, accedere alle impostazioni IAM del progetto, creare un nuovo utente con l'e-mail dell'account di servizio copiato da HubSpot, quindi aggiungere i ruoli BigQuery Data Viewer, BigQuery Job User e Storage object owner per l'utente appena creato.
   

4. Copiate l'ID del progetto dal vostro account Google Cloud.
5. In HubSpot, incollate l'ID del progetto.
6. Aggiungere l'URI del bucket di Google Cloud Storage (GCS):
   • L'URI del bucket GCS deve seguire la struttura: gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • Le tabelle esterne di BigQuery sono create in un set di dati dedicato nel progetto GCP e seguono il formato: hubspot_data_set_{hubId}
   • I dati saranno scritti nel bucket GCS e le tabelle associate faranno riferimento a file parquet in GCS.
   • Per saperne di più sulla creazione dei bucket GCS, consultare la documentazione di Google.
7. Fare clic su Prova connessione.
8. Una volta verificata la connessione, fare clic su Avanti.
9. Selezionare le caselle di controllo accanto alle fonti di dati che si desidera sincronizzare (ad esempio, Contatti, Associazioni, Eventi, ecc.).
10. Configurare la frequenza e la pianificazione della sincronizzazione.
11. Fare clic su Avvia sincronizzazione.

Monitoraggio della sincronizzazione

Dopo aver configurato la sincronizzazione tra gli account, è possibile controllare lo stato e la cronologia della sincronizzazione dalla pagina dei dettagli della sincronizzazione:

1. Nel tuo account HubSpot, passa a Gestione dati > Integrazione dei dati..
2. In Monitoraggio delle importazioni e delle sincronizzazioni, fare clic sulla scheda Sincronizzazioni applicazioni.
3. Fare clic sulla barra di ricerca e cercare Google BigQuery.
4. Fare clic su Google BigQuery. Se si è configurata la sincronizzazione in entrambe le direzioni, è possibile che appaiano più voci.
5. Nella pagina dei dettagli della sincronizzazione, è possibile gestire e rivedere le impostazioni e la cronologia della sincronizzazione:
   • Per archiviare o modificare i dettagli della sincronizzazione, in alto a destra fare clic su Azioni e selezionare l'opzione corrispondente.
   • Per attivare immediatamente una sincronizzazione, cliccare in alto a destra su Sincronizza ora.
   • I record sincronizzati, le associazioni e gli errori sono riepilogati nella parte superiore della pagina.
   • Le attività di sincronizzazione recenti vengono visualizzate nella tabella. Fare clic sulla scheda Cronologia sincronizzazione per esaminare i tentativi e i completamenti di sincronizzazione specifici. È possibile filtrare per intervalli di date specifici o per uno stato di sincronizzazione.

Stati di sincronizzazione e gestione degli errori

La tabella seguente illustra i possibili stati di sincronizzazione:

Se una sincronizzazione non riesce:

• Nella pagina dei dettagli della sincronizzazione viene visualizzato lo stato Non riuscita, insieme alle informazioni sulle tabelle che sono riuscite o meno a sincronizzarsi.
• In caso di fallimento non vengono scritti parzialmente i dati: Le tabelle BigQuery vengono aggiornate solo quando la sincronizzazione viene completata con successo.
• La prossima sincronizzazione pianificata tenterà automaticamente una nuova sincronizzazione completa.
• È possibile attivare manualmente una nuova sincronizzazione in qualsiasi momento dalla pagina dei dettagli della sincronizzazione.

Elenco dei permessi di rete

La sincronizzazione dei dati di HubSpot con fornitori di terze parti come BigQuery viene instradata attraverso gli IP proxy di HubSpot. Questi intervalli IP sono utilizzati da altre integrazioni di HubSpot, come la sincronizzazione dei dati e i webhook.

Se l'organizzazione limita l'accesso in entrata alle risorse GCP, è necessario consentire l'elenco dei seguenti intervalli CIDR in base all'hublet HubSpot:

Scopri come scoprire dove sono ospitati i dati del tuo account HubSpot.

Limitazioni della beta

Tenete a mente le seguenti limitazioni durante questa beta:

• Frequenza di sincronizzazione: è disponibile solo una serie limitata di frequenze di sincronizzazione, tra cui una volta, ogni 6 ore, ogni 12 ore, quotidianamente, settimanalmente e mensilmente. È possibile attivare manualmente una nuova sincronizzazione dalla pagina dei dettagli della sincronizzazione in HubSpot in qualsiasi momento.
• Una sola esportazione per tipo di dati: ogni tipo di oggetto, evento o associazione può essere esportato in una sola configurazione di sincronizzazione per account HubSpot.
  
  • Ad esempio, se i contatti vengono già esportati in una destinazione BigQuery, non possono essere aggiunti a una seconda configurazione finché la destinazione originale non viene archiviata.
  • In questo modo si evita la duplicazione delle pipeline di dati e si garantisce un'unica fonte di verità per ogni tipo di dati nel data warehouse.
• Supporto limitato per i dati sensibili: è possibile archiviare e sincronizzare i dati sensibili sul proprio account HubSpot, ma non è possibile sincronizzare i dati sensibili sul proprio account BigQuery.
• Nessun supporto per object_x_views: l'oggetto object_x_views non è attualmente supportato per la sincronizzazione con BigQuery. Utilizzare object_with_object_properties o unire objects con object_properties per ottenere viste equivalenti per record.

Prossimi passi

Dopo aver collegato l'integrazione con BigQuery e aver configurato le impostazioni di sincronizzazione, è possibile conoscere lo schema delle tabelle sincronizzate in BigQuery.