BetaCollegare HubSpot e 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>/*"
 ]
 }
 }
 }
 ]
}

• Fare clic su Avanti.
• Nella sezione Revisione e creazione, aggiungere il nome del criterio e una descrizione opzionale.
• Fare clic su Crea criterio.

3. Creare il ruolo IAM in AWS

Per configurare le autorizzazioni di accesso per HubSpot nella console di gestione AWS:

• Accedere alla console di gestione AWS.
• Nella home dashboard, fare clic su Servizi > Sicurezza, identità e conformità > IAM.
• Nella barra laterale sinistra, fare clic su Ruoli.
• Fare clic su Crea ruolo.
• Nella sezione Tipo di entità attendibile, selezionare Account AWS.
• Nella sezione Un account AWS, selezionare Un altro account AWS e inserire l'ID del proprio account AWS. In seguito si modificherà la relazione di fiducia per dare accesso a HubSpot.
• Selezionare Richiedi ID esterno e inserire un ID segnaposto come 0000. In seguito si modificherà la relazione di fiducia per il proprio ruolo IAM e si specificherà l'ID esterno per l'integrazione dello storage. Un ID esterno viene utilizzato per concedere l'accesso alle risorse AWS a un'applicazione di terze parti come HubSpot.

• Fare clic su Avanti.
• Selezionare il criterio creato al punto 1 e fare clic su Avanti.
• Nella sezione Dettagli ruolo, inserire un Nome ruolo e una Descrizione per identificare il ruolo.
• Fare clic su Crea ruolo.
• Nella pagina di riepilogo del ruolo, copiare il valore ARN. Questo valore verrà utilizzato nel passaggio successivo.

4. Connettere HubSpot e AWS S3

• Nel tuo account HubSpot, fai clic sull’icona del Marketplace marketplace nella barra di navigazione principale, quindi seleziona App Marketplace. Cercare e selezionare AWS S3. È anche possibile accedere all'integrazione direttamente dal proprio account utilizzando questo URL.
• In alto a destra, fare clic su Installa app.
• Inserire il nome del ruolo IAM configurato al punto 3 e il percorso dell'URL S3 per il bucket in cui si desidera scaricare i dati.
• Fare clic su Avanti.
• Rivedete e copiate i valori dell'utente AWS IAM e dell' ID esterno AWS , poiché vi serviranno nel passaggio successivo. Quindi, fate clic su Continua in Applicazioni connesse.

5. Concessione delle autorizzazioni all'utente IAM per l'accesso agli oggetti del bucket

• Accedere alla console di gestione AWS.
• Nella home dashboard, fare clic su Servizi > Sicurezza, identità e conformità > IAM.
• Nella barra laterale sinistra, fare clic su Ruoli.
• Selezionare il ruolo creato al punto 3.
• Selezionare la scheda Relazioni di fiducia e fare clic su Modifica criteri di fiducia.
• Modificare i documenti del criterio con i valori registrati al punto 3.

{
 "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 passaggio 4:

• hubspot_user_arn con il valore STORAGE_AWS_IAM_USER_ARN
• hubspot_external_id al valore STORAGE_AWS_EXTERNAL_ID

Dopo aver completato i passaggi sopra descritti, HubSpot può sincronizzare i dati in AWS S3.

Formato dei dati per la sincronizzazione tra HubSpot e AWS S3

Dati disponibili per la sincronizzazione

È possibile sincronizzare i seguenti dati da HubSpot ad AWS S3:

• Oggetti: oggetti standard e personalizzati, come contatti, aziende, ticket o prodotti.
• Record: record di singoli oggetti.
• Associazioni: tutti i tipi di associazione e i record associati.
• Eventi: dati di eventi sia per gli eventi standard di HubSpot che per gli eventi comportamentali personalizzati.
• Elenchi: Elenchi di contatti e aziende di HubSpot.
• Proprietari: proprietari dei record.
• Pipeline: pipeline di deal e ticket e fasi della pipeline.
• Proprietà: proprietà e relativi valori sui record degli oggetti, compresa la cronologia delle proprietà.

I dati degli oggetti di diverso tipo sono organizzati e disponibili in due modi:

• Individuale: ogni tipo di oggetto è memorizzato in una propria tabella e contiene solo record dello stesso tipo di oggetto. Ad esempio, objects_contacts contiene solo i record dei contatti.
• Combinato: tutti irecord di tutti i tipi di oggetto sono combinati in un unico oggetto del database. Pertanto, quando si esegue una query, è necessario specificare un filtro del tipo "WHERE objectTypeId='0-1'".

Aglioggetti personalizzati viene assegnato un ID al momento della creazione, identificato come 2-unique_ID. Ad esempio, 2-12345.

tabelle objects_x

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 del tipo di oggetto objecttype.(Si noti che se il tipo di oggetto non ha una forma plurale, allora <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.

oggetto_con_proprietà_di_oggetto

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 dei contatti nel tipo di oggetto Contatti).

oggetto_con_proprietà_storia

Questa tabella contiene i valori storici delle proprietà. Per i contatti, contiene i 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à.

Query di associazione

Come i dati degli oggetti, i dati delle associazioni sono organizzati in due modi:

• Individuale: ogni tipo di associazione è memorizzato nella propria tabella e contiene solo i record di quel tipo. Ad esempio, associations_contacts_to_deals contiene solo i record di associazione tra gli oggetti contatto e affare. T
• Combinato: tutti i record di tutti i tipi di associazione sono combinati in un'unica tabella.

associazioni_x_a_y

Ogni tipo di associazione ha una propria vista, etichettata come associations_<association type name>, ad esempio associations_contacts_to_deals.

definizioni_di_associazioni

Questa tabella contiene informazioni su tutti i tipi di associazione disponibili tra gli oggetti HubSpot, con una riga per tipo di associazione.

definizioni_di_proprietà

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.

Eventi

Gli eventi comprendono eventi standard di HubSpot ed eventi comportamentali personalizzati. Ogni evento ha una propria tabella, etichettata come events_eventname.

definizioni_di_oggetto_e_tipo_di_evento

Questa tabella contiene le definizioni di tutti gli oggetti e gli eventi disponibili nell'account HubSpot.

Frequenza di sincronizzazione e organizzazione dei dati

I dati vengono sincronizzati quotidianamente tra HubSpot e AWS S3. Per ogni giorno di sincronizzazione dei dati viene creata una cartella. Ciascuna delle seguenti tabelle 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.