Anslut 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 gå 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. Slutför konfigurationen 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 denna betaversion: 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 av app uppe till höger.
4. Ange din Bucket URI och ditt projekt-ID.
5. Klicka på Nästa.

6. Granska och notera kontona för Google Service och BigQuery eftersom du kommer att behöva 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 högst 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 bucket som ska konfigureras.
3. Klicka på fliken Behörigheter.
4. På fliken Visa efter huvudmän klickar du på Ge åtkomst .

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 > <roll> där <roll> ä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.
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 > <roll> där <roll> är den anpassade IAM-roll som skapades i steg 2.

5. Fullständig installation i HubSpot

1. I ditt HubSpot-konto klickar du på Fortsätt till Anslutna konton.

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 avassociationer och tillhörande register.
• Händelser: händelsedata för både standardhändelser i HubSpot och anpassade händelser.
• Listor: Listor över kontakter och företag i HubSpot.
• Ägare: ägare till register.
• Pipelines : affärs- och Ärendepipelines och pipeline-faser.
• Egenskaper: egenskaper och deras värden i objektregister, inklusive egenskapshistorik.

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

• Individuell: varje typ av objekt lagras i sin egen tabell och har endast register av samma typ av objekt. Till exempel innehåller objects_contacts endast kontaktregister.
• Kombinerad: allaregister för alla typer av objekt kombineras till ett databasobjekt. När du gör en sökning måste du alltså 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 i pluralform för objecttype. (Observera att om typen av objekt inte har någon pluralform kommer <object type name> att vara etiketten i singularform för 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 register i HubSpot. 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 historiskt värde för en egenskap. Det aktuella värdet för 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 innehåller associations_contacts_to_deals endast associationregister mellan kontakt- och affärsobjekt. T
• Combined: alla register för alla typer av associations kombineras i en tabell.

föreningar_x_till_y

Varje typ av associationsetikett 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. Egenskaper för händelser inkluderar standardhändelser, t.ex. öppningar och klick på 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 object_properties och data om 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

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

Synkroniseringsfrekvens och organisering av data

Datasynkronisering startar dagligen mellan HubSpot och Google BigQuery kl. 0600 UTC +0. 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