Połączenie HubSpot i AWS S3 (BETA)

{
 "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>/*"
 ]
 }
 }
 }
 ]
}

• Kliknij przycisk Dalej.
• W sekcji Sprawdź i utwórz dodaj nazwę polityki i opcjonalny opis.
• Kliknij przycisk Utwórz politykę.

3. Utwórz rolę IAM w AWS

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

• Zaloguj się do konsoli zarządzania AWS.
• Na głównym pulpicie nawigacyjnym kliknij Usługi > Bezpieczeństwo, tożsamość i zgodność > IAM.
• Na lewym pasku bocznym kliknij Role.
• Kliknij Utwórz rolę.
• W sekcji Trusted entity type wybierz AWS account.
• W sekcji An AWS acount wybierz opcję Another AWS account i wprowadź własny identyfikator konta AWS. Później zmienisz relację zaufania, aby dać dostęp do HubSpot.
• Wybierz opcję Require external ID i wprowadź identyfikator zastępczy, taki jak 0000. Później zmienisz relację zaufania dla swojej roli IAM i określisz zewnętrzny identyfikator dla integracji pamięci masowej. Zewnętrzny identyfikator służy do przyznawania dostępu do zasobów AWS aplikacji innej firmy, takiej jak HubSpot.

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

4. Połączenie HubSpot i AWS S3

• Na koncie HubSpot kliknij ikonę Marketplace marketplace w górnym panelu nawigacyjnym, następnie wybierz App Marketplace. Wyszukaj i wybierz AWS S3. Możesz również przejść do integracji bezpośrednio na swoim koncie, korzystając z tego adresu URL.
• W prawym górnym rogu kliknij przycisk Install app.
• Wprowadź nazwę roli IAM skonfigurowaną w kroku 3 i ścieżkę URL S3 dla zasobnika, do którego mają być zrzucane dane.
• Kliknij Dalej.
• Przejrzyj i skopiuj wartości AWS IAM User i AWS External ID , ponieważ będą one potrzebne w następnym kroku. Następnie kliknij Continue to Connected Apps.

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

• Zaloguj się do konsoli zarządzania AWS.
• Na głównym pulpicie nawigacyjnym kliknij Usługi > Bezpieczeństwo, tożsamość i zgodność > IAM.
• Na lewym pasku bocznym kliknij Role.
• Wybierz rolę utworzoną w kroku 3.
• Wybierz zakładkę Trust relationships i kliknij Edit trust policy.
• Zmodyfikuj dokumenty zasad z wartościami, które zarejestrowałeś 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>"
}
}
}
]
}

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żesz synchronizować następujące dane z HubSpot do AWS S3:

• 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 AWS S3. Dla każdego dnia, w którym dane są synchronizowane, 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 będzie znajdować się wiele plików CSV w formacie gzip.