O método StatsRails.trackEvent() permite que você registre eventos personalizados em seu site ou aplicação, coletando informações valiosas sobre a interação dos usuários. Com ele, você pode monitorar ações específicas dos usuários, como cliques em botões, preenchimento de formulários, rolamento da página, e muito mais.

📌 Sintaxe

StatsRails.trackEvent(eventName, eventData);
  • eventName: O nome do evento que você está rastreando. Este é um identificador único para o evento, que ajudará a distinguir entre diferentes tipos de interações.
  • eventData: Um objeto que contém os dados associados ao evento. Isso pode incluir informações como o ID do usuário, o valor de uma compra, o nome de um produto, entre outros.

💡 Exemplos de Uso

1️⃣ Rastreando o Clique de um Botão

Se você deseja registrar quando um usuário clica em um botão de "Alterar Tema" em seu site:

document.getElementById("change-theme-btn").addEventListener("click", function() {
    StatsRails.trackEvent("btn_theme_click", {
        label: "Botão de Alterar Tema"
    });
});

2️⃣ Rastreando o Preenchimento de um Formulário

Se você quiser rastrear quando um usuário envia um formulário de contato:

document.getElementById("contact-form").addEventListener("submit", function() {
    StatsRails.trackEvent("form_submission", {
        formName: "Contact Us",
        fields: {
            name: document.getElementById("name").value,
            email: document.getElementById("email").value
        }
    });
});