API DE CONVERSÕES DO FACEBOOK (CAPI)

Turno 1: O que é e como gerenciar a CAPI

Usuário: EXPLIQUE O QUE É E COMO GERENCIAR O API DE CONVERSÕES DO FACEBOOK (CAPI)


Gemini: A API de Conversões do Facebook (CAPI) é a evolução do rastreamento de anúncios da Meta. Em um mundo onde navegadores (como Safari e Chrome) estão bloqueando cookies de terceiros e usuários utilizam cada vez mais AdBlockers, o Pixel tradicional tornou-se insuficiente.

Aqui está uma explicação detalhada de como ela funciona e como você deve gerenciá-la em 2026.

1. O que é a CAPI?

Diferente do Pixel, que vive no navegador do usuário (lado do cliente), a CAPI conecta o servidor do seu site, CRM ou plataforma diretamente aos servidores da Meta.

  • Pixel (Client-side): O navegador avisa ao Facebook: "Ei, esse usuário comprou!". Se houver um bloqueador de anúncios, esse aviso nunca chega.
  • CAPI (Server-side): O seu sistema avisa ao Facebook: "Registrei uma compra aqui no meu banco de dados para o usuário X". Como essa comunicação é entre servidores, ela não pode ser bloqueada pelo navegador.

2. Como gerenciar a CAPI (Passo a Passo)

O gerenciamento eficaz não é apenas "instalar", mas sim garantir a qualidade dos dados.

A. Configuração e Implementação
Existem três formas principais de implementar:
1. Integrações de Parceiros (Mais fácil): Se você usa Shopify, Hotmart, WordPress (PixelYourSite) ou Nuvemshop, basta gerar um Token de Acesso no Gerenciador de Eventos e colar nas configurações da plataforma.
2. Google Tag Manager (GTM) Server-side: É a forma profissional mais comum hoje. Você cria um container de servidor que recebe os dados e os repassa para a Meta.
3. API Direta: Para sistemas próprios, onde seu desenvolvedor faz chamadas HTTP diretamente para a Meta.

B. O Segredo: Desduplicação
Como a recomendação da Meta é usar Pixel + CAPI juntos (configuração redundante), o Facebook receberá a mesma conversão duas vezes. Para evitar erros:
* Você deve enviar o parâmetro event_id idêntico em ambas as fontes.
* O Facebook verá os dois IDs iguais e descartará um, mantendo a precisão.

C. Monitoramento da Qualidade (EMQ)
No seu Gerenciador de Eventos, você verá uma métrica chamada Qualidade da Correspondência do Evento (Event Match Quality - EMQ).
* O que gerenciar aqui: Garanta que você está enviando o máximo de dados criptografados (hashed) possíveis, como e-mail, telefone, cidade e IP. Quanto mais dados, maior a nota (objetivo: acima de 6/10) e melhor a inteligência do Facebook para achar seu público.

3. Melhores Práticas para 2026

  • Privacidade em Primeiro Lugar: Use a CAPI para respeitar as escolhas de consentimento (LGPD). Se o usuário recusar cookies, você ainda pode enviar dados anônimos via servidor para atribuição básica, dependendo da sua política de privacidade.
  • Eventos Offline: Não rastreie apenas o site. Integre seu CRM para enviar eventos de "Venda Confirmada" ou "Lead Qualificado" que acontecem fora do navegador.
  • CAPI Gateway: Se você quer a potência da CAPI sem a complexidade técnica do GTM Server-side, a Meta oferece o "CAPI Gateway", uma solução baseada em nuvem (AWS) que automatiza quase todo o processo de envio de eventos.
Nota para o seu perfil: Como você mencionou estar usando o Dolphin Anty com cookies configurados, lembre-se que para testes de CAPI, o Facebook Pixel Helper (extensão) pode não mostrar os eventos de servidor em tempo real. O lugar correto para validar se a CAPI está funcionando é na aba "Eventos de Teste" dentro do Gerenciador de Negócios da Meta, usando o código de teste gerado lá.

Gostaria que eu te ajudasse a gerar o passo a passo para criar o Token de Acesso dentro do seu Gerenciador de Eventos?

Turno 2: GTM Server-side no Blogger

Usuário: SIM MAS LEMBRANDO QUE EU USO O BLOGGER. explique como configurar o GTM Server-side para ele


Gemini: Entendido! O Blogger é uma plataforma mais fechada, o que significa que você não tem acesso a plugins automáticos como no WordPress. Para gerenciar a CAPI no Blogger, você tem basicamente dois caminhos: o GTM Server-side (mais técnico) ou usar uma ferramenta de ponte (mais simples).

Configurar o GTM Server-side para o Blogger é a solução mais profissional para contornar as limitações da plataforma. Como o Blogger não processa código do lado do servidor para você, vamos criar um "servidor de passagem" (geralmente via Google Cloud ou Stape) que receberá os dados do seu blog e os enviará para a Meta.

Passo 1: Criar os dois Containers no GTM

Você precisará de duas estruturas dentro da sua conta do Google Tag Manager:
1. Container Web: Onde ficam as tags que rodam no navegador do usuário (já deve estar no seu Blogger).
2. Container Server: O "servidor" que processará os dados antes de mandar para o Facebook.

Passo 2: Configurar o Servidor (O "Cérebro")

Ao criar o Container de Servidor, você precisará de uma URL de sinalização.
* Google Cloud (Gratuito até certo limite): O GTM oferece o provisionamento automático.
* Stape.io (Popular pela facilidade): É um serviço que facilita o setup do servidor por um custo baixo (ou grátis para pouco tráfego).
* Resultado: Você terá uma URL como https://caps.seublog.com.br ou https://gtm.stape.io/xxx. Guarde essa URL.

Passo 3: Configurar o Container Web (No Blogger)

No seu GTM Web que já está no Blogger:
1. Vá em Tags > Nova > Configuração do Google Analytics 4 (GA4).
2. Insira seu ID de Mensuração do GA4.
3. A sacada: Marque a opção "Enviar para o contêiner do servidor" e cole a URL que você obteve no Passo 2.
4. Agora, toda vez que um usuário clicar em algo, o GTM Web enviará o dado para o seu GTM Server em vez de mandar direto para o Google/Facebook.

Passo 4: Configurar o Container Server para a CAPI

Agora, entre no seu Container Server:
1. Variáveis: Crie uma variável para o seu Token de Acesso da Meta (aquele que você gerou no Gerenciador de Eventos).
2. Clientes: Verifique se o cliente "GA4" está ativo (ele que "escuta" o que o seu Blogger envia).
3. Tags: Instale a tag oficial da "Facebook Conversions API" (disponível na Galeria de Modelos da comunidade do GTM).
4. Configuração da Tag: Insira o ID do Pixel, o Token de API e escolha o método "Inherit from GA4" (Herdar do GA4).

Passo 5: A Desduplicação (Vital)

Como você terá o Pixel no HTML do Blogger e a CAPI no Servidor, o Facebook receberá dois sinais. Para ele não contar duas vendas:
* No GTM Web, na tag do Pixel, você precisa configurar um parâmetro chamado event_id.
* No GTM Server, na tag da CAPI, você deve enviar o mesmo event_id.
* Use uma variável de "ID de Evento Único" (disponível na galeria de modelos do GTM) para garantir que o número seja igual em ambos os lados.

Por que isso é bom para quem usa Dolphin Anty?
Como você trabalha com perfis gerenciados no Dolphin: 1. Isolamento técnico. 2. Controle total dos dados enviados.

Turno 3: Configuração Stape e Event ID

Usuário: AMBOS


Gemini: Para configurar os dois pilares que faltam (o Servidor e a Desduplicação) para o seu Blogger, vamos dividir em duas partes práticas.

Parte 1: Configuração do Servidor (Via Stape.io - O mais simples para Blogger)

  1. Crie uma conta no Stape.io.
  2. No painel, clique em "Create Container".
  3. Dê um nome (ex: CAPI-Blogger) e cole o seu Container Config do GTM Server.
  4. O Stape vai dar-lhe uma URL de Servidor. No GTM Server, cole essa URL em Administração > Definições do Contentor.

Parte 2: A Desduplicação (Garantir que o Facebook não conte 2x)

1. No GTM Web (Contentor Web):
Vá a Variáveis > Nova > Galeria > "Unique Event ID". Dê o nome de {{Event ID}}. Na sua Tag do FB Pixel e na Tag do GA4, adicione o parâmetro event_id com o valor {{Event ID}}.

2. No GTM Server (Contentor Server):
Certifique-se de que a Tag da CAPI está a ler o valor que vem do GA4 (Inherit from client).

Turno 4: Edição do XML no Blogger

Usuário: AJUDA


Gemini: Para finalizar a configuração no Blogger, precisamos mexer no código XML do tema. É aqui que muitos erram, pois o Blogger tem algumas restrições com caracteres especiais (como o &) que podem quebrar o código do GTM.

1. Preparando o Código do GTM Web para o Blogger

O código padrão do GTM tem um caractere & que o Blogger não aceita. Você precisa substituí-lo por &.

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&amp;l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-XXXXXXX');</script>
<!-- End Google Tag Manager -->

2. Colando no XML do Blogger

1. No painel do Blogger, vá em Tema > Editar HTML.
2. Primeiro Código (Head): Logo abaixo da tag <head>.
3. Segundo Código (Body): Logo abaixo da tag <body>.

Turno 5: Botão de WhatsApp e Leads

Usuário: SIM (ajuda com evento de WhatsApp/Lead)


Gemini: Para criar um evento de Lead ou Botão de WhatsApp no Blogger com GTM Server-side, precisamos de dois passos: capturar o clique no navegador (Web) e garantir que o servidor envie isso para a Meta (CAPI).

1. No Contentor GTM Web: Crie um acionador de clique em links contendo wa.me. Crie uma Tag de Evento GA4 com o nome generate_lead e o parâmetro event_id. Crie a Tag do Pixel como Lead também com o event_id.

2. No Contentor GTM Server: A tag da CAPI enviará o evento generate_lead assim que recebê-lo do cliente GA4.

Turno 6: Riscos de não usar CAPI e Termos Técnicos

Usuário: E SE O USUÁRIO USAR SOMENTE O PIXEL DO FACEBOOK SEM O API? lista de termos técnicos para facilitar minha pesquisa


Gemini: Se você optar por usar somente o Pixel, você estará operando com uma "venda nos olhos".
1. Perda de 30% a 60% das conversões (iOS 14, AdBlockers).
2. Algoritmo "burro": Sem os dados, o Facebook não sabe quem converteu.
3. Instabilidade no Dolphin Anty: O Pixel depende de cookies instáveis.

Lista de Termos Técnicos:

  • Client-side / Server-side: Navegador vs Servidor.
  • EMQ (Event Match Quality): Nota de qualidade dos dados.
  • Deduplication / Event ID: Evitar contagem dupla.
  • Hashed Data: Dados criptografados (SHA-256).
  • Transport URL: URL que conecta o GTM Web ao Server.
  • Fingerprinting: Identificação de perfis pela Meta.
  • First-Party vs Third-Party Cookies: Cookies próprios vs externos.

Deseja que eu salve essa lista no seu histórico de informações para lembrarmos dela na sua próxima sessão?