I betaKoble 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 Gjennomgå og opprett legger du til policyens navn 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.
• På startpanelet klikker du på Tjenester > Sikkerhet, identitet og samsvar > IAM.
• Klikk på Roller i venstre sidefelt.
• Klikk på Opprett rolle.
• Velg AWS-konto i delen Type betrodd enhet.
• I delen En A WS-konto velger du En annen AWS-konto 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 til HubSpot og AWS S3

• I HubSpot-kontoen din klikker du på ikonet Marketplace marketplace i den øverste navigasjonslinjen og velger deretter App Marketplace. Søk etter og velg AWS S3. Du kan også navigere til integrasjonen direkte i kontoen din ved å bruke denne URL-en.
• Klikk på Installer app øverst til høyre.
• Skriv inn IAM Role Name som ble konfigurert i trinn 3, og S3 URL-banen for skuffen du vil at dataene skal dumpes i .
• 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 tillatelse til å få tilgang til bøtteobjekter

• Logg inn på AWS Management Console.
• På startpanelet klikker du på Tjenester > Sikkerhet, identitet og samsvar > IAM.
• Klikk på Roller i venstre sidefelt.
• Velg rollen du opprettet i trinn 3.
• Velg fanen Tillitsrelasjoner, og klikk på Rediger tillitspolicy.
• Endre policy-dokumentene 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: standard og egendefinerte objekter, for eksempel kontakter, selskaper, billetter eller produkter.
• Poster: individuelle objektposter.
• Assosiasjoner : alleassosiasjonstyper og tilhørende poster.
• Hendelser: hendelsesdata for både standard HubSpot-hendelser og egendefinerte atferdshendelser.
• Lister: HubSpot-kontakt- og selskapslister.
• Eiere : eiere av poster.
• Pipelines: avtale- og billettpipelines og pipelinefaser.
• Properties: egenskaper og deres verdier på objektpostene, inkludert egenskapshistorikk.

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

• Individuell: Hver objekttype lagres i sin egen tabell og inneholder bare poster av samme objekttype. For eksempel inneholder objects_contacts bare kontaktoppføringer.
• Kombinert: Alleoppføringer for alle objekttyper er samlet i ett databaseobjekt. Når du gjør en spørring, 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 tilgjengelige 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 sammenkoblet med "S").

Nedenfor finner du en fullstendig 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 hente én rad for hver post i en objekttype (f.eks. alle kontaktposter i kontaktobjekttypen).

object_properties_history

Denne tabellen inneholder historiske egenskapsverdier. 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.

Assosiasjonsspørringer

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 assosiasjonstyper er samlet 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 assosiasjonstyper mellom HubSpot-objekter, med én rad per assosiasjonstype.

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 h endelsesegenskaper. 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_type_definisjoner

Denne tabellen inneholder definisjoner for alle objekter og hendelser 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 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 tabellens størrelse overstiger 15 MB, vil det være flere gzippede CSV-filer under hver tabellmappe.