Configurando Meta Ads (CAPI)
Como obter seu Pixel ID e Token de Acesso (CAPI) no Meta Business Manager para ativar o rastreamento Server-Side blindado.
A integração do Intentyon com o Meta Ads (Facebook e Instagram) utiliza a API de Conversões (CAPI). Isso significa que enviamos os dados dos seus Eventos Qualificados diretamente dos nossos servidores para os servidores do Facebook.
Isso garante que seus dados cheguem mesmo que o usuário utilize bloqueadores de anúncios (AdBlockers) ou esteja em dispositivos Apple com restrições de privacidade (iOS 14+).
Para ativar essa integração nas Configurações do Projeto, você precisará de duas credenciais:
- Pixel ID
- Token de Acesso (CAPI Token)
1. Localizando o Pixel ID
O Pixel ID é o identificador único da sua fonte de dados.
- Acesse o Gerenciador de Eventos do Meta.
- No menu lateral esquerdo, clique em Fontes de dados.
- Selecione o Pixel que você deseja utilizar.
- Vá para a aba Configurações.
- No topo da página, você verá o Número de identificação do conjunto de dados (Este é o seu Pixel ID). Copie este número.
Documentação Oficial: Para mais detalhes sobre como encontrar seu Pixel, consulte a Central de Ajuda do Meta para Empresas.
2. Gerando o Token de Acesso (CAPI)
O Token de Acesso é a "chave secreta" que permite ao servidor do Intentyon falar com o servidor do Facebook em seu nome.
- Ainda no Gerenciador de Eventos, na aba Configurações do seu Pixel.
- Role a página para baixo até encontrar a seção API de Conversões.
- Procure pelo subtítulo Configurar integração direta (ou "Configurar manualmente").
- Clique no link ou botão azul que diz Gerar token de acesso.
- O Facebook gerará um código longo (uma sequência de letras e números). Copie este código imediatamente.
Segurança do Token: O Facebook não mostrará este token novamente depois que você sair da página. Guarde-o em um local seguro até colá-lo no Intentyon.
Requisito de Permissão: Para gerar o token, você precisa ter permissões de administrador no Business Manager e acesso total ao Pixel. Se o botão não aparecer, verifique suas permissões.
3. Ativando no Intentyon
Agora que você tem as credenciais, vamos conectá-las ao seu projeto.
- No painel do Intentyon, vá para o seu Projeto e clique na aba Configurações.
- Role até a seção Credenciais das Plataformas.
- Clique para expandir a opção Meta Ads (Facebook).
- Cole o Pixel ID no primeiro campo.
- Cole o Token de Acesso no campo "CAPI Token".
- Clique em Salvar Alterações.
Segurança dos Dados
No momento em que você clica em salvar, o Intentyon criptografa seu Token usando o padrão AES-256-GCM antes de armazená-lo no banco de dados. Ele nunca fica visível em texto puro, garantindo a segurança da sua conta de anúncios.
4. Testando a Integração
Após configurar, recomendamos verificar se os eventos estão chegando corretamente.
- Volte ao Gerenciador de Eventos do Facebook.
- Clique na aba Evento de teste.
- Navegue pelo seu site e realize uma ação que dispare um Evento Qualificado (ex: role a página e aguarde o tempo necessário).
- No Gerenciador de Eventos, você deverá ver o evento aparecer na lista.
- Procure na coluna "Método de conexão". Eventos enviados pelo Intentyon aparecerão como Servidor.
Latência dos Relatórios: Os dados podem levar algum tempo pra serem exibidos, em alguns casos, de 20 minutos a 1 hora para aparecer no Gerenciador de Eventos.
Deduplicação: O Intentyon envia parâmetros de deduplicação (event_id e event_name) automaticamente. Se você tiver o Pixel de navegador instalado (via GTM ou Shopify), o Facebook identificará que é o mesmo evento e usará o sinal do servidor para enriquecer a qualidade dos dados.