Wersja betaPołączenie HubSpot i AWS S3

Połącz HubSpot i AWS S3, aby zsynchronizować dane HubSpot z zasobnikiem S3. Po podłączeniu aplikacji, funkcje systemu CRM HubSpot mogą synchronizować dane CRM, w tym obiekty, Rekordy, Powiązania, Zdarzenia i Segmenty do AWS S3 w celu przechowywania, Raportów i analityki. 

Można na przykład zsynchronizować dane dotyczące kontaktów i firm z zasobnikiem S3 i wykorzystać je w hurtowni danych organizacji, narzędziach do analizy biznesowej lub przepływach pracy związanych z przetwarzaniem danych.

Uwaga: HubSpot nie udostępnia danych HIPAA do AWS S3.

Przed rozpoczęciem

Przed skonfigurowaniem integracji należy wyrazić zgodę na korzystanie z konta HubSpot w ramach usługi Access HubSpot data in AWS S3 beta.

Połączenie HubSpot i AWS S3

Aby połączyć HubSpot i AWS S3, należy obserwować poniższe kroki w kolejności: 

1. Skonfiguruj uprawnienia dostępu dla zasobnika AWS S3. 
2. Tworzenie zasad IAM. 
3. Utwórz rolę IAM w AWS. 
4. Podłącz HubSpot i AWS S3. 
5. Przyznanie użytkownikowi IAM uprawnień dostępu do obiektów w zasobniku S3. 

1. Konfiguracja uprawnień dostępu do zasobnika S3

HubSpot potrzebuje obserwujących uprawnień do wiadra i folderu AWS S3, aby uzyskać dostęp do plików w folderze i podfolderach:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListBucket
• s3:PutObject
• s3:DeleteObject

2. Tworzenie zasad IAM

1. Zaloguj się do konsoli zarządzania AWS.
2. Na pulpicie głównym kliknij Usługi > Bezpieczeństwo, tożsamość, & Zgodność > IAM.
3. Na lewym pasku bocznym kliknij Ustawienia konta.
4. W sekcji Security Token Service (STS ) wyszukaj region AWS, który odpowiada regionowi, w którym znajduje się twoje konto AWS. Kliknij, aby włączyć przełącznik w celu aktywacji regionu.
5. W panelu po lewej stronie kliknij opcję Zasady. 
6. Kliknij przycisk Utwórz politykę. 
7. Na karcie JSON kliknij przycisk Dodaj nowe oświadczenie. 
8. Dodaj poniższy dokument zasad, który nada HubSpot uprawnienia potrzebne do ładowania lub rozładowywania danych przy użyciu pojedynczego zasobnika i ścieżki folderu. Pliki danych można również wyczyścić za pomocą opcji PURGE copy. 

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Effect": "Allow",
 "Action": [
 "s3:PutObject",
 "s3:GetObject",
 "s3:GetObjectVersion",
 "s3:DeleteObject",
 "s3:DeleteObjectVersion"
 ],
 "Resource": "arn:aws:s3:::<bucket>/<prefix>/*"
 },
 {
 "Effect": "Allow",
 "Action": [
 "s3:ListBucket",
 "s3:GetBucketLocation"
 ],
 "Resource": "arn:aws:s3:::<bucket>",
 "Condition": {
 "StringLike": {
 "s3:prefix": [
 "<prefix>/*"
 ]
 }
 }
 }
 ]}

9. Kliknij przycisk Dalej.
10. W sekcji Ocena i tworzenie dodaj nazwę polityki i opcjonalny opis.
11. Kliknij przycisk Utwórz politykę. 

3. Utwórz rolę IAM w AWS

Aby skonfigurować uprawnienia dostępu dla HubSpot w AWS Management Console:

1. Zaloguj się do konsoli zarządzania AWS.
2. Na pulpicie głównym kliknij Usługi > Bezpieczeństwo, tożsamość, & Zgodność > IAM.
3. Na lewym pasku bocznym kliknij Role. 
4. Kliknij przycisk Utwórz rolę. 
5. W sekcji Typ zaufanego podmiotu wybierz Konto AWS.
6. W sekcji Konto AWS wybierz opcję Inne konto AWS i wprowadź identyfikator własnego konta AWS. Później zmienisz relację zaufania, aby dać dostęp do HubSpot. 
7. Wybierz opcję Wymagaj zewnętrznego ID i wprowadź identyfikator zastępczy, taki jak 0000. Później zmienisz relację zaufania dla roli IAM i określisz zewnętrzny identyfikator dla integracji magazynu. Zewnętrzny identyfikator służy do przyznawania dostępu do zasobów AWS aplikacjom zewnętrznym, takim jak HubSpot. 

8. Kliknij przycisk Dalej. 
9. Wybierz politykę utworzoną w kroku 1 i kliknij przycisk Dalej.
10. W sekcji Szczegóły roli wprowadź Nazwę roli i Opis , aby zidentyfikować rolę. 
11. Kliknij przycisk Utwórz rolę. 
12. Na stronie podsumowania roli skopiuj wartość ARN . Wartość ta zostanie użyta w następnym kroku. 

4. Połączenie HubSpot i AWS S3

1. Na koncie HubSpot kliknij ikonę Marketplace w górnym panelu nawigacyjnym, następnie wybierz HubSpot Marketplace.
2. Wyszukaj i wybierz AWS S3. 
3. Kliknij przycisk Rata. 
4. Wprowadź nazwę roli IAM skonfigurowaną w kroku 3 i ścieżkę URL S3 dla zasobnika, w którym mają być przechowywane dane.
5. Kliknij przycisk Dalej.
6. Oceń i skopiuj wartości AWS IAM User i AWS External ID, ponieważ będą one potrzebne w następnym kroku. Następnie kliknij przycisk Przejdź do połączonych aplikacji.

5. Przyznanie użytkownikowi IAM uprawnień dostępu do obiektów bucket

1. Zaloguj się do konsoli zarządzania AWS.
2. Na pulpicie głównym kliknij Usługi > Bezpieczeństwo, tożsamość, & Zgodność > IAM.
3. Na lewym pasku bocznym kliknij Role.
4. Wybierz rolę utworzoną w kroku 3. 
5. Wybierz zakładkę Relacje zaufania i kliknij Edytuj zasady zaufania. 
6. Zmodyfikuj dokumenty polisy za pomocą wartości, które zostały zarejestrowane w kroku 3. 

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Sid": "",
 "Effect": "Allow",
 "Principal": {
 "AWS": "<hubspot_user_arn>"
 },
 "Action": "sts:AssumeRole",
 "Condition": {
 "StringEquals": {
 "sts:ExternalId": "<hubspot_external_id>"
 }
 }
 }
 ]
}

7. W powyższej polityce zmień następujące dwa pola na wartości, które zostały zarejestrowane w kroku 4:

• • hubspot_user_arn do wartości STORAGE_AWS_IAM_USER_ARN
  • hubspot_external_id do wartości STORAGE_AWS_EXTERNAL_ID  

Po wykonaniu powyższych kroków HubSpot może zsynchronizować dane z AWS S3.

Format danych do synchronizacji między HubSpot i AWS S3

Dostępne dane do synchronizacji

Można synchronizować następujące dane z HubSpot do AWS S3: 

• 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ą formularza w liczbie mnogiej objecttype. Zwróć uwagę, że jeśli typ obiektu nie ma formy liczby mnogiej, wówczas <object type name> będzie etykietą w liczbie 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

Dane są codziennie synchronizowane między HubSpot i AWS S3. Dla każdego dnia synchronizacji danych tworzony jest folder. Każda z obserwujących tabel będzie dostępna jako folder z gzipowanymi 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

Dla każdej tabeli będzie kilka podfolderów. Jeśli rozmiar tabeli przekracza 15 MB, w każdym folderze tabeli znajduje się wiele plików CSV w formacie gzip.