Wersja betaPołącz HubSpot z Google BigQuery

Zsynchronizuj dane z Google BigQuery z obiektami w HubSpot CRM, takimi jak kontakty, firmy, transakcje, powiązania oraz inne dane z Twojego konta.

W poniższych sekcjach opisano, jak autoryzować aplikację Google BigQuery, a następnie skonfigurować ustawienia synchronizacji między kontem Google Cloud a HubSpot.

Podłącz i skonfiguruj integrację z Google BigQuery

Aby połączyć swoje konto Google BigQuery z HubSpot:

1. Na koncie HubSpot kliknij ikonę Marketplace w górnym panelu nawigacyjnym, następnie wybierz HubSpot Marketplace.
2. Kliknij pasek wyszukiwania i wpisz „Google BigQuery”.
3. Na stronie z listą wybierz opcję „Google BigQuery ”.
4. Kliknij „Zainstaluj”.
5. Kliknij opcję Kontynuuj konfigurację.

Zostaniesz przekierowany do narzędzia integracji danych, gdzie panel boczny poprowadzi Cię przez proces synchronizacji danych między kontami HubSpot i BigQuery zgodnie z wybranymi kierunkami synchronizacji:

• Google BigQuery → HubSpot: skonfiguruj synchronizację z BigQuery do HubSpot.
• HubSpot → Google BigQuery: skonfiguruj synchronizację z HubSpot do BigQuery.

Zsynchronizuj dane z Google BigQuery z kontem HubSpot

Aby przesłać dane z Google BigQuery do HubSpot, dodaj i skonfiguruj nowego użytkownika z wymaganymi rolami na swoim koncie BigQuery:

1. W prawym panelu wybierz Google BigQuery → HubSpot.
2. Skopiuj adres e-mail konta usługowego Google wygenerowany przez HubSpot.

3. Na koncie Google Cloud przejdź do ustawień IAM swojego projektu, utwórz nowego użytkownika, używając adresu e-mail konta usługowego skopiowanego z HubSpot, a następnie przypisz nowo utworzonemu użytkownikowi role „BigQuery Data Viewer” i „BigQuery Job User ”.

4. Skopiuj identyfikator projektu (Project ID ) ze swojego konta Google Cloud.
5. Wróć do HubSpot, wklej identyfikator projektu, a następnie kliknij „Testuj połączenie”.
6. Po zweryfikowaniu połączenia kliknij „Dalej”, aby zakończyć konfigurację.

Zsynchronizuj dane z HubSpot z kontem Google BigQuery

Aby wysłać dane z HubSpot do Google BigQuery, musisz skonfigurować użytkownika z wymaganymi uprawnieniami na swoim koncie Google Cloud, a także określić powiązany projekt GCP oraz adres URI zasobnika GCS.

Uwaga: potrzebujesz uprawnień administratora Google Cloud do projektu GCP, w którym będzie przechowywany zbiór danych BigQuery, oraz zasobnika Google Cloud Storage (GCS), w którym HubSpot będzie przechowywać pliki Parquet.

1. W prawym panelu wybierz HubSpot → Google BigQuery.
2. Skopiuj adres e-mail konta usługowego Google wygenerowany przez HubSpot.

3. Na swoim koncie Google Cloud przejdź do ustawień IAM projektu, utwórz nowego użytkownika, używając adresu e-mail konta usługowego skopiowanego z HubSpot, a następnie przypisz nowo utworzonemu użytkownikowi role „BigQuery Data Viewer”, „BigQuery Job User” oraz „Storage object owner ”.

4. Skopiuj identyfikator projektu (Project ID ) ze swojego konta Google Cloud.
5. Wróć do HubSpot i wklej identyfikator projektu.
6. Dodaj adres URI swojego zasobnika Google Cloud Storage (GCS):
   • Adres URI zasobnika GCS powinien mieć następującą strukturę: gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • Tabele zewnętrzne BigQuery są tworzone w dedykowanym zbiorze danych w projekcie GCP i mają następujący format: hubspot_data_set_{hubId}
   • Dane będą zapisywane w zasobniku GCS, a powiązane tabele będą odwoływać się do plików Parquet w GCS.
   • Więcej informacji na temat tworzenia zasobników GCS znajdziesz w dokumentacji Google.
7. Kliknij opcję „Testuj połączenie”.
8. Po zweryfikowaniu połączenia kliknij „Dalej”.
9. Zaznacz pola wyboru obok źródeł danych, które chcesz zsynchronizować (np. Kontakty, Powiązania, Wydarzenia itp.).
10. Skonfiguruj częstotliwość i harmonogram synchronizacji.
11. Kliknij „Rozpocznij synchronizację”.

Monitoruj synchronizację

Po skonfigurowaniu synchronizacji między kontami możesz sprawdzić stan synchronizacji i historię na stronie szczegółów synchronizacji:

1. Na koncie HubSpot kliknij Więcej, a następnie przejdź do Zarządzanie danymi > Integracja danych. Jeśli opcja Więcej się nie pojawia, przejdź bezpośrednio do sekcji Zarządzanie danymi > Integracja danych.
2. W sekcji Monitoruj importy i synchronizacje kliknij kartę Synchronizacja aplikacji.
3. Kliknij pasek wyszukiwania i wyszukaj Google BigQuery.
4. Kliknij „Google BigQuery”. Pamiętaj, że jeśli skonfigurowałeś synchronizację w obu kierunkach, może pojawić się wiele wpisów.
5. Na stronie szczegółów synchronizacji możesz zarządzać ustawieniami synchronizacji oraz przeglądać historię:
   • Aby zarchiwizować lub edytować szczegóły synchronizacji, w prawym górnym rogu kliknij „Działania”, a następnie wybierz odpowiednią opcję.
   • Aby natychmiast uruchomić synchronizację, w prawym górnym rogu kliknij opcję „Synchronizuj teraz”.
   • Zsynchronizowane rekordy, powiązania i błędy są podsumowane w górnej części strony.
   • W tabeli wyświetlą się ostatnie działania związane z synchronizacją. Kliknij kartę „Historia synchronizacji”, aby przejrzeć konkretne próby i zakończone operacje synchronizacji. Możesz filtrować wyniki według określonych przedziałów dat lub statusu synchronizacji.

Stany synchronizacji i obsługa błędów

Poniższa tabela przedstawia możliwe statusy synchronizacji:

Jeśli synchronizacja zakończy się niepowodzeniem:

• Na stronie szczegółów synchronizacji pojawi się status „Nieudana” wraz z informacją o tym, które tabele zostały zsynchronizowane pomyślnie, a które nie.
• W przypadku niepowodzenia dane nie są zapisywane częściowo: tabele BigQuery są aktualizowane wyłącznie po pomyślnym zakończeniu synchronizacji.
• Następna zaplanowana synchronizacja automatycznie ponowi próbę pełnej synchronizacji.
• W dowolnym momencie można ręcznie uruchomić ponowną synchronizację ze strony szczegółów synchronizacji.

Lista dozwolonych adresów sieciowych

Synchronizacja danych HubSpot z usługami zewnętrznymi, takimi jak BigQuery, odbywa się za pośrednictwem adresów IP serwerów proxy HubSpot. Te zakresy adresów IP są wykorzystywane przez inne integracje HubSpot, takie jak synchronizacja danych i webhooki.

Jeśli Twoja organizacja ogranicza dostęp przychodzący do zasobów GCP, należy dodać do listy dozwolonych następujące zakresy adresów CIDR w zależności od używanego hubletu HubSpot:

Dowiedz się, jak sprawdzić, gdzie przechowywane są dane Twojego konta HubSpot.

Ograniczenia wersji beta

Podczas trwania wersji beta należy pamiętać o następujących ograniczeniach:

• Częstotliwość synchronizacji: dostępny jest tylko ograniczony zestaw częstotliwości synchronizacji, w tym raz, co 6 godzin, co 12 godzin, codziennie, co tydzień i co miesiąc. W dowolnym momencie można ręcznie uruchomić ponowną synchronizację ze strony szczegółów synchronizacji w HubSpot.
• Jeden eksport na typ danych: każdy typ obiektu, typ zdarzenia lub para powiązań może zostać wyeksportowana tylko w ramach jednej konfiguracji synchronizacji na konto HubSpot.
  
  • Na przykład, jeśli kontakty są już eksportowane do jednego miejsca docelowego w BigQuery, nie można ich dodać do drugiej konfiguracji, dopóki pierwotne miejsce docelowe nie zostanie zarchiwizowane.
  • Zapobiega to powielaniu potoków danych i zapewnia jedno wiarygodne źródło informacji dla każdego typu danych w hurtowni danych.
• Ograniczona obsługa danych wrażliwych: możesz przechowywać i synchronizować dane wrażliwe na swoim koncie HubSpot, ale nie możesz synchronizować danych wrażliwych z kontem BigQuery.
• Brak obsługi obiektu `object_x_views`: obiekt `object_x_views` nie jest obecnie obsługiwany podczas synchronizacji z BigQuery. Użyj ` object_with_object_properties` lub połącz ` objects ` z ` object_properties `, aby uzyskać równoważne widoki dla poszczególnych rekordów.

Kolejne kroki

Po podłączeniu integracji z BigQuery i skonfigurowaniu ustawień synchronizacji zapoznaj się ze schematem synchronizowanych tabel w BigQuery.