> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nemu.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# O que é o Pixel da Nemu

> O Pixel da Nemu é uma tecnologia desenvolvida para capturar, rastrear e organizar informações de navegação dos usuários em sua loja virtual

## O que o Pixel faz

Ao ser instalado no seu site, o Pixel executa três funções principais:

* **Captura de UTMs:** Registra os parâmetros UTM presentes na URL (como utm\_source, utm\_medium, utm\_campaign, entre outros), que indicam de onde veio o usuário e por qual campanha ele chegou até o site.
* **Persistência de dados entre páginas:** Com o suporte de um script adicional, o Pixel garante que esses dados de origem não sejam perdidos durante a navegação entre páginas até o momento da conversão.
* **Identificação de usuários com Fingerprinting:** Utilizamos uma técnica de identificação probabilística chamada Fingerprinting. Ela combina variáveis como IP, navegador, sistema operacional, idioma e outros dados públicos para gerar um identificador único e anônimo de cada visitante, mesmo sem login ou cookies.

## Por que o Pixel é importante

1. **Qualidade dos dados de UTM**\
   Sem o Pixel da Nemu, os dados de origem de tráfego podem ser perdidos ou registrados de forma incompleta, comprometendo a análise de resultados. O Pixel garante que as UTMs sejam corretamente capturadas e preservadas durante a navegação do usuário, resultando em dados mais confiáveis.

2. **Construção de jornadas**\
   Com os dados capturados pelo Pixel e o identificador gerado via Fingerprinting, conseguimos traçar uma linha do tempo precisa de interações que o usuário teve com campanhas e canais antes de realizar uma compra. Isso é fundamental para análises de comportamento e para entender o papel de cada canal na jornada.

3. **Modelos de atribuição**\
   A partir dos dados coletados, a Nemu aplica modelos de atribuição como First Click, Last Click e outros modelos personalizados. Isso permite avaliar qual campanha atraiu o cliente e qual contribuiu para a conversão final, dando uma visão mais estratégica sobre o desempenho das ações de marketing.

## Como o Fingerprinting funciona na prática

Nosso sistema coleta variáveis como:

* Endereço IP (hash anonimizado)
* Navegador e versão
* Sistema operacional
* Idioma do navegador
* Resolução de tela
* Fuso horário

Essas informações são combinadas de forma criptografada e transformadas em um identificador único, chamado de `clientId`. Esse identificador é usado para unir todas as interações do mesmo visitante, mesmo em visitas diferentes e sem a necessidade de cookies tradicionais.

## Comportamentos adicionais

O Pixel da Nemu pode ter comportamentos específicos dependendo da plataforma de e-commerce utilizada. Conheça os principais:

### Loja VTEX

Durante o processo de compra, o Pixel aguarda a geração do identificador de pedido da VTEX (chamado de orderFormId).

Esse processo é totalmente seguro e em modo de leitura.

✅ **Operação de leitura:** o script apenas "observa" o orderFormId, sem interferir no funcionamento da VTEX.

⚙️ **Função opcional (Atualmente desativada):** existe uma função de escrita para preencher UTMs no marketingData da VTEX, mas ela está desativada por padrão, garantindo máxima segurança.

🔒 **Assim que o orderFormId é detectado,** ele é associado à sessão do visitante para vincular corretamente o pedido à campanha de origem.

### Nuvemshop

O Pixel utiliza o identificador de carrinho da Nuvemshop (`window.LS.cart.id`) para rastrear a sessão do visitante.

🛒 **Identificação de carrinho:** o script coleta automaticamente o ID do carrinho da Nuvemshop para associar o pedido à origem da visita.

📊 **Rastreamento completo:** permite vincular cada conversão à campanha que trouxe o usuário até a loja.

### Tray

Utiliza os atributos HTML `data-session` ou `data-checkout-session_id` para identificar a sessão do checkout.

🔗 **Sessão de checkout:** o Pixel coleta automaticamente o ID de sessão do checkout da Tray.

💾 **Persistência:** os dados são mantidos durante todo o processo de compra.

### Shopify

Aguarda a geração do token de carrinho (cart token) para rastrear o pedido.

⏳ **Monitoramento de carrinho:** o script aguarda até 50 segundos para detectar o token do carrinho.

🍪 **Cookies e LocalStorage:** utiliza cookies e localStorage para garantir que os dados não sejam perdidos.

🔄 **Atualização automática:** quando detectado, o ID do carrinho é automaticamente atualizado na sessão de tracking.

### WooCommerce

Utiliza a chave de pedido extraída da URL durante o checkout.

🔑 **Chave de pedido:** o script detecta o parâmetro `key` na URL de checkout (`/efetuar-pagamento`) para rastrear o pedido.

📦 **Cookies específicos:** armazena cookies customizados (`nemu_source`, `nemu_medium`, etc.) com validade de 30 dias para rastreamento contínuo.

### Bagy

Armazena UTMs em formato JSON dentro de cookies específicos para integração com o sistema Bagy.

🍪 **Cookie especializado:** os dados são armazenados em cookies com domínio específico e validade de 30 dias.

📊 **Metadados completos:** captura todos os parâmetros UTM para análise detalhada das campanhas.

### Magazord

Encripta os dados de UTM em base64 de forma reversa para integração segura.

🔐 **Segurança:** os dados são codificados e invertidos para proteção adicional.

🛡️ **Integração:** utiliza o cookie `trk` para armazenar os dados de forma segura.

### VNDA

Monitora a sessão através do cookie `ahoy_visit` da plataforma.

⏱️ **Aguarda sessão:** o script monitora por até 10 segundos a geração da sessão.

📝 **Metadados de campanha:** armazena informações de campanha para análise posterior.

### Wake

Integra diretamente com a API de checkout da Wake para adicionar metadados.

🔄 **API de checkout:** utiliza `client.checkout.addCheckoutMetadata()` para armazenar UTMs.

⏳ **Monitoramento:** aguarda até 10 segundos para detectar a disponibilidade da API.

📊 **Metadados completos:** armazena todas as UTMs (utmSource, utmCampaign, utmMedium, etc.) no checkout.

### Uappi

Utiliza o identificador de pedido da plataforma Uappi para rastreamento.

🆔 **ID de pedido:** coleta o `WapStore.pedido.id` para associação correta do pedido.

🔗 **Vinculação:** garante que cada conversão seja corretamente atribuída à campanha de origem.

### Shoppub

Monitora o ID do cliente na loja através da variável global Shoppub.

👤 **ID do cliente:** utiliza `window.Shoppub.customer.id_on_store` para identificação.

⏰ **Monitoramento contínuo:** verifica a cada 500ms até detectar o ID do cliente.

### JetCommerce

Aguarda a detecção do email do cliente na página de checkout.

📧 **Email como identificador:** monitora o campo de email para obter a identificação do cliente.

⏳ **Timeout estendido:** aguarda até 5 minutos para garantir a coleta dos dados.

🔄 **Atualização automática:** assim que detectado, o email é usado como identificador de sessão.

## Como instalar o Pixel

A instalação do Pixel é simples e pode ser feita em minutos. Para ver o passo a passo completo, acesse:

[Guia de instalação do Pixel da Nemu](/pages/onboarding/instalacao-pixel-nemu)
