Skip to main content

Instalação

Em sua aplicação web é necessário instalar o nosso SDK Web para que todo o fluxo seja traqueado e atribuído corretamente, para isso é necessário incluir o script do píxel da Nemu no <head> de todas as suas páginas Web, o píxel da Nemu pode ser criado em seu dashboard acessando: Integrações -> Píxels -> Clique aqui para adicionar Veja novamente como instalar aqui Ao fim da criação será exibido a URL do script do píxel da Nemu, copie e cole na <head> de todas as páginas de seu site Com isso estará disponível a variável global trackingNemu com métodos utilitários para realizar o traqueamento

Registrar UID a sessão do usuário

Para total segurança e integridade dos dados de usuários de sua aplicação, todos os UID registrados pelo nosso SDK são criptografados antes de serem armazenados em nossos servidores
Durante o processo de login da aplicação adicione uma chamada ao método setUserId() passando como argumento o UID definido do usuário que acabou de realizar o processo de login, exemplo:
function autenticarUsuario() {
  const email = "usuario@example.com";
  const senha = "1234";

  loginUser({
    email: email,
    password: senha,
    onSuccess: function (userId) {
      trackingNemu.setUserId(userId);
      console.log(`NemuTracking: Registered user: ${userId}`);
    },
    onError: function () {
      console.error("NemuTracking: Failed to authenticate user");
    },
  });
}
É obrigatório garantir que usuários que já estavam logados antes da instalação ou atualização do SDK também sejam corretamente traqueados. Para isso, você pode definir o UID assim que ele estiver disponível na aplicação normalmente logo após o carregamento do usuário salvo localmente. Opções comuns em aplicações web seriam: App SPA: dentro do useEffect de carregamento global Sites comuns: logo após o script da SDK carregar, se window.user já estiver disponível
const userId = window.sessionUser?.email || window.sessionUser?.id;

if (userId) {
  nemuTracking.setUserId(userId);
}

Recuperar UTMs ao enviar disparo de venda para a API da Nemu

O método getLastSessionHistory() retorna um objeto contendo as UTMs da última sessão do usuário, utilize esse objeto ao enviar as informações da venda a API da Nemu
function enviarVendaComUtms() {
  const session = trackingNemu.getLastSessionHistory();

  if (!session) {
    console.log("No sessions found");
    return;
  }

  const payload = {
    transactionId: "123",
    netValue: 10,
    status: "paid",
    utm_campaign: session.utmCampaign ?? null,
    utm_content: session.utmContent ?? null,
    utm_medium: session.utmMedium ?? null,
    utm_source: session.utmSource ?? null,
    utm_term: session.utmTerm ?? null,
  };

  const url = "https://developers.nemu.com.br/api/v1";

  fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify(payload),
  })
    .then((response) => {
      console.log(`API response: ${response.status}`);
    })
    .catch((error) => {
      console.error(`Error to send: ${error.message}`);
    });
}