BetaHubSpotin ja Google BigQueryn Yhdistäminen

Opi yhdistäminen HubSpot ja Google BigQuery, jotta voit synkronoida HubSpot-tiedot Google BigQuery -instanssiin.

Huomaa: HubSpot ei jaa HIPAA-tietoja Google BigQuerylle.

Yhdistäminen HubSpot ja BigQuery

Jos haluat yhdistäminen HubSpotin ja Google BigQueryn, sinun on suoritus nämä vaiheet järjestyksessä:

1. Asenna Google BigQuery HubSpot sovelluskauppa-palvelusta.
2. Luo mukautettu IAM-rooli Google Cloud Platformissa.
3. Määritä mukautettu rooli Tili.
4. Anna HubSpotin luomalle Google BigQuery tili oikeudet muokata BigQuery-taulukoita.
5. Täydellinen käyttöönotto HubSpotissa.

1. Asenna Google BigQuery HubSpot sovelluskauppa

On suositeltavaa, että tili ja Google BigQuery tili ovat avoinna erillisissä välilehdissä, kun yhdistät nämä kaksi sovellusta. 

1. Varmista, että tili on valittuna beta-ohjelmaan: Pääsy HubSpotin tietoihin Google BigQueryssä. 
2. Siirry tähän linkkiin ja valitse tili. 
3. Napsauta Asenna.
4. Kirjoita Bucket URI ja Project ID. 
5. Napsauta Seuraava. 
6. Arvostelu ja ota huomioon Google Service- ja BigQuery-tilit, sillä tarvitset niitä seuraavassa vaiheessa. Siirry sitten Google Cloud -konsoliin ja suorita seuraava vaihe. 

2. Mukautetun IAM-roolin luominen Google Cloud Platformissa

1. Kirjaudu Google Cloud -konsoliin. 
2. Napsauta vasenta navigointivalikkoa ja valitse IAM & Admin > Roles. 
3. Valitse yläreunassa Luo rooli.
4. Anna roolin nimi, valinnainen kuvaus ja tunnus . 
5. Napsauta Lisää käyttöoikeuksia. 

6. Valitse taulukosta seuraavat käyttöoikeudet ja napsauta Lisää:

bigquery.datasets.create
bigquery.datasets.get
bigquery.datasets.getIamPolicy
bigquery.jobs.create
bigquery.tables.create
bigquery.tables.createIndex
bigquery.tables.createSnapshot
bigquery.tables.createTagBinding
bigquery.tables.delete
bigquery.tables.deleteIndex
bigquery.tables.deleteSnapshot
bigquery.tables.update
bigquery.tables.get
storage.buckets.get
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list

7. Napsauta Luo. 

3. Myönnä Tili käyttöoikeudet Cloud Storage Buckets -palvelun käyttämiseen

1. Napsauta vasemmanpuoleista navigointivalikkoa ja valitse Cloud Storage > Buckets. 
2. Valitse määritettävä ämpäri . 
3. Napsauta Oikeudet-välilehteä .
4. Valitse Näytä päämiesten mukaan -välilehdellä Anna käyttöoikeus .

5. Kirjoita oikeanpuoleisessa paneelissa Uusi pääkäyttäjä -kenttään Tili nimi vaiheesta 1.

Huomaa: varmista, että määrität Tili, etkä tili.

6. Napsauta Assign roles (Roolien määrittäminen ) -osiossa pudotusvalikkoa ja valitse Custom > <role> (Mukautettu ), jossa <role> on vaiheessa 2 luotu mukautettu IAM-rooli. 
7. Napsauta Tallenna. tili lisätään Storage Objekti Viewer -rooliin. 

4. Myönnä HubSpotin luomalle Google BigQuery Tili oikeudet muokata BigQuery-taulukoita

1. Napsauta vasenta navigointivalikkoa ja valitse IAM & Admin > IAM. 
2. Napsauta Grant Access.
3. Kirjoita oikeassa paneelissa olevaan Uusi päämies -kenttään HubSpotin vaiheessa 1 luoma Google BigQuery Tili .
4. Napsauta Assign roles (Roolien määrittäminen ) -osiossa pudotusvalikkoa ja valitse Custom > <role> (Mukautettu ), jossa <role> on vaiheessa 2 luotu mukautettu IAM-rooli. 

5. Täydellinen käyttöönotto HubSpotissa

1. Palaa tili ja valitse Jatka yhdistettyihin sovelluksiin. 
2. Valitse valintaikkunassa valintaruudut ja valitse sitten Salli ja asenna. 

HubSpotin ja Google BigQueryn välisen synkronoinnin dataformaatti

Synkronoitavat tiedot

Voit synkronoida seuraavat tiedot HubSpotista Google BigQueryyn: 

• 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

HubSpotin ja Google BigQueryn väliset tietojen synkronointitehtävät alkavat päivittäin noin klo 6:00 UTC. Tietojen synkronointiin Google BigQueryyn kuluva aika riippuu tili jonotusasemasta ja tietomäärästä. Valmistumisaikoja ei ole taattu.

Jokaiselle synkronointipäivälle luodaan oma kansio, jossa on useita alikansioita kullekin taulukolle. Seitsemän viimeisintä synkronointia on saatavilla Google Cloud -alustalla, ja BigQueryn taulukot päivitetään osoittamaan viimeisimpään bucket dumpiin.

Kukin seuraavista taulukoista on saatavana Parquet-muotoisena tiedostona:

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