Salta al contenuto
Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

Connettere HubSpot e Google BigQuery (BETA)

Ultimo aggiornamento: febbraio 6, 2025

Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:

Operations Hub   Enterprise

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:

  1. Rata di Google BigQuery dall'App Marketplace di HubSpot
  2. Creare un ruolo IAM personalizzato in Google Cloud Platform
  3. Assegnare il ruolo personalizzato all'account di servizio di Google
  4. Concedere all'account Google BigQuery generato da HubSpot le autorizzazioni per modificare le tabelle BigQuery
  5. 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

CONTATTO

0-1

Informazioni sulle persone che interagiscono con la vostra azienda

AZIENDA

0-2

Informazioni su singole aziende o organizzazioni

TRATTATIVA

0-3

Dettagli sulle opportunità di guadagno con un contatto o un'azienda.

COINVOLGIMENTO

0-4

Memorizza i dati delle azioni del CRM, tra cui note, attività, e-mail, riunioni e chiamate.

TICKET

0-5

Rappresenta le richieste di aiuto o di supporto dei clienti.

PREVENTIVO

0-14

Utilizzato per condividere le informazioni sui prezzi con i potenziali acquirenti.

MODULO_INVIO

0-15

Dettagli per i singoli invii di form di HubSpot.

LINE_ITEM

0-8

Rappresenta un sottoinsieme di prodotti venduti in una trattativa. Quando un prodotto è collegato a una trattativa, diventa una voce.

CONVERSAZIONI

0-11

Dettagli dei messaggi in arrivo da più canali.

PAGINA DI ATTERRAGGIO

0-25

Dettagli delle landing page

COMPITO

0-27

Memorizza informazioni sugli elenchi di cose da fare

MODULO

0-28

Utilizzato per raccogliere informazioni sui lead dei visitatori e dei contatti

MARKETING_EMAIL

0-29

Dettagli sulle email di Marketing Hub

AD_ACCOUNT

0-30

Annuncia le informazioni sugli account pubblicitari su Linkedin, Facebook e Google

AD_CAMPAIGN

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

CAMPAGNE

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

BLOG_POST

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à

CHIAMATA

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

PONTE_MEDIO

0-57

Informazioni sulle risorse multimediali importate in HubSpot

SEQUENZA

0-58

Una sequenza è una serie di modelli di e-mail mirati e temporizzati per coltivare i contatti nel tempo

DEAL_SPLIT

0-72

Le suddivisioni delle trattative sono utilizzate per condividere il credito delle trattative tra più utenti

DOCUMENTO DI VENDITA

0-83

I documenti di vendita costituiscono una libreria di contenuti per tutto il team, che può caricare e condividere documenti con i contatti.

INVIO_DI_RISCONTRO

0-19

Memorizza le informazioni inviate a un sondaggio di feedback.

ABBONAMENTO

0-69

Gli abbonamenti contengono i dettagli dei pagamenti ricorrenti

PAGAMENTO DEL COMMERCIO

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

L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.