Wersja betaPołączenie HubSpot z Google BigQuery

Synchronizacja danych z Google BigQuery z obiektami HubSpot CRM, takimi jak kontakty, firmy, transakcje, powiązania i inne dane z 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ę Google BigQuery

Aby połączyć 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. Kliknij Google BigQuery na stronie z listą.
4. Kliknij Zainstaluj.
5. Kliknij Kontynuuj konfigurację.

Nastąpi przekierowanie do narzędzia integracji danych, gdzie panel boczny poprowadzi Cię przez synchronizację danych między kontami HubSpot i BigQuery, w oparciu o wskazówki, które chcesz zsynchronizować:

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

Synchronizacja danych Google BigQuery z kontem HubSpot

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

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

3. Na koncie Google Cloud przejdź do ustawień IAM projektu, utwórz nowego użytkownika z adresem e-mail konta usługi skopiowanym z HubSpot, a następnie dodaj role BigQuery Data Viewer i BigQuery Job User dla nowo utworzonego użytkownika.

4. Skopiuj identyfikator projektu z konta Google Cloud.
5. Z powrotem w HubSpot wklej identyfikator projektu, a następnie kliknij Testuj połączenie.
6. Po zweryfikowaniu połączenia kliknij Next, aby zakończyć konfigurację.

Synchronizacja danych HubSpot z kontem Google BigQuery

Aby wysłać dane HubSpot do Google BigQuery, należy skonfigurować użytkownika z wymaganymi uprawnieniami na koncie Google Cloud, a także określić powiązany projekt GCP i GCS bucket URI.

Uwaga: będziesz potrzebować dostępu administratora Google Cloud do projektu GCP, w którym będzie znajdować się zbiór danych BigQuery, oraz do 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ługi Google wygenerowany przez HubSpot.

3. Na koncie Google Cloud przejdź do ustawień IAM projektu, utwórz nowego użytkownika z adresem e-mail konta usługi skopiowanym z HubSpot, a następnie dodaj role BigQuery Data Viewer, BigQuery Job User i Storage object owner dla nowo utworzonego użytkownika.
   

4. Skopiuj identyfikator projektu z konta Google Cloud.
5. Z powrotem w HubSpot wklej identyfikator projektu.
6. Dodaj swój identyfikator URI usługi Google Cloud Storage (GCS):
   • URI dla bucketu GCS powinien być zgodny ze strukturą: gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/
   • Zewnętrzne tabele BigQuery są tworzone w dedykowanym zestawie danych w projekcie GCP i są zgodne z formatem: hubspot_data_set_{hubId}
   • Dane zostaną zapisane w zasobniku GCS, a powiązane tabele będą odwoływać się do plików parkietowych w GCS.
   • Więcej informacji na temat tworzenia bucketów GCS można znaleźć w dokumentacji Google.
7. Kliknij Testuj połączenie.
8. Po zweryfikowaniu połączenia kliknij Dalej.
9. Zaznacz pola wyboru obok źródeł danych, które chcesz zsynchronizować (np. Kontakty, Stowarzyszenia, Wydarzenia itp.).
10. Skonfiguruj częstotliwość i harmonogram synchronizacji.
11. Kliknij przycisk Rozpocznij synchronizację.

Monitorowanie synchronizacji

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

1. Na koncie HubSpot przejdź do opcji Zarządzanie danymi > Integracja danych..
2. W sekcji Monitoruj importy i synchronizacje kliknij kartę Synchronizacje aplikacji.
3. Kliknij pasek wyszukiwania i wyszukaj Google BigQuery.
4. Kliknij Google BigQuery. Pamiętaj, że może pojawić się wiele wpisów, jeśli skonfigurowano synchronizację w obu kierunkach.
5. Na stronie szczegółów synchronizacji można zarządzać ustawieniami i historią synchronizacji oraz przeglądać je:
   • 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 przycisk Synchronizuj teraz.
   • Zsynchronizowane rekordy, powiązania i błędy są podsumowane w górnej części strony.
   • Ostatnia aktywność synchronizacji pojawi się w tabeli. Kliknij kartę Historia synchronizacji, aby przejrzeć określone próby i zakończenia synchronizacji. Możesz filtrować według określonych zakresów dat lub stanu synchronizacji.

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

Poniższa tabela przedstawia możliwe statusy synchronizacji:

Jeśli synchronizacja nie powiedzie się:

• Status Nieudana pojawi się na stronie szczegółów synchronizacji, wraz z informacją o tym, które tabele udało się lub nie udało się zsynchronizować.
• W przypadku niepowodzenia dane nie są częściowo zapisywane: Tabele BigQuery są aktualizowane tylko po pomyślnym zakończeniu synchronizacji.
• Następna zaplanowana synchronizacja automatycznie ponowi próbę pełnej synchronizacji.
• Ponowną synchronizację można uruchomić ręcznie w dowolnym momencie na stronie szczegółów synchronizacji.

Lista dozwolonych sieci

Synchronizacja danych HubSpot z zewnętrznymi dostawcami, takimi jak BigQuery, jest kierowana przez adresy IP proxy HubSpot. Te zakresy adresów IP są używane przez inne integracje HubSpot, takie jak synchronizacja danych i webhooki.

Jeśli Twoja organizacja ogranicza dostęp przychodzący do zasobów GCP, powinieneś zezwolić na następujące zakresy CIDR w oparciu o hublet HubSpot:

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

Ograniczenia wersji beta

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

• Częstotliwość synchron izacji: 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. Możesz ręcznie uruchomić ponowną synchronizację na stronie szczegółów synchronizacji w HubSpot w dowolnym momencie.
• Jeden eksport na typ danych: każdy typ obiektu, typ zdarzenia lub para asocjacji mogą być eksportowane tylko w jednej konfiguracji synchronizacji na konto HubSpot.
  
  • Na przykład, jeśli kontakty są już eksportowane do jednego miejsca docelowego BigQuery, nie można ich dodać do drugiej konfiguracji, dopóki oryginalne miejsce docelowe nie zostanie zarchiwizowane.
  • Zapobiega to duplikowaniu potoków danych i zapewnia jedno źródło prawdy dla każdego typu danych w hurtowni danych.
• Ograniczona obsługa danych wrażliwych: można przechowywać i synchronizować dane wrażliwe z kontem HubSpot, ale nie można synchronizować danych wrażliwych z kontem BigQuery.
• Brak wsparcia dla object_x_views: obiekt object_x_views nie jest obecnie obsługiwany do synchronizacji z BigQuery. Użyj object_with_object_properties lub połącz objects z object_properties, aby uzyskać równoważne widoki na rekord.

Następne kroki

Po połączeniu integracji BigQuery i skonfigurowaniu ustawień synchronizacji, dowiedz się więcej o schemacie synchronizowanych tabel w BigQuery.