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.

Atenção: A Meta gerencia permissões e acessos por ativo individual (Página, Conta de Anúncios, Pixel e Catálogo). Caso um novo catálogo ou pixel seja criado no seu Gerenciador de Negócios após a integração inicial, ele não aparecerá automaticamente no painel da Wake. Se você criou um ativo novo ou se o catálogo existente não é exibido no menu suspenso, é necessário refazer a autenticação e conceder permissão expressa ao novo ativo no popup da Meta. 

Ao optar por criar um novo catálogo para a integração com a Meta, selecione a opção "Comércio" no campo "Setor". Dessa forma, a Meta fará a validação correta para sincronização dos produtos. 

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 selecionado entre os listados. 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".
   

Filtro nativo de Estoque e Status: Produtos inativos ou sem estoque disponível no painel da Wake são filtrados e omitidos automaticamente do envio, garantindo que anúncios dinâmicos não veiculem itens indisponíveis.

 

Compatibilidade do Catálogo: Nem todos os catálogos criados previamente no Gerenciador de Negócios são compatíveis com integrações de e-commerce. Caso um catálogo antigo não apareça para seleção ou apresente erro na ativação, opte por criar um novo catálogo diretamente no modal de autenticação da Meta durante o fluxo de conexão. 

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 selecionado entre os listados, 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.

Gerenciamento do Código: O Pixel é gerado, editado e gerenciado exclusivamente no painel da Meta (Gerenciador de Eventos). O painel da Wake apenas lista os Pixels vinculados à conta autenticada para seleção. Alterações no código do Pixel não são feitas pelo painel admin da loja. 

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

Estrutura de produtos sincronizados

Saiba quais dados de produtos são sincronizados na integração com as APIs da Meta:

Nível raiz 

• Method: Operação a ser realizada no catálogo (CREATE, UPDATE ou DELETE). 

• id: Identificador único do produto na loja, geralmente o SKU — deve coincidir com o ID enviado ao Pixel da Meta no site. 

• item_group_id: Identificador do grupo de variantes — produtos do mesmo modelo (cores, tamanhos) compartilham o mesmo valor. 

• price: Preço do produto no formato valor MOEDA (ex: 1111.00 BRL), sem símbolos de moeda. 

• image: Lista de imagens do produto, cada uma com a URL da imagem e tags opcionais de descrição. 

• age_group: Faixa etária do público-alvo do produto (ex: Adult, Kids, Infant). 

• brand: Marca do produto. 

• color: Cor do produto.

• condition: Estado de conservação do produto (new, refurbished ou used). 

• custom_label_0: Rótulo personalizado de uso livre para segmentar campanhas no Gerenciador de Anúncios (disponível de custom_label_0 a custom_label_4). 

• description: Descrição detalhada do produto usada nos anúncios — deve ser diferente do título e escrita em texto simples. 

• fb_product_category: Categoria do produto conforme a taxonomia do Facebook, usada para segmentar os anúncios. 

• gender: Gênero do público-alvo do produto (Male, Female ou Unisex). 

• gtin: Código de barras global do produto (EAN, UPC), encontrado na embalagem; deixe vazio se o produto não tiver. 

• link: URL da página do produto na loja. 

• quantity_to_sell_on_facebook: Quantidade em estoque disponível para venda nas Lojas do Facebook e Instagram. 

• material: Material principal do produto. 

• mpn: Código de referência do fabricante, usado quando o produto não possui GTIN. 

• size: Tamanho do produto escrito como palavra, abreviação ou número (ex: M, GG, 42). 

• title: Nome do produto exibido nos anúncios — máximo recomendado de 65 caracteres para evitar corte. 

• availability: Disponibilidade atual do produto (in stock ou out of stock). 

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.