Wersja betaPołą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 uruchomić 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. 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. 

1. Upewnij się, że Twoje konto HubSpot jest zgodne z wersją beta: Dostęp do danych HubSpot w Google BigQuery. 
2. Przejdź do tego linku i wybierz swoje konto HubSpot. 
3. Kliknij przycisk Rata.
4. Wprowadź identyfikator URI kubełka 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 przycisk Utwórz rolę.
4. Wprowadź tytuł, opcjonalny opis i identyfikator roli. 
5. Kliknij przycisk 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 Widok według zleceniodawców kliknij opcję Przyznaj dostęp.

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 opcję Niestandardowa > <role> , gdzie <role> to niestandardowa rola IAM utworzona w kroku 2. 
7. Kliknij przycisk Zapisz. Konto usługi Google zostanie dodane do roli Storage Obiekt Viewer . 

4. Nadanie 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 przycisk Udziel dostępu.
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 opcję Niestandardowa > <role> , gdzie <role> to niestandardowa rola IAM utworzona w kroku 2. 

5. Pełna konfiguracja w HubSpot

1. Po powrocie na konto 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: indywidualne rekordy Obiektu. 
• Powiązania: wszystkie typy powiązań i powiązane rekordy.
• Zdarzenia: dane zdarzeń zarówno dla standardowych zdarzeń HubSpot, jak i niestandardowych zdarzeń behawioralnych. 
• Segmenty: Segmenty kontaktów i firm HubSpot.
• Właściciele: Rekordowi właściciele. 
• Procesy sprzedaży: Procesy transakcji i zgłoszeń oraz etapy procesu sprzedaży. 
• 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:

• Individual: eKaż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 ich utworzenia i będzie on oznaczony 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ą liczby mnogiej formularza objecttype.(Zwróć uwagę, ż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 twoich 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

Tabela zawiera historyczne wartości Właściwości. W przypadku kontaktów zawiera on 45 najnowszych wartości. W przypadku wszystkich innych obiektów zawiera ona 20 ostatnich wartości. Tabela zawiera wiersz dla każdej historycznej wartości Właściwości. Aktualna wartość właściwości jest określana przez ostatni 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
• Połączone: wszystkie rekordy dla wszystkich typów powiązań są łączone w jedną tabelę.

associations_x_to_y 

Każdy typ powiązania ma swój własny widok, oznaczony etykietą powiązania 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 znajdujących się w danych object_properties i zdarzeniach.

Zdarzenia

Zdarzenia obejmują standardowe zdarzenia HubSpot i niestandardowe zdarzenia behawioralne. Każde zdarzenie ma swoją 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

Zadania synchronizacji danych między HubSpot i Google BigQuery rozpoczynają się codziennie około godziny 6:00 czasu UTC. Czas potrzebny na synchronizację danych z Google BigQuery zależy od pozycji konta w kolejce i ilości danych. Czas ukończenia nie jest gwarantowany.

Dla każdego dnia synchronizacji danych 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 zostaną zaktualizowane, aby wskazywały na najnowszy zrzut bucket.

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