Ultimo aggiornamento: 26 novembre 2025
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
-
Marketing Hub
Enterprise
-
Sales Hub
Enterprise
-
Service Hub
Enterprise
-
Data Hub
Enterprise
-
Content Hub
Enterprise
-
CRM HubSpot intelligente
Enterprise
Gli eventi personalizzati ti consentono di definire e monitorare eventi specifici della tua attività. Gli eventi personalizzati possono essere collegati alle proprietà degli eventi, che puoi quindi utilizzare in tutti gli strumenti di HubSpot.
Esistono diversi modi per creare eventi personalizzati:
- Invia tramite API: utilizza l'endpoint Definizione evento personalizzato per creare il tuo evento. Da lì, utilizza il tuo ID evento con l'endpoint Invia evento personalizzato per inviare gli eventi a HubSpot.
- Acquisisci i dati dal tuo sito web senza l'API:
- Codice Javascript: utilizzando Javascript personalizzato, puoi inserire codice personalizzato nello script di tracciamento HubSpot utilizzando l'editor di codice.
- Usa il visualizzatore di eventi (soloMarketing Hub Enterprise ): traccia le visualizzazioni di pagina o gli elementi cliccati selezionandoli sul tuo sito web. Scopri di più sulla creazione di eventi personalizzati con il visualizzatore di eventi.
- Importa foglio di calcolo: carica un foglio di calcolo con i dati degli eventi per acquisire attività offline, reintegrare dati o integrare manualmente qualsiasi strumento con HubSpot.
- Configura i webhook (soloDataHub Professional ed Enterprise): personalizza le condizioni che attivano un webhook e i dati che verranno inviati.
Nota: tutti gli eventi creati nello strumento Eventi personalizzati legacy non funzioneranno più dopo il 1° agosto 2025.
Il processo di creazione degli eventi prevede due parti:
- Definizione dell'evento in HubSpot, comprese eventuali proprietà personalizzate dell'evento.
- Creazione di uno snippet di codice Javascript o definizione della chiamata API che attiverà l'evento.
Crea evento tramite API
Se invii dati a HubSpot tramite API, puoi utilizzarel'opzione Invia tramite API o utilizzare l'endpoint Definizione evento personalizzato per creare il tuo evento. Scopri di più sulla definizione della tua chiamata API nella documentazione per sviluppatori di HubSpot.
Per la chiamata API sono necessarie alcune informazioni, che puoi ottenere all'interno di HubSpot:
- Nome dell'evento: il nome interno dell'evento.
- Nomi delle proprietà: i nomi interni delle proprietà a cui invierai i dati.
Per completare la creazione dell'evento da inviare tramite API:
- Seleziona Invia dati a HubSpot e copia l'ID di monitoraggio.
- Fai clic su Crea.
Per trovare il nome interno di un evento esistente e i nomi delle proprietà:
- Nel tuo account HubSpot, vai suGestione dati>Gestione eventi.
- Clicca sul nome dell'evento. Verrai reindirizzato alla pagina dei dettagli dell'evento.
- Nella parte superiore, individua il nome dell'evento sotto Nome interno. Per copiare il nome interno, clicca sull'icona di copia accanto al nome.
- Per trovare i nomi interni delle proprietà che desideri aggiornare, clicca sul nome di una proprietà.
- Nel pannello di destra, clicca sull'icona del codice, quindi visualizza il nome sotto Nome interno.
Quando invii dati al tuo evento, si applicano i seguenti limiti:
- I nomi delle proprietà sono limitati a 50 caratteri.
- Le proprietà URL e referrer possono contenere fino a 1024 caratteri, mentre tutte le altre proprietà possono contenere fino a 256 caratteri.
- Ogni occorrenza dell'evento può contenere dati per un massimo di 50 proprietà.
- I nomi interni delle proprietà devono iniziare con una lettera e contenere solo lettere minuscole dalla a alla z, numeri da 0 a 9 e trattini bassi. Le proprietà con lo stesso nome interno dopo la conversione in minuscolo sono considerate duplicate e solo una delle proprietà verrà utilizzata dopo l'occorrenza.
Crea eventi con uno snippet di codice Javascript
- Nel tuo account HubSpot, vai suGestione dati>Gestione eventi.
- In alto a destra, clicca suCrea un evento, quindi seleziona Crea evento personalizzato.
- SelezionaCodice Javascript.
- Inserisci un nome per l'evento e, se lo desideri, aggiungi una descrizione.
- Seleziona un Oggetto associato. Ciò ti consente di associare le occorrenze dell'evento a diversi oggetti in HubSpot, tra cui Contatti, Aziende, Opportunità e Ticket.
- Cliccasu Avanti.
Aggiungi proprietà
Quando viene creato un evento, saranno disponibili le proprietà predefinite dell'evento. È anche possibile creare proprietà personalizzate. Le proprietà degli eventi sono memorizzate separatamente dalle altre proprietà CRM e sono uniche per l'evento (ovvero non è possibile modificare queste proprietà dalle impostazioni dell'account).
- Per disattivare la creazione delle proprietà predefinite dell'evento, disattiva l'opzioneProprietà predefinite dell'evento.
- Per creare proprietà personalizzate, seleziona il tipo di proprietà facendo clic sul Tipo di campo per la tua proprietà. Le opzioni includono:
- Proprietà stringa personalizzata: crea una proprietà che è una stringa di testo semplice.
- Proprietà numerica personalizzata: crea una proprietà che è un valore numerico.
- Proprietà timestamp personalizzata: crea una proprietà che è un valore di data. Devi inviare i tuoi dati sotto forma di millisecondi epoch o ISO8601.
- Proprietà data personalizzata: crea una proprietà che è un valore di data.
- Proprietà booleana personalizzata: crea una proprietà che è un valore booleano.
- Proprietà enumerazione personalizzata: crea una proprietà con un insieme di valori predefiniti.
- Dopo aver selezionato la proprietà, configurala nel pannello di destra:
- Immettere un nome per la proprietà e una descrizione.
- Per le proprietà di enumerazione, fare clic su Avanti e inserire le etichette e i valori della proprietà.
- Le proprietà di enumerazione possono essere a selezione singola o multipla. Per abilitare i valori a selezione multipla, attiva l'opzioneSupporta valori multipli.
- Per le proprietà di enumerazione, fare clic su Avanti e inserire le etichette e i valori della proprietà.
-
-
- È necessario impostare i valori e le etichette prima di inviare i dati. Se questo passaggio non viene completato prima dell'invio di dati non presenti nell'elenco, i dati non saranno disponibili per l'uso. Per inviare più valori tramite API, separarli con un punto e virgola.
-
- Fai clic su Avanti.
- Dopo aver configurato l'evento e le sue proprietà, puoi aggiungere questo evento al codice di monitoraggio del tuo sito web selezionando il frammento di codice Javascript.
- Fai clic suFine.
La creazione di eventi con uno snippet di codice Javascript consente di aggiungere automaticamente Javascript al codice di tracciamento HubSpot. Ciò può essere utilizzato per acquisire dati di eventi più complessi che il codice di tracciamento non acquisisce per impostazione predefinita.
- Seleziona Snippet di codice Javascript. Utilizza lo snippet nel pannello di destra per tracciare l'evento in HubSpot. Qualsiasi proprietà personalizzata creata sarà predefinita all'interno dello snippet di codice.
- Modifica lo snippet secondo necessità inserendo il testo nel pannello di destra. Qualsiasi codice aggiunto verrà automaticamente incluso come parte del codice di monitoraggio HubSpot.
- Al termine, clicca su Crea per completare l'evento e avviare automaticamente il tracciamento.
Importazione dei dati degli eventi
Carica i dati di partecipazione agli eventi di persona, i dati con data e ora provenienti da app non integrate con HubSpot, i dati relativi a lead o campagne una tantum provenienti da un fornitore o qualsiasi altro dato relativo agli eventi in formato foglio di calcolo. Gli eventi consentono di acquisire comportamenti e di utilizzarli poi in HubSpot.
Le importazioni possono creare e aggiornare record di contatto. Le importazioni di eventi possono essere utilizzate solo per eventi già verificatisi. Il seguente file deve essere incluso in un file di importazione di eventi personalizzato:- Indirizzo e-mail di contatto.
- Si è verificato al timestamp. Ulteriori informazioni sulla formattazione delle proprietà della data nei file di importazione.
Per importare eventi personalizzati:
- Nel tuo account HubSpot, vai suGestione dati>Gestione eventi.
- In alto a destra, clicca suCrea un evento, quindi selezionaCrea evento personalizzato.
- SelezionaImporta foglio di calcolo.
- Inserisci un Nome evento e, facoltativamente, fornisci una descrizione dell'evento.
- Seleziona un Oggetto associato. Al momento, gli eventi creati tramite importazione possono essere associati solo ai contatti.
- Carica il file. Seleziona come importare gli oggetti e la lingua del file, quindi fai clic su Avanti.
- Associa le colonne alle proprietà dell'evento e del contatto, quindi fai clic su Avanti.
- Conferma il nome del file di importazione.
- Fai clic sulla casella di controllo per confermare che i contatti sono d'accordo a ricevere comunicazioni da parte tua e che il tuo file di importazione non include un elenco acquistato. Scopri di più sulla politica di utilizzo accettabile di HubSpot.
- Seleziona il formato della data della proprietà " Occorso alle ".
- Clicca su Termina importazione.
Creare eventi tramite API
- Nel tuo account HubSpot, vai suGestione dati>Gestione eventi.
- In alto a destra, clicca suCrea un evento, quindi selezionaCrea evento personalizzato.
- SelezionaInvia tramite API.
- Inserisci un nome per l'evento e, facoltativamente, fornisci una descrizione dell'evento.
- Per aggiungere proprietà personalizzate all'evento:
- Digita un nomeper la proprietà. Questo nome verrà applicato anche alnome interno.
- Fai clic sul menu a discesaTipo di campo e seleziona un tipo di campo.
- Facoltativamente, aggiungi unadescrizione.
- Se desideri aggiungere altre proprietà personalizzate, fai clic su+ Aggiungi proprietà personalizzata.
- Fare clicsu Avanti.
- Per collegare gli oggetti:
- Fai clic sul menu a discesa Seleziona unoggetto primario, quindi seleziona un oggetto associato. Ciò ti consente di associare le occorrenze dei tuoi eventi a diversi oggetti, inclusi contatti, aziende, trattative e ticket.
- Fai clicsu Personalizza la corrispondenza e seleziona l'ID di corrispondenza tra i record dell'evento e dell'oggetto. L'evento verrà collegato al record dell'oggetto solo quando i loro ID di corrispondenza sono identici. Se utilizzi un ID di corrispondenza personalizzato, la proprietà dell'oggetto selezionata deve richiedere valori univoci.
- Cliccasu Avanti.
- Per monitorare l'evento in HubSpot, clicca suCopia accanto all'ID di monitoraggio.
- Clicca suCrea evento.
Nota:
- È possibile abbinare solo proprietà di eventi e proprietà di oggetti dello stesso tipo di dati.
- Se necessario, è possibile modificare l'abbinamento personalizzato in un secondo momento, ma non è possibile modificare l'oggetto primario selezionato.
Configurare i webhook
Imposta le condizioni che attiveranno un webhook.
- Nel tuo account HubSpot, vai suGestione dati>Gestione eventi.
- In alto a destra, clicca suCrea un evento, quindi selezionaCrea evento personalizzato.
- SelezionaConfigura webhook.
- Inserisci unNome evento e seleziona unOggetto associato.
- Fai clic suAvanti.
- Configura un evento di prova:
- Copial'URL del webhook.
- Accedere allapagina delle impostazioni del webhooknell'app di terze parti che si desidera integrare.
- Incolla l'URL copiato.
- Fai clic su Invia un evento di prova.
- Fai clic suAvanti.
- Controlla le proprietà del tuo webhook. Clicca sul menua tendina Tipo di proprietàper selezionare un tipo di proprietà.
- Cliccasu Avanti.
- Seleziona una proprietà dal tuo webhook di terze parti che corrisponda esattamente a una proprietà dell'oggetto HubSpot.
Utilizza i dati degli eventi personalizzati
I dati degli eventi personalizzati possono essere visualizzati e utilizzati in tutti gli strumenti HubSpot. Di seguito, scopri dove visualizzare gli eventi e come incorporare tali dati in altri strumenti.
Puoi aprire gli eventi selezionati direttamente in alcuni strumenti HubSpot tramite il menu a tendina delle azioni nell'elenco degli eventi, nella visualizzazione di un singolo evento o nell'angolo in alto a destra dei grafici nella scheda Analizza.
Report sugli eventi personalizzati
Gli eventi personalizzati possono essere analizzati dallo strumento eventi personalizzati e i dati degli eventi saranno disponibili anche nel generatore di report personalizzati e nei report di attribuzione.
Scopri di più sull'analisi degli eventi personalizzati.
Visualizza gli eventi sulla timeline dei contatti
Gli eventi appariranno nella cronologia del record del contatto, insieme a tutte le proprietà che sono state compilate.
Per visualizzare i dettagli degli eventi sulla cronologia dei contatti:
- Passa a un record di contatto in cui si è verificato un evento personalizzato.
- Per filtrare la cronologia di un contatto in base agli eventi verificatisi, clicca su Filtra attività, quindi seleziona Evento personalizzato.
- Nella cronologia del contatto, clicca per espandere l'evento e visualizzarne i dettagli.
Nota: non è possibile visualizzare l'attività della cronologia sugli eventi personalizzati creati utilizzando i webhook.
Utilizza gli eventi personalizzati nei flussi di lavoro
In un flusso di lavoro, è possibile ritardare in base agli eventi personalizzati utilizzando un Ritardo fino al verificarsi dell'evento azione o un trigger di registrazione evento.
- Nel tuo account HubSpot, passa a Automazione > Flussi di lavoro.
- Fai clic sul nome di un flusso di lavoro. Oppure scopri come creare un nuovo flusso di lavoro.
- Per aggiungere un trigger:
- Nell'editor del flusso di lavoro, fai clic su Imposta trigger.
- Nel pannello di sinistra, seleziona Quando si verifica un evento. Imposta il trigger, quindi fai clic su Applica filtro.
- Per perfezionare ulteriormente il trigger, fai clic su Aggiungi filtri di perfezionamento. Puoi selezionare proprietà aggiuntive per perfezionare gli oggetti che desideri iscrivere al flusso di lavoro.
- Per impostazione predefinita, i record verranno registrati in un flusso di lavoro solo la prima volta che soddisfano i trigger di registrazione. Per abilitare la registrazione ripetuta, nella sezione [Oggetto] deve essere registrato nuovamente in questo flusso di lavoro? seleziona Sì, registra nuovamente ogni volta che si verifica il trigger.
- Per aggiungere un ritardo:
- Nell'editor del flusso di lavoro, fai clic sull'icona + per aggiungere un'azione del flusso di lavoro.
- Nel pannello di destra, selezionare Ritarda fino al verificarsi dell'evento.
- Configura il ritardo:
- Fai clic sul menu a discesa Evento, quindi seleziona un evento personalizzato.
- Quindi, seleziona la proprietà dell'evento che desideri ritardare.
- Seleziona il filtro per la proprietà dell'evento.
- Fai clic su Applica filtro.
-
- Selezionare il tempo di attesa massimo oppure selezionare la casella di controllo Ritarda il più a lungo possibile .
- Fai clic su Salva.
Nota:tutti i trigger di registrazione evento saranno separati utilizzando l'operatore OR. Ciò significa che solo uno dei trigger di registrazione evento deve verificarsi affinché il record venga registrato nel flusso di lavoro.
Il flusso di lavoro ritarderà quindi i record registrati fino a quando non soddisfano i criteri dell'evento personalizzato specificati o verrà attivato quando si verifica l'evento.
