Creare eventi personalizzati

Gli eventi personalizzati consentono di definire e tracciare eventi unici per la propria azienda. Gli eventi personalizzati possono essere legati a 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 eventi personalizzati 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 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 (soloMarketing Hub Enterprise ): tracciare le visualizzazioni di pagina o gli elementi cliccati selezionandoli sul sito web. Per saperne di più sulla creazione di eventi personalizzati con il Visualizzatore eventi.
• Importazione di un foglio di calcolo: caricate un foglio di calcolo con i dati degli eventi per catturare attività offline, per ricaricare i dati o per integrare manualmente qualsiasi strumento con HubSpot.
• Impostazione di webhook (soloOperations Hub Professional e Enterprise): personalizzare le condizioni di attivazione di un webhook e i dati da inviare.

Nota bene: lo strumento Eventi personalizzati sostituisce il precedente strumento Eventi legacy. Gli eventi creati nello strumento precedente continueranno a funzionare e sarà ancora possibile gestirli e analizzarli nello strumento precedente.

Il processo di creazione dell'evento prevede due parti:

• Definizione dell'evento in HubSpot, comprese eventuali proprietà personalizzate dell'evento.
• Creare un frammento di codice Javascript o definire la chiamata API che attiverà l'evento.

Creazione di un evento tramite API

Se si inviano dati a HubSpot tramite API, è possibile utilizzare l'opzione Invia tramite API o utilizzare l'endpoint Definizione eventi personalizzati 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 si invieranno i dati.

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

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

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

• Nel tuo account HubSpot, passa a Gestione dei dati > Eventi personalizzati.
• Fare clic sul nome dell'evento. Si accede così alla pagina dei dettagli dell'evento.
• Nella parte superiore, individuare il nome dell'evento sotto Nome interno.
  
  

• Per trovare i nomi interni delle proprietà da aggiornare, fare clic sul nome di una proprietà.
• Nel pannello di destra, fare clic sull'icona del codice, quindi visualizzare il nome in Nome interno.

Creare eventi con un frammento di codice Javascript

• Nel tuo account HubSpot, passa a Gestione dei dati > Eventi personalizzati.
• In alto a destra, fare clic su Evento.
• Selezionare Codice Javascript.

• Inserire il nome dell'evento e fornire una descrizione facoltativa.
• Selezionare un Oggetto associato. In questo modo è possibile associare i completamenti degli eventi a diversi oggetti di HubSpot, tra cui Contatti, Aziende, Trattative e Ticket.

• Fare clic su Avanti.

Aggiungi proprietà

Quando si crea 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 modificarle dalle impostazioni dell'account).

• Per disattivare la creazione delle proprietà predefinite degli eventi, impostare su off l'opzione Proprietà predefinite degli eventi.
• 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.

• Una volta selezionata la proprietà, configurarla nel pannello di destra:

• Inserire un nome per la proprietà e una descrizione per la stessa.
  • 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 tramite API, separarli con un punto e virgola.

• Fare clic su Avanti.
• Dopo aver impostato l'evento e le sue proprietà, è possibile aggiungere questo evento al codice di tracciamento del sito web selezionando il frammento di codice Javascript.
• Fare clic su Fine.

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

• Selezionare il frammento di codice Javascript. Utilizzare il frammento nel pannello di destra per tracciare l'evento in HubSpot. Le proprietà personalizzate create saranno predefinite nel frammento di codice.
• Modificare il frammento 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.
  

Importazione dei dati degli eventi

Caricate i dati di partecipazione agli eventi di persona, i dati con data e ora provenienti da app non integrate con HubSpot, i dati di lead o campagne di un fornitore o qualsiasi altro dato relativo a un evento in forma di foglio elettronico. Gli eventi consentono di catturare il comportamento e di utilizzarlo in tutto HubSpot.

• Indirizzo e-mail di contatto.
• Si è verificato al timestamp. Ulteriori informazioni sulla formattazione delle proprietà della data nei file di importazione.

File di esempio

Per importare eventi personalizzati:

• Nel tuo account HubSpot, passa a Gestione dei dati > Eventi personalizzati.

• In alto a destra, fare clic su Crea un evento.
• Selezionare Importazione di un foglio di calcolo.

• Inserire il nome dell'evento e fornire una descrizione facoltativa.
• Selezionare un Oggetto associato. Al momento, gli eventi creati tramite importazione possono essere associati solo ai contatti.

• Caricare il file. Selezionare la modalità di importazione degli oggetti e la lingua del file, quindi fare clic su Avanti.

• Mappare le colonne alle proprietà del contatto e dell'evento, quindi fare clic su Avanti.

• Confermare il nome del file di importazione.
• cliccate sulla casella di controllo per accettare che i contatti si aspettino di essere contattati e che il file di importazione non includa elenchi acquistati. Per saperne di più sulla Politica di utilizzo accettabile di HubSpot.
• Selezionare il formato della data della proprietà Occorso in.
• Fare clic su Termina importazione.

Creazione di eventi tramite API

• Nel tuo account HubSpot, passa a Gestione dei dati > Eventi personalizzati.
• In alto a destra, fare clic su Evento.
• Selezionare Invia tramite API.

• Inserite il nome dell'evento e, facoltativamente, la sua descrizione. Fare clic su Avanti.
• Aggiungere le proprietà seguendo i follower. Assicurarsi di creare una proprietà personalizzata dell'evento per rappresentare l'ID corrispondente. Fare clic su Avanti.
• 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, trattative e Ticket.
  • Fare clic su Personalizza la corrispondenza e selezionare l'ID di corrispondenza tra i record dell'evento e dell'oggetto. L'evento sarà collegato al record dell'oggetto solo se gli ID di corrispondenza sono identici. Se si utilizza un ID di corrispondenza personalizzato, la proprietà dell'oggetto selezionata deve richiedere valori unici.
• Fare clic su Avanti.

Impostazione dei webhook

Impostare le condizioni di attivazione di un webhook.

• Nel tuo account HubSpot, passa a Gestione dei dati > Eventi personalizzati.
• In alto a destra, fare clic su Evento.
• Selezionare Imposta webhook.
• Inserire il nome dell'evento e selezionare un oggetto Associare.

• Fare clic su Avanti.
• Impostare un evento di prova:
  • Copiare l'URL del webhook.
  • Andare alla pagina delle impostazioni del webhook nell'app di terze parti con cui si desidera integrarsi.
  • Incollare l'URL copiato.
  • Fare clic su Invia un evento di prova.
• Fare clic su Avanti.
• Recensione delle proprietà del webhook. Fare clic sul menu a discesa Tipo di proprietà per selezionare un tipo di proprietà.

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

Utilizzo di dati di eventi personalizzati

I dati degli eventi personalizzati possono essere visualizzati e utilizzati in tutti gli strumenti di HubSpot. Di seguito, scoprirete dove visualizzare i completamenti degli eventi e i modi in cui è possibile 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 in alto a destra dei grafici nella scheda Analizza.

Creazione di rapporti su eventi personalizzati

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

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

Visualizzazione del completamento degli eventi sulla cronologia dei contatti

Il completamento dell'evento viene visualizzato nella cronologia del record del contatto, insieme alle proprietà che sono state popolate.

Per visualizzare i dettagli dell'evento sulla cronologia dei contatti:

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

Utilizzo di eventi personalizzati nei flussi di lavoro

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

• Nel tuo account HubSpot, passa a Automazione > Flussi di lavoro.
• Fare clic sul nome di un flusso di lavoro. Oppure, imparare a creare un nuovo flusso di lavoro.
• Per aggiungere un'attivazione:
  • Nell'editor del flusso di lavoro, fare clic su Imposta attivazione.
  • Nel pannello di sinistra, selezionare Evento. Impostate l'attivazione, quindi fate clic su Applica filtro.
  • Per affinare ulteriormente l'attivazione, 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 si iscrivono a un flusso di lavoro solo la prima volta che soddisfano i trigger di attivazione. Per abilitare l'attivazione di nuova iscrizione, nella sezione Dovrebbe [oggetto] essere iscritto nuovamente in questo flusso di lavoro? selezionare Sì, per iscriversi ogni volta che si verifica l'attivazione di nuova iscrizione.
• 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 Ritardo 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 su cui si desidera effettuare il ritardo.
    • Selezionare il filtro per la proprietà dell'evento.
    • Fare clic su Applica filtro.
  • • Selezionare il tempo di attesa massimo o la casella di controllo Ritardo massimo .
• Fare clic su Salva.

Nota: tutte le attivazioni dell'iscrizione agli eventi vengono separate con l'operatore OR. Ciò significa che solo una delle attivazioni dell'iscrizione all'evento deve verificarsi affinché il record si iscriva al flusso di lavoro.

Il Flussi di lavoro ritarda le iscrizioni fino a quando non soddisfano i criteri dell'evento personalizzato specificato o viene attivato quando si verifica l'evento.