TestversionSynkronisera data till AWS S3 (äldre version)

Anslut HubSpot och AWS S3 för att synkronisera HubSpot-data till en S3-bucket. Efter att ha anslutit appen kan HubSpot CRM-data, inklusive objekt, poster, associationer, händelser och segment, synkroniseras till AWS S3 för lagring, rapportering och analys. 

Du kan t.ex. synkronisera uppgifter om kontakter och företag till en S3-bucket och använda dem i organisationens datalager, Business Intelligence-verktyg eller arbetsflöden för personuppgiftsbehandling.

Observera: HubSpot delar inte HIPAA-data till AWS S3.

Innan du sätter igång

Innan du ställer in integrationen måste du registrera ditt HubSpot-konto i Access HubSpot-data i AWS S3 beta.

Anslut HubSpot och AWS S3

För att ansluta HubSpot och AWS S3 måste du följa stegen nedan i tur och ordning: 

1. Konfigurera åtkomstbehörigheter för AWS S3-bucketen. 
2. Skapa en IAM-policy. 
3. Skapa IAM-rollen i AWS. 
4. Anslut HubSpot och AWS S3. 
5. Ge IAM-användaren behörighet att komma åt objekt i S3-skopan. 

1. Konfigurera åtkomstbehörigheter för S3-bucketen

HubSpot behöver följande behörigheter på en AWS S3-bucket och mapp för att komma åt filer i mappen och undermapparna:

• s3:HämtaBucketLokalisering
• s3:Hämta objekt
• s3:Hämta objektversion
• s3:ListaBucket
• s3:PutObject
• s3:Radera objekt

2. Skapa en IAM-policy

1. Logga in på AWS Management Console.
2. Klicka på Tjänster på instrumentpanelen > Säkerhet, Identitet, & Efterlevnad > IAM.
3. Klicka på Inställningar för konto i den vänstra sidofältet.
4. I avsnittet Security Token Service (STS) letar du efter den AWS-region som motsvarar den region där ditt AWS-konto finns. Klicka för att slå på strömbrytaren för att aktivera regionen.
5. Klicka på Policies i den vänstra sidopanelen. 
6. Klicka på Skapa policy. 
7. På fliken JSON klickar du på Lägg till nytt uttalande. 
8. Lägg till policydokumentet nedan som ger HubSpot de behörigheter som krävs för att ladda eller lossa data med hjälp av en enda bucket och mappsökväg. Du kan också rensa datafiler med hjälp av alternativet 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. Klicka på Nästa.
10. I avsnittet Granskning och skapande lägger du till namnet på policyn och en valfri beskrivning.
11. Klicka på Skapa policy. 

3. Skapa IAM-rollen i AWS

Så här konfigurerar du åtkomstbehörigheter för HubSpot i AWS Management Console:

1. Logga in på AWS Management Console.
2. Klicka på Tjänster på instrumentpanelen > Säkerhet, Identitet, & Efterlevnad > IAM.
3. Klicka på Roller i den vänstra sidofältet. 
4. Klicka på Skapa roll. 
5. I avsnittet Typ av betrodd enhet väljer du AWS-konto.
6. I avsnittet Ett AWS-konto väljer du Ett annat AWS-konto och anger ditt eget AWS-konto-ID. Du kommer senare att ändra förtroenderelationen för att ge åtkomst till HubSpot. 
7. Välj Require external ID och ange ett platshållar-ID som 0000. Du kommer senare att ändra förtroenderelationen för din IAM-roll och ange det externa ID:t för din integration av lagring. Ett externt ID används för att ge åtkomst till dina AWS-resurser till en tredjepartsapp som HubSpot. 

8. Klicka på Nästa. 
9. Välj den policy som skapades i steg 1 och klicka på Nästa.
10. I avsnittet Role details anger du ett rollnamn och en beskrivning för att identifiera rollen. 
11. Klicka på Skapa roll. 
12. Kopiera ARN-värdet på sidan Role summary (Rollsammanfattning). Du kommer att använda detta värde i nästa steg. 

4. Anslut HubSpot och AWS S3

1. I ditt HubSpot-konto klickar du på Marketplace-ikonen i det övre navigeringsfältet och väljer sedan HubSpot Marketplace.
2. Sök efter och välj AWS S3. 
3. Klicka på Delbetalning. 
4. Ange det IAM Role Name som konfigurerades i steg 3 och S3 URL Path för den bucket som du vill att data ska lagras i .
5. Klicka på Nästa.
6. Granskning och kopiering av värdena AWS IAM User och AWS External ID eftersom du kommer att behöva dem i nästa steg. Klicka sedan på Fortsätt till Anslutna appar.

5. Ge IAM-användaren behörighet att komma åt objekt i skopan

1. Logga in på AWS Management Console.
2. Klicka på Tjänster på instrumentpanelen > Säkerhet, Identitet, & Efterlevnad > IAM.
3. Klicka på Roller i den vänstra sidofältet.
4. Välj den roll som du skapade i steg 3. 
5. Välj fliken Förtroenderelationer och klicka på Redigera förtroendepolicy. 
6. Ändra policydokumenten med de värden som du registrerade i steg 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 ovanstående policy ändrar du följande två fält till de värden som du registrerade i steg 4:

• • hubspot_user_arn till värdet STORAGE_AWS_IAM_USER_ARN
  • hubspot_external_id till värdet STORAGE_AWS_EXTERNAL_ID  

När du har slutfört ovanstående steg kan HubSpot synkronisera data till AWS S3.

Dataformat för synkronisering mellan HubSpot och AWS S3

Tillgängliga data för synkronisering

Du kan synkronisera följande data från HubSpot till AWS S3: 

• Objekt: standardobjekt och anpassade objekt, t.ex. kontakter, företag, supportärenden eller produkter.
• Register: enskilda objektregister. 
• Associations: alla typer av associationer och tillhörande register.
• Händelser: Händelsedata för både standard HubSpot-händelser och anpassade händelser. 
• Segment: HubSpot kontakt- och företagssegment.
• Ägare: Register över ägare. 
• Pipelines: affärs- och Ärendepipelines och pipeline-faser. 
• Egenskaper: egenskaper och deras värden i objektregistren, inklusive egenskapshistoriken. 

Data om objekt av olika typer organiseras och är tillgängliga på två sätt:

• Individuell: evarje typ av objekt lagras i sin egen tabell och har endast register av samma typ av objekt. Till exempel objects_contacts innehåller endast kontaktregister.
• Kombinerad: allaregister för alla typer av objekt kombineras till ett databasobjekt. När du ställer en fråga måste du därför ange ett filter som "WHERE objectTypeId='0-1'

Anpassade objekt kommer att tilldelas ett ID vid skapandet och identifieras som 2-unique_ID. Till exempel 2-12345. 

objekt_x tabeller

Varje tillgänglig typ av objekt, inklusive anpassade objekt, har sin egen specifika tabell. Dessa tabeller namnges enligt formatet OBJECTS_<object type name> där <object type name> är beteckningen för pluralformuläret för objecttype. Observera att om typen av objekt inte har någon pluralform, så kommer <object type name> vara etiketten för singularform av namnet på typen av objekt sammanlänkat med "S".

Nedan finns en fullständig lista över tillgängliga HubSpot-typer av objekt, en kort beskrivning av de data de representerar och deras motsvarande tabeller.

objekt_med_objekt_egenskaper

Den här tabellen innehåller data från dina HubSpot-register. Du kan få en rad för varje register inom en objekttyp (t.ex. alla kontaktregister i objekttypen kontakter). 

objekt_egenskaper_historik

Denna tabell innehåller historiska värden för egenskaper. För kontakter innehåller den de senaste 45 värdena. För alla andra objekt innehåller den de senaste 20 värdena. Tabellen har en rad för varje historisk egenskap. Det aktuella värdet på en egenskap bestäms av den senaste UPDATEDAT-tidsstämpeln i egenskapens historik.

Förfrågningar från Association

Precis som data om objekt organiseras data om associationer på två olika sätt:

• Individual: varje typ av association lagras i en egen tabell och innehåller endast register av den typen. Till exempel associations_contacts_to_deals innehåller endast associationregister mellan kontakt- och affärsobjekt. T
• Kombinerad: alla register för alla typer av Associations kombineras i en tabell.

föreningar_x_till_y 

Varje typ av association har sin egen vy, märkt som associations_<association type name> t.ex. associations_contacts_to_deals. 

associationer_definitioner

Den här tabellen innehåller information om alla tillgängliga typer av associationer mellan HubSpot-objekt, med en rad per typ av objekt.

fastighets_definitioner

Den här tabellen innehåller information om egenskaper för objekt och händelser i ditt HubSpot-konto. Egenskaperna för händelser omfattar standardhändelser, t.ex. öppningar och klick i e-postmeddelanden, och egenskaper för anpassade händelser. Denna information kan vara till hjälp för att definiera värden som finns i data för object_properties och händelser.

Händelser

Händelser inkluderar standard HubSpot-händelser och anpassade beteendemässiga händelser. Varje händelse har sin egen tabell, märkt som events_eventname.

objekt_och_händelsetyp_definitioner

Den här tabellen innehåller definitioner för alla objekt och händelser som finns tillgängliga på ditt HubSpot-konto.

Synkroniseringsfrekvens och organisering av data

Data synkroniseras dagligen mellan HubSpot och AWS S3. En mapp kommer att skapas för varje dag som data synkroniseras. Var och en av följande tabeller kommer att finnas tillgänglig som en mapp med gzippade 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 kommer att finnas flera undermappar för varje tabell. Om tabellens storlek överstiger 15 MB kommer det att finnas flera gzippade CSV-filer under varje tabellmapp.