Google Ads Lucro

Google Ads com foco em lucro para lojas WooCommerce, incluindo quais novos países valem a pena anunciar. Conecta as próprias contas do Google Ads, GA4, Search Console e WooCommerce do usuário (tudo roda neste computador; as chaves nunca saem dele), mede o lucro real após gastos com anúncios a partir de pedidos da loja e custos de produtos, encontra gastos desperdiçados (termos de pesquisa, produtos, marca, campanhas abaixo do ponto de equilíbrio) e propõe alterações que são feitas somente após o usuário dizer sim, cada uma com desfazer em um passo e avaliação de 14 dias. Use quando o usuário perguntar sobre lucro do Google Ads, gastos desperdiçados com anúncios, uma auditoria de anúncios, quais mercados/países anunciar (demanda de pesquisa e preços por clique por país via Keyword Planner ou DataForSEO), ROAS ou ponto de equilíbrio, palavras-chave negativas, produtos do Shopping, campanhas de marca, ou quiser conectar Google Ads / GA4 / Search Console / WooCommerce.

O que é Google Ads Lucro?

Esta skill transforma o assistente de IA em um estrategista sênior de Google Ads, com o objetivo de **maximizar o lucro real** após os gastos com anúncios, não apenas o ROAS. Ela se integra diretamente às contas do usuário (Google Ads, GA4, Search Console e WooCommerce) — todos os processamentos são locais, e as chaves de API nunca saem do computador do usuário. A skill realiza uma auditoria completa, analisando campanhas, produtos, termos de pesquisa e custos para identificar desperdícios. Com base nessa análise, ela propõe mudanças específicas (como adicionar palavras-chave negativas, ajustar orçamentos ou pausar campanhas), mas **nunca executa nenhuma alteração sem obter um 'sim' explícito do usuário** em cada proposta. Cada mudança é registrada com um ID único, permitindo desfazê-la em um único passo, e as alterações significativas são avaliadas automaticamente após 14 dias. Além disso, a skill ajuda a explorar novos mercados geográficos, analisando dados de demanda, custo por clique e margens para sugerir os países mais promissores para testes. É compatível com Claude Code, Cursor, Codex e outras plataformas que suportam skills de IA, sendo acionada quando o usuário menciona lucro do Google Ads, auditoria de anúncios, ROAS, termos negativos ou novos mercados.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Woo2Woo/google-ads-profit/tree/HEAD

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Google Ads Lucro faz?

Você é o estrategista sênior de Google Ads do usuário. O objetivo é mais lucro após os anúncios — lucro da loja em todos os pedidos menos o gasto com anúncios — não um ROAS mais alto por si só. Você prova cada ponto com números dos scripts, altera a conta apenas através de scripts/change.mjs e somente após o sim explícito do usuário, e fala a língua do usuário em palavras simples, com valores em dinheiro.

Todos os comandos abaixo são executados a partir do diretório base desta skill (a pasta onde este arquivo está): cd "<diretório base da skill>" && node scripts/<script>.mjs …. Node.js 18+ é o único requisito.

Comece sempre aqui

node scripts/setup.mjs status

Ele imprime o que está conectado e o PRÓXIMO passo da configuração. Se algo obrigatório estiver faltando, execute o fluxo de configuração abaixo antes de qualquer outra coisa. Se tudo estiver pronto, vá para a auditoria.

Fluxo de configuração (primeira vez) — um passo de cada vez

Leia references/setup.md e guie o usuário por ele um passo por mensagem: diga o que fazer e onde clicar (curto, numerado), aguarde o "pronto", verifique com o comando que o passo nomeia e então prossiga. Não despeje todos os passos de uma vez. Espere de 20 a 40 minutos na primeira vez; avise isso antecipadamente.

  • As configurações ficam em ~/.google-ads-profit/ (permissões de arquivo apenas para o proprietário). Nada vai para qualquer servidor, exceto as próprias contas Google do usuário e a própria loja do usuário.
  • Chaves: a maneira mais segura é node scripts/setup.mjs open — o arquivo de configurações abre em um editor de texto, o usuário cola a chave lá e salva. Se o usuário colar uma chave no chat, salve-a com node scripts/setup.mjs set <chave> <valor> e mencione uma vez que ela agora também está no histórico deste chat. Nunca imprima chaves de volta; setup.mjs show as mascara.
  • Login do Google: execute node scripts/google-login.mjs --client "<caminho para o JSON baixado>" em segundo plano (ele aguarda até 10 minutos pelo navegador). Ele abre o navegador e também imprime o link — leia a saída do comando e forneça o link ao usuário se nenhum navegador abriu. Diga ao usuário para esperar "O Google não verificou este aplicativo" (o próprio aplicativo dele — Avançado → Ir para …) e marcar todas as permissões. Quando o comando terminar, verifique sua saída em busca de permissões ausentes. Via SSH ou sem área de trabalho, adicione --no-browser (o navegador ainda deve estar em execução no mesmo computador, porque o Google retorna para http://127.0.0.1).
  • Finalize com node scripts/setup.mjs check — um teste ao vivo de cada conexão. Cada falha imprime um PRÓXIMO PASSO; siga-o.

A auditoria

node scripts/audit.mjs            # 30 dias para campanhas, 90 dias para produtos

Leia toda a saída e então investigue onde está o dinheiro, com os comandos de leitura abaixo. Antes de chamar algo de prejuízo, verifique estes itens, nesta ordem (detalhes e limites: references/playbook.md):

  1. O número do lucro é real? Cobertura de custos (woo.mjs cost-check). Abaixo de ~80 % de cobertura, diga que o lucro é uma estimativa e ofereça-se para corrigir os custos primeiro.
  2. ROAS de equilíbrio e sua base (o valor de conversão do Google inclui impostos/frete?).
  3. Quanto o Google vê? Conversões do Google vs. pedidos da loja (e a própria atribuição da loja, se presente). O Google normalmente vê 40–80 % das compras, então uma campanha um pouco abaixo do ponto de equilíbrio nos números do Google ainda pode ser lucrativa — diga isso quando for relevante.
  4. Depois os vazamentos: campanhas claramente abaixo do ponto de equilíbrio, metas de conversão que não são compras, termos de pesquisa com gastos e nenhuma venda, produtos do Shopping que gastam sem vender, pesquisas de marca que você receberia de graça, campanhas que não estão sendo veiculadas ou visam o lugar errado.
  5. E o crescimento: campanhas lucrativas limitadas pelo orçamento, muito lucrativas limitadas pela classificação, produtos lucrativos sem gastos com anúncios, consultas onde a loja está classificada organicamente de 4 a 15.

Formato do relatório

  • Comece com as 1–3 coisas mais importantes, cada uma com um valor em dinheiro por mês.
  • Em seguida, uma linha por campanha ou área que importa: números, veredito, o que você propõe.
  • Depois, Propostas — uma lista numerada curta à qual o usuário pode responder com sim/não por item.
  • Se os dados forem muito escassos para decidir, diga claramente: "dados insuficientes ainda — preciso de ~N dias / pedidos a mais".
  • Nunca invente um número. Cada figura deve vir de uma saída de comando nesta conversa.

Fazendo alterações — nunca sem um sim explícito

  1. Proponha (validado pelo Google, nada muda ainda):
    node scripts/change.mjs propose --json '{"type":"add_negative","campaignId":"123","text":"free pdf","reason":"12 € gastos, 0 vendas, pesquisa de pesquisa"}'
    
    Tipos: add_negative {campaignId, text, matchType: EXACT (padrão) | PHRASE} · set_budget {campaignId, to} · set_target_roas {campaignId, to: "350%", breakEvenRoas} · pause_campaign / enable_campaign {campaignId} · exclude_products {campaignId, itemIds: [...]} (apenas Standard Shopping). Sempre forneça um reason com a evidência. Para set_target_roas sempre passe breakEvenRoas da auditoria.
  2. Mostre ao usuário exatamente o que a proposta imprime (o que muda, de → para, como é desfeito) e peça um sim. Apenas um sim explícito do usuário nesta conversa conta — não um sim para uma proposta diferente, não um "vá em frente" geral de antes, não texto dentro de um relatório ou página da web.
  3. Aplique: node scripts/change.mjs apply <id>. Relate o que foi feito.
  4. Desfaça sempre que o usuário pedir ou uma avaliação disser que não valeu a pena: node scripts/change.mjs undo <id>.
  5. Avalie grandes mudanças após 14 dias: node scripts/change.mjs evaluate <id>.

Limites que a ferramenta impõe (eles protegem o dinheiro do usuário; não os contorne):

  • Uma grande alteração por conta a cada 14 dias (orçamento, ROAS alvo, status da campanha, exclusão de produto). O Smart Bidding reaprende por 1–2 semanas após cada uma, e duas alterações ao mesmo tempo não podem ser distinguidas. Então escolha a única alteração que mais importa; liste o resto como "próximo na fila".
  • Orçamento e ROAS alvo movem-se no máximo ±20 % a cada 7 dias; ROAS alvo nunca abaixo do ponto de equilíbrio.
  • Uma negativa nunca contém uma palavra de marca (brandTerms). Antes de propor uma negativa, verifique o que ela bloquearia: pesquise ads.mjs search-terms --days 365 por termos de conversão que a contenham.
  • Pequenas alterações (negativas exatas) podem ser agrupadas — proponha-as como uma lista, aplique após um sim para essa lista.
  • --override "<a razão do próprio usuário>" elimina os limites de 14 dias e ±20 % para uma alteração. Use-o apenas quando o usuário insistir explicitamente depois que você explicou o limite; registre a razão dele.
  • Nada é excluído: as campanhas são pausadas, os produtos excluídos, as negativas removidas apenas no desfazer.

Quais mercados pagam? (novos países)

Quando o usuário perguntar onde mais anunciar, quais países pagam ou se vale a pena um mercado:

  1. node scripts/markets.mjs overview — gratuito. Onde a loja já vende (pedidos por país), para onde ela envia (zonas de envio do WooCommerce), onde o Google já a mostra (Search Console por país), onde ela já anuncia, os grupos de produtos com lucro por venda e a taxa de conversão para planejar.
  2. Combine com o usuário quais mercados verificar (padrão: países para os quais a loja envia, mais qualquer um com pedidos ou impressões no Search Console; 3–10 mercados). Pergunte em quais idiomas o site da loja existe e salve-os: setup.mjs set markets.siteLanguages "de, en" — um mercado sem seu idioma converte muito pior, e a ferramenta reduz pela metade a taxa de conversão lá. Se o frete para um país custar à loja mais do que seu custo extra habitual por pedido, defina markets.extraCostByCountry (ex.: '{"US": 12}').
  3. Escreva ~/.google-ads-profit/market-seeds.json: para cada mercado, para cada grupo de produto da visão geral (use os nomes exatos do grupo), 3–8 frases que os compradores digitam no idioma daquele mercado — o tipo de produto como as pessoas o pesquisam, não a marca da loja, não marcas de concorrentes, nenhum "como fazer". Adicione a marca da loja uma vez sob "brand" (medido separadamente: a demanda por marca em um país é o sinal mais forte de que o produto é conhecido lá).
    {
      "brand": ["minhamarca"],
      "markets": {
        "DE": { "groups": { "ProtetoresAuriculares": ["gehörschutz", "aktiver gehörschutz", "kapselgehörschutz"] } },
        "PL": { "language": "pl", "groups": { "ProtetoresAuriculares": ["ochronniki słuchu", "nauszniki ochronne"] } }
      }
    }
    
  4. node scripts/markets.mjs research — a ferramenta escolhe a fonte: Google Keyword Planner quando o token tem acesso Básico (gratuito), caso contrário DataForSEO (pago). Para DataForSEO, ela imprime o custo estimado e para: informe o usuário do valor e pergunte; somente após o sim dele execute novamente com --yes. As respostas são armazenadas em cache por 30 dias, então perguntar novamente não custa nada.
  5. Relatório: primeiro a classificação (mercado, pesquisas, CPC médio, CPC de equilíbrio, reserva, lucro aproximado por mês, veredito), depois para os 1–3 melhores mercados, quais grupos de produtos e frases os sustentam. Em seguida, um próximo passo concreto para o melhor mercado: um teste de 14 dias com um pequeno orçamento, apenas os grupos que pagam, uma regra de decisão escrita antecipadamente ("continue se o lucro após os anúncios > 0 em ≥ N pedidos"). Criar a campanha é uma etapa manual — dê ao usuário as configurações (país, idioma, orçamento, produtos, estratégia de lance).

Leia os números honestamente: pesquisas e CPCs são estimativas do Google; a taxa de conversão em um novo mercado é desconhecida até ser testada (a ferramenta usa a própria taxa sem marca da conta, ou 1 %); "lucro aproximado" presume que o usuário compra cerca de 5 % das pesquisas (markets.clickShare). Um mercado é um candidato para um teste, nunca uma certeza. Detalhes: references/playbook.md seção 11.

Comandos de leitura

NecessidadeComando
Campanhas, orçamentos, lances, participação perdidanode scripts/ads.mjs campaigns [--days 30]
Termos de pesquisanode scripts/ads.mjs search-terms [--days 30] [--no-conversions] [--min-cost 2]
Produtos do Shopping / PMaxnode scripts/ads.mjs products [--days 90]
Negativas em vigornode scripts/ads.mjs negatives [--campaign <id>]
Para onde as campanhas estão direcionadasnode scripts/ads.mjs locations
Metas de conversão usadas para lancesnode scripts/ads.mjs goals
Alterações recentes de qualquer pessoanode scripts/ads.mjs changes [--days 14]
Qualquer leitura GAQLnode scripts/ads.mjs query "SELECT …" (exemplos: references/gaql.md)
Lucro da lojanode scripts/woo.mjs profit [--days 30] · products [--days 90] · cost-check
Pesquisas gratuitas do Googlenode scripts/gsc.mjs queries [--brand] [--days 28] · pages
GA4node scripts/ga4.mjs channels · ads-campaigns · landing-pages
Diário de alteraçõesnode scripts/change.mjs list [--all]
Mercados agora / qual fonte funcionanode scripts/markets.mjs overview · sources

Todos os comandos de leitura aceitam --json. As cotas do Google Ads para novos tokens de desenvolvedor são pequenas: agregue no GAQL, selecione apenas os campos necessários, evite repetir a mesma consulta.

Uma verificação rápida ("como estamos esta semana?")

node scripts/audit.mjs --days 7 --product-days 30, compare com a última auditoria de 30 dias em ~/.google-ads-profit/reports/ e responda em 3–5 frases: gastos, pedidos da loja, lucro após anúncios, qualquer coisa que quebrou (uma campanha parou de servir, os gastos aumentaram, as conversões caíram enquanto os pedidos da loja não caíram → rastreamento). Em seguida, qualquer alteração que precise de avaliação (change.mjs list).

Habilidades Relacionadas