Google Ads Master

• Você está configurando uma nova conta do Google Ads ou integrando uma conta existente e precisa coletar configurações, ações de conversão, orçamentos e limites antes de fazer qualquer alteração.
• Você deseja relatórios de desempenho no nível de campanha ou de palavra-chave — CTR, ROAS, Parcela de Impressões na Pesquisa, CPA — interpretados com base na sua ação de conversão primária real, e não em totais mistos da interface.
• Você precisa investigar CTR baixo, diagnosticar discrepâncias no valor de conversão ou analisar dados de termos de pesquisa e geografia para tomar decisões de lance, negativação ou segmentação.
• Você deseja criar novas campanhas de pesquisa, grupos de anúncios ou palavras-chave em estado pausado a partir de uma especificação estruturada, com uma releitura GAQL pós-criação para confirmar o que foi gerado.

• Você precisa gerenciar tipos de campanha que não sejam de Pesquisa ou plataformas fora do Google Ads — esta habilidade é limitada aos fluxos de trabalho de Pesquisa do Google Ads.
• Você deseja uma otimização de campanha totalmente automatizada, sem etapa de confirmação humana; esta habilidade exige permissão explícita antes de qualquer operação de escrita.
• Você ainda não concluiu o onboarding mínimo (ID do cliente, autenticação, fuso horário de relatórios, ação de conversão principal) — a habilidade solicitará essas informações antes de prosseguir com análises ou operações de escrita.

Antes de qualquer análise ou alteração na conta, o Google Ads Master coleta um conjunto mínimo de dados necessários: ID do cliente, caminho OAuth/autenticação, token de desenvolvedor, fuso horário de relatórios, modelo de negócio, ação de conversão principal, metas de ROAS/CPA e permissões de escrita. Isso evita ações com base em contexto de conta incompleto ou incompatível.

Toda criação de campanha, grupo de anúncios e palavra-chave assume o status PAUSADO por padrão, a menos que o usuário solicite explicitamente o contrário. Orçamentos e lances nunca são modificados sem confirmação, e cada operação de escrita é seguida de uma releitura em GAQL para resumir IDs e status.

A análise de desempenho é ancorada na ação de conversão primária confirmada pelo usuário — nunca presumida como compra, lead ou cadastro. Os totais de conversão mistos exibidos na interface do Google Ads são sinalizados como não confiáveis até que o usuário confirme quais ações são contabilizadas.

Quatro scripts acompanham o skill: um helper compartilhado de cliente/configuração, um relatório de resumo de campanha (diagnósticos de CTR/ROAS/IS), um relatório de conversões primárias no nível de palavra-chave e um construtor de campanhas de Search pausadas a partir de uma especificação JSON. Todos os scripts utilizam o cliente gRPC Python google-ads.

As recomendações seguem um fluxo de trabalho consistente: segmente por grupo de intenção usando as palavras-chave reais do usuário e o mercado, aplique as ações manter/observar/reduzir/pausar/dividir/adicionar-negativos e sempre referencie os nomes de campanhas e palavras-chave junto às métricas para garantir acionabilidade.

A habilidade referencia padrões internos de GAQL e ressalvas da API para evitar problemas conhecidos de incompletude no REST, dando preferência ao cliente gRPC. Releituras pós-gravação confirmam id/nome/status/orçamento da campanha, id/status do grupo de anúncios e texto/correspondência/status da palavra-chave.

Um novo usuário conecta sua conta do Google Ads e a skill percorre o checklist de integração — coletando ID do cliente, autenticação, ação de conversão, metas e limites de segurança — antes de executar report_campaigns.py para produzir um resumo base de CTR, ROAS e Parcela de Impressões.

Um anunciante suspeita que sua ação de conversão principal está sendo diluída por micro-conversões na interface. A habilidade executa o purchase_keywords.py com escopo restrito à ação principal confirmada e identifica quais palavras-chave estão gerando resultados reais versus contagens infladas.

O CTR da campanha caiu e a causa não está clara. A skill coleta dados de termos de pesquisa e palavras-chave, diagnostica se o problema está na relevância dos anúncios, na variação de tipos de correspondência ou na Parcela de Impressões Perdidas por Classificação, e recomenda ações específicas de manter/pausar/dividir/negativar com base em evidências métricas.

Um usuário fornece um briefing de campanha com orçamentos, estratégia de lances, lista de palavras-chave, tipos de correspondência, negativos, textos de anúncio e URLs. A skill formata uma especificação em JSON, executa create_search_skeleton.py primeiro em modo de simulação (dry-run) e, em seguida, cria a estrutura como PAUSADA, lendo todos os IDs e status de volta para confirmação.