Creare eventi personalizzati

Gli eventi personalizzati consentono di definire e tracciare eventi unici per la vostra azienda. Gli eventi personalizzati possono essere legati alle proprietà dell'evento, che possono essere utilizzate in tutti gli strumenti di HubSpot.

Esistono diversi modi per creare eventi personalizzati:

• Invio tramite API: utilizzare l'endpoint Definizione evento personalizzato per creare l'evento. Da lì, utilizzare l'ID dell'evento con l'endpoint Invia evento personalizzato per inviare i completamenti dell'evento a HubSpot.
• Acquisizione di dati dal vostro sito web senza API:
  • Codice Javascript: utilizzando Custom Javascript, è possibile inserire codice personalizzato nello script di tracciamento di HubSpot utilizzando l'editor di codice.
  • Utilizzare il visualizzatore di eventi (solo perMarketing Hub Enterprise ): tracciare le visualizzazioni delle pagine o gli elementi cliccati selezionandoli sul vostro sito web. Per saperne di più sulla creazione di eventi personalizzati con il Visualizzatore eventi.
• Importazione di un foglio di calcolo: carica un foglio di calcolo con i dati degli eventi per catturare le attività offline, per ricaricare i dati o per integrare manualmente qualsiasi strumento con HubSpot.
• Impostazione di webhook (soloData Hub Professional ed Enterprise): personalizzare le condizioni che attivano un webhook e i dati che verranno inviati.

Nota bene: tutti gli eventi creati con il precedente strumento Eventi personalizzati non funzioneranno più dopo il 1° agosto 2025.

Il processo di creazione di un evento si articola in due parti:

• Definire l'evento in HubSpot, comprese le proprietà personalizzate dell'evento.
• Creare uno snippet di codice Javascript o definire la chiamata API che attiverà l'evento.

Creare un evento tramite API

Se si inviano dati a HubSpot tramite API, è possibile utilizzare l'opzione Invia tramite API o utilizzare l'endpoint Definizione evento personalizzato per creare l'evento. Per saperne di più sulla definizione della chiamata API, consultare la documentazione per sviluppatori di HubSpot.

Per la chiamata API sono necessarie alcune informazioni, che si possono ottenere dall'interno di HubSpot:

• Nome dell'evento: il nome interno dell'evento.
• Nomi delle proprietà: i nomi interni delle proprietà a cui inviare i dati.

Per terminare la creazione dell'evento per l'invio dei dati tramite API:

• Selezionare Invia dati a HubSpot e copiare l'ID di tracciamento.
• Fare clic su Crea.

Per trovare il nome interno dell'evento per un evento esistente e i nomi delle proprietà:

1. Fare clic sul nome dell'evento. Verrà visualizzata la pagina dei dettagli dell'evento.
2. Nella parte superiore, individuare il nome dell'evento sotto Nome interno. Per copiare il nome interno, fare clic sull'icona di copia accanto al nome.
   
   
3. Per trovare i nomi interni delle proprietà da aggiornare, fare clic sul nome di una proprietà.
4. Nel pannello di destra, fare clic sull'icona del codice, quindi visualizzare il nome sotto Nome interno.

Creare eventi con uno snippet di codice Javascript

1. Nel vostro account HubSpot, andate su Gestione dati > Gestione eventi.
2. In alto a destra, fare clic su Crea un evento.
3. Selezionare Codice Javascript.

4. Inserire un nome per l'evento e fornire una descrizione opzionale dell'evento.
5. Selezionare un oggetto associato. Questo consente di associare i completamenti degli eventi a diversi oggetti di HubSpot, tra cui Contatti, Aziende, Offerte e Biglietti.

6. Fare clic su Avanti.

Aggiungere proprietà

Quando viene creato un evento, sono disponibili le proprietà predefinite dell'evento. È anche possibile creare proprietà personalizzate. Le proprietà dell'evento sono memorizzate separatamente dalle altre proprietà del CRM e sono uniche per l'evento (cioè non è possibile modificare queste proprietà dalle impostazioni dell'account).

1. Nel vostro account HubSpot, andate su Gestione dati > Gestione eventi.
2. In alto a destra, fare clic su Crea un evento.
3. Selezionare Codice Javascript.
4. Inserire un nome per l'evento e, facoltativamente, fornire una descrizione dell'evento.
5. Per disattivare la creazione di proprietà predefinite dell'evento, impostare su off la voce Proprietà predefinite dell'evento.
6. Per creare proprietà personalizzate, selezionare il tipo di proprietà facendo clic sul tipo di campo della proprietà. Le opzioni includono:
   • Proprietà stringa personalizzata: crea una proprietà che è una stringa di testo semplice.
   • Proprietà numero personalizzata: crea una proprietà che è un valore numerico.
   • Proprietà timestamp personalizzata: crea una proprietà che è un valore di data. È necessario inviare i dati sotto forma di millisecondi di epoca o ISO8601.
   • Proprietà data personalizzata: creare una proprietà che sia un valore di data.
   • Proprietà booleana personalizzata: creare una proprietà che sia un valore booleano.
   • Proprietà enumerativa personalizzata: creare una proprietà con un insieme di valori predefiniti.
7. Una volta selezionata la proprietà, configurarla nel pannello di destra:

8. Inserire un nome per la proprietà e una Descrizione per la proprietà.
   • Per le proprietà 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, attivare la levetta Supporto valori multipli.

• • • È 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 via API, separarli con un punto e virgola.

9. Fare clic su Avanti.
10. Dopo aver impostato l'evento e le sue proprietà, è possibile aggiungere questo evento al codice di monitoraggio del sito web selezionando lo snippet di codice Javascript.
11. Fare clic su Fatto.

La creazione di eventi con uno snippet di codice Javascript consente di aggiungere automaticamente Javascript al codice di monitoraggio di HubSpot. Questo può essere utilizzato per catturare dati di eventi più complessi che il codice di monitoraggio non cattura per impostazione predefinita.

• Selezionare lo snippet di codice Javascript. Utilizzare lo snippet nel pannello di destra per tracciare l'evento in HubSpot. Le proprietà personalizzate create saranno predefinite all'interno dello snippet di codice.
• Modificare lo snippet come necessario inserendo il testo nel pannello di destra. Il codice aggiunto sarà automaticamente incluso nel codice di tracciamento di HubSpot.
• Al termine, fare clic su Crea per completare l'evento e avviare automaticamente il tracciamento.
  

Importare i dati degli eventi

Caricate i dati di presenza da eventi personali, i dati con data e ora provenienti da applicazioni non integrate con HubSpot, i dati di un singolo lead o di una campagna da un fornitore o qualsiasi altro dato di un evento in forma di foglio di calcolo. Gli eventi consentono di acquisire il comportamento e di utilizzarlo in tutto HubSpot.

• Indirizzo e-mail del contatto.
• Si è verificato alla data. Per saperne di più sulla formattazione delle proprietà della data nei file di importazione.

File di esempio

Per importare eventi personalizzati:

1. Nel vostro account HubSpot, andate su Gestione dati > Gestione eventi.
2. In alto a destra, fare clic su Crea un evento.
3. Selezionare Importa foglio di calcolo.

4. Inserire un nome per l'evento e, facoltativamente, una descrizione dell'evento.
5. Selezionare un oggetto associato. Al momento, gli eventi creati tramite importazione possono essere associati solo ai contatti.

6. Caricare il file. Selezionare la modalità di importazione degli oggetti e la lingua del file, quindi fare clic su Avanti.
7. Mappare le colonne alle proprietà degli eventi e dei contatti, quindi fare clic su Avanti.
8. Confermare il nome del file di importazione.
9. fare clic sulla casella di controllo per accettare che i contatti si aspettino di essere contattati e che il file di importazione non includa un elenco acquistato. Per saperne di più sulla politica di utilizzo accettabile di HubSpot.
10. Selezionare il formato della data della proprietà Occurred at.
11. Fare clic su Termina importazione.

Creare eventi tramite API

1. Nel vostro account HubSpot, andate su Gestione dati > Gestione eventi.
2. In alto a destra, fare clic su Crea un evento.
3. Selezionare Invia tramite API.

4. Inserire un nome per l'evento e, facoltativamente, fornire una descrizione dell'evento.

5. Per aggiungere proprietà personalizzate all'evento:
   • Digitare il nome della proprietà. Questo nome verrà applicato anche al nome interno .
   • Fare clic sul menu a discesa Tipo di campo e selezionare un tipo di campo.
   • Aggiungere facoltativamente una descrizione.
   • Se si desidera aggiungere altre proprietà personalizzate, fare clic su + Aggiungi proprietà personalizzata.
   • Fare clic su Avanti.

6. Per collegare gli oggetti:
   • Fare clic sul menu a discesa Seleziona unoggetto primario, quindi selezionare un oggetto associato. In questo modo è possibile associare i completamenti degli eventi a diversi oggetti, tra cui contatti, aziende, offerte e biglietti.
   • Fare clic su Personalizza la corrispondenza e selezionare l'ID di corrispondenza tra i record dell'evento e dell'oggetto. L'evento si collegherà al record dell'oggetto solo se gli ID corrispondenti sono identici. Se si utilizza un ID di corrispondenza personalizzato, la proprietà dell'oggetto selezionata deve richiedere valori univoci.
7. Fare clic su Avanti.
8. Per tracciare l'evento in HubSpot, fare clic suCopia accanto all'ID di tracciamento.
9. Fare clic su Crea evento.

Impostare i webhook

Impostare le condizioni che attivano un webhook.

1. Nel vostro account HubSpot, andate su Gestione dati > Gestione eventi.
2. In alto a destra, fare clic su Crea un evento.
3. Selezionare Imposta webhook.
4. Immettere il nome dell'evento e selezionare un oggetto associato.

5. Fare clic su Avanti.
6. Impostare un evento di prova:
   • Copiare l'URL del webhook.
   • Accedere alla pagina delle impostazioni del webhook nell'applicazione di terze parti con cui si desidera effettuare l'integrazione.
   • Incollare l'URL copiato.
   • Fare clic su Invia un evento di prova.
7. Fare clic su Avanti.
8. Esaminare le proprietà del webhook. Fare clic sul menu a discesa Tipo di proprietà per selezionare un tipo di proprietà.

9. Fare clic su Avanti.
10. Selezionare una proprietà del webhook di terze parti che corrisponda esattamente a una proprietà dell'oggetto HubSpot.

Utilizzare i dati degli eventi personalizzati

I dati degli eventi personalizzati possono essere visualizzati e utilizzati in tutti gli strumenti di HubSpot. Di seguito, vi spieghiamo dove visualizzare le compilazioni degli eventi e i modi in cui potete incorporare questi dati in altri strumenti.

È possibile aprire gli eventi selezionati direttamente in alcuni strumenti di HubSpot con il menu a tendina delle azioni nell'elenco degli eventi, nella vista del singolo evento o nell'angolo superiore destro dei grafici nella scheda Analizza.

Report sugli eventi personalizzati

I completamenti degli eventi personalizzati possono essere analizzati dallo strumento eventi personalizzati e i dati degli eventi saranno disponibili anche nel costruttore di report personalizzati e nei report di attribuzione.

Per saperne di più sull'analisi degli eventi personalizzati.

Visualizzazione del completamento degli eventi nella timeline dei contatti

Il completamento dell'evento viene visualizzato nella timeline del record del contatto, insieme a tutte le proprietà che sono state popolate.

Per visualizzare i dettagli dell'evento sulla timeline del contatto:

1. Passare a un record di contatto che ha completato un evento personalizzato.
2. Per filtrare la timeline di un contatto in base agli eventi completati, fare clic su Filtra attività, quindi selezionare Evento personalizzato.
3. Nella timeline del contatto, fare clic per espandere l'evento e visualizzarne i dettagli.

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

Utilizzare gli eventi personalizzati nei flussi di lavoro

In un flusso di lavoro, è possibile ritardare in base al completamento di eventi personalizzati utilizzando un' azioneRitarda finché non si verifica l'evento o un trigger di iscrizione all'evento.

1. Fare clic sul nome di un flusso di lavoro. Oppure, imparare a creare un nuovo flusso di lavoro.
2. Per aggiungere un trigger:
   • Nell'editor del flusso di lavoro, fare clic su Imposta trigger.
   • Nel pannello di sinistra, selezionare Quando si verifica un evento. Impostate il trigger, quindi fate clic su Applica filtro.
   • Per affinare ulteriormente il trigger, fare clic su Aggiungi filtri di affinamento. È possibile selezionare altre proprietà per affinare gli oggetti da iscrivere al flusso di lavoro.
   • Per impostazione predefinita, i record vengono iscritti in un flusso di lavoro solo la prima volta che soddisfano i trigger di iscrizione. Per abilitare la reiscrizione, nella sezione L'oggetto deve essere reiscritto in questo flusso di lavoro? selezionare Sì, reiscrizione ogni volta che si verifica il trigger.
3. Per aggiungere un ritardo:
   • Nell'editor del flusso di lavoro, fate clic sull'icona + più per aggiungere un'azione del flusso di lavoro.
   • Nel pannello di destra, selezionare Ritarda fino al verificarsi dell'evento.
   • Configurare il ritardo:
     • Fare clic sul menu a discesa Evento, quindi selezionare un evento personalizzato.
     • Quindi, selezionare la proprietà dell'evento che si desidera ritardare.
     • Selezionare il filtro per la proprietà dell'evento.
     • Fare clic su Applica filtro.
   • • Selezionare il tempo di attesa massimo o la casella di controllo Ritarda il più a lungo possibile .
4. Fare clic su Salva.

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

Il flusso di lavoro ritarderà quindi i record iscritti finché non soddisfano i criteri dell'evento personalizzato specificato o verrà attivato quando si verifica l'evento.