Koble sammen HubSpot og Google BigQuery (BETA)

Finn ut hvordan du kobler HubSpot og Google BigQuery til å synkronisere HubSpot-data til din Google BigQuery-forekomst. 

Koble HubSpot og BigQuery

Hvis du vil koble til HubSpot og Google BigQuery, må du gå gjennom disse trinnene for å:

1. Installer Google BigQuery fra HubSpot App Marketplace
2. Opprett en egendefinert IAM-rolle i Google Cloud Platform
3. Tilordne den egendefinerte rollen til Google-tjenestekontoen
4. Gi HubSpot-genererte Google BigQuery-kontotillatelser til å endre BigQuery-tabeller
5. Fullfør oppsett i HubSpot

1. Installer Google BigQuery fra HubSpot App Marketplace

Det anbefales at du har HubSpot-kontoen og Google BigQuery-kontoen åpne i separate faner når du kobler til de to appene. 

• Sørg for at HubSpot-kontoen din er registrert i denne betaversjonen : Få tilgang til HubSpot-data i Google BigQuery. 
• Gå til denne koblingen og velg HubSpot-kontoen din. 
• Klikk på Installer app øverst til høyre.
• Angi bøtte-URI og prosjekt-ID. 
• Klikk på Neste. 

• Gjennomgå og noter deg Google-tjenesten og BigQuery-kontoene etter hvert som 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

• Logg på Google Cloud-konsollen. 
• 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 kontoen for skylagringstjenesten

• Klikk på navigasjonsmenyen til venstre, og velg Skylagring > Bøtter. 
• Velg en skuff som skal konfigureres. 
• Klikk på fanen Tillatelser.
• Klikk Gi tilgang på fanen Vis etter oppdragsgivere.

• Skriv inn navnet på Google-tjenestekontoen i trinn 1 i feltet Nye oppdragsgivere   i panelet til høyre.
• I delen Tildel roller klikker du på rullegardinmenyen og velger Egendefinert > <rolle> der <rolle> er den egendefinerte IAM-rollen som ble opprettet i trinn 2. 
• Klikk på Lagre. Google-tjenestekontoen legges til i rollen Visning av lagringsobjekt. 

4. Gi HubSpot-genererte Google BigQuery-kontotillatelser til å endre BigQuery-tabeller

• Klikk på den venstre navigasjonsmenyen og velg IAM & Admin > IAM. 
• Klikk på Gi tilgang.
• Skriv inn den HubSpot-genererte Google BigQuery-kontoen fra trinn 1 i panelet til høyre i feltet Nye oppdragsgivere.
• I delen Tildel roller klikker du på rullegardinmenyen og velger Egendefinert > <rolle> der <rolle> er den egendefinerte IAM-rollen som ble opprettet i trinn 2. 

5. Fullfør oppsettet i HubSpot

• Klikk på Fortsett til tilkoblede apper i HubSpot-kontoen din. 

• Velg 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: standard og egendefinerte objekter, for eksempel kontakter, selskaper, billetter eller produkter.
• Poster: individuelle objektposter. 
• Tilknytninger: alle tilknytningstyper og tilknyttede poster.
• Hendelser: Hendelsesdata for både standard HubSpot-hendelser og tilpassede atferdshendelser. 
• Lister: HubSpot-kontakt- og firmalister.
• Eiere: Record eiere. 
• Rørledninger: avtale- og billettrørledninger og rørledningstrinn. 
• Egenskaper: egenskaper og deres verdier på objektpostene, inkludert egenskapshistorikken. 

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

• Individual: e ach-objekttypen lagres i sin egen tabell og har bare poster av samme objekttype. objects_contacts inneholder for eksempel bare kontaktoppføringer.
• Kombinert: a ll-poster for alle objekttyper kombineres til ett databaseobjekt. Når du spør, må du derfor angi et filter som «WHERE OBJECTTYPEID =’0-1’»

Egendefinerte objekter vil bli tildelt en ID når de opprettes, og vil bli identifisert som 2-unique_ID. F.eks. 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> der <object type name> er flertallsskjemaetiketten for objecttype.(Merk at hvis objekttypen ikke har noen flertallsform, vil <object type name> være entallsformetiketten til objekttype-navnet sammenkjedet med «S»).

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

object_with_object_properties

Denne tabellen inneholder data fra HubSpot-postene dine. Du kan få én rad for hver post i en objekttype (f.eks. alle kontaktposter i objekttypen kontakter). 

object_properties_history

Denne tabellen inneholder historiske egenskapsverdier. For kontakter inneholder den de siste 45 verdiene. For alle andre objekter inneholder den de siste 20 verdiene. Tabellen har en rad for hver historiske egenskapsverdi. Gjeldende verdi for en eiendom bestemmes av det siste UPDATEDAT-tidsstempelet i eiendommens historikk.

Tilknytningsspørsmål

I likhet med objektdata er assosiasjonsdata organisert på to måter:

• Individuell: hver tilknytningstype lagres i sin egen tabell og inneholder bare poster av den typen. associations_contacts_to_deals eksempel bare tilknytningsposter mellom kontakt- og avtaleobjekter. T
• Kombinert: alle poster for alle tilknytningstyper kombineres i én tabell.

associations_x_to_y 

Hver tilknytningstype har sin egen visning, merket som associations_<association type name> f.eks. associations_contacts_to_deals. 

association_definitions

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 aktivitetsegenskaper i HubSpot-kontoen. Aktivitetsegenskaper inkluderer standardaktiviteter, for eksempel åpning av e-post og klikk, og egendefinerte atferdsmessige aktivitetsegenskaper. Denne informasjonen kan være nyttig for å definere verdier som finnes i objektegenskaper  og hendelsesdata.

Aktiviteter

Hendelser inkluderer standard HubSpot-hendelser og tilpassede atferdshendelser. Hver aktivitet har sin egen tabell, merket som events_eventname.

object_and_event_type_definitions

Denne tabellen inneholder definisjoner for alle objekter og aktiviteter som er tilgjengelige i HubSpot-kontoen din.

Synkroniseringsfrekvens og dataorganisering

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 tabellene i BigQuery oppdateres for å peke på den nyeste skuffedumpen.

Hver av de følgende tabellene vil være tilgjengelig som en parkettformatfil:

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