BK-192 - Modernizar Analytics para GA4 e Meta Ads API read-only

Objetivo

Atualizar o projeto para leitura moderna de dados de mídia e performance, substituindo a dependência do Analytics antigo e preparando um fluxo real de ROI para Google Ads e Meta Ads, sempre em modo read-only.

Entregue nesta rodada

• análise técnica do estado atual do projeto
• plano canônico em docs/documentacao_tecnica/PLANO_GA4_META_ADS_API_READONLY.md
• definição das fases:
• GA4 Data API read-only
• Google Ads read-only
• Meta Ads read-only
• motor de ROI consolidado
• property id GA4 confirmado: 383339823
• service account criada e validada para leitura GA4
• tabela campanhas_metricas_importadas ajustada para aceitar campanha_id nulo
• tabela campanhas_aliases criada para aliases explícitos de campanha
• collector isolado implantado em /opt/rnt-collectors/ga4/
• primeira coleta real concluída com gravação em campanhas_metricas_importadas
• cron diário configurado para a coleta GA4
• relatório de campanhas pendentes do GA4 implantado
• desenho técnico mínimo da Fase 1 de Google Ads read-only consolidado
• credenciais mínimas de Google Ads provisionadas no ambiente
• collector isolado google_ads iniciado em /opt/rnt-collectors/google_ads/
• bloqueio atual de Google Ads registrado:
• DEVELOPER_TOKEN_NOT_APPROVED

Motivo

• a leitura atual de Analytics no projeto ainda aponta para a API antiga / Universal Analytics
• para operar mídia com ROI real, a IA precisa ler dados atuais e confiáveis
• a operação desejada é assistida:
• IA sugere
• humano aprova
• humano controla crédito e faturamento
• regra de negócio associada:
• todas as peças com venda online entram em mídia;
• a leitura de ROI serve para escalar, manter ou pausar, não para decidir elegibilidade inicial.

Próximos passos

• revisar o vínculo entre utm_campaign e as campanhas reais que devem virar vinculado
• ampliar a leitura para Google Ads read-only
• ampliar a leitura para Meta Ads read-only
• consolidar motor local de ROI por peça e campanha
• provisionar as credenciais mínimas de Google Ads:
• solicitar aprovação Basic ou Standard do developer token do Google Ads para contas reais
• após a aprovação, rerodar o dry-run do collector google_ads
• só então gravar o primeiro snapshot diário de Ads no banco