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 Neste .
• I Se gjennom og opprett -delen legger du til policynavnet 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 på AWS Management Console .
• På hjemmedashbordet klikker du på Tjenester > Sikkerhet, identitet og overholdelse > IAM .
• Klikk på Roller på venstre sidefelt.
• Klikk på Opprett rolle .
• I delen Klarert enhetstype velger du AWS-konto .
• I delen En AWS-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 spesifisere den eksterne IDen for lagringsintegrasjonen. En ekstern ID brukes til å gi tilgang til AWS-ressursene dine til en tredjepartsapp som HubSpot.

• Klikk Neste .
• Velg policyen 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 .
• På Rollesammendrag-siden kopierer du ARN- verdien. Du vil bruke denne verdien i neste trinn.

4. Koble til HubSpot og AWS S3

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

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

• Logg på AWS Management Console .
• På hjemmedashbordet klikker du på Tjenester > Sikkerhet, identitet og overholdelse > IAM .
• Klikk på Roller i venstre sidefelt.
• Velg rollen du opprettet i trinn 3.
• Velg kategorien Klareringsrelasjoner 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 retningslinjene 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 STORAGE_AWS_EXTERNAL_ID -verdien

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, firmaer, billetter eller produkter.
• Records: individuelle objektposter.
• Assosiasjoner: alle foreningstyper og tilhørende poster.
• Hendelser: hendelsesdata for både standard HubSpot-hendelser og tilpassede atferdshendelser.
• Lister: HubSpot kontakt- og firmalister.
• Eiere: plateeiere.
• Rørledninger: avtale- og billettrørledninger og rørledningsfaser.
• Egenskaper: egenskaper og deres verdier på objektpostene, inkludert egenskapshistorikken.

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

• Individuell: hver objekttype er lagret i sin egen tabell og har bare poster av samme objekttype. For eksempel inneholder objects_contacts bare kontaktposter.
• Kombinert: alle poster for alle objekttyper er kombinert til ett databaseobjekt. Derfor, når du spør, må du spesifisere et filter som "WHERE objectTypeId='0-1'

Egendefinerte objekter vil bli tildelt en ID ved opprettelsen, og vil bli identifisert som 2-unique_ID . For eksempel 2-12345 .

objekter_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 flertallsformetiketten til objecttype .(Merk at hvis objekttypen ikke har noen flertallsform, vil <object type name> formetikett for objekttypenavnet sammenkoblet med "S").

Nedenfor er en fullstendig liste over tilgjengelige HubSpot-objekttyper, en kort beskrivelse av dataene de representerer, og deres tilsvarende tabeller.

objekt_med_objektegenskaper

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

objekt_egenskaper_historie

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 historisk egenskapsverdi. Den nåværende verdien av en eiendom bestemmes av det siste UPDATEDAT-tidsstempelet i eiendommens historie.

Forespørsler fra foreningen

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

• Individuell: hver assosiasjonstype er lagret i sin egen tabell og inneholder kun 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 kombinert til én tabell.

assosiasjoner_x_til_y

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

assosiasjonsdefinisjoner

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

egenskapsdefinisjoner

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

Hendelser

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

objekt_og_hendelsestypedefinisjoner

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. En mappe vil bli opprettet 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 hvert bord. Hvis størrelsen på tabellen overstiger 15 MB, vil det være flere gzippede CSV-filer under hver tabellmappe.