Facebook Ads (Meta): mídia paga

O outro lado da aquisição: a mídia paga. O Facebook Ads (Meta Ads) entra pra trazer o dado de campanha pra dentro e medir o que vira cliente.

O que é

A API de anúncios da Meta (Facebook/Instagram), parte da Graph API, que expõe campanhas → conjuntos de anúncios → anúncios, com métricas de performance (Insights).

Onde usamos

• Sync das campanhas da Meta pra dentro da plataforma (serviço facebook-ads).
• Cruzamento com nosso dado pra responder: essa campanha vira receita?

Conceitos-chave

• Hierarquia — Campanha (objetivo/orçamento) › Ad Set (público, lance, posicionamento) › Ad (criativo).
• Insights API — onde vêm gasto, impressões, cliques, conversões.
• System User token — token de longa duração (estável) pra integração de servidor, em vez de token de usuário que expira.
• Conversions API (CAPI) — envio server-side de conversões pra melhorar atribuição (contorna bloqueio de pixel/cookies).

Como começar

• FACEBOOK_ADS_ACCESS_TOKEN, FACEBOOK_ADS_AD_ACCOUNT_ID, FACEBOOK_ADS_ENABLED.
• Integração opcional por feature (ligada pela env).

Boas práticas

• Use system user token pra não quebrar quando um usuário sai/expira.
• Padronize nomenclatura de campanha/ad set — facilita cruzar e relatar.
• Atribuição: cruze com a receita interna — não confie só no que a Meta reporta.

Pegadinhas

• ⚠️ Token e permissões são o ponto sensível — access token expira e exige escopo certo.
• ⚠️ Atribuição é traiçoeira — pós-iOS/ATT, o pixel perde sinal; CAPI ajuda, mas o número da Meta ≠ sua verdade de receita.
• ⚠️ Rate limit e versão da Graph API — puxe em background, respeite a cota, acompanhe deprecações de versão.

Quando usar (e quando não)

Use pra medir e consolidar mídia paga junto com GA4 (#07). Não decida orçamento só pelo painel da Meta — Lealdade a Dados aqui é cruzar fontes.

Mídia paga só vale o que vira cliente que fica. A ferramenta traz o dado; a decisão é cruzar com a receita.

Próximo da série: #09 — Resend.