BetaCollega HubSpot a Google BigQuery

Sincronizza i dati da Google BigQuery con gli oggetti del CRM di HubSpot, quali contatti, aziende, opportunità, associazioni e altri dati presenti nel tuo account.

Le sezioni seguenti ti guidano attraverso la procedura per autorizzare l'app Google BigQuery e configurare le impostazioni di sincronizzazione tra il tuo account Google Cloud e HubSpot.

Collegare e configurare l’integrazione con Google BigQuery

Per collegare il tuo 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. Fai clic sulla barra di ricerca e inserisci Google BigQuery.
3. Fai clic su Google BigQuery nella pagina dell'elenco.
4. Fai clic su Installa.
5. Fai clic su " Continua la configurazione".

Verrai reindirizzato allo strumento di integrazione dei dati, dove un pannello laterale ti guiderà nella sincronizzazione dei dati tra i tuoi account HubSpot e BigQuery, in base alle indicazioni che desideri sincronizzare:

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

Sincronizza i dati di Google BigQuery con il tuo account HubSpot

Per inviare i dati di Google BigQuery a HubSpot, aggiungi e configura un nuovo utente con i ruoli richiesti nel tuo account BigQuery:

1. Nel riquadro a destra, seleziona Google BigQuery → HubSpot.
2. Copia l’indirizzo e-mail dell’account di servizio Google generato da HubSpot.

3. Nel tuo account Google Cloud, accedi alle impostazioni IAM del tuo progetto, crea un nuovo utente utilizzando l'indirizzo e-mail dell'account di servizio che hai copiato da HubSpot, quindi assegna i ruoli "BigQuery Data Viewer" e " BigQuery Job User " all'utente appena creato.

4. Copia l’ID del progetto dal tuo account Google Cloud.
5. Torna su HubSpot, incolla l ’ID del progetto, quindi fai clic su “Verifica connessione”.
6. Una volta verificata la connessione, clicca su " Avanti" per completare la configurazione.

Sincronizza i dati di HubSpot con il tuo account Google BigQuery

Per inviare i dati di HubSpot a Google BigQuery, dovrai configurare un utente con le autorizzazioni necessarie nel tuo account Google Cloud, specificando anche il progetto GCP associato e l'URI del bucket GCS.

Nota: è necessario disporre dell’accesso come amministratore di Google Cloud al progetto GCP in cui risiederà il set di dati di BigQuery e di un bucket di Google Cloud Storage (GCS) in cui HubSpot salverà i file Parquet.

1. Nel riquadro a destra, seleziona HubSpot → Google BigQuery.
2. Copia l’indirizzo e-mail dell’account di servizio Google generato da HubSpot.

3. Nel tuo account Google Cloud, accedi alle impostazioni IAM del tuo progetto, crea un nuovo utente utilizzando l’indirizzo e-mail dell’account di servizio che hai copiato da HubSpot, quindi assegna all’utente appena creato i ruoli “BigQuery Data Viewer”, “BigQuery Job User” e “Storage object owner ”.

4. Copia l’ID del progetto dal tuo account Google Cloud.
5. Torna su HubSpot e incolla l’ID del progetto.
6. Aggiungi l’URI del tuo 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 vengono create in un dataset dedicato all’interno del progetto GCP e seguono il formato: hubspot_data_set_{hubId}
   • I dati verranno scritti nel bucket GCS e le tabelle associate faranno riferimento ai file Parquet presenti in GCS.
   • Scopri di più sulla creazione dei bucket GCS nella documentazione di Google.
7. Fare clic su " Verifica connessione".
8. Una volta verificata la connessione, fare clic su " Avanti".
9. Seleziona le caselle di controllo accanto alle origini dati che desideri sincronizzare (ad esempio, Contatti, Associazioni, Eventi, ecc.).
10. Configura la frequenza e la pianificazione della sincronizzazione.
11. Fai clic su " Avvia sincronizzazione".

Monitorare la sincronizzazione

Dopo aver configurato la sincronizzazione tra i tuoi account, puoi controllare lo stato e la cronologia della sincronizzazione dalla pagina dei dettagli della sincronizzazione:

1. Nel tuo account HubSpot, fai clic su Altro, quindi vai a Gestione dei dati > Integrazione dei dati. Se Altro non appare nel tuo account, vai direttamente a Gestione dei dati > Integrazione dei dati.
2. Nella sezione " Monitora le importazioni e le sincronizzazioni", fai clic sulla scheda " Sincronizzazioni app ".
3. Fai clic sulla barra di ricerca e cerca Google BigQuery.
4. Fai clic su Google BigQuery. Tieni presente che potrebbero apparire più voci se hai configurato la sincronizzazione in entrambe le direzioni.
5. Nella pagina dei dettagli di sincronizzazione, puoi gestire e controllare le impostazioni e la cronologia delle sincronizzazioni:
   • Per archiviare o modificare i dettagli della sincronizzazione, in alto a destra, fare clic su "Azioni", quindi selezionare l'opzione corrispondente.
   • Per avviare immediatamente una sincronizzazione, in alto a destra, fare clic su " Sincronizza ora".
   • I record sincronizzati, le associazioni e gli errori sono riassunti nella parte superiore della pagina.
   • L'attività di sincronizzazione recente apparirà nella tabella. Fai clic sulla scheda Cronologia sincronizzazioni per esaminare i tentativi di sincronizzazione e le operazioni completate. Puoi filtrare per intervalli di date specifici o per stato di sincronizzazione.

Stati di sincronizzazione e gestione degli errori

La tabella seguente illustra i possibili stati di sincronizzazione:

Se una sincronizzazione non va a buon fine:

• Nella pagina dei dettagli della sincronizzazione apparirà lo stato "Failed", insieme alle informazioni relative alle tabelle la cui sincronizzazione è andata a buon fine o non è riuscita.
• In caso di errore, nessun dato viene scritto parzialmente: le tabelle di BigQuery si aggiornano solo al completamento con esito positivo di una sincronizzazione.
• La successiva sincronizzazione pianificata riproverà automaticamente a eseguire una sincronizzazione completa.
• È possibile avviare manualmente una nuova sincronizzazione in qualsiasi momento dalla pagina dei dettagli della sincronizzazione.

Elenco delle reti consentite

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

Se la tua organizzazione limita l'accesso in entrata alle tue risorse GCP, dovresti inserire nella lista bianca i seguenti intervalli CIDR in base al tuo hublet HubSpot:

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

Limiti della versione beta

Tieni presente le seguenti limitazioni durante questa fase beta:

• Frequenza di sincronizzazione: è disponibile solo un numero limitato di frequenze di sincronizzazione, tra cui una volta, ogni 6 ore, ogni 12 ore, giornalmente, settimanalmente e mensilmente. È possibile avviare manualmente una nuova sincronizzazione in qualsiasi momento dalla pagina dei dettagli di sincronizzazione in HubSpot.
• Un'esportazione per tipo di dati: ogni tipo di oggetto, tipo di evento o coppia di associazioni può essere esportato solo in una configurazione di sincronizzazione per ogni account HubSpot.
  
  • Ad esempio, se i contatti vengono già esportati verso una destinazione BigQuery, non possono essere aggiunti a una seconda configurazione finché la destinazione originale non viene archiviata.
  • Ciò impedisce la duplicazione delle pipeline di dati e garantisce un'unica fonte di verità per ogni tipo di dati nel tuo data warehouse.
• Supporto limitato per i dati sensibili: puoi archiviare e sincronizzare dati sensibili nel tuo account HubSpot, ma non puoi sincronizzare dati sensibili nel tuo account BigQuery.
• Nessun supporto per object_x_views: l’oggetto object_x_views non è attualmente supportato per la sincronizzazione con BigQuery. Utilizza object_with_object_properties oppure unisci objects con object_properties per ottenere viste equivalenti per singolo record.

Prossimi passaggi

Dopo aver collegato l’integrazione con BigQuery e configurato le impostazioni di sincronizzazione, scopri lo schema delle tabelle sincronizzate in BigQuery.