Integração Meta APIs

A integração com as APIs da  Meta é uma funcionalidade disponível no módulo Mídias e Merchant da Wake Commerce que permite conectar sua loja virtual diretamente às principais APIs de marketing da Meta (Facebook e Instagram).

Por meio desta integração, é possível ativar três recursos essenciais para campanhas de performance:

• API de Conversões: envio de eventos de comportamento do usuário diretamente para a Meta, viabilizando rastreamento preciso mesmo com bloqueadores de cookies.
• API de Catálogo de Produtos: sincronização automática do catálogo da loja com a Meta, permitindo veicular anúncios dinâmicos com produtos atualizados.
• Meta Pixel: script de rastreamento de eventos no frontend da loja para mensuração de conversões, otimização de anúncios e criação de públicos personalizados.

A integração é indicada para lojistas e equipes de marketing que:

• Utilizam Meta Ads (Facebook e Instagram) como canal de aquisição de clientes.
• Precisam rastrear eventos de conversão com alta precisão, especialmente em cenários com cookies bloqueados ou navegação em modo anônimo.
• Desejam veicular campanhas de remarketing dinâmico com catálogo de produtos atualizado automaticamente.
• Buscam centralizar a gestão de audiências e eventos de pixel diretamente na plataforma Wake Commerce, sem depender de implementações manuais de código.

1. Pré-requisitos

Para habilitar a integração com a Meta, verifique se sua loja atende aos seguintes requisitos:

No painel administrativo ative as configurações de definição dos eventos:


 

Acesse a documentação técnica para saber mais sobre os componentes necessários para a integração completa com a API de Conversões e Pixel. 

2. Benefícios

A integração permite configurar ativos do ecossistema Meta de forma otimizada, incluindo benefícios como:

• Rastreamento server-side: A API de Conversões envia dados diretamente do servidor para a Meta, garantindo maior precisão mesmo com bloqueadores de anúncios.
• Catálogo sempre atualizado: A sincronização automática horária mantém preços, estoques e informações dos produtos atualizados no painel da Meta.
• Configuração centralizada: Todo o gerenciamento é feito dentro da Wake Commerce, sem necessidade de acessar código-fonte ou ferramentas externas.
• Campanhas dinâmicas: Com o catálogo integrado, é possível criar anúncios personalizados para cada usuário com base nos produtos que visualizou diretamente na Meta.
• Gestão de permissões simplificada: O fluxo de autenticação via Meta Business Extension conecta Business Manager, Conta de Anúncios, Pixel e Catálogo em um único fluxo guiado.

3. Como funciona

Confira o passo a passo para iniciar a integração

1.Acesse o módulo Mídias e Merchant via Extensões e Integrações no menu e selecione a opção Meta Business Extensions.

2.Autentique a conta da Meta: Para iniciar o fluxo de autenticação clique em "Configurar Integração". Você será direcionado para a tela de configuração e para prosseguir é preciso ler e aceitar o "Acordo do vendedor" e os "Termos da plataforma" que são as documentações oficiais da Meta.

3.Autentique as permissões: Após aceitar os termos e clicar em "Continuar com o Facebook" você será direcionado para as modais de autenticação da Meta, onde é preciso selecionar as permissões que serão conectadas à Wake, sendo elas: Business Manager, Conta de Anúncios, Pixel e Catálogo. Em seguida, é preciso confirmar o aceite das permissões e ações que a Wake terá acesso em sua conta do Facebook.

4.Configure Meta Business Extension: Pronto! Ao aceitar você será redirecionado para a plataforma e iniciará as configurações da integração. Informe o nome da integração e o status; as informações de Ad Account ID, Business ID e página do Facebook são automaticamente preenchidas de acordo com a autenticação realizada.

5.Conecte e gerencie o pacote de recursos Meta: Siga para a ativação das ferramentas da Meta que serão integradas: API de Conversões, API de Catálogo de Produtos e Meta Pixel.
 

Detalhes de cada recurso:

• API de Conversões: Ao ativar, a integração é realizada contemplando o Pixel ID. Para configurar e gerenciar os eventos de conversão, clique em "Configurar" e você será direcionado para o Gerenciador de Eventos no painel da Meta.

• API Catálogo de Produtos: Ao ativar, a integração é realizada contemplando o catálogo ID definido na autenticação. Para facilitar a operação, o gerenciamento dos produtos pode ser feito diretamente na plataforma, por meio das opções "Todos os Produtos", "Grupos de Produtos" ou "Lista Rápida".

Observação: A sincronização do catálogo de produtos ocorre de hora em hora, em horas cheias. Ou seja, é possível que a exibição dos produtos no painel da Meta não ocorra instantaneamente.
 

• Meta Pixel: Ao ativar, a integração é realizada contemplando o Pixel ID definido na autenticação, sendo possível copiá-lo. Para configurar e gerenciar o rastreamento dos eventos, clique em "Configurar" e você será direcionado para o Gerenciador de Eventos no painel da Meta.

6.Pronto! Basta salvar e sua integração com as APIs da Meta estará ativa.

4. Visualização no painel da Meta

Saiba como visualizar os produtos e eventos de disparo integrados no painel da Meta.

1.Ao acessar seu portfólio empresarial na Meta, clique em "Configurações" e logo após em "Apps". Dessa forma, será possível visualizar a integração com a Wake Commerce e todas as permissões concedidas.

2.Para visualizar as configurações de disparo, personalizações e integrações dos eventos do Meta Pixel e Conversões, acesse a página do Gerenciador de Eventos.

3.Para visualizar o catálogo de produtos integrados e sincronizados com as definições da plataforma, acesse o Gerenciador de Comércio, no qual é possível obter detalhes, mídia, status e mais dados dos produtos.

5. Casos de uso detalhados

Confira exemplos de uso da integração de forma simples.

Caso 1: Remarketing dinâmico de produtos

Um lojista de moda deseja exibir anúncios personalizados com os produtos que cada visitante visualizou, mas não comprou. Com a integração ativa, o catálogo é sincronizado automaticamente e o Meta Pixel captura os eventos de visualização de produto, adição ao carrinho e checkout. A Meta usa esses dados para criar campanhas de remarketing altamente segmentadas.

Caso 2: Rastreamento de conversões server-side

Uma loja de eletrônicos percebe que parte das suas conversões não estava sendo registrada pelo Pixel por causa de bloqueadores de anúncios. Ao ativar a API de Conversões, os eventos passam a ser enviados diretamente do servidor da Wake para a Meta, eliminando a perda de dados e melhorando a qualidade do sinal enviado ao algoritmo da Meta Ads.

Caso 3: Gestão de catálogo segmentada por grupo de produtos

Um varejista de pet shop deseja veicular anúncios apenas para a linha de produtos para cães, sem precisar exportar planilhas manualmente. Usando a opção "Grupos de Produtos" dentro da integração, ele define quais produtos do catálogo Wake serão sincronizados com a Meta, permitindo campanhas segmentadas por categoria.
 

6. FAQ

Preciso ter uma conta Business Manager da Meta para usar a integração?

Sim. A integração requer que você tenha um Business Manager ativo na Meta com acesso a uma Conta de Anúncios, Pixel e Catálogo. Caso ainda não tenha, você pode criar em business.facebook.com.

Posso ativar apenas um dos recursos (ex: somente o Meta Pixel)?

Sim. Após a autenticação, você pode escolher quais recursos deseja ativar: API de Conversões, API de Catálogo de Produtos e/ou Meta Pixel. Cada um pode ser habilitado ou desabilitado de forma independente.

Quanto tempo leva para os produtos aparecerem no painel da Meta após ativar o catálogo?

A sincronização do catálogo ocorre de hora em hora, em horas cheias. Portanto, pode levar até 60 minutos para que os produtos sejam exibidos ou atualizados no Gerenciador de Comércio da Meta.

O que é a API de Conversões e por que ela é diferente do Pixel?

O Meta Pixel funciona no navegador do usuário (client-side) e pode ser bloqueado por extensões ou configurações de privacidade. A API de Conversões envia os eventos diretamente do servidor da Wake para a Meta (server-side), garantindo que os dados cheguem mesmo quando o Pixel é bloqueado. O uso combinado dos dois é recomendado para máxima cobertura de dados.

É possível definir quais produtos do catálogo serão sincronizados?

Sim. Dentro da configuração da API de Catálogo de Produtos, você pode escolher entre "Todos os Produtos", "Grupos de Produtos" ou "Lista Rápida" para definir o escopo da sincronização com a Meta.

O que acontece se eu revogar as permissões na Meta?

Caso as permissões sejam revogadas na Meta, a integração deixará de funcionar e o envio de dados será interrompido. Para reativar, será necessário refazer o fluxo de autenticação na plataforma Wake Commerce.