P3.3 · Conversions API e conversão offline

Depende de P3.1 e P3.2. **É o prompt mais importante do projeto.**

Por que este é o mais importante

Sem ele, a Meta e o Google otimizam para clique e formulário, e a verba compra curioso. Com ele, os dois algoritmos passam a caçar dono de loja que paga.

Nenhuma campanha é ativada antes de todos os critérios de aceite deste prompt estarem verdes. Essa é a condição de partida do projeto inteiro.

O prompt

Implemente a medição server-side completa no app atribuicao.

1. Conversions API da Meta

Tarefa Celery enviar_capi(evento_id):

copiarevent_name, event_time, event_id, action_source="website", event_source_url
user_data:
  em   = sha256(email minusculo, sem espaco)
  ph   = sha256(telefone E.164, sem "+" e sem separador)
  fn, ln = sha256(nome e sobrenome minusculos)
  fbc  = cookie _fbc ou reconstruido "fb.1.<ts_ms>.<fbclid>"
  fbp  = cookie _fbp
  client_ip_address, client_user_agent
custom_data:
  value, currency="BRL", content_name, content_ids

Deduplicação: o event_id tem que ser o mesmo do pixel. Se não for, a Meta conta duas vezes e o ROAS mente para cima.

2. Os valores — a parte que ensina o algoritmo

Mande o valor econômico, não o preço de etiqueta:

Com essa hierarquia o algoritmo aprende que um lojista grande vale 24 vezes um curioso.

Documente a origem de cada valor em atribuicao/README.md e revise a cada trimestre com os números reais do painel.

3. Conversão offline no Google

Use as ferramentas criadas em P3.2. No mesmo gatilho do CAPI:

1. Se houver gclid, wbraid ou gbraid → upload_offline_conversion
2. Sempre → upload_enhanced_conversion com e-mail e telefone em hash, para cobrir quem perdeu o click id
3. Quando o lead vira Hub → adjust_offline_conversion para corrigir o valor da conversão original

4. Gatilhos

No webhook checkout.session.completed (o gancho de P0.3) e no fim do Raio-X:

1. Recupera o Toque de último toque do lead
2. Enfileira CAPI se houver sinal da Meta
3. Enfileira conversão offline se houver click id do Google
4. Enfileira conversão aprimorada sempre

5. Robustez

• Fila Celery dedicada, com retry exponencial por até 24 horas
• EventoEnviado guardando payload e resposta, para auditoria
• Falha de CAPI nunca derruba o checkout. O dinheiro entra primeiro, a medição é consequência. Escreva o teste que prova isso

6. Privacidade

• Nunca e-mail ou telefone em claro. Sempre SHA-256 do valor normalizado
• Aviso de privacidade das landings registrando o compartilhamento pseudonimizado para medição
• Sem consentimento de cookie: não enviar fbp, fbc nem IP. Enviar só o evento com dados em hash

Critérios de aceite — todos obrigatórios

1. Gerenciador de Eventos da Meta mostrando Purchase recebido pelo pixel e pela CAPI, marcado como deduplicado. Capture a tela
2. Qualidade de correspondência igual ou acima de 6,0. Abaixo disso faltam parâmetros — corrija antes de seguir
3. Conversão offline aparecendo no Google Ads em até 24h, com valor e order_id. Capture a tela
4. Teste de hash: e-mail com maiúscula, espaço e ponto no Gmail produz o hash normalizado correto
5. Teste de que falha da CAPI não derruba o webhook da Stripe
6. Teste de reconstrução do fbc a partir do fbclid
7. Teste de adjust_offline_conversion ajustando o valor quando o lead vira Hub

Só depois destes sete itens verdes, siga para P4.1.