BetaConnettere HubSpot e Google BigQuery (BETA)
Ultimo aggiornamento: febbraio 6, 2025
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
|
Scoprite come collegare HubSpot e Google BigQuery per sincronizzare i dati di HubSpot con la vostra istanza di Google BigQuery.
Collegare HubSpot e BigQuery
Per collegare HubSpot e Google BigQuery, è necessario eseguire i seguenti passaggi in ordine:
- Rata di Google BigQuery dall'App Marketplace di HubSpot
- Creare un ruolo IAM personalizzato in Google Cloud Platform
- Assegnare il ruolo personalizzato all'account di servizio di Google
- Concedere all'account Google BigQuery generato da HubSpot le autorizzazioni per modificare le tabelle BigQuery
- Completare la configurazione in HubSpot
1. Rata Google BigQuery dall'App Marketplace di HubSpot
Si consiglia di aprire l'account HubSpot e l'account Google BigQuery in schede separate quando si collegano le due applicazioni.
- Assicuratevi che il vostro account HubSpot sia abilitato a questa beta: Accesso ai dati HubSpot in Google BigQuery.
- Andate a questo link e selezionate il vostro account HubSpot.
- In alto a destra, fare clic su Rata.
- Inserite l'URI del vostro Bucket e l'ID del progetto.
- Fare clic su Avanti.
- Rivedete e prendete nota degli account Google Service e BigQuery, perché vi serviranno nella fase successiva. Quindi, accedere alla console di Google Cloud per completare la fase successiva.
2. Creazione di un ruolo IAM personalizzato in Google Cloud Platform
- Accedere alla console di Google Cloud.
- Fare clic sul menu di navigazione sinistro e selezionare IAM & Admin > Ruoli.
- In alto, fare clic su Crea ruolo.
- Inserire un titolo, una descrizione opzionale e un ID per il ruolo.
- Fare clic su Aggiungi autorizzazioni.
- Nella tabella, selezionare le seguenti autorizzazioni e fare clic su Aggiungi:
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
- Fare clic su Crea.
3. Assegnare il ruolo personalizzato all'account del servizio di archiviazione Cloud
- Fare clic sul menu di navigazione a sinistra e selezionare Cloud Storage > Bucket.
- Selezionare un bucket da configurare.
- Fare clic sulla scheda Autorizzazioni.
- Nella scheda Visualizzazione per principi, fare clic su Concedere l'accesso.
- Nel pannello di destra, nel campo Nuovo preside, inserire il nome dell'account di servizio Google dal punto 1.
- Nella sezione Assegnazione di ruoli, fare clic sul menu a discesa e selezionare Personalizzato > <ruolo>, dove <ruolo> è il ruolo IAM personalizzato creato nel passaggio 2.
- Fare clic su Salva. L'account Google Service verrà aggiunto al ruolo Storage Oggetto Viewer .
4. Concedere all'account Google BigQuery generato da HubSpot le autorizzazioni per modificare le tabelle BigQuery
- Fare clic sul menu di navigazione sinistro e selezionare IAM e amministrazione > IAM.
- Fare clic su Concedere l'accesso.
- Nel pannello di destra, nel campo New principals, inserire l'account Google BigQuery generato da HubSpot al punto 1.
- Nella sezione Assegnazione dei ruoli, fare clic sul menu a discesa e selezionare Personalizzato > <ruolo>, dove <ruolo> è il ruolo IAM personalizzato creato al punto 2.
5. Configurazione completa in HubSpot
- Nel vostro account HubSpot, fate clic su Continua con le applicazioni connesse.
- Nella finestra di dialogo, selezionare le caselle di controllo, quindi fare clic su Consenti e rata.
Formato dei dati per la sincronizzazione tra HubSpot e Google BigQuery
Dati disponibili per la sincronizzazione
È possibile sincronizzare i seguenti dati da HubSpot a Google BigQuery:
- Oggetti: oggetti standard e personalizzati, come contatti, aziende, ticket o prodotti.
- Record: i record dei singoli oggetti.
- Associazioni: tutti i tipi di associazione e i record associati.
- Eventi: dati degli eventi sia per gli eventi standard di HubSpot sia per gli eventi comportamentali personalizzati.
- Elenchi: Elenchi di contatti e aziende di HubSpot.
- Proprietari: i proprietari dei record.
- Pipeline: pipeline del ticket e fasi della trattativa.
- Proprietà: proprietà e relativi valori sui record degli oggetti, compresa la cronologia delle proprietà.
I dati degli oggetti di diverso tipo sono organizzati e disponibili in due modi:
- Individuale: ogni tipo di oggetto è memorizzato nella propria tabella e contiene solo record dello stesso tipo di oggetto. Ad esempio,
objects_contacts
contiene solo record del contatto. - Combinato: tutti irecord di tutti i tipi di oggetto sono combinati in un unico oggetto del database. Pertanto, quando si esegue una query, è necessario specificare un filtro del tipo "WHERE objectTypeId='0-1'"
Aglioggetti personalizzati viene assegnato un ID al momento della creazione, identificato come 2-unique_ID. Ad esempio, 2-12345.
oggetti_x tabelle
Ogni tipo di oggetto disponibile, compresi gli oggetti personalizzati, ha una tabella specifica. Queste tabelle sono denominate secondo il formato OBJECTS_<object type name>
, dove <object type name>
è l'etichetta della forma plurale di objecttype
.(Si noti che se il tipo di oggetto non ha una forma plurale, <object type name>
sarà l'etichetta della forma singolare del nome del tipo di oggetto concatenata con "S").
Di seguito è riportato un elenco completo dei tipi di oggetto HubSpot disponibili, una breve descrizione dei dati che rappresentano e le tabelle corrispondenti.
Tipo di oggetto HubSpot |
Tipo di oggettoId |
Descrizione dell'oggetto |
0-1 |
Informazioni sulle persone che interagiscono con la vostra azienda |
|
0-2 |
Informazioni su singole aziende o organizzazioni |
|
0-3 |
Dettagli sulle opportunità di guadagno con un contatto o un'azienda. |
|
0-4 |
Memorizza i dati delle azioni del CRM, tra cui note, attività, e-mail, riunioni e chiamate. |
|
0-5 |
Rappresenta le richieste di aiuto o di supporto dei clienti. |
|
0-14 |
Utilizzato per condividere le informazioni sui prezzi con i potenziali acquirenti. |
|
0-15 |
Dettagli per i singoli invii di form di HubSpot. |
|
0-8 |
Rappresenta un sottoinsieme di prodotti venduti in una trattativa. Quando un prodotto è collegato a una trattativa, diventa una voce. |
|
0-11 |
Dettagli dei messaggi in arrivo da più canali. |
|
0-25 |
Dettagli delle landing page |
|
0-27 |
Memorizza informazioni sugli elenchi di cose da fare |
|
0-28 |
Utilizzato per raccogliere informazioni sui lead dei visitatori e dei contatti |
|
0-29 |
Dettagli sulle email di Marketing Hub |
|
AD_ACCOUNT |
0-30 |
Annuncia le informazioni sugli account pubblicitari su Linkedin, Facebook e Google |
0-31 |
Annunci sulle campagne pubblicitarie. Una Campagna pubblicitaria può contenere uno o più annunci |
|
AD_GROUP |
0-32 |
Gruppo logico di annunci all'interno di una Campagna |
ANNUNCI |
0-33 |
Dettagli sui singoli annunci |
0-35 |
Informazioni sulle attività e sui contenuti di marketing correlati, in modo da poter misurare facilmente l'efficacia dei vostri sforzi di marketing collettivi. |
|
SITO_PAGINA |
0-38 |
Dati sulle singole pagine del sito web |
0-39 |
Dati sui post del blog |
|
ELENCO DEGLI OGGETTI |
0-45 |
Informazioni sui raggruppamenti di record di oggetti in base alle loro proprietà o attività |
0-48 |
Chiamate effettuate da altri record del CRM, per esempio i contatti |
|
FATTURA |
0-53 |
Gestire e sincronizzare le fatture con i sistemi contabili esterni |
0-57 |
Informazioni sulle risorse multimediali importate in HubSpot |
|
0-58 |
Una sequenza è una serie di modelli di e-mail mirati e temporizzati per coltivare i contatti nel tempo |
|
0-72 |
Le suddivisioni delle trattative sono utilizzate per condividere il credito delle trattative tra più utenti |
|
0-83 |
I documenti di vendita costituiscono una libreria di contenuti per tutto il team, che può caricare e condividere documenti con i contatti. |
|
0-19 |
Memorizza le informazioni inviate a un sondaggio di feedback. |
|
0-69 |
Gli abbonamenti contengono i dettagli dei pagamenti ricorrenti |
|
0-101 |
Contiene dati sui fondi raccolti dai clienti |
oggetto_con_proprietà_di_oggetto
Questa tabella contiene i dati dei record di HubSpot. È possibile ottenere una riga per ogni record all'interno di un tipo di oggetto (ad esempio, tutti i record del contatto nel tipo di oggetto Contatti).
oggetto_proprietà_storia
Questa tabella contiene i valori storici delle proprietà. Per i contatti, contiene i 45 valori più recenti. Per tutti gli altri oggetti, contiene i 20 valori più recenti. La tabella contiene una riga per ogni valore storico della proprietà. Il valore attuale di una proprietà è determinato dal timestamp UPDATEDAT più recente nella cronologia della proprietà.
Domande di associazione
Come i dati degli oggetti, i dati delle associazioni sono organizzati in due modi:
- Individuale: ogni tipo di associazione è memorizzato nella propria tabella e contiene solo record di quel tipo. Ad esempio,
associations_contacts_to_deals
contiene solo i record dell'associazione tra gli oggetti Contatto e Trattativa. T - Combinata: tutti i record di tutti i tipi di associazione sono combinati in un'unica tabella.
associazioni_x_a_y
Ogni tipo di associazione ha una propria vista, etichettata come associations_<association type name>
, ad esempio associations_contacts_to_deals
.
definizioni_di_associazione
Questa tabella contiene informazioni su tutti i tipi di associazione disponibili tra i tipi di oggetto di HubSpot, con una riga per tipo di associazione.
definizioni_di_proprietà
Questa tabella contiene informazioni sulle proprietà degli oggetti e sugli eventi dell'account HubSpot. Le proprietà degli eventi includono eventi standard, come le aperture e i clic delle e-mail, e proprietà di eventi comportamentali personalizzati. Queste informazioni possono essere utili per definire i valori presenti in object_properties e nei dati degli eventi.
Eventi
Gli eventi comprendono eventi standard di HubSpot ed eventi comportamentali personalizzati. Ogni evento ha una propria tabella, etichettata come events_eventname
.
definizioni_di_tipo_di_oggetto_e_di_evento
Questa tabella contiene le definizioni di tutti gli oggetti e gli eventi disponibili nell'account HubSpot.
Frequenza di sincronizzazione e organizzazione dei dati
I dati vengono sincronizzati quotidianamente tra HubSpot e Google BigQuery alle 0900 UTC +0. Per ogni giorno di sincronizzazione dei dati viene creata una cartella con diverse sottocartelle per ogni tabella. Le ultime sette sincronizzazioni saranno disponibili nella piattaforma Google Cloud e le tabelle in BigQuery verranno aggiornate per puntare all'ultimo bucket dump.
Ciascuna delle tabelle seguenti sarà disponibile come file in formato Parquet:
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