Eventos
O ecrã Eventos mostra os eventos que o seu site envia intencionalmente: se cada um continua a ser acionado, com que frequência, por quantos visitantes e a partir de que páginas.
Enviar um evento
Quando o snippet do Analytics da Silktide estiver numa página, chame silktide com um nome onde quer que aconteça aquilo que lhe interessa: um formulário enviado, um vídeo reproduzido, uma inscrição.
document.querySelector("#newsletter-form").addEventListener("submit", () => {
silktide("newsletter_signup");
});
O snippet define silktide antes de o script do Analytics ser carregado, pelo que um evento enviado antecipadamente fica em fila e é registado quando o script estiver pronto.
Escolha um nome que se mantenha igual enquanto acompanhar o evento, como newsletter_signup ou video_played. O nome é utilizado por filtros, exportações, objetivos e pela API. Não inclua dados pessoais: nunca coloque um endereço de e-mail, o nome de uma pessoa ou um número de conta num nome de evento.
O script do Analytics já regista alguns eventos com estes nomes, pelo que deve dar aos seus um nome diferente: page_load, page_update, page_return, click, download, frustration e field.
Enviar detalhes com um evento
Passe um objeto como segundo argumento para indicar mais sobre o que aconteceu: qual acordeão foi aberto, qual formulário foi enviado, qual vídeo foi reproduzido. Cada chave nesse objeto é uma propriedade do evento.
document.querySelectorAll("details").forEach((accordion) => {
accordion.addEventListener("toggle", () => {
if (accordion.open) {
silktide("open_accordion", {
summary: accordion.querySelector("summary")?.textContent.trim() ?? "",
});
}
});
});
- Cada valor é registado como texto. Envie texto, números ou verdadeiro e falso; um objeto ou uma lista dentro de uma propriedade não é registado de forma útil.
- Não precisa de enviar o endereço da página. Cada evento já regista a página a partir da qual foi enviado.
- Mantenha o nome de uma propriedade igual enquanto a acompanhar e não inclua dados pessoais nos valores, tal como não faria no nome do evento.
event,timeepageUrlsão utilizados pelo próprio script, pelo que não são registados como propriedades.
O que o ecrã mostra
- Os seus eventos são os quatro eventos mais frequentes do período, apresentados como cartões. Cada um mostra com que frequência o evento foi enviado, quantos visitantes o enviaram, quantas vezes por visitante, a sua evolução ao longo do período e quando foi visto pela última vez. Com Comparar ativado, a contagem mostra a alteração em relação ao período anterior.
- O ponto junto de Visto pela última vez fica âmbar quando um evento não é enviado há mais de três dias. Um evento que deixou de ter atividade pode ter sido removido do site por engano.
- Parece um teste assinala um evento enviado três ou menos vezes por um único visitante, o que normalmente significa que alguém o está a experimentar.
- Onde é acionado apresenta as páginas a partir das quais um evento foi enviado, começando pelas mais frequentes. Selecione outro evento para ver as respetivas páginas, abra os percursos que o incluem ou escolha Ver todas as páginas para ver a lista completa do evento.
- Registado automaticamente apresenta os eventos que o próprio script regista. Cada um tem uma ligação para o ecrã que o aborda: carregamentos de página para Páginas, cliques para Cliques, frustração para Frustração e transferências para Transferências.
- A tabela apresenta todos os eventos enviados pelo seu site, incluindo quando cada um foi visto pela primeira e pela última vez. Abra uma linha para ver os detalhes desse evento ou utilize o menu para ver os respetivos percursos ou filtrar todos os ecrãs por esse evento.
As pessoas que podem administrar o Analytics podem atribuir a um evento um nome legível na tabela. O nome aplica-se a toda a sua conta; os filtros e as exportações continuam a utilizar o nome que o seu site envia.
Detalhes de um evento
Abra um evento na tabela para o ver isoladamente: com que frequência foi enviado durante o período, de onde vieram os seus visitantes e Percursos através deste evento, que mostra a página em que os visitantes estavam quando o evento foi enviado e para onde foram a seguir. É semelhante a Percursos através desta página.
Páginas a partir das quais foi enviado apresenta todas as páginas a partir das quais o evento foi enviado, começando pelas mais frequentes. Pesquise uma página e abra os detalhes de uma página ou inspecione-a a partir do menu da linha.
Para um evento enviado com propriedades, os detalhes também mostram:
- Com o que foi enviado ordena os valores de uma propriedade, começando pelos mais enviados, com o número de vezes que cada um foi enviado. Escolha outra propriedade no menu acima da lista. Selecione um valor para listar apenas as vezes em que o evento foi enviado com esse valor e selecione-o novamente para listar todas as vezes.
- Todas as vezes que foi enviado apresenta cada vez que o evento foi enviado, começando pelas mais recentes: quando, a partir de que página e cada propriedade numa coluna própria. Pesquise uma página ou um valor, ou abra uma linha para ver a visita de que fez parte.
Obter detalhes de eventos através da API
A API REST da Silktide fornece-lhe os mesmos detalhes, para que possa criar relatórios nas suas próprias ferramentas. Cada endpoint recebe o nome do evento como event, juntamente com o intervalo de datas e os filtros aceites por todos os endpoints do Analytics:
analytics/event-propertiesapresenta as propriedades com que o evento foi enviado.analytics/event-property-valuesordena os valores de uma propriedade. Indique o nome da propriedade comoproperty.analytics/event-occurrencesapresenta todas as vezes que o evento foi enviado, começando pelas mais recentes. Cada linha contém otime(um carimbo de data/hora Unix, em segundos), a página comourl, a visita de que fez parte comosessionIde as respetivasproperties. Adicionepropertyevaluepara listar apenas as vezes em que foi enviado com esse valor.
Crie uma chave no ecrã da API; as estruturas completas dos pedidos e a forma de enviar eventos a partir do seu site estão disponíveis na documentação para programadores.
Utilizar eventos em objetivos
Um objetivo pode ser concluído quando um visitante aciona um evento. Consulte Funis e objetivos.
Se um evento não aparecer
Verifique se o snippet do Analytics está na página que envia o evento, se o código que chama silktide é executado e se o intervalo de datas selecionado inclui o dia de hoje.