Połączenie HubSpot i Google BigQuery (BETA)

Dowiedz się, jak połączyć HubSpot i Google BigQuery, aby zsynchronizować dane HubSpot z instancją 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. Tworzenie niestandardowej roli IAM w Google Cloud Platform
3. Przypisz rolę niestandardową do konta usługi Google
4. Przyznaj wygenerowanemu przez HubSpot kontu Google BigQuery uprawnienia do modyfikowania tabel BigQuery.
5. Pełna konfiguracja 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.

• Upewnij się, że Twoje konto HubSpot jest włączone do tej wersji beta: Dostęp do danych HubSpot w Google BigQuery.
• Przejdź do tego linku i wybierz swoje konto HubSpot.
• W prawym górnym rogu kliknij opcję Zainstaluj aplikację.
• Wprowadź identyfikator URI kubełka i identyfikator projektu.
• Kliknij przycisk Dalej.

• Przejrzyj 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. Utwórz niestandardową rolę IAM w Google Cloud Platform

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

• 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

• Kliknij przycisk Utwórz.

3. Przypisz rolę niestandardową do konta usługi przechowywania w chmurze

• Kliknij menu nawigacyjne po lewej stronie i wybierz Cloud Storage > Buckets.
• Wybierz zasobnik do skonfigurowania.
• Kliknij kartę Uprawnienia.
• Na karcie Widok według zleceniodawców kliknij opcję Przyznaj dostęp.

• W prawym panelu, w polu New principals, wprowadź nazwę konta usługi Google z kroku 2.
• W sekcji Przypisz role kliknij menu rozwijane i wybierz opcję Niestandardowe > <rola>, gdzie <rola> to niestandardowa rola IAM utworzona w kroku 1.
• Kliknij przycisk Zapisz. Konto Google Service zostanie dodane do roli Storage Object Viewer .

4. Przyznaj wygenerowanemu przez HubSpot kontu Google BigQuery uprawnienia do modyfikowania tabel BigQuery

• Kliknij menu nawigacyjne po lewej stronie i wybierz IAM & Admin > IAM.
• Kliknij przycisk Udziel dostępu.
• W prawym panelu, w polu New principals, wprowadź nazwę konta usługi Google z kroku 2.
• W sekcji Przypisz role kliknij menu rozwijane i wybierz opcję Niestandardowe > <rola>, gdzie <rola> to niestandardowa rola IAM utworzona w kroku 1.

5. Pełna konfiguracja w HubSpot

• Na koncie HubSpot kliknij przycisk Przejdź do połączonych aplikacji.

• 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żesz zsynchronizować następujące dane z HubSpot do Google BigQuery:

• Obiekty: standardowe i niestandardowe obiekty, takie jak kontakty, firmy, bilety lub produkty.
• Rekordy: indywidualne rekordy obiektów.
• Asocjacje: wszystkie typy asocjacji 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: zarejestrowani właściciele.
• Potoki: potoki transakcji i zgłoszeń oraz etapy potoku.
• Właściwości: właściwości i ich wartości w rekordach obiektów, w tym historia właściwości.

Dane obiektów różnych typów 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 kontaktów.
• 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'

Obiekty niestandardowe będą miały przypisany identyfikator w momencie tworzenia i będą identyfikowane 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ą formy liczby mnogiej objecttype.(Należy pamiętać, że jeśli typ obiektu nie ma formy liczby mnogiej, wówczas <object type name> będzie etykietą formy liczby pojedynczej nazwy typu obiektu połączonej 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 kontaktów w typie obiektu kontakty).

object_properties_history

Ta tabela zawiera historyczne wartości nieruchomoś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.

Zapytania dotyczące stowarzyszenia

Podobnie jak dane obiektów, dane asocjacji są zorganizowane na dwa sposoby:

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

associations_x_to_y

Każdy typ asocjacji ma swój własny widok, oznaczony jako 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 właściwościach zdarzeń na koncie HubSpot. Właściwości zdarzeń obejmują standardowe zdarzenia, takie jak otwarcia i kliknięcia wiadomości e-mail, oraz niestandardowe właściwości zdarzeń behawioralnych. Informacje te mogą być pomocne przy definiowaniu wartości znalezionych w object_properties i danych zdarzeń.

Wydarzenia

Zdarzenia obejmują standardowe zdarzenia HubSpot i niestandardowe zdarzenia behawioralne. Każde zdarzenie ma własną tabelę, oznaczoną jako 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

Dane są synchronizowane codziennie między HubSpot i Google BigQuery o 0900 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 poniższych tabel będzie dostępna jako folder z rozpakowanymi plikami CSV:

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