Eventos personalizados

Qualquer coisa em que você possa anexar um manipulador de clique pode ser um evento.

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

Os eventos aparecem na Visão geral (cartão Eventos), no registro de atividade de Eventos, nos funis como passos e nos relatórios de campanha quando correspondem às metas de conversão ativadas (ou a todos os eventos personalizados quando nenhuma meta está ativada). As propriedades são enviadas com o evento, mas a tabela atual do registro de atividade não as exibe.

Nomes

Use nomes curtos e estáveis: signup, cta_click, newsletter_signup. Renomear depois divide seu histórico.

Carregue antes de chamar

Chame track depois que o script do rastreador gerado tiver sido executado. Não há fila integrada para chamadas feitas antes do carregamento. Em HTML puro, coloque o script adiado da sua aplicação depois do script adiado do Seean; para um framework, siga seu guia de instalação.

Para um botão de download, anexe o manipulador depois que esse botão existir:

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

Isso conta o clique, não a prova de que um download terminou. O encadeamento opcional evita uma exceção quando o rastreador não está disponível, mas não salva nem reenvia o evento. Um visitante ignorado pode ter métodos do rastreador sem efeito, então a presença de window.seean por si só não é prova de coleta.

Para um formulário, chame o rastreador no seu caminho existente de envio bem-sucedido:

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

Não envie também este evento de sucesso no clique do botão de envio: a validação ou a requisição podem falhar, e conectar ambos contaria os envios bem-sucedidos duas vezes. Mantenha a validação e o tratamento de erros normais do seu formulário.

Cliques e formulários declarativos

Adicione data-seean-event="signup" a um botão ou link para enviar esse evento no clique, inclusive em cliques nos seus elementos aninhados. Em um formulário, o atributo envia no submit em vez de nos cliques em seus campos. Elementos dinâmicos funcionam por meio de ouvintes delegados. As predefinições de conversão automática pulam elementos marcados para evitar contagem dupla; não chame também seean.track() para a mesma ação. Os atributos declarativos não precisam do opt-in data-conversions. Os nomes não podem ser vazios, têm no máximo 64 caracteres e não podem ser pageview.

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

Adicione data-seean-event-PROPERTY="value" ao mesmo elemento marcado para enviar uma propriedade. O exemplo acima envia { "source": "footer" }. Os valores de atributo continuam sendo strings ("2" não é o número 2); o HTML normaliza os nomes de atributo para minúsculas. Apenas atributos explicitamente prefixados nesse elemento são lidos. Propriedades em ancestrais ou filhos, valores de campos de formulário e atributos não relacionados não são coletados. Alterar um atributo antes de uma interação posterior usa seu novo valor.

Os limites de propriedades abaixo se aplicam. Uma chave inválida, propriedades demais ou um valor grande demais fazem o coletor rejeitar o evento; os valores não são truncados silenciosamente. Use a API JavaScript para valores tipados de número, booleano ou nulo.

Um evento de clique ou submit não confirma que seu servidor concluiu a ação. Use o método do manipulador de sucesso acima quando precisar dessa confirmação.

Identifique usuários autenticados

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

identify(id, properties?) anexa seu próprio ID de usuário (1–64 caracteres de A–Z a–z 0–9 _ . : @ -, nunca um e-mail) a todos os registros posteriores da página aberta e registra um evento identify com as propriedades opcionais. Só tem efeito em sites que ativaram Identify users (Identificar usuários) em Settings → Installation; veja Pessoas e retenção.

Limites de propriedades

Os nomes de evento aceitam até 64 caracteres. Cada evento pode incluir até 20 propriedades; o objeto de propriedades serializado não pode passar de 4.096 caracteres. As chaves de propriedade começam com uma letra e contêm apenas letras, números ou sublinhados, até 64 caracteres. Os valores podem ser uma string de até 512 caracteres, um número finito, um booleano ou null. Objetos aninhados e arrays são rejeitados.

Use rótulos não sensíveis, como a localização de um formulário ou a categoria de um produto. Nunca envie senhas, endereços de e-mail, dados de pagamento ou tokens privados. As propriedades não estão disponíveis atualmente como colunas do registro de atividade nem como filtros de propriedade no painel; enviar uma propriedade não cria um novo controle de relatório.

Verifique um evento

Realize a ação uma vez e abra o registro de atividade de Eventos do site selecionado no período atual. Confira o nome, o caminho e a contagem. Os eventos personalizados usam os mesmos sinais de privacidade, exclusões e cota de coleta das visualizações de página; uma requisição rejeitada ou ignorada pode não deixar nenhuma linha. Um evento chamado pageview é contado como visualização, não como evento personalizado.

Se uma linha estiver faltando, verifique a prontidão do script, o payload da requisição e a solução de problemas de instalação. track() não retorna uma confirmação de que o armazenamento foi bem-sucedido, e o rastreador não fornece uma fila de reenvio persistente.

Páginas 404

Adicione <meta name="seean:status" content="404"> à sua página de não encontrado e sua visualização de página automática carrega status: 404, então ela aparece em Pages → 404s sem um segundo evento.

Chamar track("pageview", { status: 404 }) em vez disso adiciona uma segunda visualização de página. Veja rastreamento de 404.

Algo não ficou claro? Fale com o suporte.