I betaSynkroniser HubSpot-data med Amazon S3

Brug Amazon S3-integrationen til at synkronisere HubSpot CRM-data til en Amazon S3-bucket, som du ejer. Du kan vælge, hvilke objekter, tilknytninger og begivenheder der skal synkroniseres, konfigurere en tilbagevendende synkroniseringsplan og overvåge synkroniseringsstatus direkte fra HubSpot.

Hver synkronisering eksporterer et komplet øjebliksbillede af de valgte data i Parquet-format til din Amazon S3-bucket. Du kan derefter bruge de synkroniserede data med analyse- og databehandlingsværktøjer, såsom AWS Glue, Amazon Athena, Amazon EMR, Spark, Databricks eller Python-notebooks.

Bemærk: Amazon S3-integrationen er tilgængelig for nye Amazon S3-brugere, der ikke bruger den gamle Amazon S3-integration. Hvis du er superadministrator, kan du tilmelde din konto til den nye Amazon S3-integrationsbeta.

Før du går i gang

Før du begynder at synkronisere data til Amazon S3, skal du gennemgå følgende krav og begrænsninger.

Forstå kravene

• Hvis du er superadministrator, skal du tilmelde din konto til betaversionen af Amazon S3-integrationen.
• Du skal oprette en AWS Identity and Access Management (IAM)-rolle, der er knyttet til din HubSpot-konto.

Forstå begrænsninger og overvejelser

• I betafasen synkroniseres data kun i Parquet-format.
• Hver synkronisering opretter et komplet øjebliksbillede af de valgte data.
• HubSpot opretter en ny mappe for hver synkronisering og sletter ikke tidligere synkroniseringer fra din S3-bucket.
• Synkronisering affølsomme data understøttes ikke.

Opret IAM-rollen i AWS

Sådan konfigurerer du adgangstilladelser til HubSpot i AWS Management Console:

1. Log ind på AWS Management Console.
2. Klik på Services > Security, Identity, & Compliance > IAM på startdashboardet.
3. Klik på Roles i venstre sidepanel.
4. Klik på Opret rolle.
5. I afsnittet " Trusted entity type " skal du vælge din AWS-konto.
6. I afsnittet AWS-konto skal du vælge En anden AWS-konto og indtaste dit eget AWS-konto-ID. Du ændrer senere tillidsforholdet for at give HubSpot adgang.
7. Vælg "Kræv eksternt ID " og indtast et pladsholder-ID, f.eks. 0000. Du vil senere ændre tillidsforholdet for din IAM-rolle og angive det eksterne ID til din lagringsintegration. Et eksternt ID bruges til at give en tredjepartsapp som HubSpot adgang til dine AWS-ressourcer.

8. Klik på " Næste".
9. I afsnittet " Rolldetaljer " skal du indtaste et "Rollenavn" og en " Beskrivelse " for at identificere rollen.
10. Klik på Opret rolle.
11. Kopier ARN-værdien på siden " Oversigt ". Du skal bruge denne værdi i det næste trin.

Forbind HubSpot og AWS S3

1. På din HubSpot-konto skal du klikke på Marketplace-ikonet i den øverste navigationslinje og derefter vælge HubSpot Marketplace.
2. Søg efter og vælg Amazon S3 i søgefeltet.
3. Klik på " Installer".
4. Vælg din AWS IAM -rolle, og klik derefter på Installer.
5. Klik på " Næste".
6. Indtast ARN-værdien fra AWS IAM-rollen i feltet Rolle-ARN.
7. Klik på Opret forbindelse til Amazon S3.

Konfigurer bucket-tilladelser

HubSpot har brug for følgende tilladelser til en AWS S3-bucket og -mappe for at få adgang til filer i mappen og undermapperne:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListBucket
• s3:PutObject
• s3:DeleteObject

Når du har tilsluttet appen, skal du give HubSpot tilladelse til at synkronisere data til din S3-bucket.

1. På din HubSpot-konto skal du klikke på indstillingsikonet på den øverste navigationslinje. I menuen til venstre skal du navigere til Integrationer > Forbundne apps.
2. Klik på Amazon S3.
3. Klik på Vælg i panelet til højre for den Amazon S3-konto, du vil synkronisere data til.
4. På siden »Tilladelser« skal du klikke på »Kopier« for at kopiere eksemplet på en tilladelsespolitik og knytte den til den AWS IAM-rolle, du oprettede tidligere. Husk at opdatere tilladelsespolitikken med dine bucket-navne.

5. Log ind på AWS Management Console.
6. Klik på Tjenester > Sikkerhed, identitet og overholdelse > IAM på startskærmbilledet.
7. Klik på Kontoindstillinger i venstre sidepanel.
8. I afsnittet Security Token Service (STS) skal du finde den AWS-region, der svarer til den region, hvor din AWS-konto er placeret. Klik for at slå kontakten til og aktivere regionen.
9. Klik på Policies i venstre sidepanel.
10. Klik på Opret politik.
11. Klik på fanen JSON, og vælg Tilføj ny sætning.
12. Tilføj den politik, du kopierede i trin 4, som giver HubSpot de nødvendige tilladelser til at indlæse eller udlæse data ved hjælp af en enkelt bucket og mappesti.

13. Klik på Næste.
14. I afsnittet Gennemse og opret skal du angive politiknavnet og en valgfri beskrivelse.
15. Klik på Opret politik.

Konfigurer destinationsbucket

1. Tilbage på siden Tilladelser i HubSpot skal du indtaste bucketnavnet i feltet Bucket.
2. Klik på " Test forbindelse".

3. Hvis forbindelsestesten lykkes, skal du klikke på Næste.

Konfigurer synkroniseringen

1. På siden " Datakilde " skal du vælge de data, du vil synkronisere.
2. Markér afkrydsningsfelterne for de objekter, tilknytninger og begivenheder, du vil synkronisere fra HubSpot til Amazon S3.

3. Klik på " Næste".
4. På siden Detaljer skal du klikke på rullemenuen Synkroniseringsfrekvens og vælge den frekvens, du vil synkronisere data fra HubSpot til Amazon S3 med.

5. Klik på Start synkronisering.

Administrer synkroniseringen

Når du har oprettet en synkronisering, og data begynder at blive synkroniseret fra HubSpot til Amazon S3, kan du se status, identificere fejl, opdatere indstillinger eller arkivere synkroniseringen.

Sådan kontrollerer og administrerer du synkroniseringen:

1. Klik på Mere på din HubSpot-konto, og navigér derefter til Datastyring > Dataintegration. Hvis Mere ikke vises på din konto, skal du navigere direkte til Datastyring > Dataintegration.
2. Gå til fanen "App-synkroniseringer ", og find din Amazon S3-synkronisering i tabellen.
3. Gennemgå synkroniseringsstatus:

• • Synkronisering: En synkronisering er i gang.
  • Synkroniseret: Den sidste synkronisering blev gennemført uden problemer.
  • Mislykket: Der opstod en fejl under den sidste synkronisering.
  • Arkiveret: Synkroniseringskonfigurationen blev fjernet.

4. Klik på synkroniseringsnavnet for at se flere detaljer, herunder poster, der er synkroniseret korrekt, og poster, hvor synkroniseringen mislykkedes.

Sådan redigerer eller fjerner du en synkronisering:

1. Klik på Amazon S3 -synkroniseringen i tabellen.
2. Klik på rullemenuen Handlinger øverst til højre, og vælg derefter en af følgende muligheder:

• • Rediger synkronisering: Opdater synkroniseringsindstillingerne.
  • Arkiver synkronisering: Slet synkroniseringskonfigurationen.

Dataformat til synkronisering mellem HubSpot og Amazon S3

Tilgængelige data til synkronisering

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

• Objekter: standard- og brugerdefinerede objekter, såsom kontakter, virksomheder, billetter eller produkter.
• Poster: individuelle objektposter.
• Egenskaber: egenskaber og deres værdier i objektregistreringerne, herunder egenskabshistorikken.
• Tilknytninger: alle tilknytningstyper og tilknyttede poster.
• Begivenheder: udvalgte standardbegivenheder i HubSpot og brugerdefinerede adfærdsbegivenheder, herunder udvalgte begivenhedsegenskaber.

Objektdata af forskellige typer er organiseret og tilgængelige på to måder:

• Individuelt: hver objekttype gemmes i sin egen tabel og indeholder kun poster af samme objekttype. For eksempel indeholder objects_contacts kun kontaktposter.
• Kombineret: alle poster for alle objekttyper kombineres i ét databaseobjekt. Når du foretager en forespørgsel, skal du derfor angive et filter som f.eks. “WHERE objectTypeId=’0-1’

Brugerdefinerede objekter tildeles et ID ved oprettelsen og identificeres som 2-unique_ID. For eksempel 2-12345.

S3-mappestruktur

HubSpot skriver hver vellykket synkronisering til et HubSpot-administreret præfiks i din Amazon S3-bucket ved hjælp af 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 opretter en ny mappe run-id. HubSpot sletter ikke data fra tidligere synkroniseringer.

Hvis du vil fjerne ældre synkroniseringer automatisk, skal du konfigurere en Amazon S3-livscykluspolitik for bucketen eller præfikset.

HubSpot genererer filnavne for hver synkroniseringskørsel, og filnavnene kan variere fra kørsel til kørsel. Du bør ikke konfigurere efterfølgende processer, så de er afhængige af bestemte filnavne. I stedet skal du læse alle filer i den mappe med det relevante tabelnavn for den eksportkørsel, du vil behandle.

Objektfiler

Hvis du vælger objektdata, eksporterer HubSpot følgende mapper.

OBJECTS_PROPERTIES

Én række pr. objekt-egenskabsværdi.

OBJECT_WITH_OBJECT_PROPERTIES

Én række pr. objektpost, hvor de valgte egenskabsværdier er samlet i en enkelt PROPERTIES -kolonne.

For at læse en bestemt objekttype fra denne mappe skal du filtrere efter OBJECTTYPEID.

Associationsfiler

Hvis du vælger tilknytningsdata, synkroniserer HubSpot tilknytningsposter og tilknytningsdefinitioner.

ASSOCIATIONS

Én række pr. valgt tilknytning mellem to objektregistreringer.

ASSOCIATION_DEFINITIONS

Én række pr. valgt tilknytningsdefinition.

ASSOCIATIONS_<FRA_OBJEKTTYPE>_TIL_<TIL_OBJEKTTYPE>

For udvalgte forbindelsespar synkroniserer HubSpot også mapper for specifikke forbindelsespar, såsom ASSOCIATIONS_CONTACTS_TO_COMPANIES. Disse mapper indeholder forbindelsesposter og de tilhørende definitionsmetadata.

Begivenhedsfiler

Hvis du vælger begivenhedsdata, eksporterer HubSpot én mappe for hver begivenhedstype. Mappenavne følger formatet EVENTS_<EVENT_NAME>, f.eks. EVENTS_VISITED_PAGE.

Hver begivenhedsmappe indeholder standardbegivenhedskolonner og en kolonne for hver begivenhedsegenskab, der er valgt under opsætningen.