Come creare eventi personalizzati

Sommario

Utilizza gli eventi personalizzati in HubSpot per definire e monitorare eventi specifici della tua attività. Gli eventi personalizzati possono essere associati a proprietà dell'evento, che puoi poi utilizzare in tutti gli strumenti di HubSpot. Ad esempio, potresti voler monitorare eventi offline come la partecipazione a un lancio di prodotto in presenza.

Scopri i tre diversi metodi per creare eventi personalizzati. Puoi inviare eventi personalizzati tramite un'API, caricare un foglio di calcolo con i dati degli eventi o utilizzare i webhook (soloData Hub Professional ed Enterprise ).

Dopo aver configurato un evento personalizzato, puoi esaminare i dati relativi a tale evento in diversi strumenti. Puoi creare report con i dati degli eventi personalizzati, esaminare le occorrenze degli eventi personalizzati nelle timeline dei contatti e utilizzare gli eventi personalizzati nei flussi di lavoro.

Infine, monitora le prestazioni dei tuoi eventi personalizzati nello strumento di gestione degli eventi personalizzati. Potresti anche dover risolvere errori di proprietà sconosciutenello strumento di gestione degli eventi personalizzati.

Quali sono i diversi metodi per creare eventi personalizzati?

Il processo di creazione degli eventi prevede due parti:

• Definendo l'evento in HubSpot, incluse eventuali proprietà dell'evento personalizzate.
• Creando uno snippet di codice JavaScript o definendo la chiamata API che attiverà l'evento.

Esistono diversi modi per creare eventi personalizzati: 

• Invio tramite API: utilizzare l'endpoint di definizione degli eventi personalizzati per creare l'evento. Da lì, utilizzare l'ID dell'evento con l'endpoint di invio degli eventi personalizzati per inviare le occorrenze dell'evento a HubSpot.
• Acquisizione dei dati dal tuo sito web senza l'API:
  • Codice JavaScript: utilizzando JavaScript personalizzato, puoi inserire codice personalizzato nello script di tracciamento di HubSpot utilizzando l'editor di codice.
  • Utilizza il visualizzatore di eventi: monitora 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, integrare dati o integrare manualmente qualsiasi strumento con HubSpot.
• Configura i webhook (Data Hub solo Professional ed Enterprise ): personalizza le condizioni che attivano l’invio di un webhook e i dati che verranno inviati. 

Nota: gli eventi creati nello strumento Eventi personalizzati legacy non funzioneranno più dopo il 1° agosto 2025.

Come posso creare eventi personalizzati utilizzando l'API?

Se invii dati a HubSpot tramite API, puoi utilizzarel'opzione Invia tramite API oppure utilizzare l'endpoint Definizione evento personalizzato per creare il tuo evento. Scopri di più su come definire la tua chiamata API nella documentazione per sviluppatori di HubSpot.

Per la chiamata API ti serviranno alcune informazioni, che puoi ottenere dall’interno di HubSpot:

• Nome 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 per l'invio dei dati tramite API:

• Seleziona Invia dati a HubSpot e copia l'ID di tracciamento.
• Fai clic su Crea.

Per trovare il nome interno di un evento esistente e i nomi delle proprietà:

1. Nel tuo account HubSpot, vai suGestione dati>Gestione eventi.
2. Fai clic sul nome dell'evento. Verrai reindirizzato alla pagina dei dettagli dell'evento.
3. Nella parte superiore, individua il nome dell'evento sotto Nome interno. Per copiare il nome interno, clicca sull'icona di copia accanto al nome. 
   
   
   
4. Per trovare i nomi interni delle proprietà che intendi aggiornare, clicca sul nome di una proprietà.
5. Nel pannello di destra, clicca sull'icona del codice, quindi visualizza il nome sotto Nome interno.

Come posso creare eventi personalizzati con il codice JavaScript?

1. Nel tuo account HubSpot, vai suGestione dati>Gestione eventi.
2. In alto a destra, clicca suCrea un evento, quindi seleziona Crea evento personalizzato.
3. SelezionaCodice Javascript.

4. Inserisci un Nome evento e, se lo desideri, aggiungi una descrizione dell'evento.
5. Seleziona un Oggetto associato. Questo ti permette di associare le occorrenze del tuo evento a diversi oggetti in HubSpot, inclusi Contatti, Aziende, Opportunità e Ticket. 

6. Fai clic suAvanti.

Come posso aggiungere proprietà al mio evento?

Quando viene creato un evento, saranno disponibili le proprietà predefinite dell'evento. Puoi anche creare le tue proprietà personalizzate. Le proprietà degli eventi sono memorizzate separatamente dalle altre proprietà del CRM e sono univoche per l'evento (ovvero non puoi modificare queste proprietà dalle impostazioni del tuo account). 

1. Per disattivare la creazione delle proprietà predefinite dell'evento, disattiva l'opzioneProprietà predefinite dell'evento.
2. 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.
3. Dopo aver selezionato la proprietà, configurarla nel pannello a destra:

8. Inserisci un nome per la proprietà e inserisci una Descrizione per la proprietà.
   • Per le proprietà di enumerazione, clicca su Avanti e inserisci le etichette e i valori della tua proprietà.
     • Le proprietà di enumerazione possono essere a selezione singola o multipla. Per abilitare i valori a selezione multipla, attiva l'opzioneSupporta valori multipli.

• • • È necessario impostare i valori e le etichette prima di inviare i dati. Se questo passaggio non viene completato prima di inviare dati che non sono presenti nell'elenco, i dati non saranno disponibili per l'uso. Per inviare più valori tramite API, separali con un punto e virgola.

9. Fare clic su Avanti.
10. Dopo aver configurato l'evento e le relative proprietà, puoi aggiungere questo evento al codice di monitoraggio del tuo sito web selezionando "Snippet di codice JavaScript".
11. Fai clic su "Fatto".

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. 

1. 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. 
2. Modifica il frammento come necessario inserendo il testo nel pannello di destra. Qualsiasi codice aggiunto verrà automaticamente incluso nel tuo codice di monitoraggio HubSpot.
3. Al termine, clicca su Crea per completare l'evento e avviare automaticamente il monitoraggio.
    
   
   

Come posso importare dati di eventi personalizzati da fogli di calcolo?

Carica i dati di partecipazione agli eventi in presenza, i dati con data e ora provenienti da app non integrate con HubSpot, dati una tantum relativi a lead o campagne provenienti da un fornitore o qualsiasi altro dato relativo agli eventi in formato foglio di calcolo. Gli eventi ti consentono di acquisire comportamenti e di utilizzarli in tutto HubSpot. 

Le importazioni possono creare e aggiornare i seguenti record:

• Contatti

• Aziende
• Opportunità
• Biglietti
• Servizi
• Progetti
• Appuntamenti
• Corsi
• Elenchi 
• Ordini
• Oggetti personalizzati

Le proprietà richieste variano in base al tipo di oggetto.

Le importazioni di eventi possono essere utilizzate solo per eventi che si sono già verificati. In un file di importazione di eventi personalizzati devono essere inclusi i seguenti elementi:

• Indirizzo e-mail di contatto.
• Avvenuto alle timestamp. Scopri di più sulla formattazione delle proprietà della data nei file di importazione.

File di esempio

Per importare eventi personalizzati:

1. Nel tuo account HubSpot, passa a Gestione dati > Gestione eventi.
2. In alto a destra, clicca suCrea un evento, quindi selezionaCrea evento personalizzato.
3. SelezionaImporta foglio di calcolo.
4. Fai clic su Crea un nuovo evento o su Importa in un evento esistente.
   • Se selezioni Importa in un evento esistente, utilizza il menu a discesa per scegliere l'evento esistente, quindi procedi con i passaggi per caricare il tuo foglio di calcolo.
   • Se selezioni Crea un nuovo evento, procedi con i passaggi riportati di seguito.
5. Inserisci un Nome evento e, se lo desideri, aggiungi una descrizione dell'evento.
6. Seleziona un oggetto associato. Al momento, gli eventi creati tramite importazione possono essere associati solo ai contatti.
7. Carica il tuo foglio di calcolo o incolla direttamente dal foglio di calcolo. Seleziona come importare gli oggetti e la lingua del file, quindi fai clic su Avanti.
8. Mappa le colonne alle proprietà dell'evento e del contatto, quindi fai clic su Avanti.
9. Conferma il nome del tuo file di importazione.
10. Fai clic sulla casella di controllo per confermare che i contatti si aspettano di ricevere comunicazioni da te e che il tuo file di importazione non include un elenco acquistato. Scopri di più sulla politica di utilizzo accettabile di HubSpot.
11. Seleziona il formato della data della proprietà "Avvenuto il".
12. Fai clic su " Completa importazione".

Come si inviano eventi personalizzati tramite l'endpoint API?

1. Nel tuo account HubSpot, vai suGestione dati>Gestione eventi.
2. In alto a destra, clicca suCrea un evento, quindi selezionaCrea evento personalizzato.
3. SelezionaInvia tramite API.

4. Inserisci un Nome evento e, facoltativamente, fornisci una descrizione dell'evento. 

5. Per aggiungere proprietà personalizzate all'evento:
   • Digita un nomeper la proprietà. Questo nome verrà applicatoanchealnome interno.
   • Fai clic sul menu a discesaTipo di campo e seleziona un tipo di campo.
   • Facoltativamente, aggiungi unadescrizione.
   • Se desideri aggiungere altre proprietà personalizzate, clicca su+ Aggiungi proprietà personalizzata.
   • Fare clic suAvanti.

6. Per collegare gli oggetti:
   • Fai clic sul menu a discesa Seleziona unoggetto principale, quindi seleziona un oggetto associato. Ciò ti consente di associare le occorrenze dei tuoi eventi a diversi oggetti, inclusi contatti, aziende, opportunità e ticket.
   • Fai clic suPersonalizza la corrispondenza e seleziona l'ID di corrispondenza tra i record dell'evento e dell'oggetto. L'evento si collegherà al record dell'oggetto solo quando gli ID di corrispondenza sono identici. Se utilizzi un ID di corrispondenza personalizzato, la proprietà dell'oggetto selezionata deve richiedere valori univoci.
7. Fai clic suAvanti.
8. Per tracciare l'evento in HubSpot, clicca suCopia accanto all'ID di tracciamento.
9. Fai clic suCrea evento.

Come posso creare eventi personalizzati utilizzando i webhook?

Imposta le condizioni che attiveranno un webhook.

1. Nel tuo account HubSpot, vai suGestione dati>Gestione eventi.
2. In alto a destra, clicca suCrea un evento, quindi selezionaCrea evento personalizzato.
3. SelezionaConfigura webhook.
4. Inserisci unNome evento e seleziona unOggetto associato.
5. Fai clic suAvanti.
6. Configura un evento di prova:
   • Copia l'URL del webhook. 
   • Accedi allapagina delle impostazioni dei webhooknell'app di terze parti che desideri integrare.
   • Incolla l'URL copiato.
   • Fai clic su Invia un evento di prova.
7. Fai clic suAvanti.
8. Controlla le proprietà del tuo webhook. Fai clic sul menua discesa Tipo di proprietàper selezionare un tipo di proprietà. 

9. Fai clic suAvanti.
10. Seleziona una proprietà dal tuo webhook di terze parti che corrisponda esattamente a una proprietà di un oggetto HubSpot. 

Dove posso visualizzare e utilizzare i dati degli eventi personalizzati in HubSpot?

I dati degli eventi personalizzati possono essere visualizzati e utilizzati in tutti gli strumenti di HubSpot. Di seguito scoprirai dove visualizzare le occorrenze degli eventi e come incorporare tali dati in altri strumenti.

Puoi aprire gli eventi selezionati direttamente in determinati strumenti di HubSpot tramite il menu a tendina delle azioni nell’elenco degli eventi, nella vista di un singolo evento o nell’angolo in alto a destra dei grafici nella scheda Analizza.

Come posso creare report con i dati degli eventi personalizzati?

Le occorrenze degli eventi personalizzati possono essere analizzate 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 dei tuoi eventi personalizzati.

Come posso esaminare le occorrenze degli eventi sulla timeline del contatto?

Le occorrenze degli eventi appariranno sulla timeline del record del contatto, insieme a tutte le proprietà che sono state compilate.

Per visualizzare i dettagli degli eventi sulla timeline del contatto:

1. Accedi a un record di contatto in cui si è verificato un evento personalizzato.
2. Per filtrare la cronologia di un contatto in base agli eventi verificatisi, clicca su Filtra attività, quindi seleziona Evento personalizzato.
3. Nella timeline del contatto, clicca per espandere l'evento e visualizzarne i dettagli.

Nota: non è possibile visualizzare l'attività della timeline sugli eventi personalizzati creati utilizzando i webhook.

Come si utilizzano gli eventi personalizzati nei flussi di lavoro?

In un flusso di lavoro, è possibile ritardare l'esecuzione in base alle occorrenze di eventi personalizzati utilizzando un Ritarda fino a quando non si verifica l'evento o o un trigger di iscrizione all'evento.

1. Nel tuo account HubSpot, passa a Automazione > Flussi di lavoro.
2. Fai clic sul nome di un flusso di lavoro. Oppure scopri come creare un nuovo flusso di lavoro.
3. Per aggiungere un trigger:
   • Nell'editor del flusso di lavoro, clicca su Configura trigger.
   • Nel pannello di sinistra, seleziona Quando si verifica un evento. Configura il trigger, quindi clicca su Applica filtro.
   • Per perfezionare ulteriormente il trigger, clicca 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 inseriti in un flusso di lavoro solo la prima volta che soddisfano i trigger di inserimento. Per abilitare il reinserimento, nella sezione [Oggetto] deve essere reinserito in questo flusso di lavoro?, seleziona Sì, reinserisci ogni volta che si verifica il trigger.
4. Per aggiungere un ritardo:
   • Nell'editor del flusso di lavoro, fare clic sull'icona + per aggiungere un'azione del flusso di lavoro.
   • Nel pannello di destra, seleziona Ritarda fino al verificarsi dell'evento.
   • Configurare il ritardo:
     • Fai clic sul menu a discesa Evento, quindi seleziona un evento personalizzato.
     • Quindi, seleziona la proprietà dell'evento su cui desideri applicare il ritardo.
     • Seleziona il filtro per la proprietà dell'evento.
     • Fai clic su Applica filtro.
   • • Seleziona il tempo di attesa massimo oppure seleziona la casella di controllo Ritarda il più a lungo possibile .
5. Fai clic su Salva.

Nota:tutti i trigger di iscrizione all'evento saranno separati utilizzando l'operatore OR. Ciò significa che deve verificarsi solo uno dei trigger di iscrizione all'evento affinché il record venga iscritto al flusso di lavoro.

Il flusso di lavoro ritarderà quindi i record inseriti finché non soddisferanno i criteri specificati per l'evento personalizzato oppure verrà attivato quando si verificherà l'evento.

Come posso gestire e monitorare lo stato dei miei eventi personalizzati e controllare gli errori di consegna?

Per garantire che i dati rimangano accurati e che le integrazioni funzionino come previsto, è possibile utilizzare la scheda Monitor all'interno dello strumento Gestione eventi.

Come posso monitorare le prestazioni nello strumento di gestione degli eventi personalizzati?

• Andamento dei completamenti: Nel tuo account HubSpot, passa a Gestione dati > Gestione eventi. Fare clic sulla scheda Monitor per confrontare i volumi di completamento degli eventi in diversi periodi di tempo.

• Risoluzione degli errori di consegna: Nel tuo account HubSpot, passa a Gestione dati > Gestione eventi. Nella barra laterale sinistra della scheda Monitor, seleziona Errori di consegna. Questa tabella identifica gli eventi la cui sincronizzazione non è andata a buon fine e fornisce il motivo specifico dell'errore (ad es. tipi di dati non corrispondenti o violazioni dello schema).

Come posso risolvere gli errori "Proprietà sconosciuta" nello strumento di gestione degli eventi personalizzati?

Se i dati vengono inviati tramite API per una proprietà che non è mai stata definita in HubSpot, questa apparirà nel registro degli errori. Puoi risolvere rapidamente questo problema:

1. Passa il mouse sull'evento nella tabella Registri degli errori.

2. Fai clic su Azioni, quindi selezionaAggiungi proprietà all'evento.

3. Conferma i tipi di campo suggeriti per consentire a HubSpot di iniziare ad accettare immediatamente quei dati.