Vai al contenuto
SilktideAiuto

Eventi

La schermata Eventi mostra gli eventi che il tuo sito invia intenzionalmente: se ciascuno viene ancora attivato, con quale frequenza, da quanti visitatori e da quali pagine.

Inviare un evento

Una volta che lo snippet di Analytics di Silktide è presente in una pagina, chiama silktide con un nome nel punto in cui si verifica l'azione che ti interessa: un modulo inviato, un video riprodotto, un'iscrizione.

document.querySelector("#newsletter-form").addEventListener("submit", () => {
  silktide("newsletter_signup");
});

Lo snippet definisce silktide prima che lo script di Analytics sia stato caricato, quindi un evento inviato in anticipo viene messo in coda e registrato quando lo script è pronto.

Scegli un nome che rimanga invariato per tutto il tempo in cui monitori l'evento, ad esempio newsletter_signup o video_played. Il nome è quello usato da filtri, esportazioni, obiettivi e API. Non includere dati personali: non inserire mai un indirizzo email, il nome di una persona o un numero di conto nel nome di un evento.

Lo script di Analytics registra già alcuni eventi con questi nomi, quindi assegnane uno diverso ai tuoi: page_load, page_update, page_return, click, download, frustration e field.

Inviare dettagli con un evento

Passa un oggetto come secondo argomento per indicare maggiori dettagli su ciò che è accaduto: quale fisarmonica è stata aperta, quale modulo è stato inviato, quale video è stato riprodotto. Ogni chiave al suo interno è una proprietà dell'evento.

document.querySelectorAll("details").forEach((accordion) => {
  accordion.addEventListener("toggle", () => {
    if (accordion.open) {
      silktide("open_accordion", {
        summary: accordion.querySelector("summary")?.textContent.trim() ?? "",
      });
    }
  });
});
  • Ogni valore viene registrato come testo. Invia testo, numeri o valori vero e falso; un oggetto o un elenco all'interno di una proprietà non viene registrato in una forma utile.
  • Non è necessario inviare l'indirizzo della pagina. Ogni evento registra già la pagina da cui è stato inviato.
  • Mantieni invariato il nome di una proprietà per tutto il tempo in cui la monitori e non includere dati personali nei valori, proprio come nel nome dell'evento.
  • event, time e pageUrl sono utilizzati dallo script stesso, quindi non vengono registrati come proprietà.

Cosa mostra la schermata

  • I tuoi eventi mostra, sotto forma di schede, i quattro eventi più frequenti del periodo. Ogni scheda indica quante volte l'evento è stato inviato, quanti visitatori lo hanno inviato, quante volte per visitatore, il suo andamento nel periodo e quando è stato rilevato l'ultima volta. Con Confronta attivo, il conteggio mostra la variazione rispetto al periodo precedente.
  • Il punto accanto a Rilevato l'ultima volta diventa color ambra quando un evento non viene inviato da più di tre giorni. Un evento che non viene più inviato potrebbe essere stato rimosso accidentalmente dal sito.
  • Sembra un test contrassegna un evento inviato tre volte o meno da un singolo visitatore, che di solito è qualcuno che lo sta provando.
  • Dove viene attivato elenca le pagine da cui è stato inviato un evento, iniziando da quelle più frequenti. Seleziona un altro evento per visualizzarne le pagine, apri i percorsi che lo includono oppure scegli Vedi tutte le pagine per l'elenco completo dell'evento.
  • Registrati automaticamente elenca gli eventi registrati dallo script stesso. Ognuno rimanda alla schermata che lo tratta: i caricamenti delle pagine a Pagine, i clic a Clic, la frustrazione a Frustrazione e i download a Download.
  • La tabella elenca tutti gli eventi inviati dal tuo sito, indicando quando ciascuno è stato rilevato per la prima e l'ultima volta. Apri una riga per visualizzare i dettagli dell'evento oppure usa il relativo menu per visualizzarne i percorsi o filtrare tutte le schermate in base a esso.

Le persone che possono amministrare Analytics possono assegnare a un evento un nome leggibile dalla tabella. Il nome si applica a tutto il tuo account; filtri ed esportazioni continuano a usare il nome inviato dal tuo sito.

Dettagli di un evento

Apri un evento dalla tabella per visualizzarlo singolarmente: con quale frequenza è stato inviato nel periodo, da dove provenivano i suoi visitatori e Percorsi attraverso questo evento, che mostra la pagina in cui si trovavano i visitatori quando l'evento è stato inviato e dove sono andati successivamente. Funziona come Percorsi attraverso questa pagina.

Pagine da cui è stato inviato elenca tutte le pagine da cui è stato inviato l'evento, iniziando da quelle più frequenti. Cerca una pagina e aprine i dettagli o ispezionala dal menu della riga.

Per un evento inviato con proprietà, i dettagli mostrano anche:

  • Con cosa è stato inviato ordina i valori di una proprietà, iniziando da quelli inviati più spesso, con il numero di volte in cui ciascuno è stato inviato. Scegli un'altra proprietà dal menu sopra l'elenco. Seleziona un valore per elencare solo le volte in cui l'evento è stato inviato con quel valore e selezionalo di nuovo per elencarle tutte.
  • Tutte le volte in cui è stato inviato elenca ogni volta in cui l'evento è stato inviato, dalla più recente: quando, da quale pagina e ciascuna proprietà nella propria colonna. Cerca una pagina o un valore, oppure apri una riga per visualizzare la visita di cui faceva parte.

Ottenere dettagli sugli eventi tramite l'API

L'API REST di Silktide fornisce gli stessi dettagli, così puoi creare report nei tuoi strumenti. Ogni endpoint accetta il nome dell'evento come event, insieme all'intervallo di date e ai filtri accettati da ogni endpoint di Analytics:

  • analytics/event-properties elenca le proprietà con cui è stato inviato l'evento.
  • analytics/event-property-values ordina i valori di una proprietà. Specifica il nome della proprietà come property.
  • analytics/event-occurrences elenca tutte le volte in cui l'evento è stato inviato, dalla più recente. Ogni riga contiene time (un timestamp Unix, in secondi), la pagina come url, la visita di cui faceva parte come sessionId e le relative properties. Aggiungi property e value per elencare solo le volte in cui è stato inviato con quel valore.

Crea una chiave nella schermata API; le strutture complete delle richieste e le istruzioni su come inviare eventi dal tuo sito sono disponibili nella documentazione per sviluppatori.

Usare gli eventi negli obiettivi

Un obiettivo può essere completato quando un visitatore attiva un evento. Consulta Canalizzazioni e obiettivi.

Se un evento non appare

Verifica che lo snippet di Analytics sia presente nella pagina che invia l'evento, che il codice che chiama silktide venga eseguito e che l'intervallo di date selezionato includa la data odierna.

Ultimo aggiornamento

Questa pagina è stata utile?