Avançar para o conteúdo
SilktideAjuda

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, time e pageUrl sã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-properties apresenta as propriedades com que o evento foi enviado.
  • analytics/event-property-values ordena os valores de uma propriedade. Indique o nome da propriedade como property.
  • analytics/event-occurrences apresenta todas as vezes que o evento foi enviado, começando pelas mais recentes. Cada linha contém o time (um carimbo de data/hora Unix, em segundos), a página como url, a visita de que fez parte como sessionId e as respetivas properties. Adicione property e value para 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.

Última atualização

Esta página foi útil?