L'invio di eventi con JavaScript è uno dei modi più diffusi e flessibili per tracciare il comportamento dei contatti in Positive User. Puoi utilizzarlo per registrare clic, acquisti, invii di form o qualsiasi altra azione importante compiuta sul tuo sito web. Questi eventi possono poi alimentare automazioni, segmentazioni, statistiche e comunicazioni personalizzate.
Se vuoi prima comprendere il concetto alla base degli eventi, consulta: "Cos'è un evento".
Puoi inviare un evento associandolo direttamente a un'azione sul tuo sito web, come il clic su un pulsante. Quando l'azione si verifica, l'evento viene inviato a Positive User.
Esempio:
<a href="#" onclick="userengage('event.name_your_event_here')">CLICK ME!</a> Puoi arricchire gli eventi aggiungendo campi come secondo parametro.
Esempio con un solo campo:
<a href="#" onclick="userengage('event.name_your_event_here', {'price': '10'})">CLICK ME!</a>Se devi inviare più campi, passali come un oggetto.
Esempio con più campi:
<a href="#" onclick="userengage('event.name_your_event_here', {'sku': '7', 'size': '39', 'color': 'teal', 'price': '39'})">CLICK ME!</a>Prima di inviare eventi con campi, assicurati che tutti i campi degli eventi siano stati creati in Positive User con i tipi di campo corretti. In caso contrario, tutti i campi in arrivo verranno trattati come stringhe (tranne JSON). Questo può limitare le opzioni di filtro e ridurre le possibilità di automazione.
Consulta le istruzioni su come creare i campi.
Esempio:
<a href="#" onclick="userengage('event.purchase_details', { 'sku': 7, 'size': 39, 'color': 'teal', 'price': 39 })"/>In questo esempio, solo "color" è una stringa. I campi restanti vengono inviati come numeri, corrispondendo ai tipi previsti.
È molto importante scegliere il tipo di campo corretto. Una volta creato un campo, non potrai più modificarne il tipo in seguito.
Qui sotto trovi tutti i possibili tipi di campi eventi, con descrizioni ed esempi.
Tipo | Descrizione | Esempio |
Stringa | Qualsiasi stringa di caratteri limitata a 255 elementi. È perfetta per informazioni testuali, come nomi, indirizzi email o qualsiasi altro dato testuale | Campo "Piano di abbonamento", valore "Standard" |
Booleano | Rappresenta opzioni binarie (true/false) | Campo "Consenso marketing", valore "True" |
Datetime | Campo per memorizzare dettagli temporali specifici come informazioni di iscrizione o ultima attività. Richiede il formato ISO 8601 | Campo "Last seen", valore "2016-08-03 12:00:00+00:00" |
Formato file JSON | Funziona per valori più lunghi che non possono essere inseriti in altri formati di dati | Campo "Informazioni aggiuntive sull'ordine", valore (oggetto JSON valido): "key": "value" |
Numero | Questo campo è utilizzato specificamente per i campi degli eventi. Copre sia le opzioni di numeri interi che di numeri in virgola mobile | Campo "Punti raccolti", valore "15" |
Una volta inviati i dati all'applicazione Positive User, puoi verificarli in due punti:
Profilo del contatto (nella sezione "Eventi")
"Impostazioni" → "Impostazioni workspace" → "Contact Data & Events" → "Eventi" (clicca sul nome dell'evento per controllare i log)
Esempio:
