Koble til HubSpot og AWS S3 (BETA)

{
 "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.