Salta al contenuto
Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

Creare eventi comportamentali personalizzati con la procedura guidata del codice

Ultimo aggiornamento: giugno 21, 2023

Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:

Marketing Hub Enterprise

Gli eventi comportamentali personalizzati consentono di definire e tracciare eventi unici per la vostra azienda. Gli eventi comportamentali personalizzati possono essere legati alle proprietà degli eventi, che possono essere utilizzate in tutti gli strumenti di HubSpot. Gli eventi creati con lo "snippet di codice Javascript" aggiungono automaticamente i dati dell'evento al codice di tracciamento HubSpot del vostro sito e richiedono una certa familiarità con Javascript per essere impostati. Gli eventi tracciati manualmente utilizzano l'API di analytics e richiedono uno sviluppatore per essere impostati.

Scoprite come utilizzare lo strumento degli eventi comportamentali personalizzati per creare eventi relativi agli elementi cliccati e agli URL visitati.

Nota bene: lo strumento per gli eventi comportamentali personalizzati sostituisce il precedente strumento legacy per gli eventi comportamentali. Tutti gli eventi creati nello strumento precedente continueranno a funzionare e sarà possibile gestirli e analizzarli nello strumento precedente.

Il processo di creazione degli eventi si articola in due parti:

  • Definizione dell'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 l'evento in HubSpot

Per impostare un evento comportamentale personalizzato, occorre innanzitutto creare l'evento, quindi associare le proprietà all'evento:

  • Nel tuo account HubSpot, vai a Rapporti > Strumenti di analisi dati.
  • Fare clic su Eventi comportamentali personalizzati.
  • In alto a destra, fare clic su Crea evento personalizzato.
  • Selezionare Codice guidato.

  • Immettere un nome per l'evento e fornire una descrizione opzionale dell'evento.
  • Nel menu a discesa, selezionare l'oggetto associato. Questo consente di associare i completamenti degli eventi a diversi oggetti di HubSpot, tra cui Contatti, Aziende, Offerte e Biglietti.

name-custom-behavioral event

  • Fare clic su Avanti per continuare.

Aggiungere le proprietà dell'evento

Quando si crea un evento, sono disponibili le proprietà predefinite dell'evento. È inoltre possibile creare proprietà personalizzate. Le proprietà dell'evento sono memorizzate separatamente dalle altre proprietà del CRM e sono uniche per l'evento (cioè non possono essere modificate dalle impostazioni dell'account).

Per creare proprietà per un evento:

  • 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. I dati devono essere inviati sotto forma di millisecondi o ISO8601.
    • Proprietà enumerativa personalizzata: creare una proprietà con un insieme di valori predefiniti.

      create-property-custom-behavioral-event
    • Una volta selezionata la proprietà, configurarla nel pannello di destra:

    • 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à. È 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, separarli con un punto e virgola.
    • Fare clic su Fine.
    • Una volta creata la proprietà, questa apparirà nella tabella delle proprietà predefinite di HubSpot. È possibile modificare o eliminare la proprietà selezionando il menu a tendina Azioni e scegliendo Modifica o Elimina.
  • Fare clic su Avanti.
  • 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, oppure inviare i dati a HubSpot tramite API selezionando Invia dati a HubSpot.

Creare uno snippet di codice Javascript

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 tracciamento 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.
    example-code-snippet-custom-event

Inviare i dati a HubSpot

Se si inviano dati a HubSpot, è necessario definire la chiamata API per attivare l'evento. Per sapere come definire la chiamata API, consultate 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à:

  • Nel tuo account HubSpot, vai a Rapporti > Strumenti di analisi dati.
  • Fare clic su Eventi comportamentali personalizzati.
  • Fare clic sul nome dell'evento. Si accede alla pagina dei dettagli dell'evento.
  • In alto, individuare il nome dell'evento sotto Nome interno.
    internal-name-custom-event
  • 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.
Nota bene:
Quando si inviano dati all'evento, si applicano i limiti indicati di seguito:
  • I nomi delle proprietà sono limitati a 50 caratteri.
  • Le proprietà URL e referente possono ricevere fino a 1024 caratteri, mentre tutte le altre proprietà possono ricevere fino a 256 caratteri.
  • Ogni completamento 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 a-z, numeri 0-9 e trattini bassi. Le proprietà con lo stesso nome interno dopo la minuscola sono considerate duplicati e solo una delle proprietà sarà utilizzata nel completamento.
Se questi limiti vengono superati quando si effettua una richiesta API HTTP, la richiesta fallisce. Se questi limiti vengono superati quando si effettua una richiesta API JS, HubSpot troncherà i valori dei nomi delle proprietà alla lunghezza consentita e/o aggiornerà solo 50 proprietà per ogni completamento dell'evento.

Utilizzare i dati degli eventi comportamentali personalizzati

I dati degli eventi comportamentali 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 tali dati in altri strumenti.

Report sugli eventi personalizzati

I completamenti degli eventi comportamentali personalizzati possono essere analizzati dallo strumento degli eventi comportamentali 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 comportamentali personalizzati.

Visualizzazione del completamento degli eventi nella timeline dei contatti

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

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

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

Utilizzare gli eventi comportamentali personalizzati nei flussi di lavoro

In un flusso di lavoro, è possibile ritardare in base al completamento di eventi comportamentali personalizzati utilizzando l' azioneRitarda finché non si verifica l'evento:

  • Nel tuo account HubSpot, vai a Automazione > Flussi di lavoro.
  • Fare clic sul nome di un flusso di lavoro. Oppure, imparare a creare un nuovo flusso di lavoro.
  • Nell'editor del flusso di lavoro, fare 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 comportamentale 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 .
  • Fare clic su Salva.

Il flusso di lavoro ritarderà i record iscritti finché non soddisfano i criteri dell'evento comportamentale personalizzato specificato.

L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.