Połączenie HubSpot i Google BigQuery

Dowiedz się, jak połączyć HubSpot i Google BigQuery, aby zsynchronizować dane HubSpot z instancją Google BigQuery.

Uwaga: HubSpot nie udostępnia danych HIPAA do Google BigQuery.

Połączenie HubSpot i BigQuery

Aby połączyć HubSpot i Google BigQuery, należy wykonać następujące kroki w kolejności:

1. Zainstaluj Google BigQuery z HubSpot App Marketplace
2. Utwórz niestandardową rolę IAM w Google Cloud Platform
3. Przypisać niestandardową rolę do konta usługi Google
4. Przyznaj wygenerowanemu przez HubSpot kontu Google BigQuery uprawnienia do modyfikowania tabel BigQuery
5. Zakończ konfigurację w HubSpot

1. Zainstaluj Google BigQuery z HubSpot App Marketplace

Zaleca się, aby konto HubSpot i konto Google BigQuery były otwarte w osobnych kartach podczas łączenia obu aplikacji.

1. Upewnij się, że Twoje konto HubSpot jest zgodne z tą wersją beta: Dostęp do danych HubSpot w Google BigQuery.
2. Przejdź do tego linku i wybierz swoje konto HubSpot.
3. W prawym górnym rogu kliknij opcję Rata.
4. Wprowadź identyfikator URI Bucket i identyfikator projektu.
5. Kliknij przycisk Dalej.

6. Oceń i zanotuj konta Google Service i BigQuery, ponieważ będziesz ich potrzebować w następnym kroku. Następnie przejdź do konsoli Google Cloud, aby wykonać następny krok.

2. Tworzenie niestandardowej roli IAM w Google Cloud Platform

1. Zaloguj się do konsoli Google Cloud.
2. Kliknij menu nawigacyjne po lewej stronie i wybierz IAM & Admin > Roles.
3. U góry kliknij opcję Utwórz rolę.
4. Wprowadź tytuł, opcjonalny opis i identyfikator roli.
5. Kliknij Dodaj uprawnienia.

6. W tabeli wybierz następujące uprawnienia i kliknij przycisk Dodaj:

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. Kliknij przycisk Utwórz.

3. Przyznanie kontu usługi Google uprawnień dostępu do Cloud Storage Buckets

1. Kliknij menu nawigacyjne po lewej stronie i wybierz Cloud Storage > Buckets.
2. Wybierz zasobnik do skonfigurowania.
3. Kliknij kartę Uprawnienia.
4. Na karcie View by principals kliknij opcję Grant access.

5. W prawym panelu, w polu Nowi zleceniodawcy, wprowadź nazwę konta usługi Google z kroku 1.

Uwaga: upewnij się, że przypisujesz konto usługi Google, a nie konto BigQuery.

6. W sekcji Przypisz role kliknij menu rozwijane i wybierz Custom > <role>, gdzie <role> to niestandardowa rola IAM utworzona w kroku 2.
7. Kliknij przycisk Zapisz. Konto Google Service zostanie dodane do roli Storage Obiekt Viewer .

4. Przyznanie wygenerowanemu przez HubSpot kontu Google BigQuery uprawnień do modyfikowania tabel BigQuery

1. Kliknij menu nawigacyjne po lewej stronie i wybierz IAM & Admin > IAM.
2. Kliknij opcję Grant Access.
3. W prawym panelu w polu New principals wprowadź wygenerowane przez HubSpot konto Google BigQuery z kroku 1.
4. W sekcji Przypisz role kliknij menu rozwijane i wybierz Custom > <role>, gdzie <role> to niestandardowa rola IAM utworzona w kroku 2.

5. Pełna konfiguracja w HubSpot

1. Na koncie HubSpot kliknij przycisk Continue to Connected Apps.

2. W oknie dialogowym zaznacz pola wyboru, a następnie kliknij Zezwól i zainstaluj.

Format danych do synchronizacji między HubSpot i Google BigQuery

Dostępne dane do synchronizacji

Można zsynchronizować następujące dane z HubSpot do Google BigQuery:

• Obiekty: standardowe i niestandardowe obiekty, takie jak kontakty, firmy, zgłoszenia lub produkty.
• Rekordy: rekordy poszczególnych obiektów.
• Powiązania : wszystkie typy powiązań i powiązane rekordy.
• Zdarzenia: dane zdarzeń zarówno dla standardowych zdarzeń HubSpot, jak i niestandardowych zdarzeń behawioralnych.
• Listy: Listy kontaktów i firm HubSpot.
• Właściciele : właściciele rekordów.
• Pipelines : procesy transakcji i zgłoszeń oraz ich etapy.
• Właściwość : właściwości i ich wartości w rekordach obiektu, w tym historia właściwości.

Dane obiektów różnego typu są zorganizowane i dostępne na dwa sposoby:

• Indywidualny : każdy typ obiektu jest przechowywany we własnej tabeli i zawiera tylko rekordy tego samego typu obiektu. Na przykład objects_contacts zawiera tylko rekordy kontaktu.
• Combined: wszystkierekordy dla wszystkich typów obiektów są łączone w jeden obiekt bazy danych. W związku z tym podczas wysyłania zapytania należy określić filtr typu "WHERE objectTypeId='0-1'

Obiektom niestandardowym zostanie przypisany identyfikator w momencie tworzenia i będzie on identyfikowany jako 2-unique_ID. Na przykład 2-12345.

objects_x tables

Każdy dostępny typ obiektu, w tym obiekty niestandardowe, ma swoją własną tabelę. Tabele te są nazywane zgodnie z formatem OBJECTS_<object type name>, gdzie <object type name> jest etykietą typu obiektu w liczbie mnogiej objecttype.(Należy pamiętać, że jeśli typ obiektu nie ma liczby mnogiej, wówczas <object type name> będzie etykietą typu obiektu w liczbie pojedynczej połączoną z "S").

Poniżej znajduje się pełna lista dostępnych typów obiektów HubSpot, krótki opis reprezentowanych przez nie danych oraz odpowiadające im tabele.

object_with_object_properties

Ta tabela zawiera dane z rekordów HubSpot. Można uzyskać jeden wiersz dla każdego rekordu w ramach typu obiektu (np. wszystkie rekordy kontaktu w typie obiektu kontakty).

object_properties_history

Ta tabela zawiera historyczne wartości Właściwości. W przypadku kontaktów zawiera 45 ostatnich wartości. Dla wszystkich innych obiektów zawiera 20 ostatnich wartości. Tabela zawiera wiersz dla każdej historycznej wartości właściwości. Bieżąca wartość właściwości jest określana przez najnowszy znacznik czasu UPDATEDAT w historii właściwości.

Powiązanie zapytań

Podobnie jak dane obiektów, dane powiązań są zorganizowane na dwa sposoby:

• Indywidualne: każdy typ powiązania jest przechowywany we własnej tabeli i zawiera tylko rekordy tego typu. Na przykład associations_contacts_to_deals zawiera tylko rekordy powiązań między obiektami kontaktu i transakcji. T
• Combined: wszystkie rekordy dla wszystkich typów powiązań są łączone w jednej tabeli.

associations_x_to_y

Każdy typ powiązania ma swój własny widok, oznaczony etykietą associations_<association type name> np. associations_contacts_to_deals.

association_definitions

Ta tabela zawiera informacje o wszystkich dostępnych typach powiązań między obiektami HubSpot, z jednym wierszem na typ powiązania.

property_definitions

Ta tabela zawiera informacje o właściwościach obiektów i zdarzeniach na koncie HubSpot. Właściwości zdarzeń obejmują standardowe zdarzenia, takie jak otwarcia i kliknięcia wiadomości e-mail, oraz niestandardowe zdarzenia behawioralne. Informacje te mogą być pomocne przy definiowaniu wartości znalezionych w object_properties i danych zdarzeń.

Zdarzenia

Zdarzenia obejmują standardowe zdarzenia HubSpot i niestandardowe zdarzenia behawioralne. Każde zdarzenie ma własną tabelę, oznaczoną etykietą events_eventname.

object_and_event_type_definitions

Ta tabela zawiera definicje wszystkich obiektów i zdarzeń dostępnych na koncie HubSpot.

Częstotliwość synchronizacji i organizacja danych

Synchronizacja danych między HubSpot i Google BigQuery rozpoczyna się codziennie o godzinie 0600 UTC +0. Dla każdego dnia, w którym dane są synchronizowane, tworzony jest folder z kilkoma podfolderami dla każdej tabeli. Siedem ostatnich synchronizacji będzie dostępnych na platformie Google Cloud, a tabele w BigQuery są aktualizowane w celu wskazania najnowszego zrzutu danych.

Każda z obserwujących tabel będzie dostępna jako plik w formacie Parquet:

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