Anslut HubSpot och AWS S3 (BETA)

Lär dig hur du ansluter HubSpot och AWS S3 för att synkronisera HubSpot-data till din S3-bucket.

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-bucketen

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

• Logga in på AWS Management Console.
• Klicka på Services > Security, Identity, & Compliance > IAM på startpanelen .
• Klicka på Kontoinställningar i den vänstra sidofältet.
• 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.
• Klicka på Policies i den vänstra sidopanelen.
• Klicka på Skapa policy.
• Klicka på Lägg till nytt uttalande på fliken JSON.
• 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>/*"
 ]
 }
 }
 }
 ]
}

• Klicka på Nästa.
• I avsnittet Granska och skapa lägger du till namnet på policyn och en valfri beskrivning.
• Klicka på Skapa policy.

3. Skapa IAM-rollen i AWS

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

• Logga in på AWS Management Console.
• Klicka på Services > Security, Identity, & Compliance > IAM på startpanelen .
• Klicka på Roller i den vänstra sidofältet.
• Klicka på Skapa roll.
• I avsnittet Typ av betrodd enhet väljer du AWS-konto.
• I avsnittet An AWS acount väljer du Another AWS account och anger ditt eget AWS-konto-ID. Du kommer senare att ändra förtroendeförhållandet för att ge åtkomst till HubSpot.
• 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 lagringsintegration. Ett externt ID används för att ge åtkomst till dina AWS-resurser till en tredjepartsapp som HubSpot.

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

4. Anslut HubSpot och AWS S3

• Se till att ditt HubSpot-konto är valt till denna beta: Få tillgång till HubSpot-data i AWS S3.
• Navigera till denna URL och välj ditt HubSpot-konto.
• Klicka på Installera app längst upp till höger.
• Ange det IAM Role Name som konfigurerades i steg 3 och S3 URL Path för den bucket som du vill att data ska dumpas till.
• Klicka på Nästa.
• Granska och kopiera 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 Connected Apps.

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

• Logga in på AWS Management Console.
• Klicka på Services > Security, Identity, & Compliance > IAM på startpanelen .
• Klicka på Roller i den vänstra sidofältet.
• Välj den roll som du skapade i steg 3.
• Välj fliken Förtroenderelationer och klicka på Redigera förtroendepolicy.
• Ä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>"
 }
 }
 }
 ]
}

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:

• Objects: standardobjekt och anpassade objekt, t.ex. kontakter, företag, biljetter eller produkter.
• Register: register över enskilda objekt.
• Associations: alla typer avassociationer och tillhörande poster.
• Händelser: Händelsedata för både standardhändelser i HubSpot och anpassade beteendehändelser.
• Listor: HubSpots kontakt- och företagslistor.
• Ägare: registreradeägare .
• Pipelines: pipelines för affärer och ärenden samt pipelinefaser.
• Properties: egenskaper och deras värden i objektposterna, inklusive egenskapshistorik.

Objektdata av olika slag är organiserade och tillgängliga på två sätt:

• Individuell: varje objekttyp lagras i en egen tabell och innehåller endast poster av samma objekttyp. Till exempel innehåller objects_contacts endast kontaktposter.
• Combined: allaposter för alla objekttyper 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 tilldelas ett ID när de skapas och identifieras som 2-unique_ID. Till exempel 2-12345.

objekt_x tabeller

Varje tillgänglig objekttyp, inklusive anpassade objekt, har sin egen specifika tabell. Dessa tabeller namnges enligt formatet OBJECTS_<object type name> där <object type name> är pluralformen av objecttype. (Observera att om objekttypen inte har någon pluralform, kommer <object type name> att vara singularformen av objekttypens namn sammanlänkat med "S").

Nedan finns en fullständig lista över tillgängliga HubSpot-objekttyper, 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-poster. Du kan få en rad för varje post inom en objekttyp (t.ex. alla kontaktposter i objekttypen kontakter).

objekt_egenskaper_historik

Denna tabell innehåller historiska fastighetsvärden. 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 historiskt egenskapsvärde. Det aktuella värdet för en egenskap bestäms av den senaste UPDATEDAT-tidsstämpeln i egenskapens historik.

Föreningens förfrågningar

Precis som objektdata är associationsdata organiserad på två sätt:

• Individuell: varje associationstyp lagras i en egen tabell och innehåller endast poster av den typen. Till exempel innehåller associations_contacts_to_deals endast associationer mellan kontakt- och affärsobjekt. T
• Kombinerad: alla poster för alla föreningstyper kombineras i en tabell.

föreningar_x_till_y

Varje associationstyp 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 associationstyper mellan HubSpot-objekt, med en rad per associationstyp.

fastighets_definitioner

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

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

Denna tabell innehåller definitioner för alla objekt och händelser som är tillgängliga i ditt HubSpot-konto.

Synkroniseringsfrekvens och dataorganisation

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 gzipade 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.