Koble HubSpot og AWS S3 (BETA)

Lær hvordan du kobler HubSpot og AWS S3 for å synkronisere HubSpot-data til S3-bøtten din.

Koble HubSpot og AWS S3

For å koble HubSpot og AWS S3 må du følge trinnene nedenfor i rekkefølge:

1. Konfigurere tilgangstillatelser for AWS S3-bøtta
2. Opprett en IAM-policy
3. Opprett IAM-rollen i AWS
4. Koble HubSpot og AWS S3
5. Gi IAM-brukeren rettigheter til å få tilgang til S3-bøtteobjekter

1. Konfigurer tilgangstillatelser for S3-bøtta

HubSpot trenger følgende tillatelser på en AWS S3-bøtte og -mappe for å få tilgang til filer i mappen og undermapper:

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

2. Opprett en IAM-policy

• Logg inn på AWS Management Console.
• Klikk på Tjenester > Sikkerhet, identitet og samsvar > IAM på startpanelet .
• Klikk på Kontoinnstillinger i venstre sidefelt.
• I Security Token Service (STS) -delen ser du etter AWS-regionen som tilsvarer regionen AWS-kontoen din befinner seg i. Klikk for å slå bryteren på for å aktivere regionen.
• Klikk på Policyer i venstre sidepanel.
• Klikk på Opprett policy.
• Klikk på Legg til ny setning i JSON-fanen.
• Legg til policy-dokumentet nedenfor som vil gi HubSpot de nødvendige tillatelsene til å laste inn eller ut data ved hjelp av en enkelt bucket og mappebane. Du kan også rense datafiler ved hjelp av alternativet PURGE copy.

{
 "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>/*"
 ]
 }
 }
 }
 ]
}

• Klikk på Neste.
• I delen Gjennomgå og opprett legger du til navnet på policyen og en valgfri beskrivelse.
• Klikk på Opprett policy.

3. Opprett IAM-rollen i AWS

Slik konfigurerer du tilgangstillatelser for HubSpot i AWS Management Console:

• Logg inn på AWS Management Console.
• Klikk på Tjenester > Sikkerhet, identitet og samsvar > IAM på startpanelet .
• Klikk på Roller i venstre sidefelt.
• Klikk på Opprett rolle.
• Velg AWS-konto i delen Betrodd enhetstype .
• I An AWS acount-delen velger du Another AWS account og skriver inn din egen AWS-konto-ID. Du vil senere endre tillitsforholdet for å gi tilgang til HubSpot.
• Velg Krev ekstern ID, og skriv inn en plassholder-ID som 0000. Du vil senere endre tillitsforholdet for IAM-rollen din og angi den eksterne ID-en for lagringsintegrasjonen. En ekstern ID brukes til å gi tilgang til AWS-ressursene dine til en tredjepartsapp som HubSpot.

• Klikk på Neste.
• Velg policyen som ble opprettet i trinn 1, og klikk på Neste.
• I delen Rolledetaljer angir du et rollenavn og en beskrivelse for å identifisere rollen.
• Klikk på Opprett rolle.
• Kopier ARN-verdien på siden Role summary (Rolleoversikt). Du vil bruke denne verdien i neste trinn.

4. Koble HubSpot og AWS S3

• Sørg for at HubSpot-kontoen din er valgt inn i denne betaversjonen: Få tilgang til HubSpot-data i AWS S3.
• Gå til denne URL-en og velg HubSpot-kontoen din.
• Klikk på Installer app øverst til høyre.
• Skriv inn IAM-rollenavnet som ble konfigurert i trinn 3, og S3 URL-banen for skuffen du vil at dataene skal dumpes til.
• Klikk på Neste.
• Gå gjennom og kopier verdiene for AWS IAM User og AWS External ID , ettersom du trenger dem i neste trinn. Klikk deretter på Fortsett til tilkoblede apper.

5. Gi IAM-brukeren rettigheter til å få tilgang til bøtteobjekter

• Logg inn på AWS Management Console.
• Klikk på Tjenester > Sikkerhet, identitet og samsvar > IAM på startpanelet .
• Klikk på Roller i venstre sidefelt.
• Velg rollen du opprettet i trinn 3.
• Velg fanen Tillitsrelasjoner, og klikk på Rediger tillitspolicy.
• Endre policydokumentene med verdiene du registrerte i trinn 3.

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Sid": "",
 "Effect": "Allow",
 "Principal": {
 "AWS": "<hubspot_user_arn>"
 },
 "Action": "sts:AssumeRole",
 "Condition": {
 "StringEquals": {
 "sts:ExternalId": "<hubspot_external_id>"
 }
 }
 }
 ]
}

I policyen ovenfor endrer du følgende to felt til verdiene du registrerte i trinn 4:

• hubspot_user_arn til STORAGE_AWS_IAM_USER_ARN-verdien
• hubspot_external_id til STORAGE_AWS_EXTERNAL_ID-verdien

Når du har fullført trinnene ovenfor, kan HubSpot synkronisere data til AWS S3.

Dataformat for synkronisering mellom HubSpot og AWS S3

Tilgjengelige data for synkronisering

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

• Objekter: standardobjekter og egendefinerte objekter, for eksempel kontakter, selskaper, billetter eller produkter.
• Poster: individuelle objektposter.
• Assosiasjoner: alle assosiasjonstyper og tilhørende poster.
• Hendelser: Hendelsesdata for både standard HubSpot-hendelser og egendefinerte atferdshendelser.
• Lister: HubSpots kontakt- og selskapslister.
• Eiere: registrerte eiere.
• Pipelines: avtale- og billettpipelines og pipelinefaser.
• Egenskaper: egenskaper og deres verdier på objektpostene, inkludert egenskapshistorikken.

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

• Individuell: Hver objekttype lagres i sin egen tabell og har bare poster av samme objekttype. For eksempel inneholder objects_contacts bare kontaktoppføringer.
• Kombinert: Alleposter for alle objekttyper kombineres til ett databaseobjekt. Når du spør, må du derfor spesifisere et filter som "WHERE objectTypeId='0-1'

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

objects_x-tabeller

Hver tilgjengelig objekttype, inkludert egendefinerte objekter, har sin egen spesifikke tabell. Disse tabellene navngis i formatet OBJECTS_<object type name>, der <object type name> er flertallsformen av objecttype. (Merk at hvis objekttypen ikke har noen flertallsform, vil <object type name> være entallsformen av objekttypenavnet, sammenkjedet med "S").

Nedenfor finner du en komplett liste over tilgjengelige HubSpot-objekttyper, en kort beskrivelse av dataene de representerer, og de tilhørende tabellene.

objekt_med_objektegenskaper

Denne tabellen inneholder data fra HubSpot-postene dine. Du kan få én rad for hver post innenfor en objekttype (f.eks. alle kontaktposter i kontaktobjekttypen).

object_properties_history

Denne tabellen inneholder historiske eiendomsverdier. For kontakter inneholder den de siste 45 verdiene. For alle andre objekter inneholder den de 20 siste verdiene. Tabellen har en rad for hver historiske egenskapsverdi. Den gjeldende verdien for en egenskap bestemmes av det siste UPDATEDAT-tidsstempelet i egenskapens historikk.

Forespørsler om assosiasjoner

I likhet med objektdata er assosiasjonsdata organisert på to måter:

• Individuell: Hver assosiasjonstype lagres i sin egen tabell og inneholder bare poster av den typen. For eksempel inneholder associations_contacts_to_deals bare assosiasjonsposter mellom kontakt- og avtaleobjekter. T
• Kombinert: Alle poster for alle tilknytningstyper samles i én tabell.

assosiasjoner_x_til_y

Hver assosiasjonstype har sin egen visning, merket som associations_<association type name>, f.eks. associations_contacts_to_deals.

assosiasjon_definisjoner

Denne tabellen inneholder informasjon om alle tilgjengelige tilknytningstyper mellom HubSpot-objekter, med én rad per tilknytningstype.

property_definitions

Denne tabellen inneholder informasjon om objektegenskaper og hendelsesegenskaper i HubSpot-kontoen din. Hendelsesegenskaper inkluderer standardhendelser, for eksempel e-poståpninger og klikk, og egendefinerte atferdsmessige hendelsesegenskaper. Denne informasjonen kan være nyttig for å definere verdier som finnes i object_properties og hendelsesdata.

Hendelser

Hendelser inkluderer standard HubSpot-hendelser og egendefinerte atferdshendelser. Hver hendelse har sin egen tabell, merket som events_eventname.

objekt_og_hendelse_typedefinisjoner

Denne tabellen inneholder definisjoner for alle objekter og hendelser som er tilgjengelige i HubSpot-kontoen din.

Synkroniseringsfrekvens og organisering av data

Data synkroniseres daglig mellom HubSpot og AWS S3. Det opprettes en mappe for hver dag dataene synkroniseres. Hver av de følgende tabellene vil være tilgjengelig som en mappe med gzippede CSV-filer:

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

Det vil være flere undermapper for hver tabell. Hvis tabellen er større enn 15 MB, vil det ligge flere gzippede CSV-filer under hver tabellmappe.