Forbind 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>/*"
 ]
 }
 }
 }
 ]
}

• Klik på Næste.
• I afsnittet Gennemgå og opret skal du tilføje navnet på politikken og en valgfri beskrivelse.
• Klik på Opret politik.

3. Opret IAM-rollen i AWS

Sådan konfigureres adgangstilladelser til HubSpot i AWS Management Console:

• Log ind på AWS Management Console.
• Klik på Services > Security, Identity & Compliance > IAM på startdashboardet.
• Klik på Roller i venstre sidepanel.
• Klik på Opret rolle.
• I afsnittet Trusted entity type skal du vælge AWS account.
• I afsnittet En AWS-konto skal du vælge En anden AWS-konto og indtaste dit eget AWS-konto-ID. Du vil senere ændre tillidsforholdet for at give adgang til HubSpot.
• Vælg Kræv eksternt ID, og indtast et pladsholder-id som 0000. Du vil senere ændre tillidsforholdet for din IAM-rolle og angive det eksterne ID for din storage-integration. Et eksternt ID bruges til at give adgang til dine AWS-ressourcer til en tredjepartsapp som HubSpot.

• Klik på Næste.
• Vælg den politik, der blev oprettet i trin 1, og klik på Næste.
• I afsnittet Rolledetaljer skal du indtaste et rollenavn og en beskrivelse for at identificere rollen.
• Klik på Opret rolle.
• Kopier ARN-værdien på siden Role summary. Du skal bruge denne værdi i næste trin.

4. Forbind HubSpot og AWS S3

Før du installerer integrationen, skal du sørge for, at din HubSpot-konto er tilmeldt Access HubSpot data in AWS S3 beta.

• Søg efter og vælg AWS S3. Du kan også navigere til integrationen direkte i din konto ved hjælp af denne URL.
• Klik på Installer app øverst til højre.
• Indtast det IAM Role Name , der blev konfigureret i trin 3, og S3 URL Path for den bucket, du vil have data til at blive dumpet i .
• Klik på Næste.
• Gennemgå og kopier værdierne for AWS IAM User og AWS External ID , da du skal bruge dem i næste trin. Klik derefter på Continue to Connected Apps.

5. Giv IAM-brugeren tilladelse til at få adgang til bucket-objekter

• Log ind på AWS Management Console.
• Klik på Services > Security, Identity & Compliance > IAM på startdashboardet.
• Klik på Roller i venstre sidepanel.
• Vælg den rolle, du oprettede i trin 3.
• Vælg fanen Tillidsrelationer, og klik på Rediger tillidspolitik.
• Ændr politikdokumenterne med de værdier, du registrerede i trin 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 ovenstående politik skal du ændre følgende to felter til de værdier, du registrerede i trin 4:

• hubspot_user_arn til værdien STORAGE_AWS_IAM_USER_ARN
• hubspot_external_id til værdien STORAGE_AWS_EXTERNAL_ID

Når du har gennemført ovenstående trin, kan HubSpot synkronisere data til AWS S3.

Dataformat til synkronisering mellem HubSpot og AWS S3

Tilgængelige data til synkronisering

Du kan synkronisere følgende data fra HubSpot til AWS S3:

• Objekter: standard- og brugerdefinerede objekter som f.eks. kontakter, virksomheder, billetter eller produkter.
• Poster: individuelle objektposter.
• Associationer : alle associationstyper og tilknyttede poster.
• Begivenheder: Begivenhedsdata for både standard HubSpot-begivenheder og brugerdefinerede adfærdsbegivenheder.
• Lister: HubSpot-kontakt- og virksomhedslister.
• Ejere : ejere af poster.
• Pipelines: deal- og ticket-pipelines og pipeline-faser.
• Egenskaber : Egenskaber og deres værdier på objektposterne, herunder egenskabshistorikken.

Objektdata af forskellige typer er organiseret og tilgængelige på to måder:

• Individuelt: Hver objekttype gemmes i sin egen tabel og har kun poster af samme objekttype. For eksempel indeholder objects_contacts kun kontaktoptegnelser.
• Kombineret: Alleposter for alle objekttyper kombineres til ét databaseobjekt. Når du forespørger, skal du således angive et filter som "WHERE objectTypeId='0-1'

Brugerdefinerede objekter får tildelt et ID på oprettelsestidspunktet og identificeres som 2-unique_ID. For eksempel 2-12345.

objects_x-tabeller

Hver tilgængelig objekttype, inklusive brugerdefinerede objekter, har sin egen specifikke tabel. Disse tabeller navngives i formatet OBJECTS_<object type name>, hvor <object type name> er flertalsformen af objecttype. (Bemærk, at hvis objekttypen ikke har nogen flertalsform, vil <object type name> være entalsformen af objekttypens navn sammenkædet med "S").

Nedenfor er en komplet liste over tilgængelige HubSpot-objekttyper, en kort beskrivelse af de data, de repræsenterer, og deres tilsvarende tabeller.

HubSpot-objekttype	ObjekttypeId	Beskrivelse
KONTAKT	0-1	Oplysninger om personer, der interagerer med din virksomhed
VIRKSOMHED	0-2	Oplysninger om individuelle virksomheder eller organisationer
HANDEL	0-3	Detaljer om indtægtsmuligheder med en kontakt eller virksomhed.
ENGAGEMENT	0-4	Gemmer data fra CRM-handlinger, herunder noter, opgaver, e-mails, møder og opkald.
BILLET	0-5	Repræsenterer kundeanmodninger om hjælp eller support.
QUOTE	0-14	Bruges til at dele prisoplysninger med potentielle købere.
FORM_SUBMISSION	0-15	Detaljer for individuelle indsendelser til en HubSpot-formular.
LINE_ITEM	0-8	Repræsenterer en delmængde af de produkter, der sælges i en aftale. Når et produkt er knyttet til en aftale, bliver det til en varelinje.
KONVERSATION	0-11	Detaljer om indgående beskeder fra flere kanaler.
LANDING_PAGE	0-25	Detaljer om dine landingssider
TASK	0-27	Gemmer oplysninger om to-do-lister
FORM	0-28	Bruges til at indsamle lead-oplysninger om dine besøgende og kontakter
MARKETING_EMAIL	0-29	Detaljer om e-mails fra marketing hub
AD_ACCOUNT	0-30	Gemmer oplysninger om dine annoncekonti på Linkedin, Facebook og Google
AD_CAMPAIGN	0-31	Detaljer om dine annoncekampagner. En annoncekampagne kan indeholde en eller flere annoncer
AD_GROUP	0-32	Logisk gruppering af annoncer i en annoncekampagne
AD	0-33	Detaljer om individuelle annoncer
KAMPAGNE	0-35	Oplysninger om relaterede marketingaktiver og -indhold, så du nemt kan måle effektiviteten af din samlede marketingindsats.
SITE_PAGE	0-38	Data om individuelle sider på dine websites
BLOG_POST	0-39	Data om blogindlæg
OBJECT LIST	0-45	Oplysninger om grupperinger af objektposter baseret på deres egenskaber eller aktiviteter
CALL	0-48	Opkald foretaget af andre CRM-poster, f.eks. kontakter
INVOICE	0-53	Administrer og synkroniser fakturaer med eksterne regnskabssystemer
MEDIA_BRIDGE	0-57	Oplysninger om medieaktiver, der er importeret til HubSpot
SEQUENCE	0-58	En sekvens er en række målrettede, tidsbestemte e-mail-skabeloner til at pleje kontakter over tid
DEAL_SPLIT	0-72	Deal splits bruges til at dele deal credit mellem flere brugere
SALES_DOCUMENT	0-83	Salgsdokumenter opbygger et bibliotek med indhold, som hele dit team kan uploade og dele dokumenter med dine kontakter.
FEEDBACK_INDSENDELSE	0-19	Gemmer oplysninger, der er indsendt til en feedback-undersøgelse.
ABONNEMENT	0-69	Abonnementer indeholder oplysninger om tilbagevendende betalinger.
HANDELSBETALING	0-101	Indeholder data om midler indsamlet fra kunder

objekt_med_objekt_egenskaber

Denne tabel indeholder data fra dine HubSpot-poster. Du kan få en række for hver post inden for en objekttype (f.eks. alle kontaktposter i kontaktobjekttypen).

object_properties_history

Denne tabel indeholder historiske egenskabsværdier. For kontakter indeholder den de seneste 45 værdier. For alle andre objekter indeholder den de seneste 20 værdier. Tabellen har en række for hver historisk egenskabsværdi. Den aktuelle værdi for en egenskab bestemmes af det seneste UPDATEDAT-tidsstempel i egenskabens historik.

Forespørgsler om associationer

Ligesom objektdata er associationsdata organiseret på to måder:

• Individuelt: Hver associationstype gemmes i sin egen tabel og indeholder kun poster af den type. For eksempel indeholder associations_contacts_to_deals kun associationsposter mellem kontakt- og aftaleobjekter. T
• Kombineret: Alle poster for alle associationstyper er samlet i én tabel.

associationer_x_til_y

Hver associationstype har sin egen visning, mærket som associations_<association type name> f.eks. associations_contacts_to_deals.

associationer_definitioner

Denne tabel indeholder oplysninger om alle tilgængelige associationstyper mellem HubSpot-objekter, med en række pr. associationstype.

egenskaber_definitioner

Denne tabel indeholder oplysninger om objektegenskaber og hændelsesegenskaber i din HubSpot-konto. Hændelsesegenskaber omfatter standardhændelser, som f.eks. e-mailåbninger og -klik, og brugerdefinerede adfærdsrelaterede h ændelsesegenskaber. Disse oplysninger kan være nyttige til at definere værdier, der findes i object_properties og hændelsesdata.

Begivenheder

Begivenheder omfatter standard HubSpot-begivenheder og brugerdefinerede adfærdsbegivenheder. Hver begivenhed har sin egen tabel, mærket som events_eventname.

object_and_event_type_definitions

Denne tabel indeholder definitioner for alle objekter og hændelser, der er tilgængelige på din HubSpot-konto.

Synkroniseringsfrekvens og dataorganisation

Data synkroniseres dagligt mellem HubSpot og AWS S3. Der oprettes en mappe for hver dag, dataene synkroniseres. Hver af de følgende tabeller vil være tilgængelig 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

Der vil være flere undermapper for hver tabel. Hvis tabellens størrelse overstiger 15 MB, vil der være flere gzippede CSV-filer under hver tabelmappe.