Koble HubSpot og Google BigQuery (BETA)
Sist oppdatert: september 25, 2024
Gjelder for:
Operations Hub Enterprise |
Lær hvordan du kobler HubSpot og Google BigQuery for å synkronisere HubSpot-data med Google BigQuery-forekomsten din.
Koble HubSpot og BigQuery sammen
For å koble HubSpot og Google BigQuery må du gå gjennom disse trinnene i rekkefølge:
- Installer Google BigQuery fra HubSpot App Marketplace
- Opprett en egendefinert IAM-rolle i Google Cloud Platform
- Tilordne den egendefinerte rollen til Google Service-kontoen
- Gi den HubSpot-genererte Google BigQuery-kontoen rettigheter til å endre BigQuery-tabeller
- Komplett oppsett i HubSpot
1. Installer Google BigQuery fra HubSpot App Marketplace
Det anbefales at du har HubSpot-kontoen din og Google BigQuery-kontoen åpen i separate faner når du kobler de to appene sammen.
- Sørg for at HubSpot-kontoen din er valgt inn i denne betaversjonen: Få tilgang til HubSpot-data i Google BigQuery.
- Gå til denne lenken og velg HubSpot-kontoen din.
- Klikk på Installer app øverst til høyre.
- Skriv inn Bucket URI og prosjekt-ID.
- Klikk på Neste.
- Gå gjennom og noter Google Service- og BigQuery-kontoene, ettersom du trenger dem i neste trinn. Naviger deretter til Google Cloud-konsollen for å fullføre neste trinn.
2. Opprett en egendefinert IAM-rolle i Google Cloud Platform
- Logg inn på Google Cloud-konsollen din.
- Klikk på navigasjonsmenyen til venstre, og velg IAM & Admin > Roller .
- Klikk på Opprett rolle øverst.
- Skriv inn en tittel, valgfri beskrivelse og ID for rollen.
- Klikk på Legg til tillatelser.
- Velg følgende tillatelser i tabellen , og klikk på Legg til:
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
- Klikk på Opprett.
3. Tilordne den egendefinerte rollen til Cloud Storage Service-kontoen
- Klikk på navigasjonsmenyen til venstre, og velg Cloud Storage > Buckets.
- Velg en bøtte som skal konfigureres.
- Klikk på fanen Tillatelser.
- Klikk på Gi tilgang i fanen Vis etter prinsipal.
- I det høyre panelet, i feltet New principals, skriver du inn navnet på Google Service-kontoen fra trinn 2.
- I delen Tilordne roller klikker du på rullegardinmenyen og velger Egendefinert > <rolle>, der <rolle> er den egendefinerte IAM-rollen som ble opprettet i trinn 1.
- Klikk på Lagre. Google Service-kontoen legges til i rollen Storage Object Viewer .
4. Gi den HubSpot-genererte Google BigQuery-kontoen rettigheter til å endre BigQuery-tabeller
- Klikk på navigasjonsmenyen til venstre , og velg IAM & Admin > IAM .
- Klikk på Gi tilgang.
- I det høyre panelet, i feltet New principals, skriver du inn navnet på Google Service-kontoen fra trinn 2.
- I delen Tilordne roller klikker du på rullegardinmenyen og velger Egendefinert > <rolle>, der <rolle> er den egendefinerte IAM-rollen som ble opprettet i trinn 1.
5. Fullstendig oppsett i HubSpot
- I HubSpot-kontoen din klikker du på Fortsett til tilkoblede apper.
- Merk av i avmerkingsboksene i dialogboksen, og klikk deretter på Tillat og installer.
Dataformat for synkronisering mellom HubSpot og Google BigQuery
Tilgjengelige data for synkronisering
Du kan synkronisere følgende data fra HubSpot til Google BigQuery:
- Objekter: standardobjekter og egendefinerte objekter, for eksempel kontakter, selskaper, billetter eller produkter.
- Poster: individuelle objektposter.
- Assosiasjoner: alle assosiasjonstyper og tilhørende poster.
- Hendelser: Hendelsesdata for både standard HubSpot-hendelser og egendefinerte atferdshendelser.
- Lister: HubSpots kontakt- og selskapslister.
- Eiere: registrerte eiere.
- Pipelines: avtale- og billettpipelines og pipelinefaser.
- Egenskaper: egenskaper og deres verdier på objektpostene, inkludert egenskapshistorikken.
Objektdata av ulike typer er organisert og tilgjengelige på to måter:
- Individuell: Hver objekttype lagres i sin egen tabell og har bare poster av samme objekttype. For eksempel inneholder
objects_contacts
bare kontaktoppføringer. - Kombinert: Alleposter for alle objekttyper kombineres til ett databaseobjekt. Når du spør, må du derfor spesifisere et filter som "WHERE objectTypeId='0-1'
Egendefinerte objekter tildeles en ID når de opprettes, og identifiseres som 2-unique_ID. For eksempel 2-12345.
objects_x-tabeller
Hver tilgjengelig objekttype, inkludert egendefinerte objekter, har sin egen spesifikke tabell. Disse tabellene navngis i formatet OBJECTS_<object type name>
, der <object type name>
er flertallsformen av objecttype
. (Merk at hvis objekttypen ikke har noen flertallsform, vil <object type name>
være entallsformen av objekttypenavnet, sammenkjedet med "S").
Nedenfor finner du en komplett liste over tilgjengelige HubSpot-objekttyper, en kort beskrivelse av dataene de representerer, og de tilhørende tabellene.
HubSpot Objekttype |
ObjectTypeId |
Beskrivelse |
0-1 |
Informasjon om enkeltpersoner som samhandler med virksomheten din |
|
0-2 |
Informasjon om enkeltbedrifter eller organisasjoner |
|
0-3 |
Detaljer om inntektsmuligheter med en kontakt eller et selskap. |
|
0-4 |
Lagrer data fra CRM-handlinger, inkludert notater, oppgaver, e-post, møter og samtaler. |
|
0-5 |
Representere kundeforespørsler om hjelp eller support. |
|
0-14 |
Brukes til å dele prisinformasjon med potensielle kjøpere. |
|
0-15 |
Detaljer for individuelle innsendinger for et HubSpot-skjema. |
|
0-8 |
Representerer en delmengde av produkter som selges i en avtale. Når et produkt knyttes til en avtale, blir det en varelinje. |
|
0-11 |
Detaljer om innkommende meldinger fra flere kanaler. |
|
0-25 |
Detaljer om landingssidene dine |
|
0-27 |
Lagrer informasjon om gjøremålslister |
|
0-28 |
Brukes til å samle inn informasjon om besøkende og kontakter |
|
0-29 |
Detaljer om e-poster fra markedsføringshuben |
|
AD_ACCOUNT |
0-30 |
Lagrer informasjon om annonsekontoene dine på Linkedin, Facebook og Google |
0-31 |
Detaljer om annonsekampanjene dine. En annonsekampanje kan inneholde én eller flere annonser |
|
AD_GROUP |
0-32 |
Logisk gruppering av annonser i en annonsekampanje |
AD |
0-33 |
Detaljer om individuelle annonser |
0-35 |
Informasjon om relaterte markedsføringsressurser og -innhold, slik at du enkelt kan måle effektiviteten av den samlede markedsføringsinnsatsen. |
|
SITE_PAGE |
0-38 |
Data om individuelle sider på nettsidene dine |
0-39 |
Data om blogginnlegg |
|
OBJECT LIST |
0-45 |
Informasjon om grupperinger av objektposter basert på egenskaper eller aktiviteter |
0-48 |
Samtaler foretatt av andre CRM-poster, for eksempel kontakter |
|
FAKTURA |
0-53 |
Administrer og synkroniser fakturaer med eksterne regnskapssystemer |
0-57 |
Informasjon om medieressurser som er importert til HubSpot |
|
0-58 |
En sekvens er en serie målrettede, tidsbestemte e-postmaler for å pleie kontakter over tid |
|
0-72 |
Deling av avtaler brukes til å dele avtalekreditten mellom flere brukere |
|
0-83 |
Salgsdokumenter bygger et bibliotek med innhold som hele teamet kan laste opp og dele dokumenter med kontaktene dine. |
|
0-19 |
Lagrer informasjon som er sendt inn i en tilbakemeldingsundersøkelse. |
|
0-69 |
Abonnementer inneholder informasjon om tilbakevendende betalinger |
|
0-101 |
Inneholder data om innsamlede midler fra kunder |
objekt_med_objektegenskaper
Denne tabellen inneholder data fra HubSpot-postene dine. Du kan få én rad for hver post innenfor en objekttype (f.eks. alle kontaktposter i kontaktobjekttypen).
object_properties_history
Denne tabellen inneholder historiske eiendomsverdier. For kontakter inneholder den de siste 45 verdiene. For alle andre objekter inneholder den de 20 siste verdiene. Tabellen har en rad for hver historiske egenskapsverdi. Den gjeldende verdien for en egenskap bestemmes av det siste UPDATEDAT-tidsstempelet i egenskapens historikk.
Forespørsler om assosiasjoner
I likhet med objektdata er assosiasjonsdata organisert på to måter:
- Individuell: Hver assosiasjonstype lagres i sin egen tabell og inneholder bare poster av den typen. For eksempel inneholder
associations_contacts_to_deals
bare assosiasjonsposter mellom kontakt- og avtaleobjekter. T - Kombinert: Alle poster for alle tilknytningstyper samles i én tabell.
assosiasjoner_x_til_y
Hver assosiasjonstype har sin egen visning, merket som associations_<association type name>
, f.eks. associations_contacts_to_deals
.
assosiasjon_definisjoner
Denne tabellen inneholder informasjon om alle tilgjengelige tilknytningstyper mellom HubSpot-objekter, med én rad per tilknytningstype.
property_definitions
Denne tabellen inneholder informasjon om objektegenskaper og hendelsesegenskaper i HubSpot-kontoen din. Hendelsesegenskaper inkluderer standardhendelser, for eksempel e-poståpninger og klikk, og egendefinerte atferdsmessige hendelsesegenskaper. Denne informasjonen kan være nyttig for å definere verdier som finnes i object_properties og hendelsesdata.
Hendelser
Hendelser inkluderer standard HubSpot-hendelser og egendefinerte atferdshendelser. Hver hendelse har sin egen tabell, merket som events_eventname
.
objekt_og_hendelse_typedefinisjoner
Denne tabellen inneholder definisjoner for alle objekter og hendelser som er tilgjengelige i HubSpot-kontoen din.
Synkroniseringsfrekvens og organisering av data
Data synkroniseres daglig mellom HubSpot og Google BigQuery kl. 0900 UTC +0. Det opprettes en mappe for hver dag dataene synkroniseres, med flere undermapper for hver tabell. De siste syv synkroniseringene vil være tilgjengelige i Google Cloud-plattformen, og tabeller i BigQuery oppdateres for å peke på den siste bucket-dumpen.
Hver av de følgende tabellene vil være tilgjengelig som en mappe med gzippede CSV-filer:
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