Luo mukautettuja tapahtumia
Päivitetty viimeksi: huhtikuuta 8, 2025
Saatavilla minkä tahansa seuraavan Tilauksen kanssa, paitsi jos toisin mainitaan:
|
|
|
|
|
Mukautettujen tapahtumien avulla voit määritellä ja seurata yrityksellesi ominaisia tapahtumia. Mukautetut tapahtumat voidaan sitoa tapahtumaominaisuuksiin, joita voit sitten käyttää kaikissa HubSpotin työkaluissa.
Mukautettuja tapahtumia voidaan luoda eri tavoin:
- Lähetä API:n kautta: käytä tapahtuman luomiseen mukautetun tapahtuman määrittelyn päätepistettä. Käytä sitten tapahtuman tunnusta send Custom event -päätepisteen kanssa lähettääksesi tapahtuman loppuunsaattamiset HubSpotiin.
- Kerää tietoja verkkosivustoltasi ilman API:ta:
- Koodi Javascript: Käyttämällä mukautettua Javascriptiä voit lisätä mukautettua koodia HubSpot-seurantaskriptiin käyttämällä koodieditoria.
- Käytä tapahtumavisualisointia (vainMarketing Hub Enterprise ): Seuraa sivunäkymiä tai klikattuja elementtejä valitsemalla ne verkkosivustollasi. Lisätietoja mukautettujen tapahtumien luomisesta tapahtumavisualisaattorin avulla.
- Tuo taulukkolaskenta: lataa taulukkolaskenta tapahtumatietoja offline-toiminnan tallentamiseksi, tietojen täydentämiseksi tai minkä tahansa työkalun integroimiseksi manuaalisesti HubSpotiin.
- Verkkokoukkujen määrittäminen (vainOperations Hub Professional ja Enterprise): Mukauta ehtoja, jotka laukaisevat verkkokoukun, ja lähetettäviä tietoja.
Huomaa: mukautettu tapahtumatyökalu korvaa aiemman tapahtumatyökalun. Kaikki vanhalla työkalulla luodut tapahtumat toimivat edelleen, ja voit edelleen hallita ja analysoida niitä vanhalla työkalulla.
Tapahtuman luomisprosessi koostuu kahdesta osasta:
- Tapahtuman määrittäminen HubSpotissa, mukaan lukien kaikki mukautetut tapahtuman ominaisuudet.
- Javascript-koodinpätkän luominen tai tapahtuman käynnistävän API-kutsun määrittäminen .
Tapahtuman luominen API:n kautta
Jos lähetät tietoja HubSpotiin API:n kautta, voit käyttää Lähetä API:n kautta -vaihtoehtoa tai tapahtuman luomiseenCustom event definition -päätepistettä. Lue lisää API-kutsun määrittelystä HubSpotin kehittäjädokumentaatiosta.
Tarvitset API-kutsua varten muutamia tietoja, jotka saat HubSpotin sisältä:
- Tapahtuman nimi: tapahtuman sisäinen nimi.
- Ominaisuuksien nimet: niiden ominaisuuksien sisäiset nimet, joihin lähetät tietoja.
Viimeistele tapahtuman luominen tietojen lähettämiseksi API:n kautta:
- Valitse Lähetä tiedot HubSpotiin ja kopioi seurantatunnus.
- Napsauta Luo.
Olemassa olevan tapahtuman sisäisen tapahtuman nimen ja ominaisuuksien nimien etsiminen:
- Siirry HubSpot-tililläsi kohtaan Tietojen hallinta > Mukautetut tapahtumat.
- Valitse Mukautetut tapahtumat.
- Napsauta tapahtuman nimeä. Tämän jälkeen siirryt tapahtuman yksityiskohtien sivulle.
- Etsi tapahtuman nimi yläreunasta kohdasta Sisäinen nimi.
- Löydät päivitettävien ominaisuuksien sisäiset nimet napsauttamalla ominaisuuden nimeä.
- Napsauta oikeanpuoleisessa paneelissa koodikuvaketta ja katso sitten nimi kohdasta Sisäinen nimi.
Kun lähetät tietoja tapahtumaasi, sovelletaan alla olevia rajoituksia:
- Ominaisuuksien nimet on rajoitettu 50 merkkiin.
- URL- ja referrer-ominaisuuksiin voidaan käyttää enintään 1024 merkkiä, kun taas kaikkiin muihin ominaisuuksiin voidaan käyttää enintään 256 merkkiä.
- Kukin tapahtuman täydennys voi sisältää enintään 50 ominaisuuden tiedot.
- Ominaisuuksien sisäisten nimien on alettava kirjaimella, ja niiden on sisällettävä vain pieniä kirjaimia a-z, numeroita 0-9 ja alaviivoja. Ominaisuudet, joilla on sama sisäinen nimi pienaakkosten jälkeen, katsotaan kaksoiskappaleiksi, ja vain yhtä ominaisuutta käytetään täytössä.
Luo tapahtumia Javascript-koodinpätkällä
- Siirry HubSpot-tililläsi kohtaan Tietojen hallinta > Mukautetut tapahtumat.
- Napsauta oikeassa yläkulmassa Luo tapahtuma.
- Valitse koodi Javascript.
- Anna tapahtuman nimi ja valinnaisesti tapahtuman kuvaus.
- Valitse liitetty kohde. Tämän avulla voit yhdistää tapahtumien loppuunsaattamiset HubSpotin eri objekteihin, kuten yhteystietoihin, yrityksiin, tarjouksiin ja lippuihin.
- Napsauta Seuraava.
Lisää ominaisuuksia
Kun tapahtuma luodaan, tapahtuman oletusominaisuudet ovat käytettävissä. Voit myös luoda omia mukautettuja ominaisuuksia. Tapahtumaominaisuudet tallennetaan erillään muista CRM-ominaisuuksista, ja ne ovat ainutlaatuisia tapahtumalle (eli et voi muokata näitä ominaisuuksia tiliasetuksista).
- Jos haluat poistaa oletustapahtumaominaisuuksien luomisen käytöstä, vaihda oletustapahtumaominaisuudet pois käytöstä.
- Jos haluat luoda mukautettuja ominaisuuksia, valitse ominaisuustyyppi napsauttamalla ominaisuuden kenttätyyppiä. Vaihtoehtoja ovat mm:
- Mukautettu merkkijono-ominaisuus: Luo ominaisuus, joka on pelkkä merkkijono.
- Mukautettu numeroominaisuus: Luo ominaisuus, joka on numeroarvo.
- Mukautettu aikaleimaominaisuus: Luo ominaisuus, joka on päivämääräarvo. Sinun on lähetettävä tietosi epochimillisekunteina tai ISO8601-muodossa.
- Mukautettu luetteluominaisuus: Luo ominaisuus, jolla on joukko ennalta määritettyjä arvoja.
- Kun olet valinnut ominaisuuden, määritä ominaisuus oikeassa paneelissa:
-
- Anna ominaisuudelle nimi ja anna ominaisuuden kuvaus.
- Napsauta Enumeration-ominaisuuksien kohdalla Seuraava ja syötä ominaisuuden Labels ja Values.
- Luettelo-ominaisuudet voivat olla yksi- tai monivalintaisia. Jos haluat ottaa käyttöön monivalintaiset arvot, kytke Support multi-value (Tuki monivalintaisia arvoja ) -vaihtoehto päälle.
-
-
- Sinun on asetettava arvot ja merkinnät ennen tietojen lähettämistä niihin. Jos tätä vaihetta ei suoriteta ennen kuin lähetät tietoja, jotka eivät ole luettelossa, tietoja ei voi käyttää. Jos haluat lähettää useita arvoja API:n kautta, erota ne puolipisteellä.
-
-
- Napsauta Valmis.
- Napsauta Seuraava.
- Kun olet määrittänyt tapahtuman ja sen ominaisuudet, voit lisätä tämän tapahtuman verkkosivustosi seurantakoodiin valitsemalla Javascript-koodinpätkän.
Tapahtumien luominen Javascript-koodinpätkällä mahdollistaa Javascriptin lisäämisen HubSpot-seurantakoodiin automaattisesti. Tätä voidaan käyttää monimutkaisempien tapahtumatietojen tallentamiseen, joita seurantakoodi ei oletusarvoisesti tallenna.
- Valitse Javascript-koodinpätkä. Käytä oikeassa paneelissa olevaa koodinpätkää tapahtuman seuraamiseen HubSpotissa. Kaikki luodut mukautetut ominaisuudet ovat valmiiksi määritettyinä koodinpätkässä.
- Muokkaa pätkää tarpeen mukaan syöttämällä tekstiä oikeaan paneeliin. Kaikki lisäämäsi koodi sisällytetään automaattisesti osaksi HubSpot-seurantakoodia.
- Kun olet valmis, napsauta Luo viimeistelläksesi tapahtuman ja aloittaaksesi seurannan automaattisesti.
Tuo tapahtumatiedot
Lataa läsnäolotiedot henkilökohtaisista tapahtumista, aikaleimattuja tietoja sovelluksista, joita et integroi HubSpotin kanssa, kertaluonteisia lyijy- tai kampanjatietoja toimittajalta tai muita tapahtumatietoja taulukkomuodossa. Tapahtumien avulla voit kaapata käyttäytymistä ja käyttää sitä sitten HubSpotissa.
Tuonti voi luoda ja päivittää yhteystiedot. Tapahtumien tuontia voidaan käyttää vain jo tapahtuneisiin tapahtumiin. Mukautetun tapahtuman tuontitiedoston on sisällettävä seuraavat tiedot:- Yhteyshenkilön sähköpostiosoite.
- Tapahtui aikaleimalla. Lisätietoja päivämääräominaisuuksien muotoilusta tuontitiedostoissa.
Omien tapahtumien tuominen:
- Siirry HubSpot-tililläsi kohtaan Tietojen hallinta > Mukautetut tapahtumat.
- Napsauta oikeassa yläkulmassa Luo tapahtuma.
- Valitse Tuo laskentataulukko.
- Anna tapahtuman nimi ja valinnaisesti tapahtuman kuvaus.
- Valitse liitetty kohde. Tällä hetkellä tuonnin kautta luotuja tapahtumia voidaan liittää vain yhteystietoihin.
- Lataa tiedosto. Valitse , miten objektit tuodaan, ja tiedoston kieli ja napsauta sitten Seuraava.
- Liitä sarakkeet tapahtuman ja yhteystiedon ominaisuuksiin ja napsauta sitten Seuraava.
- Vahvista tuontitiedoston nimi.
- klikkaa valintaruutua hyväksyessäsi, että yhteyshenkilöt odottavat kuulevansa sinusta ja että tuontitiedostosi ei sisällä ostettua luetteloa. Lue lisää HubSpotin hyväksyttävän käytön käytännöistä.
- Valitse Occurred at -ominaisuuden päivämäärämuoto.
- Napsauta viimeistele tuonti.
Tapahtumien luominen API:n kautta
- Siirry HubSpot-tililläsi kohtaan Tietojen hallinta > Mukautetut tapahtumat.
- Napsauta oikeassa yläkulmassa Luo tapahtuma.
- Valitse Lähetä API:n kautta.
- Anna tapahtuman nimi ja valinnaisesti tapahtuman kuvaus. Napsauta Seuraava.
- Lisää ominaisuuksia seuraavien vaiheiden avulla. Varmista, että luot mukautetun tapahtumaominaisuuden, joka edustaa vastaavaa ID:tä. Napsauta Seuraava.
- Objektien yhdistäminen:
- Napsauta Valitseensisijainen objekti -pudotusvalikkoa ja valitse sitten liittyvä objekti. Näin voit liittää tapahtumien loppuunsaattamiset eri objekteihin, kuten yhteystietoihin, yrityksiin, tarjouksiin ja lippuihin.
- Napsauta Mukauta vastaavuutta ja valitse tapahtuma- ja objektitietueiden välinen vastaava tunnus. Tapahtuma linkittyy objektitietueeseen vain, jos niiden vastaavat tunnukset ovat samat. Jos käytät mukautettua vastaavuustunnusta, valitsemasi objektiominaisuuden on vaadittava yksilöllisiä arvoja.
- Napsauta Seuraava.
Huom:
- Voit yhdistää vain saman tietotyypin tapahtumaominaisuuksia ja objektiominaisuuksia.
- Voit tarvittaessa muokata mukautettua vastaavuutta myöhemmin, mutta et voi muuttaa valittua ensisijaista kohdetta.
Määritä verkkokoukut
Aseta ehdot, jotka laukaisevat webhookin.
- Siirry HubSpot-tililläsi kohtaan Tietojen hallinta > Mukautetut tapahtumat.
- Napsauta oikeassa yläkulmassa Luo tapahtuma.
- Valitse Setup webhooks.
- Anna tapahtuman nimi ja valitse liitetty kohde.
- Napsauta Seuraava.
- Määritä testitapahtuma:
- Kopioi Webhookin URL-osoite.
- Siirry sen kolmannen osapuolen sovelluksen webhook-asetussivulle, johon haluat integroida.
- Liitä kopioitu URL-osoite.
- Napsauta Lähetä testitapahtuma.
- Napsauta Seuraava.
- Tarkista verkkokoukkusi ominaisuudet. Valitse ominaisuustyyppi napsauttamalla Property type -pudotusvalikkoa.
- Napsauta Seuraava.
- Valitse kolmannen osapuolen webhookista ominaisuus, joka vastaa täsmälleen HubSpot-objektin ominaisuutta.
Käytä mukautettuja tapahtumatietoja
Mukautettuja tapahtumatietoja voidaan tarkastella ja käyttää kaikissa HubSpotin työkaluissa. Alla kerrotaan, mistä voit tarkastella tapahtumien loppuunsaattamisia ja miten voit sisällyttää nämä tiedot muihin työkaluihin.
Voit avata valitut tapahtumat suoraan tietyissä HubSpot-työkaluissa tapahtumaluettelon Toiminnot-pudotusvalikosta, yksittäisen tapahtuman näkymästä tai Analysoi-välilehden kaavioiden oikeasta yläkulmasta.
Raportti mukautetuista tapahtumista
Mukautettuja tapahtumia voidaan analysoida mukautetun tapahtumatyökalun avulla, ja tapahtumatiedot ovat käytettävissä myös mukautetun raportin rakentajassa ja attribuutioraporteissa.
Lisätietoja mukautettujen tapahtumien analysoinnista.
Tarkastele tapahtumien valmistumista yhteystietojen aikajanalla
Tapahtuman päättyminen näkyy yhteystietueen aikajanalla yhdessä täytettyjen ominaisuuksien kanssa.
Voit tarkastella tapahtuman yksityiskohtia yhteysaikataululla:
- Siirry yhteystietueeseen, joka on suorittanut mukautetun tapahtuman.
- Jos haluat suodattaa yhteyshenkilön aikajanan päättyneiden tapahtumien mukaan, valitse Suodata toiminta ja valitse sitten Mukautettu tapahtuma.
- Laajenna tapahtuma yhteyshenkilön aikajanalla napsauttamalla sitä, jolloin tapahtuman tiedot tulevat näkyviin.
Mukautettujen tapahtumien käyttäminen työnkuluissa
Työnkulussa voit viivyttää mukautetun tapahtuman päättymisen perusteella käyttämällä Viivytä, kunnes tapahtuma tapahtuu -toimintoa tai tapahtuman ilmoittautumisen laukaisinta.
- Siirry HubSpot-tililläsi kohtaan Automaatio > Työnkulut.
- Napsauta työnkulun nimeä. Tai opettele luomaan uusi työnkulku.
- Liipaisimen lisääminen:
- Työnkulkueditorissa valitse Laukaisimien määrittäminen.
- Valitse vasemmassa paneelissa Kun tapahtuma tapahtuu. Määritä laukaisin ja valitse sitten Käytä suodatinta.
- Voit tarkentaa laukaisinta valitsemalla Lisää tarkennussuodattimia. Voit valita lisäominaisuuksia tarkentaaksesi kohteita, jotka haluat rekisteröidä työnkulkuun.
- Oletusarvoisesti tietueet rekisteröidään työnkulkuun vain silloin, kun ne täyttävät rekisteröinnin laukaisimet ensimmäisen kerran. Jos haluat ottaa uudelleenrekisteröinnin käyttöön, valitse kohdassa Pitäisikö [objekti] rekisteröidä uudelleen tähän työnkulkuun? kohdassa Kyllä, rekisteröidään uudelleen joka kerta, kun laukaisu tapahtuu.
- Viiveen lisääminen:
- Lisää työnkulun toiminto napsauttamalla työnkulkueditorissa + plus-kuvaketta.
- Valitse oikeassa paneelissa Viive, kunnes tapahtuma tapahtuu.
- Määritä viive:
- Napsauta Tapahtuma-pudotusvalikkoa ja valitse sitten mukautettu tapahtuma.
- Valitse sitten tapahtumaominaisuus, johon haluat viivyttää.
- Valitse tapahtumaominaisuuden suodatin.
- Napsauta Käytä suodatinta.
-
- Valitse enimmäisodotusaika tai valitse Delay as long as possible (Viivytä niin kauan kuin mahdollista ) -valintaruutu.
- Napsauta Tallenna.
Huomaa: kaikki tapahtuman rekisteröinnin laukaisijat erotetaan toisistaan OR-operaattorilla. Tämä tarkoittaa, että vain yhden tapahtuman kirjautumisen laukaisijoista on tapahduttava, jotta tietue kirjautuisi työnkulkuun.
Työnkulku viivästyttää kirjattuja tietueita, kunnes ne täyttävät määritetyt mukautetut tapahtumakriteerit, tai se käynnistyy tapahtuman sattuessa.