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: 24/09/2026

A API de Conversões do Facebook é uma interface que cria uma conexão direta e confiável entre a sua loja e o Facebook. Ela permite obter os mesmos dados do Pixel do Facebook, mas sem perder informações por causa da relevância cada vez maior da segurança dos dados de quem navega.

Assim, os dados não ficam sujeitos às políticas dos dispositivos nem dos navegadores 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 vai ajudar você a otimizar suas campanhas e anúncios.

Observação

Você pode saber mais sobre esse recurso no artigo da Meta sobre a API de Conversões.

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).
Importante

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 backend da sua loja.

Passos para configuração

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á possuir uma conta do Facebook conectada;
  • Se ainda não tiver feito a conexão.

3.1. Se já tiver uma conta do Facebook conectada, será preciso clicar em "Desconectar conta".

3.2. Em seguida, clicar em "Conectar com a Meta" e depois em "Continuar como...".

Selecionar para seguir com a conta conectada no navegador, com o botão "Continuar como..." em destaque

3.3. Agora, seguir o tutorial “Como conectar o Facebook e Instagram Shopping?”, a partir do passo 4 do tópico "Passos de configuração".

️❗ Você deve 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).

Importante

Caso tenha anúncios em execução, as informações não serão perdidas nem será necessário recriá-las.

4. Durante o procedimento de integração, você verá uma etapa para autorizar o acesso da API de conversões. 

Para isso, 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.

5. Refazer a verificação de domínio dentro do Gerenciador de Negócios, seguindo os passos do artigo: Como verificar o domínio para o Instagram Shopping?

6. Verificar se configurou os eventos totais do Pixel. Se ainda não o fez, seguir este artigo: Saiba mais sobre como medir o total de eventos.

Dica

Caso sua loja use somente um subdomínio, não será possível configurar o total de eventos.

Pronto!

Você habilitou a API de Conversões do Facebook.

Sugerimos ver estes artigos complementares da Central de Ajuda da Meta, empresa à qual pertencem o Facebook e o Instagram:

Importante

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

Por enquanto, apenas os eventos Purchase, AddToCart e InitiateCheckout são monitorados. Estamos atualizando a funcionalidade gradativamente em conjunto com o Facebook.

O local onde se verifica é dentro do Gerenciador de Negócios. Na seção de origem de dados, será possível ver os eventos do servidor (pode levar algumas horas para aparecer). No momento, somente rastreamos os eventos Purchase (compra confirmada) e InitiateCheckout (checkout iniciado).

De início o que deve acontecer é que as medições melhorem, assim como o alcance dos anúncios, as medições e o ROI do investimento, que seria a essência da API. Além disso, a médio prazo, o que deverá acontecer é que o Pixel captará melhor as informações.

Não, pois ao conectar o Facebook, é possível selecionar o uso de todos os recursos. Além disso, a API de Conversões funciona de forma complementar ao Pixel. Assim, seus anúncios ficam cada vez mais otimizados.

No momento, vão aparecer os eventos tanto do servidor quanto do navegador, mas as métricas não se duplicam. Isso é algo que o Facebook solicitou para medir a qualidade dos eventos que enviamos do servidor.

Acreditamos que não, porém não temos uma resposta concreta, pois isso depende do Facebook. Seguiremos acompanhando e avisaremos se surgirem novidades sobre esse assunto.

Porque é necessário aceitar novas permissões do Facebook para ativar o envio de dados para o Pixel.

Acessar o Gerenciador de Negócios da Meta > Gerenciador de Eventos > Selecionar seu pixel > 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 backend da sua loja: ela só dispara o evento de compra quando o pedido está efetivamente pago, com todos os valores reais.

Se você estiver buscando informações sobre a utilização do Pixel, acessar a nossa seção: Pixel do Facebook