I betaSynkroniser HubSpot-data til Amazon S3

Bruk Amazon S3-integrasjonen til å synkronisere HubSpot CRM-data til en Amazon S3-bucket som du eier. Du kan velge hvilke objekter, tilknytninger og hendelser som skal synkroniseres, konfigurere en gjentakende synkroniseringsplan og overvåke synkroniseringsstatusen direkte fra HubSpot.

Hver synkronisering eksporterer et fullstendig øyeblikksbilde av de valgte dataene i Parquet-format til Amazon S3-bucket. Du kan deretter bruke de synkroniserte dataene med analyse- og databehandlingsverktøy, for eksempel AWS Glue, Amazon Athena, Amazon EMR, Spark, Databricks eller Python-notatbøker.

Merk: Amazon S3-integrasjonen er tilgjengelig for nye Amazon S3-brukere som ikke bruker den gamle Amazon S3-integrasjonen. Hvis du er superadministrator, kan du melde kontoen din på den nye Amazon S3-integrasjonsbetaen.

Før du begynner

Før du begynner å synkronisere data til Amazon S3, bør du gå gjennom følgende krav og begrensninger.

Forstå kravene

• Hvis du er superadministrator, kan du melde kontoen din på betaversjonen av Amazon S3-integrasjonen.
• Du må opprette en AWS Identity and Access Management (IAM)-rolle knyttet til HubSpot-kontoen din.

Forstå begrensninger og hensyn

• I løpet av betaversjonen synkroniseres data kun i Parquet-format.
• Hver synkronisering oppretter et komplett øyeblikksbilde av de valgte dataene.
• HubSpot oppretter en ny mappe for hver synkronisering og sletter ikke tidligere synkroniseringer fra S3-bøtta di.
• Synkronisering avsensitive data støttes ikke.

Opprett IAM-rollen i AWS

Slik konfigurerer du tilgangstillatelser for HubSpot i AWS Management Console:

1. Logg inn på AWS Management Console.
2. På startpanelet klikker du på Tjenester > Sikkerhet, identitet og samsvar > IAM.
3. Klikk på «Roller» i venstre sidefelt.
4. Klikk på Opprett rolle.
5. I delen «Trusted entity type » velger du din AWS-konto.
6. I delen «AWS-konto» velger du «En annen AWS-konto» og skriver inn din egen AWS-konto-ID. Du vil senere endre tillitsforholdet for å gi tilgang til HubSpot.
7. Velg «Krev ekstern ID» og skriv inn en plassholder-ID, for eksempel 0000. Du vil senere endre tillitsforholdet for IAM-rollen din og angi den eksterne ID-en for lagringsintegrasjonen. En ekstern ID brukes til å gi en tredjepartsapp som HubSpot tilgang til AWS-ressursene dine.

8. Klikk på «Neste».
9. I delen «Rolldetaljer» angir du et «Rollenavn» og en «Beskrivelse» for å identifisere rollen.
10. Klikk på Opprett rolle.
11. På siden «Oversikt» kopierer du ARN-verdien. Du vil bruke denne verdien i neste trinn.

Koble HubSpot og AWS S3 sammen

1. På HubSpot-kontoen din klikker du på Marketplace-ikonet i den øverste navigasjonslinjen, og deretter velger du HubSpot Marketplace.
2. Søk etter og velg Amazon S3 i søkefeltet.
3. Klikk på Installer.
4. Velg din AWS IAM -rolle, og klikk deretter på Installer.
5. Klikk på «Neste».
6. Skriv inn ARN-verdien fra AWS IAM-rollen i feltet «Rolle-ARN ».
7. Klikk på «Koble til Amazon S3».

Konfigurer tillatelser for bøtten

HubSpot trenger følgende tillatelser for en AWS S3-bucket og -mappe for å få tilgang til filer i mappen og undermappene:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListBucket
• s3:Legg til objekt
• s3:DeleteObject

Etter at du har koblet til appen, må du gi HubSpot tillatelse til å synkronisere data til S3-bucketet ditt.

1. I HubSpot-kontoen din klikker du på innstillinger-ikonet i den øverste navigasjonslinjen. Gå til Integrasjoner > Tilkoblede apper i menyen i venstre sidefelt.
2. Klikk på Amazon S3.
3. I panelet til høyre klikker du på Velg for den Amazon S3-kontoen du vil synkronisere data til.
4. På siden «Tillatelser» klikker du på «Kopier» for å kopiere eksemplet på en tillatelsespolicy og knytte den til den AWS IAM-rollen du opprettet tidligere. Husk å oppdatere tillatelsespolicyen med navnene på dine egne bucketer.

5. Logg inn på AWS Management Console.
6. På startpanelet klikker du på Tjenester > Sikkerhet, identitet og samsvar > IAM.
7. Klikk på Kontoinnstillinger i venstre sidefelt.
8. I delen «Security Token Service (STS)» søker du etter den AWS-regionen som tilsvarer regionen der AWS-kontoen din befinner seg. Klikk for å slå på bryteren og aktivere regionen.
9. Klikk på Policies i venstre sidepanel.
10. Klikk på Opprett policy.
11. På JSON -fanen klikker du på Legg til ny setning.
12. Legg til retningslinjen du kopierte i trinn 4, som gir HubSpot de tillatelsene den trenger for å laste inn eller laste ut data ved hjelp av én enkelt bøtte og mappesti.

13. Klikk på «Neste».
14. I delen Gjennomgå og opprett legger du til retningslinjenavnet og en valgfri beskrivelse.
15. Klikk på Opprett policy.

Konfigurer målbucket

1. Tilbake på siden «Tillatelser » i HubSpot, skriv inn navnet på bøtten i feltet «Bøtte ».
2. Klikk på «Test tilkobling».

3. Hvis tilkoblingstesten er vellykket, klikker du på Neste.

Konfigurer synkroniseringen

1. På siden «Datakilde» velger du dataene du vil synkronisere.
2. Merk av i boksene for objektene, tilknytningene og hendelsene du vil synkronisere fra HubSpot til Amazon S3.

3. Klikk på «Neste».
4. På siden «Detaljer» klikker du på rullegardinmenyen «Synkroniseringsfrekvens» og velger hvor ofte du vil at dataene skal synkroniseres fra HubSpot til Amazon S3.

5. Klikk på «Start synkronisering».

Administrer synkroniseringen

Når du har konfigurert en synkronisering og data begynner å synkroniseres fra HubSpot til Amazon S3, kan du se statusen, identifisere feil, oppdatere innstillinger eller arkivere synkroniseringen.

Slik kontrollerer og administrerer du synkroniseringen:

1. I HubSpot-kontoen din klikker du på Mer, og så navigerer du til Dataadministrasjon > Dataintegrering. Hvis Mer ikke vises i kontoen din, navigerer du direkte til Dataadministrasjon > Dataintegrering.
2. Gå til fanen «App-synkroniseringer » og finn Amazon S3-synkroniseringen din i tabellen.
3. Gjennomgå synkroniseringsstatusen:

• • Synkronisering: en synkroniseringskjøring pågår.
  • Synkronisert: den siste synkroniseringen ble fullført.
  • Mislykket: Det oppstod en feil under den siste synkroniseringen.
  • Arkivert: Synkroniseringskonfigurasjonen ble fjernet.

4. Klikk på synkroniseringsnavnet for å se flere detaljer, inkludert poster som er synkronisert og poster som ikke ble synkronisert.

Slik redigerer eller fjerner du en synkronisering:

1. Klikk på Amazon S3 -synkroniseringen i tabellen.
2. Klikk på rullegardinmenyen «Handlinger» øverst til høyre, og velg deretter ett av følgende:

• • Rediger synkronisering: Oppdater synkroniseringsinnstillingene.
  • Arkiver synkronisering: Slett synkroniseringskonfigurasjonen.

Dataformat for synkronisering mellom HubSpot og Amazon S3

Tilgjengelige data for synkronisering

Du kan synkronisere følgende data fra HubSpot til AWS S3:

• Objekter: standard- og tilpassede objekter, for eksempel kontakter, selskaper, billetter eller produkter.
• Post: individuelle objektposter.
• Egenskaper: egenskaper og verdiene deres i objektpostene, inkludert egenskapshistorikken.
• Tilknytninger: alle tilknytningstyper og tilknyttede poster.
• Hendelser: utvalgte standardhendelser i HubSpot og tilpassede atferdshendelser, inkludert utvalgte hendelsesegenskaper.

Objektdata av ulike typer er organisert og tilgjengelig på to måter:

• Individuelt: hver objekttype lagres i sin egen tabell og inneholder kun poster av samme objekttype. For eksempel inneholder objects_contacts kun kontaktposter.
• Kombinert: alle poster for alle objekttyper er kombinert i ett databaseobjekt. Når du foretar en søk, må du derfor spesifisere et filter som «WHERE objectTypeId=’0-1’

Tilpassede objekter tildeles en ID når de opprettes, og identifiseres som 2-unique_ID. For eksempel 2-12345.

S3-mappestruktur

HubSpot skriver hver vellykket synkronisering til et HubSpot-administrert prefiks i Amazon S3-bøtten din ved hjelp av følgende struktur:

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

For eksempel:

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

Hver synkronisering oppretter en ny mappe run-id. HubSpot sletter ikke data fra tidligere synkroniseringskjøringer.

Hvis du vil fjerne eldre synkroniseringsdata automatisk, må du konfigurere en Amazon S3-livssykluspolicy for bøtta eller prefikset.

HubSpot genererer filnavn for hver synkroniseringskjøring, og filnavnene kan variere fra kjøring til kjøring. Ikke konfigurer nedstrømsprosesser slik at de er avhengige av bestemte filnavn. Les i stedet inn alle filene i mappen med det riktige tabellnavnet for den eksportkjøringen du ønsker å behandle.

Objektfiler

Hvis du velger objektdata, eksporterer HubSpot følgende mapper.

OBJECTS_PROPERTIES

Én rad per objekt-egenskapsverdi.

OBJECT_WITH_OBJECT_PROPERTIES

Én rad per objektpost, med valgte egenskapsverdier gruppert i én enkelt PROPERTIES-kolonne.

For å lese en bestemt objekttype fra denne mappen, filtrer etter OBJECTTYPEID.

Assosiasjonsfiler

Hvis du velger tilknytningsdata, synkroniserer HubSpot tilknytningsposter og tilknytningsdefinisjoner.

ASSOCIATIONS

Én rad per valgt tilknytning mellom to objektregistreringer.

ASSOCIATION_DEFINITIONS

Én rad per valgt tilknytningsdefinisjon.

ASSOCIATIONS_<FRA_OBJEKTTYPE>_TIL_<TIL_OBJEKTTYPE>

For valgte tilknytningspar synkroniserer HubSpot også mapper for spesifikke tilknytningspar, for eksempel ASSOCIATIONS_CONTACTS_TO_COMPANIES. Disse mappene inneholder tilknytningsposter og tilhørende definisjonsmetadata.

Hendelsesfiler

Hvis du velger hendelsesdata, eksporterer HubSpot én mappe for hver hendelsestype. Mappenavnene har formatet EVENTS_<EVENT_NAME>, for eksempel EVENTS_VISITED_PAGE.

Hver hendelsesmappe inneholder standard hendelseskolonner og en kolonne for hver hendelsesegenskap som ble valgt under oppsettet.