BetaSincronizza i dati di HubSpot con Amazon S3

Utilizza l'integrazione con Amazon S3 per sincronizzare i dati di HubSpot CRM con un bucket Amazon S3 di tua proprietà. Puoi scegliere quali oggetti, associazioni ed eventi sincronizzare, configurare una pianificazione di sincronizzazione ricorrente e monitorare lo stato della sincronizzazione direttamente da HubSpot.

Ogni sincronizzazione esporta un'istantanea completa dei dati selezionati in formato Parquet nel tuo bucket Amazon S3. Puoi quindi utilizzare i dati sincronizzati con strumenti di analisi e elaborazione dei dati, come AWS Glue, Amazon Athena, Amazon EMR, Spark, Databricks o notebook Python.

Nota: l’integrazione con Amazon S3 è disponibile per i nuovi utenti di Amazon S3 che non utilizzano l’integrazione legacy con Amazon S3. Se sei un Super Admin, puoi attivare la versione beta della nuova integrazione con Amazon S3 per il tuo account.

Prima di iniziare

Prima di iniziare a sincronizzare i dati su Amazon S3, esamina i seguenti requisiti e limitazioni.

Comprendere i requisiti

• Se sei un Super Admin, attiva l’adesione del tuo account alla versione beta dell’integrazione con Amazon S3.
• Devi creare un ruolo AWS Identity and Access Management (IAM) associato al tuo account HubSpot.

Comprendere le limitazioni e le considerazioni

• Durante la fase beta, i dati vengono sincronizzati solo in formato Parquet.
• Ogni sincronizzazione crea un’istantanea completa dei dati selezionati.
• HubSpot crea una nuova cartella per ogni sincronizzazione e non elimina le sincronizzazioni precedenti dal tuo bucket S3.
• La sincronizzazionedei dati sensibili non è supportata.

Crea il ruolo IAM in AWS

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

1. Accedi alla console di gestione di AWS.
2. Nella dashboard iniziale, fai clic su Servizi > Sicurezza, identità e conformità > IAM.
3. Nella barra laterale sinistra, clicca su Ruoli.
4. Fai clic su Crea ruolo.
5. Nella sezione Tipo di entità attendibile, seleziona il tuo account AWS.
6. Nella sezione Account AWS , seleziona Un altro account AWS e inserisci l’ID del tuo account AWS. In seguito modificherai la relazione di fiducia per concedere l’accesso a HubSpot.
7. Seleziona Richiedi ID esterno e inserisci un ID segnaposto, ad esempio 0000. In seguito modificherai la relazione di fiducia per il tuo ruolo IAM e specificherai l’ID esterno per la tua integrazione di archiviazione. Un ID esterno viene utilizzato per concedere l’accesso alle tue risorse AWS a un’app di terze parti come HubSpot.

8. Fai clic su " Avanti".
9. Nella sezione Dettagli del ruolo, inserisci un Nome del ruolo e una Descrizione per identificare il ruolo.
10. Fai clic su " Crea ruolo".
11. Nella pagina Riepilogo, copia il valore ARN. Utilizzerai questo valore nel passaggio successivo.

Collegare HubSpot e AWS S3

1. Nel tuo account HubSpot, fai clic sull'icona del Marketplace nella barra di navigazione principale, quindi seleziona Marketplace di HubSpot.
2. Nella barra di ricerca, cerca e seleziona Amazon S3.
3. Fai clic su Installa.
4. Seleziona il tuo ruolo IAM di AWS, quindi fai clic su Installa.
5. Fai clic su Avanti.
6. Inserisci il valore ARN del ruolo IAM di AWS nel campo ARN del ruolo.
7. Fai clic su Connetti ad Amazon S3.

Configurare le autorizzazioni del bucket

HubSpot necessita delle seguenti autorizzazioni su un bucket e una cartella AWS S3 per accedere ai file presenti nella cartella e nelle sottocartelle:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListBucket
• s3:InserisciOggetto
• s3:EliminaOggetto

Dopo aver collegato l’app, concedi a HubSpot l’autorizzazione a sincronizzare i dati con il tuo bucket S3.

1. Nel tuo account HubSpot, fai clic sull'icona delle impostazioni nella barra di navigazione principale. Nel menu della barra laterale sinistra, vai a Integrazioni > App connesse.
2. Fare clic su Amazon S3.
3. Nel pannello di destra, fare clic su Seleziona per l'account Amazon S3 con cui si desidera sincronizzare i dati.
4. Nella pagina "Permessi ", fare clic su "Copia" per copiare la politica di autorizzazioni di esempio e associarla al ruolo IAM di AWS creato in precedenza. Si prega di aggiornare la politica di autorizzazioni con i nomi dei propri bucket.

5. Accedi alla console di gestione AWS.
6. Nella dashboard iniziale, fare clic su Servizi > Sicurezza, identità e conformità > IAM.
7. Nella barra laterale sinistra, fare clic su Impostazioni account.
8. Nella sezione Security Token Service (STS), individuare la regione AWS corrispondente a quella in cui si trova il proprio account AWS. Fare clic per attivare l'interruttore e abilitare la regione.
9. Nel pannello di sinistra, fare clic su Politiche.
10. Fai clic su Crea policy.
11. Nella scheda JSON, clicca su Aggiungi nuova istruzione.
12. Aggiungi la policy che hai copiato al Passo 4, che fornirà a HubSpot le autorizzazioni necessarie per caricare o scaricare dati utilizzando un unico bucket e un unico percorso di cartella.

13. Fai clic su Avanti.
14. Nella sezione " Rivedi e crea ", inserisci il nome della politica e, se lo desideri, una descrizione.
15. Fai clic su Crea politica.

Configura il bucket di destinazione

1. Tornando alla pagina Autorizzazioni in HubSpot, nel campo Bucket, inserisci il nome del bucket.
2. Fai clic su " Verifica connessione".

3. Se il test di connessione ha esito positivo, clicca su Avanti.

Configurare la sincronizzazione

1. Nella pagina " Origine dati ", seleziona i dati che desideri sincronizzare.
2. Seleziona le caselle di controllo relative agli oggetti, alle associazioni e agli eventi che desideri sincronizzare da HubSpot ad Amazon S3.

3. Fai clic su Avanti.
4. Nella pagina Dettagli, clicca sul menu a tendina Frequenza di sincronizzazione e seleziona la frequenza con cui desideri che i dati vengano sincronizzati da HubSpot ad Amazon S3.

5. Fai clic su Avvia sincronizzazione.

Gestisci la sincronizzazione

Dopo aver configurato una sincronizzazione e una volta che i dati iniziano a essere sincronizzati da HubSpot ad Amazon S3, puoi controllarne lo stato, individuare eventuali errori, aggiornare le impostazioni o archiviare la sincronizzazione.

Per controllare e gestire la sincronizzazione:

1. Nel tuo account HubSpot, fai clic su Altro, quindi vai a Gestione dei dati > Integrazione dei dati. Se Altro non appare nel tuo account, vai direttamente a Gestione dei dati > Integrazione dei dati.
2. Accedi alla scheda " Sincronizzazioni app " e individua la sincronizzazione con Amazon S3 nella tabella.
3. Controlla lo stato della sincronizzazione:

• • Sincronizzazione: è in corso un'operazione di sincronizzazione.
  • Sincronizzato: l’ultima sincronizzazione è stata completata con successo.
  • Fallita: l’ultima sincronizzazione ha riscontrato un errore.
  • Archiviato: la configurazione di sincronizzazione è stata rimossa.

4. Fai clic sul nome della sincronizzazione per visualizzare ulteriori dettagli, inclusi i record sincronizzati con successo e quelli non riusciti.

Per modificare o rimuovere una sincronizzazione:

1. Nella tabella, clicca sulla sincronizzazione Amazon S3.
2. In alto a destra, clicca sul menu a tendina "Azioni", quindi seleziona una delle seguenti opzioni:

• • Modifica sincronizzazione: aggiorna le impostazioni di sincronizzazione.
  • Archivia sincronizzazione: elimina la configurazione di sincronizzazione.

Formato dei dati per la sincronizzazione tra HubSpot e Amazon 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: singoli record di oggetti.
• Proprietà: proprietà e relativi valori presenti nei record degli oggetti, compresa la cronologia delle proprietà.
• Associazioni: tutti i tipi di associazione e i record associati.
• Eventi: eventi HubSpot standard selezionati ed eventi comportamentali personalizzati, comprese le proprietà degli eventi selezionati.

I dati degli oggetti di diversi tipi 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 record relativi ai contatti.
• Combinati: tutti i record per tutti i tipi di oggetto sono combinati in un unico oggetto del database. Pertanto, durante l’esecuzione di una query, è necessario specificare un filtro del tipo “WHERE objectTypeId=’0-1’

Agli oggetti personalizzati verrà assegnato un ID al momento della creazione e saranno identificati come 2-unique_ID. Ad esempio, 2-12345.

Struttura delle cartelle S3

HubSpot salva ogni sincronizzazione riuscita in un prefisso gestito da HubSpot all’interno del tuo bucket Amazon S3 utilizzando la seguente struttura:

s3://<bucket-name>/hubspot-dataout/<account-id>/<run-id>/<table-name>/<file-name>

Ad esempio:

s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/OBJECT_WITH_OBJECT_PROPERTIES/part-000.parquet

s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/EVENTS_VISITED_PAGE/part-000.parquet

s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/ASSOCIATIONS_CONTACTS_TO_COMPANIES/part-000.parquet

Ogni sincronizzazione crea una nuova cartella run-id. HubSpot non elimina i dati delle sincronizzazioni precedenti.

Se desideri rimuovere automaticamente le sincronizzazioni più vecchie, configura una politica del ciclo di vita di Amazon S3 per il bucket o il prefisso.

HubSpot genera nomi di file per ogni esecuzione di sincronizzazione e tali nomi possono variare da un'esecuzione all'altra. Non configurare i processi a valle in modo che dipendano da nomi di file specifici. Leggi invece tutti i file presenti nella cartella table-name corrispondente all'esecuzione di esportazione che desideri elaborare.

File degli oggetti

Se selezioni i dati degli oggetti, HubSpot esporta le seguenti cartelle.

OBJECTS_PROPERTIES

Una riga per ogni valore di proprietà dell’oggetto.

OBJECT_WITH_OBJECT_PROPERTIES

Una riga per ogni record dell’oggetto, con i valori delle proprietà selezionate raggruppati in un’unica colonna PROPERTIES.

Per leggere un tipo di oggetto specifico da questa cartella, applicare un filtro in base a OBJECTTYPEID.

File di associazione

Se si selezionano i dati di associazione, HubSpot sincronizza i record di associazione e le definizioni di associazione.

ASSOCIATIONS

Una riga per ogni associazione selezionata tra due record di oggetto.

ASSOCIATION_DEFINITIONS

Una riga per ogni definizione di associazione selezionata.

ASSOCIATIONS_<TIPO_OGGETTO_DI_ORIGINE>_TO_<TIPO_OGGETTO_DI_DESTINAZIONE>

Per le coppie di associazioni selezionate, HubSpot sincronizza anche le cartelle relative a coppie di associazioni specifiche, come ASSOCIATIONS_CONTACTS_TO_COMPANIES. Queste cartelle contengono i record di associazione e i metadati delle definizioni associate.

File degli eventi

Se selezioni i dati degli eventi, HubSpot esporta una cartella per ogni tipo di evento. I nomi delle cartelle seguono il formato EVENTS_<NOME_EVENTO>, ad esempio EVENTS_VISITED_PAGE.

Ogni cartella degli eventi contiene le colonne standard degli eventi e una colonna per ciascuna proprietà dell’evento selezionata durante la configurazione.