NO | Knowledge Quick Answers

Koble til HubSpot og AWS S3 (BETA)

Skrevet av HubSpot Support | Sep 18, 2024 3:09:59 PM

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 dinAccess 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 å: 

  1. Konfigurer tilgangstillatelser for AWS S3-bøtte
  2. Opprett en IAM-retningslinje
  3. Opprett IAM-rollen i AWS
  4. Koble til HubSpot og AWS S3
  5. 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å 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

KONTAKT

0-1

Informasjon om enkeltpersoner som samhandler med virksomheten din

FIRMA

0-2

Informasjon om enkeltbedrifter eller organisasjoner

TILBUD

0-3

Detaljer om inntektsmuligheter med en kontakt eller et selskap. 

ENGASJEMENT

0-4

Lagrer data fra CRM-handlinger, inkludert notater, oppgaver, e-post, møter og samtaler.

BILLETT

0-5

Representere kundeforespørsler om hjelp eller støtte.

TILBUD

0-14

Brukes til å dele prisinformasjon med potensielle kjøpere.

FORM_SUBMISSION

0-15

Detaljer for individuelle innsendinger for et HubSpot-skjema.

LINE_ITEM

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.

SAMTALE

0-11

Detaljer om innkommende meldinger fra flere kanaler.

LANDING_PAGE

0-25

Opplysninger om destinasjonssidene dine

 OPPGAVE

0-27

Lagrer informasjon om gjøremålslister

SKJEMA

0-28

Brukes til å samle inn kundeemneinformasjon om besøkende og kontakter

MARKETING_EMAIL

0-29

Detaljer om eposter fra markedsføringssenteret

AD_ACCOUNT

0-30

Lagrer informasjon om annonsekontoene dine på Linkedin, Facebook og Google

AD_CAMPAIGN

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

KAMPANJE

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

BLOGG_POST

0-39

Data om blogginnlegg

OBJEKTLISTE

0-45

Informasjon om grupperinger av objektposter basert på deres egenskaper eller aktiviteter

RING

0-48

Samtaler foretatt av andre CRM-poster, for eksempel kontakter

FAKTURA

0-53

Administrer og synkroniser fakturaer med eksterne regnskapssystemer

MEDIA_BRIDGE

0-57

Informasjon om medieelementer som er importert til HubSpot

SEKVENS

0-58

En sekvens er en serie målrettede, tidsinnstilte e-postmaler for å pleie kontakter over tid

DEAL_SPLIT

0-72

Avtaledelinger brukes til å dele avtalekreditt mellom flere brukere

SALES_DOCUMENT

0-83

Salgsdokumenter bygger et bibliotek med innhold som hele teamet kan laste opp og dele dokumenter med kontaktene sine.

FEEDBACK_SUBMISSION

0-19

Lagrer informasjon sendt til en tilbakemeldingsundersøkelse.

ABONNEMENT

0-69

Abonnementer inneholder detaljer om tilbakevendende betalinger

HANDELSBETALING

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.