I betaTilkoble HubSpot og Google BigQuery

Lær hvordan du tilkobler HubSpot og Google BigQuery for å synkronisere HubSpot-data med Google BigQuery-forekomsten din.

Merk: HubSpot deler ikke HIPAA-data til Google BigQuery.

Tilkoble HubSpot og BigQuery

For å tilkoble HubSpot og Google BigQuery må du kjøre gjennom disse trinnene i rekkefølge:

1. Avdrag Google BigQuery fra HubSpot App Marketplace.
2. Opprett en egendefinert IAM-rolle i Google Cloud Platform.
3. Tilordne den egendefinerte rollen til Google Service-kontoen.
4. Gi den HubSpot-genererte Google BigQuery-kontoen rettigheter til å endre BigQuery-tabeller.
5. Fullstendig oppsett i HubSpot.

1. Avdrag 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 tilkobler de to appene. 

1. Sørg for at HubSpot-kontoen din er valgt inn i betaversjonen: Få tilgang til HubSpot-data i Google BigQuery. 
2. Gå til denne lenken og velg HubSpot-kontoen din. 
3. Klikk på Avdrag.
4. Skriv inn Bucket URI og prosjekt-ID. 
5. Klikk på Neste. 
6. Gjennomgå og noter kontoene for Google Service og BigQuery, da du trenger dem i neste trinn. Gå deretter til Google Cloud-konsollen for å fullføre neste trinn. 

2. Opprett en egendefinert IAM-rolle i Google Cloud Platform

1. Logg inn på Google Cloud-konsollen din. 
2. Klikk på navigasjonsmenyen til venstre, og velg IAM & Admin > Roles. 
3. Klikk på Opprett rolle øverst.
4. Skriv inn en tittel, valgfri beskrivelse og ID for rollen. 
5. Klikk på Legg til tillatelser. 

6. I tabellen velger du følgende tillatelser og klikker 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

7. Klikk på Opprett. 

3. Gi Google Service-kontoen tilgang til Cloud Storage Buckets

1. Klikk på navigasjonsmenyen til venstre, og velg Cloud Storage > Buckets. 
2. Velg en bøtte som skal konfigureres. 
3. Klikk på fanen Tillatelser .
4. Klikk på Gi tilgang i fanen Vis etter prinsipal .

5. I det høyre panelet, i feltet Nye oppdragsgivere , skriver du inn navnet på Google Service-kontoen fra trinn 1.

Merk: Sørg for å tilordne Google Service-kontoen, ikke BigQuery-kontoen.

6. I delen Tilordne roller klikker du på rullegardinmenyen og velger Egendefinert > <role> , der <role> er den egendefinerte IAM-rollen som ble opprettet i trinn 2. 
7. Klikk på Lagre. Google Service-kontoen blir lagt til i rollen Storage Objekt Viewer . 

4. Gi den HubSpot-genererte Google BigQuery-kontoen rettigheter til å endre BigQuery-tabeller

1. Klikk på navigasjonsmenyen til venstre, og velg IAM & Admin > IAM. 
2. Klikk på Gi tilgang.
3. I det høyre panelet, i feltet New principals , skriver du inn den HubSpot-genererte Google BigQuery-kontoen fra trinn 1.
4. I delen Tilordne roller klikker du på rullegardinmenyen og velger Egendefinert > <role> , der <role> er den egendefinerte IAM-rollen som ble opprettet i trinn 2. 

5. Komplett oppsett i HubSpot

1. Tilbake på HubSpot-kontoen din klikker du på Fortsett til Tilkoblede kontoer. 
2. I dialogboksen merker du av i avkrysningsboksene, og klikker deretter på Tillat og avdrag. 

Dataformat for synkronisering mellom HubSpot og Google BigQuery

Tilgjengelige data for synkronisering

Du kan synkronisere følgende data fra HubSpot til Google BigQuery: 

• Objekter: standard og egendefinerte objekter, for eksempel kontakter, selskaper, tickets eller produkter.
• Oppføringer: Oppføringer av individuelle objekter. 
• Tilknytninger: alle typer tilknytninger og tilknyttede oppføringer.
• Hendelser: Hendelsesdata for både standard HubSpot-hendelser og egendefinerte atferdsmessige hendelser. 
• Segmenter: HubSpot kontakt- og bedriftssegmenter.
• Eiere: Oppføring av eiere. 
• Pipelines: avtale- og ticket-pipelines og pipeline-faser. 
• Egenskaper: egenskaper og deres verdier på objektets oppføringer, inkludert egenskapsoversikten. 

Objektdata av ulike typer er organisert og tilgjengelig på to måter:

• Individuell: ehver objekttype lagres i sin egen tabell og har bare oppføringer av samme objekttype. For eksempel objects_contacts inneholder bare kontaktoppføringer.
• Kombinert: Alleoppføringer 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 får tildelt 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 er navngitt etter formatet OBJECTS_<object type name> hvor <object type name> er betegnelsen på flertallsskjemaet for objecttype(Merk at hvis objekttypen ikke har noe skjema i flertall, vil <object type name> vil være entallsformen av objekttypens navn sammenkjedet med "S").

Nedenfor finner du en fullstendig liste over tilgjengelige HubSpot-objekttyper, en kort beskrivelse av dataene de representerer, og de tilhørende tabellene.

objekt_med_objektegenskaper

Denne tabellen inneholder data fra oppføringene dine i HubSpot. Du kan få én rad for hver oppføring i en objekttype (f.eks. alle kontaktoppføringer i objekttypen kontakter). 

object_properties_history

Denne tabellen inneholder historiske verdier for egenskaper. For kontakter inneholder den de 45 siste verdiene. For alle andre objekter inneholder den de 20 siste verdiene. Tabellen har en rad for hver historiske egenskap. Den nåværende verdien av en egenskap bestemmes av det siste UPDATEDAT-tidsstempelet i egenskapens historikk.

Tilknytning spørsmål

I likhet med data om objekter er data om tilknytninger organisert på to måter:

• Individuell: Hver type tilknytning lagres i sin egen tabell og inneholder bare oppføringer av den typen. For eksempel associations_contacts_to_deals inneholder bare tilknytninger for oppføring mellom kontakt- og avtaleobjekter. T
• Kombinert: Alle oppføringer for alle typer tilknytninger samles i én tabell.

assosiasjoner_x_til_y 

Hver type tilknytning 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 egenskaper for objekter og hendelser i HubSpot-kontoen din. Egenskapene for hendelser omfatter standardhendelser, for eksempel åpning og klikk på e-post, og egendefinerte atferdsmessige hendelser. Denne informasjonen kan være nyttig for å definere verdier som finnes i object_properties og data om hendelser.

Hendelser

Hendelser inkluderer standard HubSpot-hendelser og egendefinerte atferdsmessige hendelser. 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 på HubSpot-kontoen din.

Synkroniseringsfrekvens og organisering av data

Datasynkroniseringsjobber mellom HubSpot og Google BigQuery starter hver dag ca. kl. 06:00 UTC. Hvor lang tid det tar før data synkroniseres med Google BigQuery, avhenger av kontoens køposisjon og datavolum. Gjennomføringstiden er ikke garantert.

Det opprettes en mappe for hver dag dataene synkroniseres, med flere undermapper for hver tabell. De sju siste synkroniseringene vil være tilgjengelige i Google Cloud-plattformen, og tabeller i BigQuery oppdateres til å peke på den nyeste bucket-dumpen.

Hver av de følgende tabellene vil være tilgjengelig som en fil i Parkett-format:

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