Eventi personalizzati

Tutto ciò a cui puoi collegare un gestore di clic può diventare un evento.

window.seean.track("signup");
window.seean.track("download", { file: "pricing.pdf" });

Gli eventi compaiono nella Panoramica (scheda Eventi), nel registro attività degli eventi, nei funnel come passi e nei report delle campagne quando corrispondono agli obiettivi di conversione attivi (oppure tutti gli eventi personalizzati quando nessun obiettivo è attivo). Le proprietà vengono inviate con l’evento, ma la tabella attuale del registro attività non le mostra.

Nomi

Usa nomi brevi e stabili: signup, cta_click, newsletter_signup. Rinominare in seguito divide la cronologia.

Caricare prima di chiamare

Chiama track dopo che lo script del tracker generato è stato eseguito. Non esiste una coda integrata per le chiamate fatte prima del caricamento. Per HTML semplice, posiziona lo script differito della tua applicazione dopo lo script differito di Seean; per un framework, segui la sua guida di installazione.

Per un pulsante di download, collega il gestore dopo che il pulsante esiste:

document.querySelector("#download-pricing")?.addEventListener("click", () => {
  window.seean?.track("download", { file: "pricing.pdf" });
});

Questo conta il clic, non la prova che il download sia terminato. L’optional chaining evita un’eccezione quando il tracker non è disponibile, ma non salva né ritenta l’evento. Un visitatore ignorato può avere metodi del tracker che non fanno nulla, quindi la sola presenza di window.seean non è prova di raccolta.

Per un modulo, chiama il tracker nel percorso di invio riuscito che hai già:

// After your server has confirmed the newsletter signup succeeded:
window.seean?.track("newsletter_signup", { form: "footer" });

Non inviare questo evento di successo anche dal clic sul pulsante di invio: la validazione o la richiesta possono fallire e collegare entrambi conterebbe due volte gli invii riusciti. Mantieni la normale validazione e gestione degli errori del tuo modulo.

Clic e moduli dichiarativi

Aggiungi data-seean-event="signup" a un pulsante o a un link per inviare quell’evento al clic, inclusi i clic sui suoi elementi annidati. Su un modulo, l’attributo invia all’invio del modulo invece che ai clic sui suoi campi. Gli elementi dinamici funzionano grazie a listener delegati. I preset di conversione automatici saltano gli elementi marcati per evitare doppi conteggi; non chiamare anche seean.track() per la stessa azione. Gli attributi dichiarativi non richiedono l’attivazione data-conversions. I nomi devono essere non vuoti, di al massimo 64 caratteri e diversi da pageview.

<button data-seean-event="download" data-seean-event-source="footer">Download</button>
<form data-seean-event="contact_submit">…</form>

Aggiungi data-seean-event-PROPERTY="value" allo stesso elemento marcato per inviare una proprietà. L’esempio sopra invia { "source": "footer" }. I valori degli attributi restano stringhe ("2" non è il numero 2); l’HTML normalizza i nomi degli attributi in minuscolo. Vengono letti solo gli attributi con prefisso esplicito su quell’elemento. Le proprietà su antenati o figli, i valori dei campi del modulo e gli attributi non correlati non vengono raccolti. Cambiare un attributo prima di un’interazione successiva usa il nuovo valore.

Si applicano i limiti delle proprietà indicati sotto. Una chiave non valida, troppe proprietà o un valore troppo grande fanno rifiutare l’evento dal collettore; i valori non vengono troncati in silenzio. Usa l’API JavaScript per valori tipizzati numero, booleano o null.

Un evento di clic o di invio non conferma che il tuo server abbia completato l’azione. Usa il metodo del gestore di successo descritto sopra quando ti serve quella conferma.

Identificare gli utenti che hanno effettuato l’accesso

window.seean?.identify("user_42", { plan: "pro" });

identify(id, properties?) associa il tuo id utente (1–64 caratteri tra A–Z a–z 0–9 _ . : @ -, mai un’e-mail) a ogni record successivo della pagina aperta e registra un evento identify con le proprietà opzionali. Ha effetto solo per i siti web che hanno attivato Identify users (Identifica utenti) in Settings → Installation; vedi Persone e retention.

Limiti delle proprietà

I nomi degli eventi accettano fino a 64 caratteri. Ogni evento può includere fino a 20 proprietà; l’oggetto delle proprietà serializzato non deve superare 4.096 caratteri. Le chiavi delle proprietà iniziano con una lettera e contengono solo lettere, numeri o trattini bassi, fino a 64 caratteri. I valori possono essere una stringa fino a 512 caratteri, un numero finito, un booleano o null. Oggetti annidati e array vengono rifiutati.

Usa etichette non sensibili come la posizione di un modulo o la categoria di un prodotto. Non inviare mai password, indirizzi e-mail, dati di pagamento o token privati. Le proprietà non sono attualmente disponibili come colonne del registro attività né come filtri di proprietà della dashboard; inviare una proprietà non crea un nuovo controllo nei report.

Verificare un evento

Esegui l’azione una volta e apri il Events activity log (registro attività degli eventi) del sito web selezionato nel periodo corrente. Controlla nome, percorso e conteggio. Gli eventi personalizzati usano gli stessi segnali di privacy, le stesse esclusioni e la stessa quota di raccolta delle visualizzazioni di pagina; una richiesta rifiutata o ignorata può non lasciare alcuna riga. Un evento chiamato pageview viene contato come visualizzazione e non come evento personalizzato.

Se manca una riga, controlla che lo script sia pronto, il payload della richiesta e la risoluzione dei problemi di installazione. track() non restituisce una conferma che il salvataggio sia riuscito e il tracker non offre una coda di ritentativi persistente.

Pagine 404

Aggiungi <meta name="seean:status" content="404"> alla tua pagina non trovata: la sua visualizzazione di pagina automatica porterà status: 404 e comparirà sotto Pages → 404s (Pagine → 404) senza un secondo evento.

Chiamare invece track("pageview", { status: 404 }) aggiunge una seconda visualizzazione di pagina. Vedi tracciamento 404.

Qualcosa non è chiaro? Contatta il supporto.