Dowiedz się, jak połączyć HubSpot i AWS S3, aby zsynchronizować dane HubSpot z zasobnikiem S3.
Przed skonfigurowaniem integracji konieczne będzie wybranie konta HubSpot do Access HubSpot data in AWS S3 beta.
Aby połączyć HubSpot i AWS S3, należy obserwować poniższe kroki w kolejności:
HubSpot potrzebuje obserwujących uprawnień do wiadra i folderu AWS S3, aby uzyskać dostęp do plików w folderze i podfolderach:
Uwaga:
<bucket>
i <prefix>
rzeczywistą nazwą zasobnika i prefiksem ścieżki folderu.Nazwy zasobów Amazon (ARN) dla wiader w regionach rządowych mają prefiksarn:aws-us-gov:s3:::.s3:prefix
na ["*"] lub ["<ścieżka>
/*"] przyznaje dostęp do wszystkich prefiksów odpowiednio w określonym zasobniku lub ścieżce w zasobniku.
{
"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>/*"
]
}
}
}
]
}
Aby skonfigurować uprawnienia dostępu dla HubSpot w AWS Management Console:
{
"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:
Po wykonaniu powyższych kroków HubSpot może zsynchronizować dane z AWS S3.
Możesz synchronizować następujące dane z HubSpot do AWS S3:
Dane obiektów różnego typu są zorganizowane i dostępne na dwa sposoby:
objects_contacts
zawiera tylko rekordy kontaktu.Obiektom niestandardowym zostanie przypisany identyfikator w momencie tworzenia i będzie on identyfikowany jako 2-unique_ID. Na przykład 2-12345.
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.
Typ obiektu HubSpot |
ObjectTypeId |
Opis |
0-1 |
Informacje o osobach kontaktujących się z Twoją firmą |
|
0-2 |
Informacje o poszczególnych firmach lub organizacjach |
|
0-3 |
Szczegóły dotyczące możliwości uzyskania przychodu z kontaktem lub firmą. |
|
0-4 |
Przechowuje dane z działań CRM, w tym notatki, zadania, wiadomości e-mail, spotkania i połączenia. |
|
0-5 |
Reprezentują prośby klientów o pomoc lub wsparcie. |
|
0-14 |
Służy do udostępniania informacji o cenach potencjalnym nabywcom. |
|
0-15 |
Szczegóły dla poszczególnych przesyłań formularza HubSpot. |
|
0-8 |
Reprezentuje podzbiór produktów sprzedawanych w ramach transakcji. Gdy produkt jest dołączony do transakcji, staje się pozycją liniową. |
|
0-11 |
Szczegóły wiadomości przychodzących z wielu kanałów. |
|
0-25 |
Szczegóły stron docelowych |
|
0-27 |
Przechowuje informacje o listach zadań do wykonania |
|
0-28 |
Służy do zbierania informacji o leadach dotyczących odwiedzających i kontaktów |
|
0-29 |
Szczegóły dotyczące wiadomości e-mail z Marketing hub |
|
AD_ACCOUNT |
0-30 |
Reklamy przechowują informacje o kontach reklam w serwisach Linkedin, Facebook i Google |
0-31 |
Szczegóły dotyczące kampanii reklam. Kampania reklamowa może zawierać jedną lub więcej reklam |
|
AD_GROUP |
0-32 |
Logiczna grupa reklam w ramach kampanii reklamowej |
REKLAMY |
0-33 |
Szczegóły dotyczące poszczególnych reklam |
0-35 |
Informacje o powiązanych zasobach marketingowych i treściach, dzięki czemu można łatwo dokonać pomiaru skuteczności wspólnych działań marketingowych. |
|
SITE_PAGE |
0-38 |
Dane dotyczące poszczególnych stron w witrynie internetowej |
0-39 |
Dane dotyczące postów na blogu |
|
LISTA OBIEKTÓW |
0-45 |
Informacje o grupowaniu rekordów obiektów na podstawie ich właściwości lub działań |
0-48 |
Połączenia wykonane przez inne rekordy CRM, na przykład kontakty |
|
FAKTURA |
0-53 |
Zarządzanie fakturami i synchronizowanie ich z zewnętrznymi systemami księgowymi |
0-57 |
Informacje o zasobach medialnych zaimportowanych do HubSpot |
|
0-58 |
Sekwencja to seria ukierunkowanych szablonów wiadomości e-mail, które mają na celu pielęgnowanie kontaktów w czasie |
|
0-72 |
Podziały transakcji są używane do dzielenia kredytów transakcji między wielu użytkowników |
|
0-83 |
Dokumenty sprzedaży tworzą bibliotekę treści dla całego zespołu, umożliwiając przesyłanie i udostępnianie dokumentów kontaktom. |
|
0-19 |
Przechowuje informacje przesłane do ankiety z opinią. |
|
0-69 |
Subskrypcje zawierają szczegóły płatności cyklicznych |
|
0-101 |
Windykacja zawiera dane o środkach pobranych od klientów |
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).
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.
Podobnie jak dane obiektów, dane asocjacji są zorganizowane na dwa sposoby:
associations_contacts_to_deals
zawiera tylko rekordy kontaktu i transakcji. TKażdy typ asocjacji ma swój własny widok, oznaczony jako associations_<association type name>
np. associations_contacts_to_deals
.
Ta tabela zawiera informacje o wszystkich dostępnych typach powiązań między obiektami HubSpot, z jednym wierszem na typ powiązania.
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 obejmują standardowe zdarzenia HubSpot i niestandardowe zdarzenia behawioralne. Każde zdarzenie ma własną tabelę, oznaczoną jako events_eventname
.
Ta tabela zawiera definicje wszystkich obiektów i zdarzeń dostępnych na koncie HubSpot.
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.