CL-192 - Plano de GA4 Data API e Meta Ads API read-only

Resumo

Foi formalizado no RNT o plano técnico para migrar a leitura de Analytics antigo para GA4 Data API e preparar leitura read-only de Google Ads e Meta Ads, com foco em ROI real e operação assistida por IA.

Entregas

• docs/documentacao_tecnica/PLANO_GA4_META_ADS_API_READONLY.md
• docs/backlog/BK-192-ga4-meta-ads-api-readonly.md
• collector isolado em /opt/rnt-collectors/ga4/
• ajuste de schema em campanhas_metricas_importadas para aceitar campanha_id nulo
• primeira gravação real em campanhas_metricas_importadas para o período 2026-03-24 a 2026-03-30
• cron diário em /etc/cron.d/rnt-ga4-collector
• tabela campanhas_aliases criada para aliases explícitos de campanha
• relatório report_pending_campaigns.py adicionado ao collector GA4
• desenho mínimo do braço google_ads read-only incorporado ao plano
• credenciais mínimas de Google Ads provisionadas no ambiente
• collector isolado google_ads criado em /opt/rnt-collectors/google_ads/
• endpoint ajustado para v22

Observações

• nenhuma automação de publicação de mídia foi ativada
• o collector nasce em modo read-only sobre GA4 e grava apenas snapshots agregados no banco local
• a primeira carga real gravou 110 snapshots agregados:
• 87 com status_vinculo=sem_campanha
• 23 com status_vinculo=vinculado
• o próximo risco técnico relevante não é mais a API, e sim o refinamento contínuo do vínculo entre campanhas do GA4 e a tabela campanhas
• a próxima frente técnica já está desenhada para Google Ads read-only, mas a conta real segue bloqueada por DEVELOPER_TOKEN_NOT_APPROVED