I betaKontakt HubSpot og Google BigQuery

Lær, hvordan du kontakter HubSpot og Google BigQuery for at synkronisere HubSpot-data til din Google BigQuery-instans.

Bemærk: HubSpot deler ikke HIPAA-data med Google BigQuery.

Kontakt HubSpot og BigQuery

For at kontakte HubSpot og Google BigQuery skal du køre gennem disse trin i rækkefølge:

1. Rate Google BigQuery fra HubSpot App Marketplace.
2. Opret en brugerdefineret IAM-rolle i Google Cloud Platform.
3. Tildel den tilpassede rolle til Google Service-kontoen.
4. Giv den HubSpot-genererede Google BigQuery-konto tilladelse til at ændre BigQuery-tabeller.
5. Komplet opsætning i HubSpot.

1. Rate Google BigQuery fra HubSpot App Marketplace

Det anbefales, at du har din HubSpot-konto og Google BigQuery-konto åben i separate faner, når du kontakter de to apps. 

1. Sørg for, at din HubSpot-konto er valgt til betaen: Få adgang til HubSpot-data i Google BigQuery. 
2. Naviger til dette link , og vælg din HubSpot-konto. 
3. Klik på Rate .
4. Indtast din Bucket URI og dit projekt-ID. 
5. Klik på Næste. 
6. Anmeld og noter Google Service- og BigQuery-kontiene, da du skal bruge dem i næste trin. Naviger derefter til din Google Cloud-konsol for at gennemføre det næste trin. 

2. Opret en brugerdefineret IAM-rolle i Google Cloud Platform

1. Log ind på din Google Cloud-konsol. 
2. Klik på navigationsmenuen til venstre, og vælg IAM & Admin > Roles. 
3. Klik på Opret rolle øverst.
4. Indtast en titel, valgfri beskrivelse og ID for rollen. 
5. Klik på Tilføj tilladelser. 

6. Vælg følgende tilladelser i tabellen, og klik på Tilføj:

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. Klik på Opret. 

3. Giv Google Service-kontoen tilladelse til at få adgang til Cloud Storage Buckets

1. Klik på navigationsmenuen til venstre, og vælg Cloud Storage > Buckets. 
2. Vælg en spand , der skal konfigureres. 
3. Klik på fanen Tilladelser .
4. Klik på Giv adgang på fanen Vis efter hovedpersoner .

5. I højre panel, i feltet New principals , skal du indtaste navnet på Google Service-kontoen fra trin 1.

Bemærk: Sørg for at tildele Google Service-kontoen, ikke BigQuery-kontoen.

6. I afsnittet Assign roles skal du klikke på rullemenuen og vælge Custom > <role> , hvor <role> er den brugerdefinerede IAM-rolle, der blev oprettet i trin 2. 
7. Klik på Gem. Google Service-kontoen bliver føjet til rollen Storage Objekt Viewer . 

4. Giv den HubSpot-genererede Google BigQuery-konto tilladelse til at ændre BigQuery-tabeller

1. Klik på navigationsmenuen til venstre, og vælg IAM & Admin > IAM. 
2. Klik på Giv adgang.
3. I det højre panel i feltet New principals skal du indtaste den HubSpot-genererede Google BigQuery-konto fra trin 1.
4. I afsnittet Assign roles skal du klikke på rullemenuen og vælge Custom > <role> , hvor <role> er den brugerdefinerede IAM-rolle, der blev oprettet i trin 2. 

5. Komplet opsætning i HubSpot

1. Tilbage på din HubSpot-konto skal du klikke på Continue to Connected Apps. 
2. Marker afkrydsningsfelterne i dialogboksen, og klik derefter på Tillad og rate. 

Dataformat til synkronisering mellem HubSpot og Google BigQuery

Tilgængelige data til synkronisering

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

• Objekter: standard- og brugerdefinerede objekter, f.eks. kontakter, virksomheder, tickets eller produkter.
• Registre: individuelle objektregistre. 
• Tilknytninger: alle typer af tilknytninger og tilknyttede registre.
• Hændelser: hændelsesdata for både standard HubSpot-hændelser og brugerdefinerede adfærdsmæssige hændelser. 
• Segmenter: HubSpot-kontakt- og virksomhedssegmenter.
• Ejere: registrerede ejere. 
• Pipelines: deal- og ticket-pipelines og pipeline-faser. 
• Egenskaber: Egenskaber og deres værdier på objektregistrene, herunder egenskabshistorikken. 

Objektdata af forskellige typer er organiseret og tilgængelige på to måder:

• Individuel: eHver objekttype gemmes i sin egen tabel og har kun registre af samme objekttype. For eksempel, objects_contacts indeholder kun kontaktregistre.
• Kombineret: alleregistre for alle objekttyper kombineres til ét databaseobjekt. Når du forespørger, skal du således angive et filter som "WHERE objectTypeId='0-1'

Brugerdefinerede objekter får tildelt et ID på oprettelsestidspunktet og identificeres som 2-unique_ID. For eksempel 2-12345. 

objekter_x tabeller

Hver tilgængelig objekttype, inklusive brugerdefinerede objekter, har sin egen specifikke tabel. Disse tabeller navngives ved at følge formatet OBJECTS_<object type name> hvor <object type name> er plural formular label af objekttypen objecttype(Bemærk, at hvis objekttypen ikke har nogen flertalsform, så vil <object type name> vil være entalsformens label af objekttypens navn sammenkædet med "S").

Nedenfor er en komplet liste over tilgængelige HubSpot-objekttyper, en kort beskrivelse af de data, de repræsenterer, og deres tilsvarende tabeller.

objekt_med_objekt_egenskaber

Denne tabel indeholder data fra dine HubSpot-registre. Du kan få en række for hvert register inden for en objekttype (f.eks. alle kontaktregistre i objekttypen kontakter). 

objekt_egenskaber_historie

Denne tabel indeholder historiske værdier for egenskaber. For kontakter indeholder den de seneste 45 værdier. For alle andre objekter indeholder den de seneste 20 værdier. Tabellen har en række for hver historisk værdi af egenskaben. Den aktuelle værdi af en egenskab bestemmes af det seneste UPDATEDAT-tidsstempel i egenskabens historik.

Forespørgsler om tilknytning

Ligesom data om objekter er data om tilknytninger organiseret på to måder:

• Individuel: Hver type tilknytning gemmes i sin egen tabel og indeholder kun registre af den type. For eksempel, associations_contacts_to_deals indeholder kun tilknytningsregistre mellem kontakt- og dealobjekter. T
• Kombineret: alle registre for alle typer af tilknytninger kombineres i én tabel.

associationer_x_til_y 

Hver type tilknytning har sin egen visning, mærket som associations_<association type name> f.eks. associations_contacts_to_deals. 

association_definitioner

Denne tabel indeholder oplysninger om alle tilgængelige tilknytningstyper mellem HubSpot-objekter, med en række pr. tilknytningstype.

egenskaber_definitioner

Denne tabel indeholder oplysninger om egenskaber for objekter og hændelser på din HubSpot-konto. Egenskaber for hændelser omfatter standardhændelser, som f.eks. åbning og klik på e-mails, og brugerdefinerede adfærdsmæssige hændelser. Disse oplysninger kan være nyttige til at definere værdier, der findes i object_properties og data om hændelser.

Hændelser

Hændelser omfatter standard HubSpot-hændelser og brugerdefinerede adfærdsmæssige hændelser. Hver hændelse har sin egen tabel, labelet som events_eventname.

objekt_og_hændelsestype_definitioner

Denne tabel indeholder definitioner for alle objekter og hændelser, der er tilgængelige på din HubSpot-konto.

Synkroniseringsfrekvens og dataorganisation

Datasynkroniseringsjobs mellem HubSpot og Google BigQuery starter dagligt omkring kl. 6:00 UTC. Den tid, det tager for data at blive synkroniseret til Google BigQuery, afhænger af din kontos køposition og datamængde. Gennemførelsestiden er ikke garanteret.

Der oprettes en mappe for hver dag, dataene synkroniseres, med flere undermapper for hver tabel. De sidste syv synkroniseringer vil være tilgængelige på Google Cloud-platformen, og tabeller i BigQuery opdateres til at pege på det seneste bucket-dump.

Hver af de følgende tabeller vil være tilgængelige som en fil i Parket-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