Início›Configure sua loja›Configurações›Configurações avançadas›Códigos externos›Pixel do Facebook
Como ativar a API de conversões do Facebook?
Saiba como configurar a API de conversões do Facebook para melhorar a medição dos eventos realizados pelos clientes da sua Nuvemshop.
Última atualização: 05/10/2026
A API de Conversões da Meta é uma interface que cria uma conexão direta e confiável entre a sua loja e a Meta. Ela permite enviar os mesmos eventos do Pixel, mas a partir do servidor da Nuvemshop, sem perder informações por causa de bloqueadores de anúncios ou das políticas de privacidade dos dispositivos e navegadores.
Assim, os dados não ficam sujeitos ao que cada pessoa usa para acessar a sua loja, garantindo resultados mais completos. Ou seja, a API de Conversões é uma ferramenta complementar ao Pixel e ajuda você a otimizar suas campanhas e anúncios.
O que você consegue ao conectar seu portfólio da Meta?
Ao conectar seu portfólio da Meta com a Nuvemshop, você pode:
Medir o desempenho dos seus anúncios com dados precisos: a Nuvemshop envia à Meta as informações reais de cada compra concluída na sua loja.
Otimizar suas campanhas com dados do servidor: a integração ativa automaticamente a API de Conversões da Meta, que complementa o Pixel para uma medição mais completa e resistente a bloqueadores de anúncios.
Marcar produtos em publicações do Instagram e do Facebook (disponível apenas para o México).
Dica
Ao conectar seu portfólio, a API de Conversões da Meta é ativada automaticamente. Não é necessário fazer nenhuma configuração adicional: é uma consequência direta da conexão e funciona a partir do servidor da sua loja.
Como conectar o portfólio da Meta para ativar a API de Conversões?
Para ativar a API de Conversões, siga estes passos:
1. Acessar o seu painel administrador Nuvemshop.
2. Seguir pela seção "Canais de venda > Instagram e Facebook > Minha conta".
3. Nessa tela, você encontrará dois cenários: se já possui uma conta da Meta conectada ou se ainda não fez a conexão. Clicar na aba correspondente:
3.1. Se já tiver uma conta conectada, clicar em "Desconectar conta".
3.2. Em seguida, clicar em "Conectar com a Meta" e depois em "Continuar como...".
3.3. Seguir o tutorial Como conectar o Facebook e Instagram Shopping? a partir do passo 4 do tópico Passos de configuração. Escolher as mesmas opções que usava antes (catálogo, página do Facebook, conta do Instagram, conta de anúncios, Pixel e conta de comércio).
Caso tenha anúncios em execução, as informações não serão perdidas nem será necessário recriá-las.
3.1. Clicar em "Conectar com a Meta".
3.2. Clicar em "Continuar como..." para seguir com a conta conectada no navegador.
3.3. Selecionar os recursos que deseja conectar (catálogo, página do Facebook, conta do Instagram, conta de anúncios e Pixel). Veja o passo a passo completo no tutorial Como conectar o Facebook e Instagram Shopping?
4. Durante o procedimento de integração, você verá uma etapa para autorizar o acesso da API de Conversões. Descer até a opção "Acessar seus anúncios do Facebook e estatísticas relacionadas" e clicar no botão para que ele fique azul, como no exemplo abaixo.
A integração nativa da Nuvemshop com a API de Conversões não é compatível com a API de Conversões Gateway da Meta. Se as duas estiverem ativas ao mesmo tempo, a do Gateway pode bloquear ou contaminar os dados da integração nativa, gerando eventos vazios e afetando seu ROAS.
Perguntas frequentes sobre a API de Conversões da Meta
Pelo servidor, a Nuvemshop envia os eventos AddToCart, InitiateCheckout, AddPaymentInfo e Purchase. Os demais eventos (PageView, ViewContent, Search e ViewCategory) são enviados pelo navegador, por meio do Pixel.
A verificação é feita dentro do Gerenciador de Eventos da Meta. Ao abrir o seu Pixel, na coluna de método de conexão, os eventos enviados pela API aparecem como Servidor, e os enviados pelo Pixel aparecem como Navegador. Os eventos do servidor podem levar algumas horas para aparecer.
De início, o que deve acontecer é que as medições melhorem, assim como o alcance dos anúncios e o retorno do investimento. A médio prazo, a Meta passa a ter mais informações para otimizar as suas campanhas.
Porque alguns eventos são enviados pelos dois caminhos ao mesmo tempo. A Meta reconhece que se trata da mesma ação e não duplica as métricas. Esse envio duplo é recomendado pela própria Meta para medir a qualidade dos eventos e melhorar a correspondência com as pessoas que viram os anúncios.
É 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.
Não. Ao conectar a Meta, é possível selecionar o uso de todos os recursos que você já utilizava. Além disso, a API de Conversões funciona de forma complementar ao Pixel, então seus anúncios continuam ativos e ficam cada vez mais otimizados.
Não há previsão para isso, mas a decisão depende da Meta. A Nuvemshop segue acompanhando e avisará se surgirem novidades sobre esse assunto.
Porque é necessário aceitar novas permissões da Meta para ativar o envio de dados pelo servidor. Sem essa autorização, a API de Conversões não consegue enviar os eventos.
Acessar o Gerenciador de Negócios da Meta > Gerenciador de Eventos, selecionar o seu Pixel e verificar as fontes de dados conectadas. Se "Gateway" aparecer como origem ativa, você precisa desconectá-lo antes de continuar.
A integração nativa da Nuvemshop é a recomendada porque está conectada diretamente ao servidor da sua loja: ela dispara o evento de compra com os valores reais do pedido e permite escolher se a conversão é registrada no checkout concluído ou somente quando o pedido é pago.
Se você estiver buscando informações sobre a utilização do Pixel, acesse a seção Pixel do Facebook da Central de Ajuda.
