I betaKontakt HubSpot og AWS S3

Kontakt HubSpot og AWS S3 for at synkronisere HubSpot-data til en S3-bøtte. Efter kontakt med appen kan HubSpot CRM-data, herunder objekter, registre, tilknytninger, hændelser og segmenter, synkroniseres med AWS S3 til opbevaring, rapportering og analyse. 

Du kan f.eks. synkronisere data om kontakter og virksomheder til en S3-bucket og bruge dem i din organisations datalager, business intelligence-værktøjer eller arbejdsgange til databehandling.

Bemærk: HubSpot deler ikke HIPAA-data til AWS S3.

Før du går i gang

Før du sætter integrationen op, skal du vælge din HubSpot-konto til Access HubSpot data in AWS S3 beta.

Kontakt HubSpot og AWS S3

For at kontakte HubSpot og AWS S3 skal du følge nedenstående trin i rækkefølge: 

1. Konfigurer adgangstilladelser til AWS S3-bucketen. 
2. Opret en IAM-politik. 
3. Opret IAM-rollen i AWS. 
4. Kontakt HubSpot og AWS S3. 
5. Giv IAM-brugeren tilladelse til at få adgang til objekter i S3-bucket. 

1. Konfigurer adgangstilladelser til S3-bucketen

HubSpot har brug for følgende tilladelser til en AWS S3-bucket og -mappe for at få adgang til filer i mappen og undermapper:

• s3:HentBucketLokation
• s3:HentObjekt
• s3:HentObjektVersion
• s3:ListBucket
• s3:PutObject
• s3:DeleteObject

2. Opret en IAM-politik

1. Log ind på AWS Management Console.
2. Klik på Services > Security, Identity, & Compliance > IAM på home dashboard.
3. Klik på Indstillinger for konto i venstre sidepanel.
4. I afsnittet Security Token Service (STS) skal du kigge efter den AWS-region, der svarer til den region, hvor din AWS-konto er placeret. Klik for at slå kontakten til for at aktivere regionen.
5. Klik på Politikker i venstre side. 
6. Klik på Opret politik. 
7. Klik på Tilføj ny erklæring på fanen JSON . 
8. Tilføj nedenstående policydokument, som giver HubSpot de nødvendige tilladelser til at indlæse eller udlæse data ved hjælp af en enkelt bucket og mappesti. Du kan også rense datafiler ved hjælp af indstillingen PURGE copy. 

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

9. Klik på Næste.
10. I afsnittet Anmeldelse og oprettelse skal du tilføje navnet på politikken og en valgfri beskrivelse.
11. Klik på Opret politik. 

3. Opret IAM-rollen i AWS

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

1. Log ind på AWS Management Console.
2. Klik på Services > Security, Identity, & Compliance > IAM på home dashboard.
3. Klik på Roller i venstre sidepanel. 
4. Klik på Opret rolle. 
5. Vælg AWS-konto i afsnittet Type enhed, der er tillid til .
6. 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. 
7. 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. 

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

4. Kontakt HubSpot og AWS S3

1. På din HubSpot-konto skal du klikke på Marketplace-ikonet i den øverste navigationslinje og derefter vælge HubSpot Marketplace.
2. Søg efter og vælg AWS S3. 
3. Klik på Rate . 
4. Indtast det IAM Role Name , der blev konfigureret i trin 3, og S3 URL Path for den bucket, du vil gemme data i.
5. Klik på Næste.
6. Anmeld 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

1. Log ind på AWS Management Console.
2. Klik på Services > Security, Identity, & Compliance > IAM på home dashboard.
3. Klik på Roller i venstre sidepanel.
4. Vælg den rolle, du oprettede i trin 3. 
5. Vælg fanen Tillidsrelationer , og klik på Rediger tillidspolitik. 
6. Ændr policedokumenterne 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>"
 }
 }
 }
 ]
}

7. I ovenstående politik skal du ændre de 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, f.eks. kontakter, virksomheder, tickets eller produkter.
• Registre: individuelle objektregistre. 
• Tilknytninger: alle typer af tilknytninger og tilknyttede registre.
• Hændelser: hændelsesdata for både standard HubSpot-hændelser og brugerdefinerede adfærdsmæssige hændelser. 
• Segmenter: HubSpot-kontakt- og virksomhedssegmenter.
• Ejere: registrerede ejere. 
• Pipelines: deal- og ticket-pipelines og pipeline-faser. 
• Egenskaber: Egenskaber og deres værdier på objektregistrene, herunder egenskabshistorikken. 

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

• Individuel: eHver objekttype gemmes i sin egen tabel og har kun registre af samme objekttype. For eksempel, objects_contacts indeholder kun kontaktregistre.
• Kombineret: alleregistre 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. 

objekter_x tabeller

Hver tilgængelig objekttype, inklusive brugerdefinerede objekter, har sin egen specifikke tabel. Disse tabeller navngives ved at følge formatet OBJECTS_<object type name> hvor <object type name> er plural formular label af objecttype. Bemærk, at hvis objekttypen ikke har nogen flertalsform, så vil <object type name> vil være singular form label af navnet på objekttypen 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.

objekt_med_objekt_egenskaber

Denne tabel indeholder data fra dine HubSpot-registre. Du kan få en række for hvert register inden for en objekttype (f.eks. alle kontaktregistre i objekttypen kontakter). 

objekt_egenskaber_historie

Denne tabel indeholder historiske værdier for egenskaber. 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 værdi af egenskaben. Den aktuelle værdi af en egenskab bestemmes af det seneste UPDATEDAT-tidsstempel i egenskabens historik.

Forespørgsler om tilknytning

Ligesom data om objekter er data om tilknytninger organiseret på to måder:

• Individuel: Hver type tilknytning gemmes i sin egen tabel og indeholder kun registre af den type. For eksempel, associations_contacts_to_deals indeholder kun tilknytningsregistre mellem kontakt- og dealobjekter. T
• Kombineret: alle registre for alle typer af tilknytninger kombineres i én tabel.

associationer_x_til_y 

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

association_definitioner

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

egenskaber_definitioner

Denne tabel indeholder oplysninger om egenskaber for objekter og hændelser på din HubSpot-konto. Egenskaber for hændelser omfatter standardhændelser, som f.eks. åbning og klik på e-mails, og brugerdefinerede adfærdsmæssige hændelser. Disse oplysninger kan være nyttige til at definere værdier, der findes i object_properties og data om hændelser.

Hændelser

Hændelser omfatter standard HubSpot-hændelser og brugerdefinerede adfærdsmæssige hændelser. Hver hændelse har sin egen tabel, labelet som events_eventname.

objekt_og_hændelsestype_definitioner

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 til hver tabel. Hvis tabellen fylder mere end 15 MB, vil der være flere gzippede CSV-filer under hver tabelmappe.