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 App Marketplace firmy HubSpot
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.

• 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ę Rata.
• Wprowadź identyfikator URI Bucket 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. Tworzenie niestandardowej roli 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 opcję Utwórz rolę.
• Wprowadź tytuł, opcjonalny opis i identyfikator roli.
• Kliknij 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 View by principals kliknij opcję Grant access.

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

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

• Kliknij menu nawigacyjne po lewej stronie i wybierz IAM & Admin > IAM.
• Kliknij opcję Grant Access.
• W prawym panelu w polu New principals wprowadź wygenerowane przez HubSpot konto Google BigQuery z kroku 1.
• 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

• Na koncie HubSpot kliknij przycisk Continue to Connected Apps.

• 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, zgłoszenia lub produkty.
• Rekordy: rekordy poszczególnych 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 : właściciele rekordów.
• Pipelines : procesy przetwarzania zgłoszeń i etapy transakcji.
• 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 mają nazwy obserwujące format 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łą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.

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 kontaktu i transakcji. T
• Combined: wszystkie rekordy dla wszystkich typów asocjacji są połą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 zdarzeniach 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ń.

Zdarzenia

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, zostanie utworzony 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