Início›Configure sua loja›Configurações›Configurações avançadas›Códigos externos›Pixel do Facebook
Quais eventos a Nuvemshop envia para o Pixel e como eles funcionam?
Saiba quais eventos a Nuvemshop dispara da sua loja virtual para o Pixel do Facebook e os detalhes de funcionamento de cada um deles.
Última atualização: 05/10/2026
A Nuvemshop oferece a possibilidade de conectar o Pixel da Meta (Facebook e Instagram) na loja virtual, permitindo acompanhar as ações que as pessoas fazem no site. Os eventos são enviados por dois caminhos complementares: pelo navegador (Pixel) e pelo servidor (API de Conversões). Neste artigo, você entende quais eventos a Nuvemshop envia, por qual caminho e como cada um funciona.
Atualmente, a Nuvemshop envia 8 eventos para a Meta. A tabela mostra por qual caminho cada evento é enviado, como aparece no Gerenciador de Eventos:
Evento
Enviado pelo navegador (Pixel)
Enviado pelo servidor (API de Conversões)
PageView
Sim
Não
ViewContent
Sim
Não
Search
Sim
Não
ViewCategory
Sim
Não
AddToCart
Sim
Sim
InitiateCheckout
Sim
Sim
AddPaymentInfo
Sim
Sim
Purchase
Sim
Sim
Importante
Estamos melhorando gradualmente a forma como alguns eventos são calculados e enviados. Por isso, o envio de AddPaymentInfo pelo navegador e as novas regras de ViewContent, AddToCart e InitiateCheckout descritas abaixo podem ainda não estar ativas em todas as lojas.
Entenda o que é cada evento clicando nas barras abaixo:
O PageView é um evento padrão do Pixel que registra cada visita a uma página da loja, independentemente do conteúdo visualizado.
O ViewContent registra a visualização da página de um produto.
O evento é enviado para cada variante visualizada. Ou seja, se o cliente troca de cor ou tamanho na página do produto, um novo ViewContent é registrado para a variante selecionada. Isso dá mais detalhe à Meta para otimizar campanhas de catálogo.
O valor enviado no evento é o preço da variante visualizada, e nunca R$ 0.
O AddToCart registra a adição de um produto ao carrinho de compras da loja.
O valor enviado no evento é o preço do item adicionado naquele momento, e não o total do carrinho. Assim, o valor reflete exatamente a ação do cliente, mesmo que já existam outros produtos no carrinho.
O InitiateCheckout indica o início do processo de finalização da compra, quando o cliente clica em "Finalizar compra" no carrinho.
O evento é registrado a cada início de checkout, inclusive quando o cliente volta para a loja, altera o carrinho e inicia o checkout novamente. Antes, apenas o primeiro início de cada carrinho era contado.
O evento também informa quais variantes estavam no carrinho no momento em que o checkout foi iniciado.
O AddPaymentInfo registra o momento em que o cliente confirma as informações de pagamento e envia o pedido, ou seja, quando clica no botão para concluir a compra com um meio de pagamento já escolhido, antes da confirmação do pagamento.
Esse evento é enviado pelo servidor, no momento em que o carrinho se transforma em pedido, e também pelo navegador, um instante antes. A Meta reconhece que se trata da mesma ação e não duplica a contagem.
O AddPaymentInfo é um bom indicador de quantas pessoas chegam até a etapa de pagamento, mas não concluem a compra.
O Purchase é disparado quando acontece a conclusão de uma compra, indicada pelo recebimento da confirmação do pedido.
Você pode escolher se o evento é registrado quando o checkout é concluído ou somente quando o pedido é marcado como pago. Veja como configurar nas perguntas frequentes deste artigo.
O Search é disparado toda vez que o cliente realiza uma pesquisa na barra de busca da loja.
O ViewCategory não é um evento padrão da Meta, mas é utilizado para registrar as visitas às páginas de categoria da loja.
Agora que você sabe o significado de cada evento, é importante confirmar se eles estão sendo disparados. Para isso, consulte o tutorial Como testar os eventos do Pixel do Facebook?
Porque o ViewContent passou a ser enviado para cada variante visualizada, e não apenas uma vez por produto. Se o cliente troca de cor ou tamanho na página, cada variante gera um novo evento.
Esse aumento é esperado e não indica erro na integração. Ele dá mais detalhe à Meta para otimizar campanhas de catálogo.
Porque o AddToCart passou a enviar o preço do item adicionado, e não mais o total do carrinho. Antes, se o carrinho já tinha outros produtos, o valor do evento ficava inflado.
A redução no valor médio é esperada e não representa queda de desempenho das campanhas. O valor agora reflete com mais precisão a ação do cliente.
Porque o InitiateCheckout passou a ser registrado a cada início de checkout, inclusive quando o cliente volta para a loja, altera o carrinho e inicia o checkout de novo. Antes, apenas o primeiro início de cada carrinho era contado.
Por isso, é normal que a proporção entre InitiateCheckout e Purchase aumente. O número de compras (Purchase) não é afetado por essa mudança.
Alguns eventos (AddToCart, InitiateCheckout, AddPaymentInfo e Purchase) são enviados pelos dois caminhos: pelo navegador (Pixel) e pelo servidor (API de Conversões). A Meta reconhece que se trata da mesma ação e não duplica a contagem.
É normal que o servidor registre mais eventos do que o navegador. O navegador pode perder eventos por bloqueadores de anúncios, restrições de privacidade do Safari ou navegadores dentro de aplicativos. O envio pelo servidor não depende dessas condições e garante que a informação chegue à Meta.
No evento Purchase (compra), enviamos os seguintes dados para o Pixel:
IDs dos produtos
Os produtos
Total da compra
ID da compra
Moeda da transação
Além dessas informações, a Nuvemshop envia para a Meta o que eles chamam de cookies do Facebook. Isso é uma solicitação padrão da Meta, para que eles analisem e façam os lançamentos de campanhas. Para saber como funcionam os cookies e configurá-los, consulte o artigo da Meta Sobre configurações de cookies para o pixel do Facebook.
O evento Purchase (compra) é disparado a partir do sistema interno da Nuvemshop para a Meta, e você pode escolher entre duas formas de medir as conversões:
O pedido é marcado como pago: o evento só é registrado após a confirmação do pagamento e a atualização do status do pedido.
Completam o checkout: o evento é registrado assim que o cliente finaliza a compra, sem considerar a confirmação de pagamento.
Essa configuração é feita no painel administrador da sua Nuvemshop, em "Configurações > Códigos externos > Conversões para Google e Facebook".
Os eventos padrão do Pixel não podem ser desativados, mas essa forma de medição pode ser alterada a qualquer momento.
Não. O evento Purchase não é identificado pelo Pixel Helper nem pelo Teste de eventos da Meta.
Isso acontece porque, diferente dos outros eventos, o Purchase é disparado pelo sistema interno da Nuvemshop (servidor), e essas ferramentas visualizam apenas os eventos disparados pela loja no navegador. Por esse motivo, o evento pode aparecer como PageView nessas ferramentas.
Para confirmar se o evento está funcionando, é preciso aguardar uma compra real ou fazer uma compra teste na loja. O envio do Purchase pode acontecer em até 24 horas após a conclusão da compra.
2. No menu lateral, seguir pelo caminho "Catálogo > Eventos".
3. Ao carregar a tela, clicar no Pixel configurado.
4. Localizar a seção "Conversões no site com números de identificação de conteúdo com correspondência" e clicar na aba "Compras" para visualizar o evento Purchase.
Nesse exemplo, não há evento registrado porque a loja utilizada é um ambiente de testes.
Ao desconectar o Pixel, ele para de receber os eventos da sua loja. As informações que já foram processadas não são perdidas, mas os novos eventos deixam de ser enviados para a Meta.
O Pixel é uma ferramenta da Meta usada para rastrear o comportamento das pessoas que clicam em anúncios e navegam pelo seu site. Como essa parte do processo é controlada pela Meta, a Nuvemshop não tem acesso às ferramentas que poderiam bloquear esses registros. O ideal é contatar o suporte da Meta para verificar as opções disponíveis.
Não recomendamos criar eventos personalizados na Meta, pois isso pode comprometer o desempenho dos eventos nativos, duplicar conversões e gerar problemas na medição. A integração da Nuvemshop já envia todos os eventos listados neste artigo.
Se ainda assim você decidir configurar públicos personalizados no Gerenciador de Eventos da Meta, saiba que essa é uma tarefa que depende da estrutura do seu site e do seu funil de vendas. Como a Nuvemshop não presta suporte para configurações específicas, estes são apenas exemplos genéricos, e você precisará substituí-los pelos URLs reais das páginas da sua loja:
Quando o cliente se cadastra: https://www.seusite.com/account/register/
Quando o cliente adiciona ao carrinho: https://www.seusite.com/produtos/nome-do-produto/ (sempre o link do produto adicionado)
Quando o cliente preenche os dados de compra: https://www.seusite.com/checkout/v3/next/
Quando o cliente finaliza uma compra: https://www.seusite.com/checkout/v3/success
Lembre-se de que a configuração precisa ser feita de acordo com a estrutura e o fluxo de navegação do seu site para que os eventos sejam rastreados com precisão.
Como criar anúncios dinâmicos para Facebook e Instagram Shopping?
Se você tem a intenção de criar anúncios dinâmicos para as campanhas dos canais de venda, primeiro será preciso vincular o Pixel ao seu catálogo de produtos. Veja como acessando o tutorial: Como conectar o Pixel ao catálogo de produtos?