/relatorio-ads

Transforma dados de campanhas Google Ads e Meta Ads num relatório executivo semanal com variação, alertas e recomendações. Use com “relatório de ads”, “performance da semana”, “relatorio google ads” ou /relatorio-ads.

Como funciona

O que lê

• GOOGLE_ADS_* (env): se presentes, métricas via API (GAQL) — confirmar na documentação oficial GAQL da versão instalada os nomes de campo antes da primeira query da sessão; campos de referência: campaign.name, metrics.cost_micros, metrics.clicks, metrics.impressions, metrics.conversions, metrics.ctr
• Sem GOOGLE_ADS_*: CSV exportado do Google Ads em dados/
• Meta Ads: sempre por CSV do Meta Ads Manager em dados/ (sem API de insights no inventário de integrações)
• _memoria/empresa.md, _memoria/estrategia.md (contexto), _memoria/preferencias.md (se o dono já entende CPM/CTR/CPA)
• marketing/campanhas/relatorios/ — relatório da semana anterior, para variação período a período

Passos

1. Perguntar onde estão os exports da semana, se não indicados junto ao pedido.
2. Se GOOGLE_ADS_* existirem, consultar a API por GAQL; senão, ler o CSV do Google Ads em dados/. Ler sempre o CSV da Meta em dados/. Avisar quando faltar coluna/campo crítico.
3. Buscar o relatório anterior mais recente em marketing/campanhas/relatorios/ para calcular variação de investimento, cliques, impressões, CTR, CPC/CPM, conversões e CPA.
4. Redigir o resumo executivo com os números principais e a variação de cada um.
5. Detalhar por canal os melhores e piores desempenhos (campanha/grupo/palavra-chave no Google; campanha/criativo na Meta) e, no Google, termos de busca sem conversão.
6. Gerar alertas por severidade (vermelho/amarelo/verde): queima de orçamento sem retorno, queda de CTR, frequência Meta > 3,0 (saturação) ou > 4,0 (ruído), CPA subindo, oportunidade de aumento de orçamento com impression share perdida.
7. Redigir 3 a 5 recomendações concretas e nomeadas (campanha, valor, motivo) para a semana seguinte.
8. Salvar o relatório em marketing/campanhas/relatorios/<AAAA-MM-DD>.md com frontmatter (período, investimento total, conversões totais, CPA médio, canais cobertos).
9. Mostrar no chat o resumo executivo, alertas e recomendações, apontando o caminho do arquivo.
10. Perguntar se o resumo deve ir por email a um cliente; se sim, encaminhar para email-profissional.

O que grava e onde

• marketing/campanhas/relatorios/<AAAA-MM-DD>.md

Pontos de aprovação

• Envio do resumo por email: só ocorre se o usuário confirmar.

Falha cedo

• Nenhum export indicado nem encontrado em dados/: perguntar UMA vez o caminho dos arquivos da semana.
• GOOGLE_ADS_* ausentes: usar caminho manual (CSV) e dizer que a API desbloquearia leitura automática sem exportação manual toda semana.
• CSV com colunas em formato diferente do esperado (idioma, estrutura de conta): avisar qual coluna não foi reconhecida e pedir confirmação de mapeamento antes de calcular.
• Dado truncado ou ilegível: declarar “dados incompletos” e seguir só com o que der para calcular — nunca inventar número.

Verificação final

marketing/campanhas/relatorios/<AAAA-MM-DD>.md existe, contém frontmatter completo e pelo menos uma comparação com o período anterior — confirmar com cat do arquivo gerado.