Anslut HubSpot och Google BigQuery (BETA)

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

Koppla ihop HubSpot och BigQuery

För att koppla ihop HubSpot och Google BigQuery måste du gå igenom dessa steg i tur och ordning:

1. Installera 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. Fullständig installation i HubSpot

1. Installera 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.

• Se till att ditt HubSpot-konto är valt till denna beta: Få tillgång till HubSpot-data i Google BigQuery.
• Navigera till den här länken och välj ditt HubSpot-konto.
• Klicka på Installera app längst upp till höger.
• Ange din Bucket URI och ditt projekt-ID.
• Klicka på Nästa.

• Granska och notera kontona 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

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

• 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

• Klicka på Skapa.

3. Tilldela den anpassade rollen till Cloud Storage Service-kontot

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

• I fältet New principals i den högra panelen anger du namnet på Google Service-kontot från steg 2.
• 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 1.
• Klicka på Spara. Google Service-kontot kommer att läggas till i rollen Storage Object Viewer .

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

• Klicka på den vänstra navigeringsmenyn och välj IAM & Admin > IAM .
• Klicka på Grant Access (Ge åtkomst).
• I fältet New principals i den högra panelen anger du namnet på Google Service-kontot från steg 2.
• 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 1.

5. Fullständig installation i HubSpot

• I ditt HubSpot-konto klickar du på Continue to Connected Apps.

• Markera kryssrutorna i dialogrutan och klicka sedan på Tillåt och installera.

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:

• Objects: standardobjekt och anpassade objekt, t.ex. kontakter, företag, biljetter eller produkter.
• Register: register över enskilda objekt.
• Associations: alla typer avassociationer och tillhörande poster.
• Händelser: Händelsedata för både standardhändelser i HubSpot och anpassade beteendehändelser.
• Listor: HubSpots kontakt- och företagslistor.
• Ägare: registreradeägare .
• Pipelines: pipelines för affärer och ärenden samt pipelinefaser.
• Properties: egenskaper och deras värden i objektposterna, inklusive egenskapshistorik.

Objektdata av olika slag är organiserade och tillgängliga på två sätt:

• Individuell: varje objekttyp lagras i en egen tabell och innehåller endast poster av samma objekttyp. Till exempel innehåller objects_contacts endast kontaktposter.
• Combined: allaposter för alla objekttyper 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 tilldelas ett ID när de skapas och identifieras som 2-unique_ID. Till exempel 2-12345.

objekt_x tabeller

Varje tillgänglig objekttyp, inklusive anpassade objekt, har sin egen specifika tabell. Dessa tabeller namnges enligt formatet OBJECTS_<object type name> där <object type name> är pluralformen av objecttype. (Observera att om objekttypen inte har någon pluralform, kommer <object type name> att vara singularformen av objekttypens namn sammanlänkat med "S").

Nedan finns en fullständig lista över tillgängliga HubSpot-objekttyper, 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-poster. Du kan få en rad för varje post inom en objekttyp (t.ex. alla kontaktposter i objekttypen kontakter).

objekt_egenskaper_historik

Denna tabell innehåller historiska fastighetsvärden. 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 egenskapsvärde. Det aktuella värdet för en egenskap bestäms av den senaste UPDATEDAT-tidsstämpeln i egenskapens historik.

Föreningens förfrågningar

Precis som objektdata är associationsdata organiserad på två sätt:

• Individuell: varje associationstyp lagras i en egen tabell och innehåller endast poster av den typen. Till exempel innehåller associations_contacts_to_deals endast associationer mellan kontakt- och affärsobjekt. T
• Kombinerad: alla poster för alla föreningstyper kombineras i en tabell.

föreningar_x_till_y

Varje associationstyp 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 associationstyper mellan HubSpot-objekt, med en rad per associationstyp.

fastighets_definitioner

Den här tabellen innehåller information om objekt- och händelseegenskaper i ditt HubSpot-konto. Händelseegenskaper inkluderar standardhändelser, t.ex. öppningar och klick på e-postmeddelanden, och anpassade beteendemässiga händelse egenskaper. Den här informationen kan vara till hjälp för att definiera värden som finns i object_properties och händelsedata.

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 i ditt HubSpot-konto.

Synkroniseringsfrekvens och dataorganisation

Data synkroniseras dagligen mellan HubSpot och Google BigQuery kl. 0900 UTC +0. En mapp kommer att 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 följande tabeller kommer att finnas tillgänglig som en mapp med gzippade 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