Miten luoda mukautettuja tapahtumia

Yhteenveto

Käytä HubSpotin mukautettuja tapahtumia määrittääksesi ja seurataksesi yrityksellesi ominaisia tapahtumia. Mukautetut tapahtumat voidaan liittää tapahtuman ominaisuuksiin, joita voit sitten käyttää kaikissa HubSpotin työkaluissa. Voit esimerkiksi seurata offline-tapahtumia, kuten osallistumista tuotteen lanseeraustilaisuuteen.

Tutustu kolmeen eri tapaan luoda mukautettuja tapahtumia. Voit lähettää mukautettuja tapahtumia API:n kautta, ladata taulukon tapahtumatietoja tai käyttää webhookeja (vainData Hub Professional ja Enterprise ).

Kun olet määrittänyt mukautetun tapahtuman, voit tarkastella mukautettujen tapahtumien tietoja eri työkaluissa. Voit luoda raportteja mukautettujen tapahtumien tiedoista, tarkastella mukautettujen tapahtumien esiintymisiä kontaktien aikajanoilla ja käyttää mukautettuja tapahtumia työnkuluissa.

Lopuksi voit seurata mukautettujen tapahtumien suorituskykyä mukautettujen tapahtumien hallintatyökalussa. Saatat myös joutua korjaamaan tuntemattomia ominaisuusvirheitämukautettujen tapahtumien hallintatyökalussa.

Mitkä ovat eri menetelmät mukautettujen tapahtumien luomiseen?

Tapahtuman luominen koostuu kahdesta osasta:

• Määrittämällä tapahtuman HubSpotissa, mukaan lukien mahdolliset mukautetut tapahtumaominaisuudet.
• Luo JavaScript-koodinpätkä tai määritä API-kutsu, joka laukaisee tapahtuman.

Mukautettuja tapahtumia voidaan luoda eri tavoin: 

• Lähetä API:n kautta: luo tapahtuma käyttämällä mukautetun tapahtuman määritelmän päätepistettä. Käytä sitten tapahtuman tunnusta mukautetun tapahtuman lähetyspäätepisteessä lähettääksesi tapahtumat HubSpotille.
• Kerää tietoja verkkosivustoltasi ilman API:ta:
  • Javascript-koodi: mukautetun Javascriptin avulla voit lisätä mukautettua koodia HubSpot-seurantakoodiin koodieditorin avulla.
  • Käytä tapahtumien visualisointityökalua: seuraa sivun katselukertoja tai napsautettuja elementtejä valitsemalla ne verkkosivustollasi. Lue lisää mukautettujen tapahtumien luomisesta tapahtumien visualisointityökalulla.
• Tuo taulukkolaskentaohjelma: lataa taulukkolaskentaohjelma, jossa on tapahtumatietoja, kerätäksesi offline-toimintaa, täyttääksesi tietoja tai integroidaksesi manuaalisesti minkä tahansa työkalun HubSpotin kanssa.
• Määritä webhookit (Data Hub vain Professional- ja Enterprise-versiot ): mukauta ehdot, jotka laukaisevat webhookin, sekä lähetettävät tiedot. 

Huomaa: vanhassa mukautettujen tapahtumien hallintatyökalussa luodut tapahtumat eivät enää toimi 1.8.2025 jälkeen.

Kuinka luon mukautettuja tapahtumia API:n avulla?

Jos lähetät tietoja HubSpotille API:n kautta, voit käyttääLähetä API:n kautta -vaihtoehtoa tai käyttää mukautetun tapahtuman määritelmän päätepistettä tapahtuman luomiseen. Lisätietoja API-kutsun määrittämisestä on HubSpotin kehittäjädokumentaatiossa.

Tarvitset API-kutsua varten muutamia tietoja, jotka saat HubSpotista:

• Tapahtuman nimi: tapahtuman sisäinen nimi. 
• Ominaisuuksien nimet: niiden ominaisuuksien sisäiset nimet, joihin aiot lähettää tietoja.

Voit viimeistellä tapahtuman luomisen tietojen lähettämiseksi API:n kautta seuraavasti:

• Valitse Lähetä tiedot HubSpotille ja kopioi seurantatunnus.
• Napsauta Luo.

Voit etsiä olemassa olevan tapahtuman sisäisen nimen ja ominaisuusnimet seuraavasti:

1. Siirry HubSpot-tililläsi kohtaanTietojen hallinta>Tapahtumien hallinta.
2. Napsauta tapahtuman nimeä. Siirryt tapahtuman tietosivulle.
3. Etsi yläosasta tapahtuman nimi kohdasta Sisäinen nimi. Kopioi sisäinen nimi napsauttamalla nimen vieressä olevaa kopiointikuvaketta. 
   
   
4. Löydät päivitettävien ominaisuuksien sisäiset nimet napsauttamalla ominaisuuden nimeä.
5. Napsauta oikeanpuoleisessa paneelissa koodikuvaketta ja tarkastele nimeä Sisäinen nimi-kohdassa.

Kuinka luon mukautettuja tapahtumia JavaScript-koodilla?

1. Siirry HubSpot-tililläsi kohtaanTietojen hallinta>Tapahtumien hallinta.
2. Napsauta oikeassa yläkulmassaLuo tapahtuma ja valitse sitten Luo mukautettu tapahtuma.
3. ValitseJavascript-koodi.

4. Kirjoita Tapahtuman nimi ja anna halutessasi tapahtuman kuvaus.
5. Valitse Liitetty objekti. Näin voit liittää tapahtumasi eri objekteihin HubSpotissa, kuten Yhteystiedot, Yritykset, Kaupat ja Tiketit. 

6. NapsautaSeuraava.

Kuinka lisään ominaisuuksia tapahtumaani?

Kun tapahtuma luodaan, oletusarvoiset tapahtumaominaisuudet ovat käytettävissä. Voit myös luoda omia mukautettuja ominaisuuksia. Tapahtumaominaisuudet tallennetaan erillään muista CRM-ominaisuuksista, ja ne ovat tapahtumakohtaisia (eli et voi muokata näitä ominaisuuksia tilisi asetuksista). 

1. Voit poistaa oletustapahtumaominaisuuksien luomisen käytöstä kytkemällä Oletustapahtumaominaisuudet pois päältä.
2. Voit luoda mukautettuja ominaisuuksia valitsemalla ominaisuuden tyypin napsauttamalla ominaisuuden Kenttätyyppi-kohtaa. Vaihtoehtoja ovat: 
   • Mukautettu merkkijono-ominaisuus: luo ominaisuus, joka on pelkkää tekstiä sisältävä merkkijono. 
   • Mukautettu numeromääritelmä: luo määritelmä, joka on numeron arvo.
   • Mukautettu aikaleimapominaisuus: luo ominaisuus, joka on päivämääräarvo. Tiedot on lähetettävä epoch-millisekunteina tai ISO8601-muodossa.
   • Mukautettu päivämääräominaisuus: luo ominaisuus, joka on päivämääräarvo.
   • Mukautettu boolean-ominaisuus: luo ominaisuus, joka on boolean-arvo. 
   • Mukautettu luettelomääritelmäominaisuus: luo ominaisuus, jossa on joukko ennalta määriteltyjä arvoja.
3. Kun olet valinnut ominaisuuden, määritä sen asetukset oikeanpuoleisessa paneelissa:

8. Anna ominaisuudelle nimi ja kirjoita ominaisuuden kuvaus.
   • Luettelomääritteiden osalta napsauta Seuraava ja kirjoita määritteen nimet ja arvot.
     • Luettelomääritteet voivat olla yksittäisiä tai monivalintaisia. Ota monivalinta käyttöön kytkemälläTukee moniarvoa -kytkin päälle.

• • • Sinun on määritettävä arvot ja nimikkeet ennen tietojen lähettämistä niihin. Jos tätä vaihetta ei suoriteta ennen luettelossa olemattomien tietojen lähettämistä, tietoja ei voi käyttää. Jos haluat lähettää useita arvoja API:n kautta, erota ne toisistaan puolipisteellä.

9. Napsauta Seuraava.
10. Kun olet määrittänyt tapahtuman ja sen ominaisuudet, voit lisätä tämän tapahtuman verkkosivustosi seurantakoodiin valitsemalla Javascript-koodinpätkän.
11. NapsautaValmis.

Tapahtumien luominen JavaScript-koodinpätkällä mahdollistaa JavaScriptin lisäämisen HubSpot-seurantakoodiin automaattisesti. Tätä voidaan käyttää monimutkaisempien tapahtumatietojen keräämiseen, joita seurantakoodi ei kerää oletusarvoisesti. 

1. Valitse Javascript-koodinpätkä. Käytä oikean paneelin koodinpätkää tapahtuman seurantaan HubSpotissa. Kaikki luodut mukautetut ominaisuudet määritetään valmiiksi koodinpätkässä. 
2. Muokkaa koodinpätkää tarpeen mukaan kirjoittamalla tekstiä oikeanpuoleiseen paneeliin. Lisäämäsi koodi sisällytetään automaattisesti osaksi HubSpot-seurantakoodiasi.
3. Kun olet valmis, napsauta Luo, jotta tapahtuma valmistuu ja seuranta alkaa automaattisesti.
    
   

Kuinka tuon mukautettuja tapahtumatietoja taulukoista?

Lataa taulukkomuodossa olevat osallistumistiedot fyysisistä tapahtumista, aikaleimattuja tietoja sovelluksista, joita et ole integroinut HubSpotiin, kertaluonteisia liidi- tai kampanjatietoja toimittajalta tai muita tapahtumatietoja. Tapahtumien avulla voit kerätä käyttäytymistietoja ja käyttää niitä sitten koko HubSpotissa. 

Tuonnit voivat luoda ja päivittää seuraavia tietueita:

• Yhteystiedot

• Yritykset
• Kaupat
• Lipput
• Palvelut
• Projektit
• Tapaamiset
• Kurssit
• Luettelot 
• Tilaukset
• Mukautetut objektit

Vaaditut ominaisuudet vaihtelevat objektityypin mukaan.

Tapahtumien tuontia voidaan käyttää vain jo tapahtuneisiin tapahtumiin. Mukautetussa tapahtumien tuontitiedostossa on oltava seuraavat tiedot:

• Yhteyshenkilön sähköpostiosoite.
• Tapahtui aikaleimalla. Lue lisää päivämääräominaisuuksien muotoilusta tuontitiedostoissa.

Esimerkkitiedosto

Mukautettujen tapahtumien tuominen:

1. Siirry HubSpot-tililläsi kohtaan Tietojenhallinta > Tapahtumanhallinta.
2. Napsauta oikeassa yläkulmassaLuo tapahtuma ja valitse sittenLuo mukautettu tapahtuma.
3. ValitseTuo taulukko.
4. Napsauta joko Luo uusi tapahtuma tai Tuo olemassa olevaan tapahtumaan.
   • Jos valitset Tuo olemassa olevaan tapahtumaan, valitse avattavasta valikosta olemassa oleva tapahtuma ja jatka sitten vaiheita taulukon lataamiseksi.
   • Jos valitset Luo uusi tapahtuma, jatka alla olevien ohjeiden mukaisesti.
5. Kirjoita Tapahtuman nimi ja lisää halutessasi tapahtuman kuvaus.
6. Valitse liitetty objekti. Tällä hetkellä tuonnin kautta luodut tapahtumat voidaan liittää vain yhteystietoihin.
7. Lataa taulukkolaskenta tai liitä tiedot suoraan taulukkolaskennasta. Valitse objektien tuontitapa ja tiedoston kieli ja napsauta sitten Seuraava.
8. Määritä sarakkeet tapahtuman ja yhteystiedon ominaisuuksiin ja napsauta sitten Seuraava.
9. Vahvista tuontitiedoston nimi.
10. Napsauta valintaruutua hyväksyäksesi, että yhteyshenkilöt odottavat sinulta yhteydenottoa ja että tuontitiedostosi ei sisällä ostettua listaa. Lue lisää HubSpotin hyväksyttävän käytön käytänteistä.
11. Valitse Tapahtui-ominaisuuden päivämäärämuoto.
12. Napsauta Viimeistele tuonti.

Kuinka lähetän mukautettuja tapahtumia API-päätelaitteen kautta?

1. Siirry HubSpot-tililläsi kohtaanTietojen hallinta>Tapahtumien hallinta.
2. Napsauta oikeassa yläkulmassaLuo tapahtuma ja valitse sittenLuo mukautettu tapahtuma.
3. ValitseLähetä API:n kautta.

4. Kirjoita Tapahtuman nimi ja anna halutessasi tapahtuman kuvaus. 

5. Mukautettujen tapahtumaominaisuuksien lisääminen:
   • Kirjoitaominaisuuden nimi. Tätä nimeä käytetäänmyös sisäisenä nimenä.
   • NapsautaKenttätyyppi -pudotusvalikkoa ja valitse kenttätyyppi.
   • Voit halutessasi lisätäkuvauksen.
   • Jos haluat lisätä lisää mukautettuja ominaisuuksia, napsauta+ Lisää mukautettu ominaisuus.
   • NapsautaSeuraava.

6. Objektien linkittäminen:
   • Napsauta Valitseensisijainen objekti -pudotusvalikkoa ja valitse sitten liitettävä objekti. Näin voit liittää tapahtumasi erilaisiin objekteihin, kuten yhteyshenkilöihin, yrityksiin, kauppoihin ja tiketteihin.
   • NapsautaMukauta vastaavuutta ja valitse vastaava tunnus tapahtuma- ja objektitietueiden välillä. Tapahtuma linkitetään objektitietueeseen vain, jos niiden vastaavat tunnukset ovat identtiset. Jos käytät mukautettua vastaavuustunnusta, valitsemasi objektin ominaisuuden on vaadittava yksilöllisiä arvoja.
7. NapsautaSeuraava.
8. Voit seurata tapahtumaa HubSpotissa napsauttamalla Seurantatunnuksen vieressä olevaaKopioi-painiketta.
9. NapsautaLuo tapahtuma.

Kuinka luon mukautettuja tapahtumia webhookien avulla?

Määritä ehdot, jotka laukaisevat webhookin.

1. Siirry HubSpot-tililläsi kohtaanTietojen hallinta>Tapahtumien hallinta.
2. Napsauta oikeassa yläkulmassaLuo tapahtuma ja valitse sittenLuo mukautettu tapahtuma.
3. ValitseMääritä webhookit.
4. SyötäTapahtuman nimi ja valitseLiitetty objekti.
5. NapsautaSeuraava.
6. Määritä testitapahtuma:
   • Kopioiwebhook-URL-osoite. 
   • Siirrywebhook-asetussivullekolmannen osapuolen sovelluksessa, johon haluat integroida.
   • Liitä kopioitu URL-osoite.
   • Napsauta Lähetä testitapahtuma.
7. NapsautaSeuraava.
8. Tarkista webhookin ominaisuudet. NapsautaOminaisuustyyppi-pudotusvalikkoaja valitse ominaisuustyyppi. 

9. NapsautaSeuraava.
10. Valitse kolmannen osapuolen webhookista ominaisuus, joka vastaa tarkalleen HubSpot-objektin ominaisuutta. 

Missä voin tarkastella ja käyttää mukautettujen tapahtumien tietoja HubSpotissa?

Mukautettujen tapahtumien tietoja voi tarkastella ja käyttää kaikissa HubSpotin työkaluissa. Alla on tietoa siitä, missä voit tarkastella tapahtumia ja miten voit sisällyttää tiedot muihin työkaluihin.

Voit avata valitsemasi tapahtumat suoraan tietyissä HubSpot-työkaluissa tapahtumaluettelon toimintojen pudotusvalikosta, yksittäisen tapahtuman näkymästä tai Analysoi-välilehden kaavioiden oikeasta yläkulmasta.

Kuinka luon raportteja mukautettujen tapahtumatietojen avulla

Mukautettuja tapahtumia voidaan analysoida mukautettujen tapahtumien työkalussa, ja tapahtumatiedot ovat käytettävissä myös mukautetun raportin luontityökalussa ja attribuutioraporteissa.

Lue lisää mukautettujen tapahtumien analysoinnista.

Kuinka tarkastelen tapahtumia kontaktin aikajanalla?

Tapahtumat näkyvät kontaktitietueen aikajanalla yhdessä täytettyjen ominaisuuksien kanssa.

Voit tarkastella tapahtuman tietoja kontaktin aikajanalla seuraavasti:

1. Siirry yhteystietotietueeseen, jossa mukautettu tapahtuma on tapahtunut.
2. Voit suodattaa kontaktin aikajanan tapahtumien mukaan napsauttamalla Suodata toimintaa ja valitsemalla sitten Mukautettu tapahtuma.
3. Napsauta yhteyshenkilön aikajanalla tapahtumaa laajentaaksesi sen ja näyttääksesi tapahtuman tiedot.

Huomaa: et voi tarkastella aikajanan tapahtumia webhookien avulla luoduissa mukautetuissa tapahtumissa.

Kuinka käytän mukautettuja tapahtumia työnkuluissa?

Työnkulussa voit viivästyttää toimintoja mukautettujen tapahtumien perusteella käyttämällä Viivytä, kunnes tapahtuma tapahtuu -toimintoa tai tapahtuman rekisteröintikynnystä.

1. Siirry HubSpot-tililläsi kohtaan Automaatio > Työnkulut.
2. Napsauta työnkulun nimeä. Tai lue, miten luot uuden työnkulun.
3. Lisää laukaisija seuraavasti:
   • Napsauta työnkulun muokkausnäkymässä Määritä laukaisijat.
   • Valitse vasemmasta paneelista Kun tapahtuma tapahtuu. Määritä laukaisija ja napsauta sitten Käytä suodatinta.
   • Voit tarkentaa laukaisinta napsauttamalla Lisää tarkennussuodattimia. Voit valita lisäominaisuuksia tarkentaaksesi kohteita, jotka haluat liittää työnkulkuun.
   • Oletusarvoisesti tietueet liitetään työnkulkuun vain ensimmäisen kerran, kun ne täyttävät liittämisen laukaisuehdot. Jos haluat ottaa uudelleenliittämisen käyttöön, valitse kohdassa Pitäisikö [objekti] liittää uudelleen tähän työnkulkuun? vaihtoehto Kyllä, liitä uudelleen aina, kun laukaisija tapahtuu.
4. Viiveen lisääminen:
   • Napsauta työnkulun muokkaimessa +-kuvaketta lisätäksesi työnkulun toiminnon.
   • Valitse oikeanpuoleisesta paneelista Viivytä, kunnes tapahtuma tapahtuu.
   • Määritä viive:
     • Napsauta Tapahtuma -pudotusvalikkoa ja valitse sitten mukautettu tapahtuma.
     • Valitse sitten tapahtuman ominaisuus, jota haluat viivästyttää.
     • Valitse suodatin tapahtuman ominaisuudelle.
     • Napsauta Käytä suodatinta.
   • • Valitse enimmäisodotusaika tai valitse Viivytä niin kauan kuin mahdollista -valintaruutu .
5. Napsauta Tallenna.

Huomaa:kaikki tapahtuman rekisteröintikytkimet erotetaan toisistaan OR-operaattorilla. Tämä tarkoittaa, että vain yhden tapahtuman rekisteröintikytkimen on täytyttävä, jotta tietue rekisteröidään työnkulkuun.

Työnkulku viivästyttää sitten liitettyjä tietueita, kunnes ne täyttävät määritetyt mukautetun tapahtuman kriteerit, tai se laukeaa, kun tapahtuma tapahtuu.

Kuinka hallitsen ja seuraan mukautetun tapahtumani tilaa ja toimitusvirheitä?

Varmistaaksesi, että tietosi pysyvät tarkkoina ja integraatiosi toimivat odotetusti, voit käyttää Tapahtumien hallinta -työkalun Monitor- välilehteä.

Kuinka voin seurata suorituskykyä mukautetun tapahtuman hallintatyökalussa?

• Suorituskykytrendit: Siirry HubSpot-tililläsi kohtaan Tietojenhallinta > Tapahtumanhallinta. Napsauta Monitor-välilehteä vertaillaksesi tapahtumien suoritusmääriä eri ajanjaksojen välillä.

• Toimitusvirheiden vianmääritys: Siirry HubSpot-tililläsi kohtaan Tietojenhallinta > Tapahtumanhallinta. Valitse Seuranta-välilehden vasemmasta sivupalkista Toimitusvirheet. Tässä taulukossa näkyvät tapahtumat, joiden synkronointi epäonnistui, sekä epäonnistumisen tarkka syy (esim. yhteensopimattomat tietotyypit tai skeemarikkomukset).

Kuinka korjaan "Unknown Property" -virheet mukautettujen tapahtumien hallintatyökalussa?

Jos API:n kautta lähetetään tietoja ominaisuudesta, jota ei ole koskaan määritelty HubSpotissa, se näkyy virhelokissa. Voit ratkaista tämän nopeasti:

1. Vie hiiri tapahtuman päälle Virhelokit -taulukossa.

2. Napsauta Toiminnot ja valitse sittenLisää ominaisuudet tapahtumaan.

3. Vahvista ehdotetut kenttätyypit, jotta HubSpot voi alkaa hyväksyä kyseiset tiedot välittömästi.