- Vidensbase
- Konto og opsætning
- Integrationer
- Få adgang til HubSpot-data i Google BigQuery (BETA)
I betaFå adgang til HubSpot-data i Google BigQuery (BETA)
Sidst opdateret: 30 juni 2026
Gælder for:
-
Data Hub Enterprise
Når du har forbundet Google BigQuery til din HubSpot-konto, kan du søge efter HubSpot-data i BigQuery.
Denne artikel indeholder oplysninger om skemaet for hver tabel, der synkroniseres med BigQuery, og som du kan bruge sammen med Googles dokumentation til at søge efter HubSpot-data i din BigQuery-konto.
Dataoversigt
Forespørgsler opbygges ved hjælp af SQL og kan bruges til at hente HubSpot-data såsom:
- Objekter: standard- og brugerdefinerede objekter, såsom kontakter, virksomheder og produkter.
- Poster: individuelle poster, f.eks. en enkelt kontakt eller virksomhed.
- Forbindelser: alle tilgængelige forbindelsestyper og aktuelt tilknyttede poster.
- Begivenheder: begivenhedsdata for både standard HubSpot-begivenheder, såsom åbning af e-mails, og brugerdefinerede adfærdsbegivenheder.
Objektdata af forskellige typer kombineres i v1: alle poster for alle objekttyper kombineres i ét databaseobjekt. Når du foretager en forespørgsel, skal du derfor angive et filter som f.eks. “WHERE objectTypeId=’0-1’
Brugerdefinerede objekter tildeles et ID ved oprettelsen og identificeres som 2-unique_ID. For eksempel 2-12345.
Læs mere om HubSpots CRM-datamodel.
Synkroniserede tabelskemaer
Afsnittene nedenfor indeholder detaljer om skemaet for hver tabel, der synkroniseres fra din HubSpot-konto til BigQuery, baseret på dine konfigurerede synkroniseringsindstillinger.
object_properties-skema
Skemaet nedenfor indeholder detaljer om den synkroniserede object_properties-tabel:
| Kolonnenavn | Type | Beskrivelse |
| OBJECTTYPEID | STRING | Objekttypens ID (f.eks. 0-1 for kontakter). |
| OBJECTID | INT64 | ID'et for posten (f.eks. 123752 som eksempel på en kontaktpost). |
| NAME | STRING | Navnet på egenskaben. |
| VALUE | JSON | Egenskabens værdi |
| OPDATERET | TIMESTAMP | Dato og klokkeslæt for, hvornår posten sidst blev opdateret i HubSpot. |
| INGESTEDAT | TIDSTEMPEL | Dato og klokkeslæt for, hvornår posten sidst blev importeret af BigQuery. |
object_with_object_properties-skema
Skemaet nedenfor indeholder detaljer om den synkroniserede object_with_object_properties-tabel:
| Kolonnenavn | Type | Beskrivelse |
| OBJECTTYPEID | STRING | ID'et for objekttypen (f.eks. 0-1 for kontakter). |
| OBJECTID | INT64 | ID'et for posten (f.eks. 123752 som et eksempel på en kontaktpost). |
| EGENSKABER | JSON | Postens egenskabsværdier |
| UPDATEDAT | TIMESTAMP | Dato og klokkeslæt for, hvornår posten sidst blev opdateret i HubSpot. |
| INGESTEDAT | TIDSTEMPEL | Dato og klokkeslæt for, hvornår posten sidst blev importeret af BigQuery. |
associations-skema
Skemaet nedenfor indeholder detaljer om den synkroniserede associations-tabel:
| Kolonnenavn | Type | Beskrivelse |
| COMBINEDASSOCIATIONTYPEID | STRING | Den unikke identifikator for associeringsdefinitionen. |
| FROMOBJECTID | INT64 | ID'et for kildeobjektet. |
| TOOBJECTID | INT64 | ID'et for destinationsobjektet. |
| INGESTEDAT | TIMESTAMP | Dato og klokkeslæt for, hvornår posten sidst blev indlæst af BigQuery. |
association_definitions-skema
Skemaet nedenfor indeholder detaljer om den synkroniserede tabel associations_definitions:
| Kolonnenavn | Type | Beskrivelse |
| COMBINEDASSOCIATIONTYPEID | STRING | Den unikke identifikator for den specifikke tilknytningsdefinition. |
| ASSOCIATIONCATEGORY | STRING | Oprindelsen til tilknytningstypen. Mulige værdier omfatter: HUBSPOT_DEFINED, USER_DEFINED eller INTEGRATOR_DEFINED. |
| ASSOCIATIONTYPEID | STRING | En unik identifikator for en associeringsdefinition inden for dens ASSOCIATIONCATEGORY. Der vil ikke være to definitioner i samme kategori, der deler dette ID. |
| FROMOBJECTTYPEID | STRING | Objekttype-ID'et for associationens kildeobjekt. |
| FROMOBJECTTYPE | STRING | Navnet på foreningens kildeobjekttype. |
| TOOBJECTTYPEID | STRING | Objekttype-ID'et for foreningens målobjekt. |
| TOOBJECTTYPE | STRING | Navnet på foreningens destinationsobjekttype. |
| NAME | STRING | Det definerede navn på tilknytningsdefinitionen. |
| LABEL | STRING | En beskrivende etiket til associeringsdefinitionen. |
| ISMAINASSOCIATIONDEFINITION | BOOLEAN | Angiver, om dette er den primære associationstype (true), som er den, HubSpot viser på associerede poster. |
| INGESTEDAT | TIDSTEMPEL | Dato og klokkeslæt for, hvornår posten sidst blev indlæst af BigQuery. |
Begivenheder
Begivenheder omfatter standardbegivenheder fra HubSpot og brugerdefinerede adfærdsbegivenheder. Hver begivenhed har sit eget databaseobjekt, der er mærket som events_eventname.
| Navn | |
| EVENTS_AD_INTERACTION | Detaljer om en annonce og de kontakter, der har interageret med den ved at klikke på annoncen eller indsende en formular efter at have interageret med den. |
| EVENTS_AD_METRICS_IMPORTED_V0 |
Oplysninger om en annonce og dens præstationsmålinger. |
| EVENTS_CALL_MENTIONED_KEYWORD | Oplysninger om søgeord, der er nævnt af deltagere i opkald. |
| EVENTS_CLICKED_LINK_IN_EMAIL_V2 |
Links, som kontakter har klikket på i marketing-e-mails. |
| EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 | Links, som kontakter har klikket på i e-mails i Conversations-indbakken. |
| EVENTS_COOKIE_BANNER_CLICKED | Kontakter, der har klikket på cookies. |
| EVENTS_COOKIE_BANNER_VIEWED | Kontakter, der har set cookies. |
| EVENTS_DOCUMENT_SHARED_V2 | Salgsdokumenter, der er delt med kontakter via et eksternt link. |
| EVENTS_DOCUMENT_VIEWED_V2 | Salgsdokumenter og kontakter, der har set dem ved at åbne det eksterne link. |
| EVENTS_DOCUMENT_COMPLETED_V2 | Salgsdokumenter og kontakter, der har afsluttet dem. |
| EVENTS_HS_SCHEDULED_EMAIL_V2 | E-mails, der er sendt til HubSpots e-mailservere med henblik på afsendelse. |
| EVENTS_MTA_DELIVERED_EMAIL_V2 | E-mails, der er leveret til modtagerne via HubSpots e-mailservere. |
| EVENTS_MTA_BOUNCED_EMAIL_V2 | Forsøg på at levere e-mails, der blev afvist af modtagerens e-mail-server. |
| EVENTS_OPENED_EMAIL_V2 | E-mails, der er åbnet af kontakter. |
| EVENTS_REPORTED_SPAM_EMAIL_V2 | E-mails, der er markeret som spam af modtagerne. |
| EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 | Ændringer i e-mail-abonnementer foretaget af modtagere. |
| EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 | Åbninger af e-mails i indbakken, der spores af kontakter. |
| EVENTS_MB_MEDIA_PLAYED | Aktiviteter vedrørende afspilning af videoer blandt kontakter. |
| EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE | Kontakten har booket et møde via en sekvens. |
| EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE | Kontakten har tilmeldt sig sekvensen. |
| EVENTS_V2_CONTACT_FINISHED_SEQUENCE | Sekvensen er afsluttet. |
| EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL | Kontakten har svaret på en e-mail (eller en indgående e-mail, der afmeldte sekvensen), der blev sendt via sekvensen. |
| EVENTS_V2_KONTAKT_AFMELDET_FRA_SEKVENS | Kontakten har afmeldt sig sekvensen. |
| EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE | Brugeren har manuelt afmeldt kontakten. |
| EVENTS_V2_KONTAKT_AFMELDTE_SEKVENS_E-MAIL | Kontakten har afmeldt sig, hvilket medfører afmelding fra sekvensen. |
| EVENTS_V2_SEQUENCE_EMAIL_BOUNCED | Sekvens-e-mailen blev returneret. |
| EVENTS_V2_SEQUENCE_ERRORED | Der opstod en fejl i sekvensen, hvilket medførte afmelding. |
| EVENTS_V2_SEQUENCE_STEP_EXECUTED | Sekvenstrin udført. |
| EVENTS_VISITED_PAGE | Besøg på websiden af kontakter. |
| EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> | Integrationsbegivenheder (Timeline V3 API) |
Du kan identificere begivenheder ved at kombinere deres begivenhedstype-ID og ID. De kolonner, der returneres, afhænger af begivenheden, med én kolonne for hver begivenhedsegenskab. Alle begivenheder returnerer følgende kolonner:
| Kolonnenavn | Type | Beskrivelse |
EVENTTYPEID |
STRING | ID'et for begivenhedstypen, svarende til OBJECTTYPEID Du kan hente alle begivenhedstype-ID'er i din konto ved hjælp af visningen object_and_event_type_definitions. |
ID |
STRING | Dette er unikt for hver begivenhedstype. Der vil ikke være to poster med samme ID inden for en given begivenhedstype. |
OBJECTTYPEID |
STRING | Den type objekt, der gennemførte begivenheden. For eksempel vil et klik på et link i en e-mail vise0-1 i denne kolonne, hvilket repræsenterer kontaktobjektet. |
OBJECTID |
INT64 | ID'et for den post, der gennemførte begivenheden. |
OCCURREDAT |
TIMESTAMP | Hvornår begivenheden fandt sted. |
|
|
INT64 | Et tal, der angiver, hvornår begivenheden fandt sted. Indeholder de samme data som kolonnen OCCURREDAT, men er formateret som et tal og bruges som en del af tabellens klyngenøgle. I de fleste tilfælde kan du bruge OCCURREDAT tidsstemplet i stedet for dette tal. |
|
|
Tal | Et tal, der angiver, hvornår begivenheden fandt sted. Indeholder de samme data som kolonnen |
INGESTEDAT |
Tidsstempel | Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af BigQuery. Få mere at vide om kolonnedatatypetyper. |
PROPERTY_* |
Varchar | Individuelle kolonner, der indeholder begivenhedsegenskaberne. |