Criar campanha de Pesquisa no Google Ads

Antes de começar, aplique account-conventions (contexto, segurança, nomenclatura) e, ao escrever anúncios, ad-copy-principles.

Passo 1 — Briefing (pergunte só o que faltar no contexto)

Necessário: produto/oferta, URL da landing page, região, idioma, orçamento diário, conversão medida, CPA alvo (ou valor da venda), se é Marca ou Não-marca. Se houver URL, leia a página para extrair benefícios, provas, oferta e termos que o cliente usa.

Se a conta tiver dados (MCP/conector/CSV), consulte antes: termos de pesquisa que já convertem, negativas existentes e campanhas que possam canibalizar a nova.

Passo 2 — Mapa de intenção → grupos

Liste as intenções de busca de quem compraria (problema, solução, categoria, comparação, local, preço). Cada intenção forte vira um grupo. Mostre ao usuário uma tabela:

Mire 3-7 grupos para começar. Pouca verba (< R$ 50/dia) → 2-3 grupos, só os de maior intenção.

Passo 3 — Palavras-chave

• 5-20 por grupo, todas da mesma intenção. Frase + Exata por padrão (veja account-conventions §5).
• Máximo 80 caracteres e 10 palavras por palavra-chave; sem símbolos além de -, &, ., '.
• Se houver ferramenta de volume (Planejador de palavras-chave via conector), use para priorizar; senão, sinalize que os volumes não foram verificados.

Passo 4 — Anúncios

1 RSA por grupo (2 se houver hipótese clara para testar), 15 títulos e 4 descrições seguindo ad-copy-principles. Título com a palavra-chave principal do grupo em pelo menos 2 posições. Caminhos (Path 1/2) com a palavra-chave.

Passo 5 — Negativas

• Nível campanha: termos irrelevantes óbvios do nicho + marca própria (se for Não-marca).
• Sugira uma lista compartilhada da conta se não existir (vaga, emprego, curso, grátis, pdf, download, reclame aqui…, adaptado ao negócio).
• Confira conflitos com as palavras-chave positivas (o validador faz isso).

Passo 6 — Extensões

Escreva 4-8 sitelinks (texto + 2 descrições + URL), 6-10 frases de destaque e 1 snippet estruturado. Entregue-os no plano (passo 8); o usuário adiciona no Editor/interface, ou você publica via conector se houver.

Passo 7 — Gerar e validar o CSV

Gere out/<NomeDaCampanha>.csv no formato de references/editor-csv-format.md (UTF-8, vírgula, cabeçalho exato). A campanha sempre com Campaign Status = Paused.

Rode o validador e corrija até zerar os erros:

python3 <pasta-desta-skill>/scripts/validate_editor_csv.py out/<NomeDaCampanha>.csv

(<pasta-desta-skill> é o diretório onde este SKILL.md está.) Avisos (warnings) podem ficar, mas explique-os.

Passo 8 — Entregar

Salve também out/<NomeDaCampanha>-plano.md com: resumo da estratégia, tabela de grupos, orçamento e lance, negativas, extensões, o que medir na primeira e segunda semana e critérios para mudar o lance (ex.: "trocar para CPA desejado após 30 conversões").

Diga ao usuário como importar:

1. Google Ads Editor → baixar a conta → Conta › Importar › De arquivo → escolha o CSV
2. Revise as alterações pendentes → Publicar
3. A campanha sobe pausada; ative quando revisar extensões e conversões.

Publicação direta (opcional)

Com o servidor do plugin (simular_campanha_pesquisa / criar_campanha_pesquisa), em vez de importar no Editor:

1. Monte o plano (mesmos grupos, palavras-chave, RSAs e negativas do CSV) e chame simular_campanha_pesquisa. Ela valida localmente com as mesmas regras do validador e roda validate_only na API; nada é criado.
2. Mostre ao usuário o resumo devolvido e peça um ok explícito. Sem ok, pare aqui.
3. Com o ok, chame criar_campanha_pesquisa com o mesmo plano e o código de confirmação. Qualquer mudança no plano invalida o código: simule de novo e peça novo ok.
4. A campanha nasce pausada (não há como criar ativa) e a mudança vai para o changelog. Informe o ID criado.

Extensões (sitelinks, destaques, snippets) ainda não são criadas pela ferramenta: entregue-as no plano para o usuário adicionar. Sem o servidor, só use outro conector com escrita (ex.: Windsor.ai execute_action com google_ads) se o usuário confirmar explicitamente depois de ver o plano; crie tudo pausado e registre em google-ads-changelog.md.

Variações

• Performance Max: em vez de palavras-chave, entregue grupo de recursos (15 títulos curtos, 5 longos, 5 descrições, sinais de público, temas de pesquisa) em markdown; o CSV do Editor não cobre bem imagens/vídeos.
• Campanha de Marca: 1 grupo, Exata + Frase da marca e variações/erros de digitação, CPC baixo, IS alvo.