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.

Accedi ai dati di HubSpot in Google BigQuery (BETA)

Ultimo aggiornamento: 30 giugno 2026

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

Data Hub Enterprise

Dopo aver collegato Google BigQuery al tuo account HubSpot, potrai eseguire query sui dati di HubSpot in BigQuery.

Questo articolo fornisce informazioni sullo schema di ciascuna tabella sincronizzata con BigQuery, che puoi utilizzare insieme alla documentazione di Google per eseguire query sui dati di HubSpot nel tuo account BigQuery.

Panoramica dei dati

Le query vengono costruite utilizzando SQL e possono essere utilizzate per recuperare dati di HubSpot quali:

Oggetti: oggetti standard e personalizzati, come contatti, aziende, prodotti.
Record: singoli record, come un singolo contatto o un'azienda.
Associazioni: tutti i tipi di associazione disponibili e i record attualmente associati.
Eventi: dati relativi sia agli eventi standard di HubSpot, come le aperture delle email, sia agli eventi comportamentali personalizzati.

I dati degli oggetti di diversi tipi vengono combinati per la versione v1: tutti i record relativi a tutti i tipi di oggetto vengono raggruppati in un unico oggetto del database. Pertanto, quando si esegue una query, è necessario specificare un filtro del tipo “WHERE objectTypeId=’0-1’

Agli oggetti personalizzati verrà assegnato un ID al momento della creazione e saranno identificati come 2-unique_ID. Ad esempio, 2-12345.

Scopri di più su modello di dati CRM di HubSpot.

Schemi delle tabelle sincronizzate

Le sezioni seguenti forniscono dettagli sullo schema di ciascuna tabella sincronizzata dal tuo account HubSpot a BigQuery, in base alle impostazioni di sincronizzazione configurate.

Schema di object_properties

Lo schema riportato di seguito fornisce dettagli sulla tabella object_properties sincronizzata:

Nome colonna	Tipo	Descrizione
OBJECTTYPEID	STRING	L'ID del tipo di oggetto (ad es., 0-1 per i contatti).
OBJECTID	INT64	L'ID del record (ad es. 123752 come esempio di record di contatto).
NAME	STRING	Il nome della proprietà.
VALORE	JSON	Il valore della proprietà
DATA DI AGGIORNAMENTO	TIMESTAMP	Data e ora dell'ultimo aggiornamento del record in HubSpot.
INGESTEDAT	TIMESTAMP	Data e ora dell'ultimo inserimento del record in BigQuery.

Schema object_with_object_properties

Lo schema riportato di seguito fornisce dettagli sulla tabella object_with_object_properties sincronizzata:

Nome colonna	Tipo	Descrizione
OBJECTTYPEID	STRING	L'ID del tipo di oggetto (ad es., 0-1 per i contatti).
OBJECTID	INT64	L'ID del record (ad es. 123752 come esempio di record di contatto).
PROPRIETÀ	JSON	I valori delle proprietà del record
DATA DI AGGIORNAMENTO	TIMESTAMP	Data e ora dell'ultimo aggiornamento del record in HubSpot.
INGESTEDAT	TIMESTAMP	Data e ora dell'ultimo inserimento del record in BigQuery.

Schema associations

Lo schema riportato di seguito fornisce i dettagli della tabella associations sincronizzata:

Nome colonna	Tipo	Descrizione
COMBINEDASSOCIATIONTYPEID	STRINGA	L'identificatore univoco della definizione dell'associazione.
ID_OGGETTO_DI_ORIGINE	INT64	L'ID dell'oggetto di origine.
TOOBJECTID	INT64	L'ID dell'oggetto di destinazione.
INGESTEDAT	TIMESTAMP	Data e ora dell'ultimo inserimento del record in BigQuery.

schema association_definitions

Lo schema riportato di seguito fornisce i dettagli della tabella associations_definitions sincronizzata:

Nome colonna	Tipo	Descrizione
COMBINEDASSOCIATIONTYPEID	STRINGA	L'identificatore univoco della definizione specifica dell'associazione.
CATEGORIA_ASSOCIAZIONE	STRING	L'origine del tipo di associazione. I valori possibili includono: HUBSPOT_DEFINED, USER_DEFINED o INTEGRATOR_DEFINED.
ID_TIPO_ASSOCIAZIONE	STRING	Un identificatore univoco per una definizione di associazione all’interno della relativa CATEGORIA_ASSOCIAZIONE. Non esistono due definizioni nella stessa categoria che condividano questo ID.
FROMOBJECTTYPEID	STRING	L'ID del tipo di oggetto di origine dell'associazione.
FROMOBJECTTYPE	STRING	Il nome del tipo di oggetto di origine dell'associazione.
ID_TIPO_OGGETTO_DI_DESTINAZIONE	STRING	L'ID del tipo di oggetto di destinazione dell'associazione.
TOOBJECTTYPE	STRING	Il nome del tipo di oggetto di destinazione dell'associazione.
NAME	STRING	Il nome definito della definizione dell'associazione.
LABEL	STRING	Un'etichetta descrittiva per la definizione dell'associazione.
È LA DEFINIZIONE DELL'ASSOCIAZIONE PRINCIPALE	BOOLEANO	Indica se si tratta del tipo di associazione principale (vero), ovvero quello che HubSpot visualizza sui record associati.
INGESTEDAT	TIMESTAMP	Data e ora dell'ultimo inserimento del record in BigQuery.

Eventi

Gli eventi includono gli eventi standard di HubSpot e gli eventi comportamentali personalizzati. Ogni evento ha un proprio oggetto nel database, denominato events_eventname.

Nome
EVENTS_AD_INTERACTION	Dettagli relativi a un annuncio e ai contatti che hanno interagito con esso cliccandoci sopra o inviando un modulo dopo aver interagito con esso.
EVENTS_AD_METRICS_IMPORTED_V0	Dettagli di un annuncio e delle relative metriche di rendimento.
EVENTS_CALL_MENTIONED_KEYWORD	Dettagli sulle parole chiave menzionate dai partecipanti durante le chiamate.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Link cliccati dai contatti nelle e-mail di marketing.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Link cliccati dai contatti nelle email della Posta in arrivo di Conversations.
EVENTS_COOKIE_BANNER_CLICKED	Contatti che hanno cliccato sui cookie.
EVENTS_COOKIE_BANNER_VIEWED	Contatti che hanno visualizzato i cookie.
EVENTS_DOCUMENT_SHARED_V2	Documenti di vendita condivisi con i contatti tramite un link esterno.
EVENTS_DOCUMENT_VIEWED_V2	Documenti di vendita e contatti che li hanno visualizzati aprendo il link esterno.
EVENTS_DOCUMENT_COMPLETED_V2	Documenti di vendita e contatti che li hanno chiusi.
EVENTS_HS_SCHEDULED_EMAIL_V2	Email inviate ai server di posta di HubSpot per essere spedite.
EVENTS_MTA_DELIVERED_EMAIL_V2	Email consegnate con successo ai destinatari dai server di posta di HubSpot.
EVENTS_MTA_BOUNCED_EMAIL_V2	Tentativi di consegna delle email che sono stati respinti dal server di posta del destinatario.
EVENTS_OPENED_EMAIL_V2	Aperture delle email da parte dei contatti.
EVENTS_REPORTED_SPAM_EMAIL_V2	Email contrassegnate come spam dai destinatari.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Modifiche alle iscrizioni alle e-mail da parte dei destinatari.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Aperture delle email nella Posta in arrivo monitorate dai contatti.
EVENTS_MB_MEDIA_PLAYED	Attività di riproduzione video da parte dei contatti.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Il contatto ha prenotato un incontro tramite una sequenza.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Il contatto si è iscritto alla sequenza.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	La sequenza è terminata.
EVENTS_V2_CONTACT_HA_RISPOSTO_ALL'EMAIL_DELLA_SEQUENZA	Il contatto ha risposto all'e-mail (o all'e-mail in arrivo che ha causato la cancellazione dalla sequenza) inviata tramite la sequenza.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Il contatto si è disiscritto dalla sequenza.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	L'utente ha cancellato manualmente il contatto dalla sequenza.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Il contatto si è disiscritto, annullando l'iscrizione alla sequenza.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	L'email della sequenza è stata respinta.
EVENTS_V2_SEQUENCE_ERRORED	Errore nella sequenza che ha causato la cancellazione.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Fase della sequenza eseguita.
EVENTS_VISITED_PAGE	Visite alle pagine del sito web da parte dei contatti.
EVENTS_<NOME_EVENTO_INTEGRAZIONE>_<IDENTIFICATORE_UNICO>	Eventi di integrazione (API Timeline V3)

È possibile identificare gli eventi combinando l’ID del tipo di evento e l’ID dell’evento stesso. Le colonne restituite dipendono dall’evento, con una colonna per ogni proprietà dell’evento. Tutti gli eventi restituiranno le seguenti colonne:

Nome colonna	Tipo	Descrizione
`EVENTTYPEID`	STRINGA	L'ID del tipo di evento, simile a OBJECTTYPEID È possibile interrogare tutti gli ID dei tipi di evento presenti nel proprio account utilizzando la vista object_and_event_type_definitions.
`ID`	STRING	È univoco per ogni tipo di evento. Non esistono due record con lo stesso ID all’interno di un determinato tipo di evento.
`OBJECTTYPEID`	STRING	Il tipo di oggetto che ha completato l'evento. Ad esempio, un clic su un link contenuto in un'e-mail mostrerebbe`0-1` in questa colonna, a indicare l'oggetto "contatti".
`OBJECTID`	INT64	L'ID del record che ha completato l'evento.
`OCCURREDAT`	TIMESTAMP	Quando si è verificato l'evento.
`OCCURREDATDATEINT`	INT64	Un numero che rappresenta il momento in cui si è verificato l'evento. Contiene gli stessi dati della colonna `OCCURREDAT`, ma formattati come numero e utilizzati come parte della chiave cluster della tabella. Nella maggior parte dei casi, è possibile utilizzare il timestamp `OCCURREDAT` al posto di questo numero.
`OCCUREDATDATEINT`	Numero	Un numero che indica quando si è verificato l'evento. Contiene gli stessi dati della colonna `OCCURREDAT`, ma è formattato come numero e utilizzato come parte della chiave di cluster della tabella. Nella maggior parte dei casi, è possibile utilizzare il timestamp `OCCURREDAT` al posto di questo numero.
`INGESTEDAT`	Timestamp	Data e ora dell’ultima acquisizione dei dati da parte di BigQuery. Ulteriori informazioni sui tipi di dati delle colonne.
`PROPERTY_*`	Varchar	Singole colonne contenenti le proprietà dell'evento.

L'articolo è stato utile?

Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.

BetaAccedi ai dati di HubSpot in Google BigQuery (BETA)