HubSpotin ja AWS S3:n yhdistäminen (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>/*"
 ]
 }
 }
 }
 ]
}

• Napsauta Seuraava.
• Lisää Review and create (Tarkista ja luo ) -osiossa käytännesäännön nimi ja valinnainen kuvaus.
• Napsauta Luo käytäntö.

3. Luo IAM-rooli AWS:ssä

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

• Kirjaudu sisään AWS Management Consoleen.
• Valitse aloituskojelaudassa Services > Security, Identity, & Compliance > IAM.
• Napsauta vasemmanpuoleisessa sivupalkissa Roles (Roolit).
• Napsauta Luo rooli.
• Valitse Luottamuksellisen yksikön tyyppi -osiossa AWS-tili.
• Valitse An AWS acount (AWS-tili ) -osiossa Another AWS account (Toinen AWS-tili ) ja kirjoita oman AWS-tilisi tunnus. Muutat myöhemmin luottamussuhdetta niin, että HubSpotille annetaan käyttöoikeus.
• Valitse Require external ID (Vaadi ulkoinen tunnus ) ja syötä sijoitustunnus, kuten 0000. Muutat myöhemmin luottamussuhteen IAM-rooliin ja määrität ulkoisen ID:n tallennusintegraatiota varten. Ulkoista ID:tä käytetään, kun annetaan pääsy AWS-resursseihisi kolmannen osapuolen sovellukselle, kuten HubSpotille.

• Napsauta Seuraava.
• Valitse vaiheessa 1 luotu käytäntö ja napsauta Seuraava.
• Kirjoita Role details (Roolin tiedot ) -osioon Role name (Roolin nimi ) ja Description (Kuvaus ) roolin yksilöimiseksi.
• Napsauta Luo rooli.
• Kopioi ARN-arvo Roolien yhteenvetosivulla. Käytät tätä arvoa seuraavassa vaiheessa.

4. Yhdistä HubSpot ja AWS S3

Varmista ennen integraation asentamista, että HubSpot-tilisi on valittuna Access HubSpot data in AWS S3 beta-ohjelmaan.

• Etsi ja valitse AWS S3. Voit myös siirtyä integraatioon suoraan tililläsi käyttämällä tätä URL-osoitetta.
• Valitse oikeassa yläkulmassa Asenna sovellus.
• Kirjoita vaiheessa 3 määritetty IAM-roolin nimi ja S3-URL-polku sille ämpäriin, johon haluat tiedot dumpata.
• Napsauta Seuraava.
• Tarkista ja kopioi AWS IAM User- ja AWS External ID -arvot, koska tarvitset niitä seuraavassa vaiheessa. Napsauta sitten Continue to Connected Apps.

5. Myönnä IAM-käyttäjälle oikeudet käyttää ämpäriobjekteja.

• Kirjaudu sisään AWS Management Consoleen.
• Valitse aloituskojelaudassa Services > Security, Identity, & Compliance > IAM.
• Napsauta vasemmassa sivupalkissa Roles (Roolit).
• Valitse vaiheessa 3 luomaasi roolia.
• Valitse Luottamussuhteet-välilehti ja valitse Muokkaa luottamuskäytäntöä.
• Muokkaa käytäntöasiakirjoja 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>"
 }
 }
 }
 ]
}

Muuta yllä olevassa politiikassa seuraavat kaksi kenttää vaiheesta 4 tallentamiesi arvojen mukaisiksi:

• hubspot_user_arn arvoksi STORAGE_AWS_IAM_USER_ARN.
• hubspot_external_id arvoksi 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 tietomuoto

Synkronoitavat tiedot

Voit synkronoida seuraavat tiedot HubSpotista AWS S3:een:

• Objektit: vakio- ja mukautetut objektit, kuten yhteystiedot, yritykset, liput tai tuotteet.
• Tietueet: yksittäiset objektitietueet.
• Assosiaatiot: kaikki assosiaatiotyypit ja niihin liittyvät tietueet.
• Tapahtumat: tapahtumatiedot sekä HubSpotin vakiotapahtumista että mukautetuista käyttäytymistapahtumista.
• Luettelot: HubSpotin yhteystieto- ja yritysluettelot.
• Omistajat: tietueiden omistajat.
• Putket: kauppaputket ja lippuputket sekä putkivaiheet.
• Ominaisuudet: objektitietueiden ominaisuudet ja niiden arvot, mukaan lukien ominaisuuksien historia.

Erityyppiset objektitiedot on järjestetty ja käytettävissä kahdella tavalla:

• Yksittäinen: kukin objektityyppi tallennetaan omaan tauluunsa, ja siinä on vain saman objektityypin tietueita. Esimerkiksi objects_contacts sisältää vain yhteystietueet.
• Yhdistetty: kaikkienobjektityyppienkaikkitietueet on yhdistetty yhdeksi tietokantaobjektiksi. Näin ollen kyselyä tehdessäsi sinun 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 objektityypillä, mukaan lukien mukautetut objektit, on oma erityinen taulukkonsa. Nämä taulukot nimetään muotoa OBJECTS_<object type name> noudattaen, jossa <object type name> on objecttype:n monikkomuotoinen nimitys (huomaa, että jos objektityypillä ei ole monikkomuotoa, <object type name> on objektityypin nimen yksikkömuotoinen nimitys, johon on liitetty "S").

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

HubSpot-objektin tyyppi	ObjectTypeId	Kuvaus
YHTEYSTIEDOT	0-1	Tietoja henkilöistä, jotka ovat vuorovaikutuksessa yrityksesi kanssa
COMPANY	0-2	Tietoja yksittäisistä yrityksistä tai organisaatioista
DEAL	0-3	Yksityiskohtaisia tietoja tulonhankintamahdollisuuksista kontaktin tai yrityksen kanssa.
ENGAGEMENT	0-4	Tallentaa tietoja CRM-toiminnoista, mukaan lukien muistiinpanot, tehtävät, sähköpostit, kokoukset ja puhelut.
TICKET	0-5	Edustaa asiakkaan avun- tai tukipyyntöjä.
QUOTE	0-14	Käytetään hintatietojen jakamiseen potentiaalisille ostajille.
FORM_SUBMISSION	0-15	HubSpot-lomakkeen yksittäisten lähetysten tiedot.
LINE_ITEM	0-8	Edustaa kaupassa myytävien tuotteiden osajoukkoa. Kun tuote liitetään kauppaan, siitä tulee rivierä.
CONVERSATION	0-11	Tiedot useista kanavista saapuvista viesteistä.
LANDING_PAGE	0-25	Laskeutumissivujesi tiedot
TASK	0-27	Tallentaa tietoja tehtävälistoista
FORM	0-28	Käytetään keräämään tietoja vierailijoista ja yhteystiedoista.
MARKETING_EMAIL	0-29	Tiedot markkinointikeskuksesta lähetetyistä sähköposteista
AD_ACCOUNT	0-30	Tallentaa tiedot mainostileistäsi Linkedinissä, Facebookissa ja Googlessa.
AD_CAMPAIGN	0-31	Tiedot mainoskampanjoistasi. Mainoskampanja voi sisältää yhden tai useamman mainoksen
AD_GROUP	0-32	Mainosten looginen ryhmittely mainoskampanjan sisällä.
AD	0-33	Yksittäisten mainosten tiedot
KAMPANJA	0-35	Tietoja asiaan liittyvistä markkinointivaroista ja sisällöstä, jotta voit helposti mitata yhteisten markkinointitoimien tehokkuutta.
SIVUSTO_SIVU	0-38	Tiedot yksittäisistä sivuista verkkosivustoillasi
BLOG_POST	0-39	Tiedot blogikirjoituksista
OBJECT LIST	0-45	Tiedot objektitietueiden ryhmittelystä niiden ominaisuuksien tai toimintojen perusteella.
CALL	0-48	Muiden CRM-tietueiden, esimerkiksi yhteystietojen, tekemät puhelut.
INVOICE	0-53	Hallinnoi ja synkronoi laskuja ulkoisten kirjanpitojärjestelmien kanssa.
MEDIA_BRIDGE	0-57	Tiedot HubSpotiin tuoduista media-varoista
SEQUENCE	0-58	Sekvenssi on sarja kohdennettuja, ajoitettuja sähköpostimalleja, joiden avulla kontakteja hoidetaan ajan mittaan.
DEAL_SPLIT	0-72	Diiliosuuksia käytetään jakamaan kauppahyvityksiä useiden käyttäjien kesken.
SALES_DOCUMENT	0-83	Myyntidokumentit rakentavat koko tiimillesi sisältökirjaston, johon voit ladata ja jakaa dokumentteja yhteystietojesi kanssa.
FEEDBACK_SUBMISSION	0-19	Tallentaa palautekyselyyn lähetetyt tiedot.
SUBSCRIPTION	0-69	Tilaukset sisältävät tiedot toistuvista maksuista.
KAUPALLINEN MAKSU	0-101	Sisältää tietoja asiakkailta kerätyistä varoista

object_with_object_properties (objekti_objekti_ominaisuuksilla)

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

object_properties_history

Tämä taulukko sisältää historialliset ominaisuusarvot. Yhteystietojen osalta se sisältää viimeisimmät 45 arvoa. Kaikkien muiden objektien osalta se sisältää viimeisimmät 20 arvoa. Taulukossa on rivi kullekin historialliselle ominaisuuden arvolle. Ominaisuuden tämänhetkinen arvo määräytyy ominaisuuden historian viimeisimmän UPDATEDAT-aikaleiman perusteella.

Assosiaatiokyselyt

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

• Yksilöllinen: kukin assosiaatiotyyppi tallennetaan omaan tauluunsa ja se sisältää vain kyseisen tyypin tietueita. Esimerkiksi associations_contacts_to_deals sisältää vain yhteystieto- ja sopimusobjektien välisiä assosiaatiotietueita. T
• Yhdistetty: kaikkien assosiaatiotyyppien tietueet yhdistetään yhteen taulukkoon.

associations_x_to_y

Kullakin assosiaatiotyypillä on oma näkymä, joka on merkitty 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 assosiaatiotyypeistä, ja siinä on yksi rivi kutakin assosiaatiotyyppiä kohti.

property_definitions

Tämä taulukko sisältää tietoja HubSpot-tilisi objekti- ja tapahtumaominaisuuksista. Tapahtumaominaisuuksiin kuuluvat vakiotapahtumat, kuten sähköpostin avaukset ja napsautukset, sekä mukautetut käyttäytymiseen liittyvät tapahtumaominaisuudet. 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. Jokaisella tapahtumalla on oma taulukkonsa, joka on merkitty nimellä events_eventname.

objekti_ja_tapahtumatyypin_määrittelyt

Tämä taulukko sisältää kaikkien HubSpot-tililläsi käytettävissä olevien objektien ja tapahtumien määritelmät.

Synkronointitiheys ja tietojen organisointi

Tiedot synkronoidaan päivittäin HubSpotin ja AWS S3:n välillä. Jokaiselle synkronointipäivälle luodaan oma kansio. Kukin seuraavista taulukoista on saatavilla kansiossa, jossa on gzippatut CSV-tiedostot:

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.