I betaKoble til HubSpot og AWS S3 (BETA)
Sist oppdatert: februar 14, 2025
Gjelder for:
|
Finn ut hvordan du kobler HubSpot og AWS S3 til å synkronisere HubSpot-data til S3-skuffen.
Før du kommer i gang
Før du konfigurerer integrasjonen, må du velge HubSpot-kontoen din i Access HubSpot-dataene i AWS S3 beta.
Koble til HubSpot og AWS S3
For å koble til HubSpot og AWS S3, må du følge trinnene nedenfor for å:
- Konfigurer tilgangstillatelser for AWS S3-bøtte
- Opprett en IAM-retningslinje
- Opprett IAM-rollen i AWS
- Koble til HubSpot og AWS S3
- Gi IAM-brukertillatelser til å få tilgang til S3-bøtteobjekter
1. Konfigurer tilgangstillatelser for S3-skuffen
HubSpot trenger følgende tillatelser på en AWS S3-bøtte og -mappe for å få tilgang til filer i mappen og undermappene:
- s3:GetBucketLocation
- s3:GetObject
- s3:GetObjectVersion
- s3:ListBucket
- s3:PutObject
- s3:DeleteObject
2. Opprett en IAM-retningslinje
- Logg på AWS Management Console.
- På startoversikten klikker du på Tjenester > Sikkerhet, identitet og samsvar > IAM.
- Klikk på Kontoinnstillinger i venstre sidepanel.
- I delen Security Token Service (STS) ser du etter AWS-regionen som tilsvarer regionen AWS-kontoen din befinner seg i. Klikk for å slå på bryteren for å aktivere regionen.
- Klikk på Retningslinjer i venstre sidepanel.
- Klikk på Opprett vilkår.
- Klikk på Legg til ny uttalelse på JSON-fanen.
- Legg til retningslinjedokumentet nedenfor som vil gi HubSpot tillatelsene den trenger for å laste inn eller ut data ved hjelp av en enkelt bøtte og mappebane. Du kan også tømme datafiler ved hjelp av alternativet for tømmekopiering.
Vennligst merk:
- Pass på at du erstatter
<bucket>
og<prefix>
med det faktiske bucket-navnet og mappebaneprefikset. Amazon Resource Names (Arn) for buckets in government regions have an arn: aws-us-gov:s3::: prefix. - Ved å angi betingelsen
s3:prefix
til enten ["*"] eller ["<bane>/*"] får du tilgang til alle prefiksene i henholdsvis den angitte kurven eller kurven i kurven.
{
"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 Se gjennom og opprett legger du til navnet på retningslinjene og en valgfri beskrivelse.
- Klikk på Opprett vilkår.
3. Opprett IAM-rollen i AWS
Slik konfigurerer du tilgangstillatelser for HubSpot i AWS Management Console:
- Logg på AWS Management Console.
- På startoversikten klikker du på Tjenester > Sikkerhet, identitet og samsvar > IAM.
- Klikk på Roller i venstre sidepanel.
- Klikk på Opprett rolle.
- Velg AWS-konto i delen Type klarert enhet .
- I delen En AWS-konto velger du En annen AWS-konto og angir 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 klareringsforholdet for IAM-rollen 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 retningslinjene som ble opprettet i trinn 1, og klikk på Neste.
- I delen Rolledetaljer skriver du inn et rollenavn og en beskrivelse for å identifisere rollen.
- Klikk på Opprett rolle.
- Kopier ARN-verdien på rollesammendragssiden. Du vil bruke denne verdien i neste trinn.
4. Koble til HubSpot og AWS S3
Før du installerer integrasjonen, må du kontrollere at HubSpot-kontoen din er valgt å delta den Tilgang til HubSpot-data i AWS S3 beta.- Søk etter og velg AWS S3. Du kan også navigere til integrasjonen direkte i kontoen din ved hjelp av denne nettadressen.
- Klikk på Installer app øverst til høyre.
- Skriv inn IAM-rollenavnet som ble konfigurert i trinn 3, og S3-URL-banen for kurven du vil at dataene skal dumpes i.
- Klikk på Neste.
- Gjennomgå og kopier AWS IAM User- og AWS External ID-verdiene etter hvert som du trenger dem i neste trinn. Klikk deretter på Fortsett til tilkoblede apper.
5. Gi IAM-brukertillatelser til å få tilgang til bøtteobjekter
- Logg på AWS Management Console.
- På startoversikten klikker du på Tjenester > Sikkerhet, identitet og samsvar > IAM.
- Klikk på Roller i venstre sidepanel.
- Velg rollen du opprettet i trinn 3.
- Velg fanen Klareringsforhold, og klikk på Rediger klareringspolicy.
- Endre retningslinjedokumentene 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 fra trinn 4:
- hubspot_user_arn til STORAGE_AWS_IAM_USER_Arn -verdien
- hubspot_external_id til verdien STORAGE_AWS_EXTERNAL_ID
Etter å ha 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: standard og egendefinerte objekter, for eksempel kontakter, selskaper, billetter eller produkter.
- Poster: individuelle objektposter.
- Tilknytninger: alle tilknytningstyper og tilknyttede poster.
- Hendelser: Hendelsesdata for både standard HubSpot-hendelser og tilpassede atferdshendelser.
- Lister: HubSpot-kontakt- og firmalister.
- Eiere: Record eiere.
- Rørledninger: avtale- og billettrørledninger og rørledningstrinn.
- Egenskaper: egenskaper og deres verdier på objektpostene, inkludert egenskapshistorikken.
Objektdata av forskjellige typer er organisert og tilgjengelig på to måter:
- Individual: e ach-objekttypen lagres i sin egen tabell og har bare poster av samme objekttype.
objects_contacts
inneholder for eksempel bare kontaktoppføringer. - Kombinert: a ll-poster for alle objekttyper kombineres til ett databaseobjekt. Når du spør, må du derfor angi et filter som «WHERE OBJECTTYPEID =’0-1’»
Egendefinerte objekter vil bli tildelt en ID når de opprettes, og vil bli identifisert som 2-unique_ID. F.eks. 2-12345.
objects_x tabeller
Hver tilgjengelig objekttype, inkludert egendefinerte objekter, har sin egen spesifikke tabell. Disse tabellene er navngitt etter formatet OBJECTS_<object type name>
der <object type name>
er flertallsskjemaetiketten for objecttype
.(Merk at hvis objekttypen ikke har noen flertallsform, vil <object type name>
være entallsformetiketten til objekttype-navnet sammenkjedet med «S»).
Nedenfor er en fullstendig liste over tilgjengelige HubSpot-objekttyper, en kort beskrivelse av dataene de representerer, og tilhørende tabeller.
HubSpot-objekttype |
Objekttype-ID |
Beskrivelse |
0-1 |
Informasjon om enkeltpersoner som samhandler med virksomheten din |
|
0-2 |
Informasjon om enkeltbedrifter eller organisasjoner |
|
0-3 |
Detaljer om inntektsmuligheter med en kontakt eller et selskap. |
|
0-4 |
Lagrer data fra CRM-handlinger, inkludert notater, oppgaver, e-post, møter og samtaler. |
|
0-5 |
Representere kundeforespørsler om hjelp eller støtte. |
|
0-14 |
Brukes til å dele prisinformasjon med potensielle kjøpere. |
|
0-15 |
Detaljer for individuelle innsendinger for et HubSpot-skjema. |
|
0-8 |
Representerer et delsett av produkter som selges i en avtale. Når et produkt er knyttet til en avtale, blir det en linjeartikkel. |
|
0-11 |
Detaljer om innkommende meldinger fra flere kanaler. |
|
0-25 |
Opplysninger om destinasjonssidene dine |
|
0-27 |
Lagrer informasjon om gjøremålslister |
|
0-28 |
Brukes til å samle inn kundeemneinformasjon om besøkende og kontakter |
|
0-29 |
Detaljer om eposter fra markedsføringssenteret |
|
AD_ACCOUNT |
0-30 |
Lagrer informasjon om annonsekontoene dine på Linkedin, Facebook og Google |
0-31 |
Informasjon om annonsekampanjene dine. En annonsekampanje kan inneholde én eller flere annonser |
|
AD_GROUP |
0-32 |
Logisk gruppering av annonser i en annonsekampanje |
AD |
0-33 |
Informasjon om individuelle annonser |
0-35 |
Informasjon om relaterte markedsføringsressurser og innhold, slik at du enkelt kan måle effektiviteten av dine kollektive markedsføringsinnsatser. |
|
SITE_PAGE |
0-38 |
Data om individuelle sider på nettstedene dine |
0-39 |
Data om blogginnlegg |
|
0-45 |
Informasjon om grupperinger av objektposter basert på deres egenskaper eller aktiviteter |
|
0-48 |
Samtaler foretatt av andre CRM-poster, for eksempel kontakter |
|
FAKTURA |
0-53 |
Administrer og synkroniser fakturaer med eksterne regnskapssystemer |
0-57 |
Informasjon om medieelementer som er importert til HubSpot |
|
0-58 |
En sekvens er en serie målrettede, tidsinnstilte e-postmaler for å pleie kontakter over tid |
|
0-72 |
Avtaledelinger brukes til å dele avtalekreditt mellom flere brukere |
|
0-83 |
Salgsdokumenter bygger et bibliotek med innhold som hele teamet kan laste opp og dele dokumenter med kontaktene sine. |
|
0-19 |
Lagrer informasjon sendt til en tilbakemeldingsundersøkelse. |
|
0-69 |
Abonnementer inneholder detaljer om tilbakevendende betalinger |
|
0-101 |
Inneholder data om midler innhentet fra kunder |
object_with_object_properties
Denne tabellen inneholder data fra HubSpot-postene dine. Du kan få én rad for hver post i en objekttype (f.eks. alle kontaktposter i objekttypen kontakter).
object_properties_history
Denne tabellen inneholder historiske egenskapsverdier. For kontakter inneholder den de siste 45 verdiene. For alle andre objekter inneholder den de siste 20 verdiene. Tabellen har en rad for hver historiske egenskapsverdi. Gjeldende verdi for en eiendom bestemmes av det siste UPDATEDAT-tidsstempelet i eiendommens historikk.
Tilknytningsspørsmål
I likhet med objektdata er assosiasjonsdata organisert på to måter:
- Individuell: hver tilknytningstype lagres i sin egen tabell og inneholder bare poster av den typen.
associations_contacts_to_deals
eksempel bare tilknytningsposter mellom kontakt- og avtaleobjekter. T - Kombinert: alle poster for alle tilknytningstyper kombineres i én tabell.
associations_x_to_y
Hver tilknytningstype har sin egen visning, merket som associations_<association type name>
, f.eks. associations_contacts_to_deals
.
association_definitions
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 aktivitetsegenskaper i HubSpot-kontoen. Aktivitetsegenskaper inkluderer standardaktiviteter, for eksempel åpning av e-post og klikk, og egendefinerte atferdsmessige aktivitetsegenskaper. Denne informasjonen kan være nyttig for å definere verdier som finnes i objektegenskaper og hendelsesdata.
Aktiviteter
Hendelser inkluderer standard HubSpot-hendelser og tilpassede atferdshendelser. Hver aktivitet har sin egen tabell, merket som events_eventname
.
object_and_event_type_definitions
Denne tabellen inneholder definisjoner for alle objekter og aktiviteter som er tilgjengelige i HubSpot-kontoen din.
Synkroniseringsfrekvens og dataorganisering
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 tilgjengelige 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 størrelsen på tabellen overstiger 15 MB, vil det være flere gzippede CSV-filer under hver tabellmappe.