Yhdistä HubSpot ja Google BigQuery (BETA)

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

Yhdistä HubSpot ja BigQuery

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

1. Asenna Google BigQuery HubSpot App Marketplace -sovelluskaupasta.
2. Mukautetun IAM-roolin luominen Google Cloud Platformissa
3. Määritä mukautettu rooli Google-palvelutilille.
4. Myönnä HubSpotin luomalle Google BigQuery -tilille oikeudet muokata BigQuery-taulukoita.
5. Täydellinen käyttöönotto HubSpotissa

1. Asenna Google BigQuery HubSpot App Marketplace -sovelluskaupasta.

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

• Varmista, että HubSpot-tilisi on valittuna tähän beta-ohjelmaan: Access HubSpot data in Google BigQuery.
• Siirry tähän linkkiin ja valitse HubSpot-tilisi.
• Napsauta oikeassa yläkulmassa Asenna sovellus.
• Syötä Bucket URI ja Project ID.
• Napsauta Seuraava.

• Tarkista ja ota huomioon Google Service- ja BigQuery-tilit, sillä tarvitset niitä seuraavassa vaiheessa. Siirry sitten Google Cloud -konsoliin ja suorita seuraava vaihe.

2. Luo mukautettu IAM-rooli Google Cloud Platformissa.

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

• 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

• Napsauta Luo.

3. Määritä mukautettu rooli Cloud Storage Service -tilille.

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

• Kirjoita oikeanpuoleisessa paneelissa Uusi pääkäyttäjä -kenttään vaiheessa 2 annetun Google-palvelutilin nimi.
• Napsauta Assign roles (Roolien määrittäminen ) -osiossa pudotusvalikkoa ja valitse Custom > <role> ( Mukautettu > <rooli> ), jossa <role> on vaiheessa 1 luotu mukautettu IAM-rooli.
• Napsauta Tallenna. Google-palvelutili lisätään Storage Object Viewer -rooliin.

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

• Napsauta vasenta navigointivalikkoa ja valitse IAM & Admin > IAM.
• Napsauta Grant Access.
• Kirjoita oikeanpuoleisessa paneelissa Uusi pääkäyttäjä -kenttään vaiheessa 2 annetun Google-palvelutilin nimi.
• Napsauta Assign roles (Roolien määrittäminen ) -osiossa pudotusvalikkoa ja valitse Custom > <role> ( Mukautettu > <rooli> ), jossa <role> on vaiheessa 1 luotu mukautettu IAM-rooli.

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

• Napsauta HubSpot-tililläsi Jatka yhdistettyihin sovelluksiin.

• 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 kohteiden tietueet.
• Yhdistelmät: kaikki yhdistelmätyypit ja niihin liittyvät tietueet.
• Tapahtumat: tapahtumatiedot sekä HubSpotin vakiotapahtumista että mukautetuista käyttäytymistapahtumista.
• Luettelot: HubSpotin yhteyshenkilö- ja yritysluettelot.
• Omistajat: omistajat.
• Putket: sopimusten ja lippujen putket ja putkivaiheet.
• Ominaisuudet: objektitietueiden ominaisuudet ja niiden arvot, mukaan lukien ominaisuuksien historia.

Erityyppiset objektitiedot on järjestetty ja saatavilla kahdella tavalla:

• Yksilöllinen: kukin objektityyppi tallennetaan omaan tauluunsa, ja siinä on vain saman objektityypin tietueita. Esimerkiksi objects_contacts sisältää vain yhteystietoja.
• Yhdistetty: kaikkienkohdetyyppienkaikkitietueet yhdistetään 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.

object_with_object_properties (objekti_objektien_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ää kiinteistöjen historialliset arvot. Yhteystietojen osalta se sisältää viimeisimmät 45 arvoa. Kaikkien muiden kohteiden 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, joka sisältää vain kyseisen tyypin tietueita. Esimerkiksi associations_contacts_to_deals sisältää vain yhteystieto- ja kaupanteko-objektien välisiä assosiaatiotietueita. T
• Yhdistetty: kaikkien yhdistystyyppien kaikki tietueet yhdistetään yhteen taulukkoon.

assosiaatio_x_y

Kullakin assosiaatiotyypillä on oma näkymänsä, joka on merkitty osoitteella 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äistä tiedoista voi olla hyötyä 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.

objektin_ja_tapahtuman_tyypin_määrittelyt

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

Synkronointitaajuus ja tietojen organisointi

Tiedot synkronoidaan päivittäin HubSpotin ja Google BigQueryn välillä klo 0900 UTC +0. Jokaiselle synkronointipäivälle luodaan 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 ämpäri-dumppiin.

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