Compatibilidade de atribuição de anúncios

Estado inicial da V1

A primeira versão da API usa leads.anuncio como a fonte confirmada para contatos de anúncios. O valor é retornado como legacy_value; ele só também aparece em source_url quando começa com http:// ou https://.

Essa escolha evita inventar IDs da Meta. Uma URL, um sourceID ou um nome livre não prova, isoladamente, campaign_id, adset_id ou ad_id.

Preparação para Meta

A tabela histórica lead_ad_attributions recebe colunas normalizadas e opcionais para anúncio, conjunto, campanha, criativo e confiança. Elas começam nulas e não duplicam leads, contatos, payloads nem eventos. A API não consulta a Graph API durante a requisição do cliente.

Quando a ingestão Meta estiver validada com dados reais, o resolvedor poderá priorizar a atribuição mais recente e confiável da mesma clínica e do mesmo contato:

1. lead_ad_attributions resolvida e tenant-safe;
2. fallback para leads.anuncio;
3. null quando não existe evidência.

Os campos públicos já são estáveis (source, status, ad_id, adset_id, campaign_id e equivalentes). Assim, ativar o resolvedor no futuro não exige renomear nem mudar o tipo das respostas.

Limites deliberados

• Não há meta_payload jsonb nem cópia integral de resposta da Meta.
• Não há tabela materializada de contatos por anúncio.
• IDs Meta só serão preenchidos com evidência validada.
• Dados de outra clínica nunca participam do resolvedor, mesmo que IDs externos coincidam.