Pixel com Principia: Facebook e Google Ads

A integração com a Principia (ex-Provi) envia as notificações de status das solicitações de crédito educacional pros pixels do Facebook (Meta), Google Ads, GA4, TikTok, Pinterest, Taboola e OpenAI, pela API de Conversões de cada plataforma (server-side). Cada notificação vai como evento de compra com o valor do checkout (convertido de centavos pra reais), moeda, ID da solicitação, os cursos e os dados do aluno (nome, email, telefone, data de nascimento e endereço).

O webhook da Principia não traz cookies do navegador nem UTMs. Por isso o Track Combo cruza a solicitação com a visita registrada pela Web Tag na sua página de vendas, principalmente pelo email do aluno, e completa o evento com os identificadores de clique (fbp, fbc, gclid, ttclid) e as UTMs da visita antes de enviar pros pixels.

# Requisitos

• Conta de parceiro na Principia
• Projeto criado no TrackCombo
• Web Tag instalada na página de vendas do curso, pra venda ser ligada ao clique no anúncio
• Pelo menos um pixel cadastrado no projeto com a API de Conversões ativa

# Passo a Passo

# 1. Adicione a Integração no TrackCombo

1. Abra seu projeto no TrackCombo
2. Vá em Integrações
3. Clique em + Nova Integração
4. Selecione Principia
5. Copie a URL do webhook gerada pelo TrackCombo

# 2. Configure o Webhook na Principia

1. Acesse o Portal do Parceiro
2. Vá em Configurações > Integrações > Webhooks
3. Clique em Criar webhook
4. Cole a URL copiada do TrackCombo
5. Salve a configuração

# 3. Teste a Integração

1. Crie uma solicitação de teste na Principia
2. No TrackCombo, acesse o projeto e vá na aba Eventos
3. Verifique se os eventos de status estão sendo recebidos
4. Confirme que os dados do aluno e da transação foram registrados

# Eventos de Status da Principia

A Principia envia eventos conforme o progresso da solicitação:

• basic_info_incomplete: aluno iniciou mas não completou informações básicas
• document_info_incomplete: documentação pendente
• approved: solicitação de crédito aprovada
• waiting_signature: contrato enviado ao aluno, aguardando assinatura
• signed: contrato assinado
• waiting_payment: aguardando pagamento ou análise de crédito
• made_effective: venda efetivada, aluno ativo
• paid_first_installment: primeira parcela paga

# Pixels que funcionam com a Principia

A Principia gera um evento de compra (purchase) no Track Combo a partir das notificações que chegam no webhook. A conversão que importa pros anúncios é a venda efetivada (made_effective). Cada pixel recebe o evento com o nome que a plataforma de anúncio espera.

# Facebook (Meta)

Venda da Principia vira Purchase na API de Conversões, com valor, moeda, ID da solicitação e dados do aluno. Precisa do Token de Conversão cadastrado no pixel. Veja como configurar o pixel do Facebook.

# Google Ads

Venda da Principia vira a conversão de compra do Google Ads. O envio usa o Conversion Label que você cadastra no pixel pro evento purchase; sem label, a venda não é enviada. Veja como configurar o pixel do Google Ads.

# GA4 (Google Analytics)

Venda da Principia vira purchase no GA4 pelo Measurement Protocol, com valor, moeda, ID da solicitação, os cursos e as UTMs da visita. Precisa do API Secret no pixel. Veja como configurar o GA4.

# TikTok

Venda da Principia vira CompletePayment na Events API do TikTok. Precisa do token de acesso no pixel. Veja como configurar o pixel do TikTok.

# Pinterest

Venda da Principia vira checkout, o evento de compra da API de Conversões do Pinterest. Precisa do token no pixel. Veja como configurar o pixel do Pinterest.

# Taboola

Venda da Principia vira make_purchase. Só vão pro Taboola as vendas de quem chegou por um anúncio do Taboola (com o clique tbclid registrado pela Web Tag). Veja como configurar o pixel do Taboola.

# OpenAI (anúncios no ChatGPT)

Venda da Principia vira order_created na Conversions API da OpenAI. Veja como configurar o pixel da OpenAI.

# Dados Traqueados

A integração envia automaticamente:

• ID da solicitação
• Valor do checkout (convertido de centavos pra reais) e moeda (BRL)
• Cursos associados (ID e nome)
• Nome, email e telefone do aluno
• Data de nascimento
• Cidade, estado, CEP e rua

# Dicas Importantes

• O evento made_effective é o mais importante: indica a conversão final
• Valores são enviados em centavos (ex: R$ 2.990,00 = 299000) e o TrackCombo converte automaticamente

# Problemas Comuns

Como instalar o pixel do Facebook na Principia?
Cadastre o pixel do Facebook com o Token de Conversão no seu projeto do Track Combo e conecte a Principia pelo webhook (passo a passo acima). A venda chega no Facebook como Purchase pela API de Conversões, sem depender do navegador do aluno.

A Principia envia conversões pro Google Ads?
Sim. Com a integração ativa e o pixel do Google Ads cadastrado com o Conversion Label de compra, a venda da Principia é enviada como conversão. Como o webhook não traz o gclid, ele vem da visita registrada pela Web Tag na página de vendas.

Quais status da Principia viram compra nos pixels?
A integração transforma em compra as notificações que a Principia manda pro webhook. Como a conversão final é made_effective, status intermediários (cadastro incompleto, aprovado, aguardando assinatura) não deveriam ir pros pixels como compra. Se o seu webhook na Principia notifica todos os status, fale com o suporte do Track Combo pra filtrar só a venda efetivada no seu projeto.

Eventos não chegam?

• Verifique se a URL do webhook está correta no portal da Principia
• Confirme que o webhook está ativo
• Consulte o suporte da Principia se necessário

Conversão não registra como purchase?

• Verifique se o status made_effective está mapeado como evento de compra no TrackCombo
• Confira na aba Eventos se o payload está chegando completo