TestversionAnslut HubSpot och Google BigQuery

Lär dig hur du ansluter HubSpot och Google BigQuery för att synkronisera HubSpot-data till din Google BigQuery-instans.

Observera: HubSpot delar inte HIPAA-data till Google BigQuery.

Anslut HubSpot och BigQuery

För att ansluta HubSpot och Google BigQuery måste du köra igenom dessa steg i ordning:

1. Delbetalning av Google BigQuery från HubSpot App Marketplace.
2. Skapa en anpassad IAM-roll i Google Cloud Platform.
3. Tilldela den anpassade rollen till Google Service-kontot.
4. Ge det HubSpot-genererade Google BigQuery-kontot behörighet att ändra BigQuery-tabeller.
5. Komplett installation i HubSpot.

1. Delbetalning av Google BigQuery från HubSpot App Marketplace

Vi rekommenderar att du har ditt HubSpot-konto och Google BigQuery-konto öppna i separata flikar när du ansluter de två apparna. 

1. Se till att ditt HubSpot-konto är registrerat för betaversionen: Få tillgång till HubSpot-data i Google BigQuery. 
2. Navigera till den här länken och välj ditt HubSpot-konto. 
3. Klicka på Delbetalning.
4. Ange din Bucket URI och ditt projekt-ID. 
5. Klicka på Nästa. 
6. Granskning och notering av konton för Google Service och BigQuery eftersom du behöver dem i nästa steg. Navigera sedan till din Google Cloud-konsol för att slutföra nästa steg. 

2. Skapa en anpassad IAM-roll i Google Cloud Platform

1. Logga in på din Google Cloud-konsol. 
2. Klicka på den vänstra navigeringsmenyn och välj IAM & Admin > Roles. 
3. Klicka på Skapa roll längst upp.
4. Ange en titel, valfri beskrivning och ID för rollen. 
5. Klicka på Lägg till behörigheter. 

6. Välj följande behörigheter i tabellen och klicka på Lägg till:

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. Klicka på Skapa. 

3. Ge Google Service Konto behörigheter för åtkomst till Cloud Storage Buckets

1. Klicka på den vänstra navigeringsmenyn och välj Cloud Storage > Buckets. 
2. Välj en skopa som ska konfigureras. 
3. Klicka på fliken Behörigheter .
4. Klicka på Ge åtkomst på fliken Visa efter huvudmän .

5. I fältet Nya huvudmän i den högra panelen anger du namnet på Google Service-kontot från steg 1.

Observera: se till att tilldela Google Service-kontot, inte BigQuery-kontot.

6. I avsnittet Tilldela roller klickar du på rullgardinsmenyn och väljer Anpassad > <role> där <role> är den anpassade IAM-roll som skapades i steg 2. 
7. Klicka på Spara. Google Service-kontot kommer att läggas till i rollen Storage Objekt Viewer . 

4. Ge det HubSpot-genererade Google BigQuery-kontot behörighet att ändra BigQuery-tabeller

1. Klicka på den vänstra navigeringsmenyn och välj IAM & Admin > IAM. 
2. Klicka på Grant Access (Ge åtkomst).
3. I den högra panelen, i fältet Nya huvudmän , anger du det HubSpot-genererade Google BigQuery-kontot från steg 1.
4. I avsnittet Tilldela roller klickar du på rullgardinsmenyn och väljer Anpassad > <role> där <role> är den anpassade IAM-roll som skapades i steg 2. 

5. Fullständig installation i HubSpot

1. Tillbaka på ditt HubSpot-konto klickar du på Fortsätt till Anslutna appar. 
2. Markera kryssrutorna i dialogrutan och klicka sedan på Tillåt och delbetalning. 

Dataformat för synkronisering mellan HubSpot och Google BigQuery

Tillgängliga data för synkronisering

Du kan synkronisera följande data från HubSpot till Google BigQuery: 

• Objekt: standardobjekt och anpassade objekt, t.ex. kontakter, företag, supportärenden eller produkter.
• Register: enskilda objektregister. 
• Associations: alla typer av associationer och tillhörande register.
• Händelser: Händelsedata för både standard HubSpot-händelser och anpassade händelser. 
• Segment: HubSpot kontakt- och företagssegment.
• Ägare: Register över ägare. 
• Pipelines: affärs- och Ärendepipelines och pipeline-faser. 
• Egenskaper: egenskaper och deras värden i objektregistren, inklusive egenskapshistoriken. 

Data om objekt av olika typer organiseras och är tillgängliga på två sätt:

• Individuell: evarje typ av objekt lagras i sin egen tabell och har endast register av samma typ av objekt. Till exempel objects_contacts innehåller endast kontaktregister.
• Kombinerad: allaregister för alla typer av objekt kombineras till ett databasobjekt. När du ställer en fråga måste du därför ange ett filter som "WHERE objectTypeId='0-1'

Anpassade objekt kommer att tilldelas ett ID vid skapandet och identifieras som 2-unique_ID. Till exempel 2-12345. 

objekt_x tabeller

Varje tillgänglig typ av objekt, inklusive anpassade objekt, har sin egen specifika tabell. Dessa tabeller namnges enligt formatet OBJECTS_<object type name> där <object type name> är etiketten för pluralform för objecttype.(Observera att om typen av objekt inte har någon pluralform, så kommer <object type name> vara etiketten för singularform av namnet på typen av objekt sammanlänkat med "S").

Nedan finns en fullständig lista över tillgängliga HubSpot-typer av objekt, en kort beskrivning av de data de representerar och deras motsvarande tabeller.

objekt_med_objekt_egenskaper

Den här tabellen innehåller data från dina HubSpot-register. Du kan få en rad för varje register inom en objekttyp (t.ex. alla kontaktregister i objekttypen kontakter). 

objekt_egenskaper_historik

Denna tabell innehåller historiska värden för egenskaper. För kontakter innehåller den de senaste 45 värdena. För alla andra objekt innehåller den de senaste 20 värdena. Tabellen har en rad för varje historisk egenskap. Det aktuella värdet på en egenskap bestäms av den senaste UPDATEDAT-tidsstämpeln i egenskapens historik.

Förfrågningar från Association

Precis som data om objekt organiseras data om associationer på två olika sätt:

• Individual: varje typ av association lagras i en egen tabell och innehåller endast register av den typen. Till exempel associations_contacts_to_deals innehåller endast associationregister mellan kontakt- och affärsobjekt. T
• Kombinerad: alla register för alla typer av Associations kombineras i en tabell.

föreningar_x_till_y 

Varje typ av association har sin egen vy, märkt som associations_<association type name> t.ex. associations_contacts_to_deals. 

associationer_definitioner

Den här tabellen innehåller information om alla tillgängliga typer av associationer mellan HubSpot-objekt, med en rad per typ av objekt.

fastighets_definitioner

Den här tabellen innehåller information om egenskaper för objekt och händelser i ditt HubSpot-konto. Egenskaperna för händelser omfattar standardhändelser, t.ex. öppningar och klick i e-postmeddelanden, och egenskaper för anpassade händelser. Denna information kan vara till hjälp för att definiera värden som finns i data för object_properties och händelser.

Händelser

Händelser inkluderar standard HubSpot-händelser och anpassade beteendemässiga händelser. Varje händelse har sin egen tabell, märkt som events_eventname.

objekt_och_händelsetyp_definitioner

Den här tabellen innehåller definitioner för alla objekt och händelser som finns tillgängliga på ditt HubSpot-konto.

Synkroniseringsfrekvens och organisering av data

Datasynkroniseringsjobb mellan HubSpot och Google BigQuery startar dagligen cirka kl. 6:00 UTC. Den tid det tar för data att synkroniseras till Google BigQuery beror på ditt kontos köposition och datavolym. Färdigställandetiderna är inte garanterade.

En mapp skapas för varje dag som data synkroniseras med flera undermappar för varje tabell. De senaste sju synkroniseringarna kommer att finnas tillgängliga i Google Cloud-plattformen och tabeller i BigQuery uppdateras för att peka på den senaste bucket dump.

Var och en av de följande tabellerna kommer att finnas tillgänglig som en fil i Parquet-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