Koble HubSpot og Google BigQuery (BETA)

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:

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 Service-kontoen
4. Gi den HubSpot-genererte Google BigQuery-kontoen rettigheter til å endre BigQuery-tabeller
5. 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.

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