Scoprite come collegare HubSpot e AWS S3 per sincronizzare i dati di HubSpot con il vostro bucket S3.
Prima di impostare l'integrazione, è necessario inserire il proprio account HubSpot nellabeta di Access HubSpot data in AWS S3 .
Per collegare HubSpot e AWS S3, è necessario seguire in ordine i seguenti passaggi:
HubSpot ha bisogno delle seguenti autorizzazioni su un bucket e una cartella AWS S3 per accedere ai file della cartella e delle sottocartelle:
Nota bene:
<bucket>
e <prefix>
con il nome effettivo del bucket e il prefisso del percorso della cartella.I nomi delle risorse Amazon (ARN) per i bucket nelle regioni governative hanno un prefissoarn:aws-us-gov:s3::.s3:prefix
su ["*"] o ["<path>".
/*"] garantisce l'accesso a tutti i prefissi nel bucket o nel percorso del bucket specificato, rispettivamente.
{
"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>/*"
]
}
}
}
]
}
Per configurare le autorizzazioni di accesso a HubSpot nella console di gestione AWS:
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"AWS": "<hubspot_user_arn>"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"sts:ExternalId": "<hubspot_external_id>"
}
}
}
]
}
Nel criterio di cui sopra, modificare i due campi seguenti con i valori registrati al punto 4:
Dopo aver completato i passaggi sopra descritti, HubSpot può sincronizzare i dati in AWS S3.
È possibile sincronizzare i seguenti dati da HubSpot a AWS S3:
I dati degli oggetti di diverso tipo sono organizzati e disponibili in due modi:
objects_contacts
contiene solo record del contatto.Aglioggetti personalizzati viene assegnato un ID al momento della creazione, identificato come 2-unique_ID. Ad esempio, 2-12345.
Ogni tipo di oggetto disponibile, compresi gli oggetti personalizzati, ha una tabella specifica. Queste tabelle sono denominate secondo il formato OBJECTS_<object type name>
, dove <object type name>
è l'etichetta della forma plurale di objecttype
.(Si noti che se il tipo di oggetto non ha una forma plurale, <object type name>
sarà l'etichetta della forma singolare del nome del tipo di oggetto concatenata con "S").
Di seguito è riportato un elenco completo dei tipi di oggetto HubSpot disponibili, una breve descrizione dei dati che rappresentano e le tabelle corrispondenti.
Tipo di oggetto HubSpot |
Tipo di oggettoId |
Descrizione dell'oggetto |
0-1 |
Informazioni sulle persone che interagiscono con la vostra azienda |
|
0-2 |
Informazioni su singole aziende o organizzazioni |
|
0-3 |
Dettagli sulle opportunità di guadagno con un contatto o un'azienda. |
|
0-4 |
Memorizza i dati delle azioni del CRM, tra cui note, attività, e-mail, riunioni e chiamate. |
|
0-5 |
Rappresenta le richieste di aiuto o di supporto dei clienti. |
|
0-14 |
Utilizzato per condividere le informazioni sui prezzi con i potenziali acquirenti. |
|
0-15 |
Dettagli per i singoli invii di form di HubSpot. |
|
0-8 |
Rappresenta un sottoinsieme di prodotti venduti in una trattativa. Quando un prodotto è collegato a una trattativa, diventa una voce. |
|
0-11 |
Dettagli dei messaggi in arrivo da più canali. |
|
0-25 |
Dettagli delle landing page |
|
0-27 |
Memorizza informazioni sugli elenchi di cose da fare |
|
0-28 |
Utilizzato per raccogliere informazioni sui lead dei visitatori e dei contatti |
|
0-29 |
Dettagli sulle email provenienti da Marketing hub |
|
AD_ACCOUNT |
0-30 |
Annuncia le informazioni sugli account pubblicitari su Linkedin, Facebook e Google |
0-31 |
Annunci sulle campagne pubblicitarie. Una Campagna pubblicitaria può contenere uno o più annunci |
|
AD_GROUP |
0-32 |
Gruppo logico di annunci all'interno di una Campagna |
ANNUNCI |
0-33 |
Dettagli sui singoli annunci |
0-35 |
Informazioni sulle attività e sui contenuti di marketing correlati, in modo da poter misurare facilmente l'efficacia dei vostri sforzi di marketing collettivi. |
|
SITO_PAGINA |
0-38 |
Dati sulle singole pagine del sito web |
0-39 |
Dati sui post del blog |
|
ELENCO DEGLI OGGETTI |
0-45 |
Informazioni sui raggruppamenti di record di oggetti in base alle loro proprietà o attività |
0-48 |
Chiamate effettuate da altri record del CRM, per esempio i contatti |
|
FATTURA |
0-53 |
Gestire e sincronizzare le fatture con i sistemi contabili esterni |
0-57 |
Informazioni sulle risorse multimediali importate in HubSpot |
|
0-58 |
Una sequenza è una serie di modelli di e-mail mirati e temporizzati per coltivare i contatti nel tempo |
|
0-72 |
Le suddivisioni delle trattative sono utilizzate per condividere il credito delle trattative tra più utenti |
|
0-83 |
I documenti di vendita costituiscono una libreria di contenuti per tutto il team, che può caricare e condividere documenti con i contatti. |
|
0-19 |
Memorizza le informazioni inviate a un sondaggio di feedback. |
|
0-69 |
Gli abbonamenti contengono i dettagli dei pagamenti ricorrenti |
|
0-101 |
Contiene dati sui fondi raccolti dai clienti |
Questa tabella contiene i dati dei record di HubSpot. È possibile ottenere una riga per ogni record all'interno di un tipo di oggetto (ad esempio, tutti i record del contatto nel tipo di oggetto Contatti).
Questa tabella contiene i valori storici delle proprietà. Per i contatti, contiene i 45 valori più recenti. Per tutti gli altri oggetti, contiene i 20 valori più recenti. La tabella contiene una riga per ogni valore storico della proprietà. Il valore attuale di una proprietà è determinato dal timestamp UPDATEDAT più recente nella cronologia della proprietà.
Come i dati degli oggetti, i dati delle associazioni sono organizzati in due modi:
associations_contacts_to_deals
contiene solo i record dell'associazione tra gli oggetti Contatto e Trattativa. TOgni tipo di associazione ha una propria vista, etichettata come associations_<association type name>
, ad esempio associations_contacts_to_deals
.
Questa tabella contiene informazioni su tutti i tipi di associazione disponibili tra i tipi di oggetto di HubSpot, con una riga per tipo di associazione.
Questa tabella contiene informazioni sulle proprietà degli oggetti e sugli eventi dell'account HubSpot. Le proprietà degli eventi includono eventi standard, come le aperture e i clic delle e-mail, e proprietà di eventi comportamentali personalizzati. Queste informazioni possono essere utili per definire i valori presenti in object_properties e nei dati degli eventi.
Gli eventi comprendono eventi standard di HubSpot ed eventi comportamentali personalizzati. Ogni evento ha una propria tabella, etichettata come events_eventname
.
Questa tabella contiene le definizioni di tutti gli oggetti e gli eventi disponibili nell'account HubSpot.
I dati vengono sincronizzati quotidianamente tra HubSpot e AWS S3. Verrà creata una cartella per ogni giorno di sincronizzazione dei dati. Ciascuna delle tabelle seguenti sarà disponibile come cartella con file CSV gzippati:
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
Ci saranno diverse sottocartelle per ogni tabella. Se la dimensione della tabella supera i 15 MB, ci saranno più file CSV gzippati sotto ogni cartella della tabella.