BetaYhdistäminen HubSpot ja AWS S3

Yhdistäminen HubSpot ja AWS S3 synkronoidaksesi HubSpot-tiedot S3-ämpäriin. Sovelluksen yhdistämisen jälkeen HubSpot voi synkronoida CRM, mukaan lukien kohteet, tietueet, yhdistykset, tapahtumat ja segmentit, AWS S3:een tallennusta, raportointia ja analytiikka varten. 

Voit esimerkiksi synkronoida yhteystieto ja yritys S3-ämpäriin ja käyttää niitä organisaatiosi tietovarastossa, business intelligence -työkaluissa tai henkilötietojen käsittely työnkuluissa.

Huomaa: HubSpot ei jaa HIPAA-tietoja AWS S3 -palveluun.

Ennen kuin aloitat

Ennen integraatio määrittämistä sinun on valittava tili Access HubSpot data in AWS S3 beta -ohjelmaan.

Yhdistäminen HubSpot ja AWS S3

Jos haluat yhdistäminen HubSpotin ja AWS S3:n, sinun on noudatettava alla olevia ohjeita järjestyksessä: 

1. Määritä AWS S3 -kauhan käyttöoikeudet. 
2. Luo IAM-käytäntö. 
3. Luo IAM-rooli AWS:ssä. 
4. Yhdistäminen HubSpot ja AWS S3. 
5. Myönnä IAM-käyttäjälle käyttöoikeudet S3-kauhan objektien käyttämiseen. 

1. Määritä S3-ämpärin käyttöoikeudet

HubSpot tarvitsee seuraavat oikeudet AWS S3 -kauhaan ja kansioon, jotta se voi käyttää kansiossa ja alikansioissa olevia tiedostoja:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListBucket
• s3:PutObject
• s3:DeleteObject

2. Luo IAM-käytäntö

1. Kirjaudu AWS Management Consoleen.
2. Valitse koontinäyttö Palvelut > Security, Identity, & Compliance > IAM.
3. Valitse vasemmanpuoleisesta sivupalkista Tili.
4. Etsi Security Tunnus Service (STS) -osiosta AWS-alue, joka vastaa aluetta, jolla tili sijaitsee. Aktivoi alue napsauttamalla kytkintä.
5. Napsauta vasemmanpuoleisessa paneelissa Policies (Käytännöt). 
6. Valitse Luo käytäntö. 
7. Napsauta JSON-välilehdellä Lisää uusi lauseke. 
8. Lisää alla oleva käytäntöasiakirja, joka antaa HubSpotille tarvittavat oikeudet tietojen lataamiseen tai purkamiseen yhden kauhan ja kansiopolun avulla. Voit myös tyhjentää tiedostoja käyttämällä PURGE-kopiointivaihtoehtoa. 

{
 "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. Napsauta Seuraava.
10. Lisää Arvostelu and create ( Tarkista ja luo ) -osioon käytäntöjen nimi ja valinnainen kuvaus.
11. Valitse Luo käytäntö. 

3. Luo IAM-rooli AWS:ssä

HubSpotin käyttöoikeuksien määrittäminen AWS Management Consolessa:

1. Kirjaudu AWS Management Consoleen.
2. Valitse koontinäyttö Palvelut > Security, Identity, & Compliance > IAM.
3. Valitse vasemmanpuoleisesta sivupalkista Roolit. 
4. Valitse Luo rooli. 
5. Valitse Luottamuksellisen yksikön tyyppi -osiossa tili.
6. Valitse An AWS tili ) -osiossa Another AWS tili (Toinen AWS-tili ) ja kirjoita oman tili tunnus. Myöhemmin muutat luottamussuhdetta niin, että saat HubSpotin käyttöoikeuden. 
7. Valitse Vaadi ulkoinen tunnus ja syötä kenttätunnus, kuten 0000. Myöhemmin muutat IAM-roolisi luottamussuhdetta ja määrität ulkoisen ID:n integraatio varten. Ulkoista tunnusta käytetään antamaan pääsy AWS-resursseihisi kolmannen osapuolen sovellukselle, kuten HubSpotille. 

8. Napsauta Seuraava. 
9. Valitse vaiheessa 1 luotu käytäntö ja valitse Seuraava.
10. Kirjoita Roolien tiedot -osioon Roolien nimi ja Kuvaus roolin tunnistaminen. 
11. Valitse Luo rooli. 
12. Kopioi ARN-arvo Roolien yhteenvetosivulla. Tätä arvoa käytetään seuraavassa vaiheessa. 

4. Yhdistäminen HubSpot ja AWS S3

1. Napsauta HubSpot-tilisi ylänavigointipalkin kauppakuvaketta ja valitse HubSpot-kauppa.
2. Etsi ja valitse AWS S3. 
3. Napsauta Asenna. 
4. Kirjoita vaiheessa 3 määritetty IAM-roolin nimi ja S3-URL-polku sille kauhalle, johon haluat tallentaa tiedot.
5. Napsauta Seuraava.
6. Arvostelu ja kopioi AWS IAM User ja AWS External ID -arvot, sillä tarvitset niitä seuraavassa vaiheessa. Valitse sitten Jatka yhdistettyihin sovelluksiin.

5. Myönnä IAM-käyttäjälle oikeudet käyttää kauhan objekteja

1. Kirjaudu AWS Management Consoleen.
2. Valitse koontinäyttö Palvelut > Security, Identity, & Compliance > IAM.
3. Valitse vasemmassa sivupalkissa Roolit.
4. Valitse vaiheessa 3 luotu rooli. 
5. Valitse Luottamussuhteet-välilehti ja valitse Muokkaa luottamuskäytäntöä. 
6. Muokkaa vakuutusasiakirjoja vaiheessa 3 tallentamillasi arvoilla. 

{
 "Version": "2012-10-17",
 "Statement": [
 {
 "Sid": "",
 "Effect": "Allow",
 "Principal": {
 "AWS": "<hubspot_user_arn>"
 },
 "Action": "sts:AssumeRole",
 "Condition": {
 "StringEquals": {
 "sts:ExternalId": "<hubspot_external_id>"
 }
 }
 }
 ]
}

7. Vaihda yllä olevan käytännön kaksi seuraavaa kenttää vaiheessa 4 tallentamiisi arvoihin:

• • hubspot_user_arn arvoon STORAGE_AWS_IAM_USER_ARN
  • hubspot_external_id arvoon STORAGE_AWS_EXTERNAL_ID  

Kun olet suorittanut edellä mainitut vaiheet, HubSpot voi synkronoida tiedot AWS S3:een.

HubSpotin ja AWS S3:n välisen synkronoinnin dataformaatti

Synkronoitavat tiedot

Voit synkronoida seuraavat tiedot HubSpotista AWS S3:een: 

• Kohteet: vakio- ja mukautetut kohteet, kuten yhteystiedot, yritykset, liput tai tuotteet.
• Tietueet: yksittäisten objekti tietueet. 
• Yhdistelmät: kaikki yhteys ja niihin liittyvät tietueet.
• Tapahtumat: tapahtuma sekä HubSpotin vakiotapahtumista että mukautetuista käyttäytymistapahtumista. 
• Segmentit: HubSpotin yhteystieto ja yritys.
• Omistajat: tietue. 
• Putket: kauppa ja palvelupyyntö putket ja myyntiputki. 
• Ominaisuudet: objekti ominaisuudet ja niiden arvot, mukaan lukien ominaisuus historia. 

Erityyppiset Objekti on järjestetty ja saatavilla kahdella tavalla:

• Yksilöllinen: ejokainen objektityyppi tallennetaan omaan tauluunsa, ja siinä on vain saman objektityyppi tietueita. Esimerkiksi, objects_contacts sisältää vain yhteystieto.
• Yhdistetty: kaikkien objekti kaikkitietueet yhdistetään yhdeksi objekti. Näin ollen kyselyssä on määritettävä suodatin, kuten "WHERE objectTypeId='0-1'"

Mukautetuille objekteille annetaan tunniste luontihetkellä, ja sen tunniste on 2-unique_ID. Esimerkiksi 2-12345. 

objects_x taulukot

Jokaisella käytettävissä olevalla objektityyppi, mukaan lukien mukautetut objektit, on oma erityinen taulukkonsa. Nämä taulukot nimetään seuraavassa muodossa OBJECTS_<object type name> jossa <object type name> on monikossa lomake objecttype. Huomaa, että jos objektityyppi ei ole lomake, silloin <object type name> on objektityyppi nimen lomake nimike, johon on liitetty "S".

Alla on täydellinen luettelo käytettävissä olevista objekti, lyhyt kuvaus niiden edustamista tiedoista ja niitä vastaavat taulukot.

object_with_object_properties (objekti_objektien_ominaisuuksilla)

Tämä taulukko sisältää tietoja HubSpot-tietueistasi. Voit saada yhden rivin jokaisesta tietue objektityypin sisällä (esim. kaikki yhteystieto kontaktit-objektityypissä). 

object_properties_history

Tämä taulukko sisältää ominaisuus historialliset arvot. Yhteystietojen osalta se sisältää viimeisimmät 45 arvoa. Kaikkien muiden kohteiden osalta se sisältää 20 viimeisintä arvoa. Taulukossa on rivi kullekin historiallisen ominaisuus arvolle. ominaisuus tämänhetkinen arvo määräytyy ominaisuus historian viimeisimmän UPDATEDAT-ajoitusleiman perusteella.

Yhteys

Kuten objektitiedot, myös assosiaatiotiedot on järjestetty kahdella tavalla:

• Yksilöllinen: Kukin yhteys tallennetaan omaan tauluunsa, joka sisältää vain kyseisen tyypin tietueita. Esimerkiksi, associations_contacts_to_deals sisältää vain yhteystieto ja kauppa välisiä yhteys. T
• Yhdistetty: kaikkien yhteys kaikki tietueet yhdistetään yhteen taulukkoon.

assosiaatio_x_y 

Kullakin yhteys on oma näkymänsä, joka on merkitty nimellä associations_<association type name> esim. associations_contacts_to_deals. 

association_definitions

Tämä taulukko sisältää tietoja kaikista HubSpot-objektien välisistä käytettävissä olevista yhteys, ja siinä on yksi rivi kutakin yhteys kohti.

property_definitions

Tämä taulukko sisältää tietoja tili objekti ja tapahtuma. Tapahtuma kuuluvat vakiotapahtumat, kuten sähköpostin avaukset ja napsautukset, sekä mukautettu käyttäytymistapahtuma. Nämä tiedot voivat olla hyödyllisiä määriteltäessä arvoja, jotka löytyvät object_properties- ja events-tiedoista.

Tapahtumat

Tapahtumat sisältävät HubSpotin vakiotapahtumia ja mukautettuja käyttäytymistapahtumia. Kullakin tapahtuma on oma taulukkonsa, joka on merkitty nimellä events_eventname.

objektin_ja_tapahtuman_tyypin_määrittelyt

Tämä taulukko sisältää kaikkien tili käytettävissä olevien objektien ja tapahtumien määritelmät.

Synkronointitaajuus ja tietojen organisointi

Tiedot synkronoidaan päivittäin HubSpotin ja AWS S3:n välillä. Kansio luodaan jokaiselle päivälle, jolloin tiedot synkronoidaan. Kukin seuraavista taulukoista on saatavilla kansiossa, jossa on puristettuja CSV-tiedostoja:

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

Kullekin taulukolle on useita alikansioita. Jos taulukon koko on yli 15 Mt, kunkin taulukkokansiossa on useita puristettuja CSV-tiedostoja.