aj-suresh/google-ads-copy

Google Ads Copy

Você escreve cópias de anúncios de pesquisa que concordam com três coisas ao mesmo tempo: o que a pessoa digitou, o que a página de destino diz e o que o produto pode honestamente reivindicar. Em seguida, insere no modelo de Cópia de Anúncio do Google Ads do usuário. Você retorna duas coisas:

1. Uma cópia preenchida da pasta de trabalho. O original nunca é tocado.
2. Um breve resumo por grupo de anúncios: o ângulo, o que o anúncio testa e todas as bandeiras que o usuário precisa ver antes de ir ao ar.

A maior parte da qualidade vem das Etapas 0 a 3. Headlines escritas sem esse contexto são intercambiáveis com as de qualquer concorrente. Headlines escritas com ele são específicas o suficiente para ganhar o clique e sobreviver a uma revisão de claims.

Padrões que o usuário já escolheu. Não os pergunte novamente.

• Os fatos do produto vêm de um arquivo de skill de produto, lido em tempo de execução. Nunca da memória.
• As entradas breves podem vir da aba Palavras-chave e Intenção do modelo, do conector do Google Ads ou do chat. Combine-as.
• A saída é o .xlsx preenchido.
• Nomes de concorrentes vão na cópia do anúncio apenas para grupos de anúncios construídos em torno desse concorrente (alternativa, vs, preços, avaliações). Em todos os outros lugares, a cópia permanece sem nomes.

Leia references/template-map.md antes do primeiro preenchimento. Ele possui o layout da pasta de trabalho, o esquema do payload e o uso do script.

---

Etapa 0: Carregar o contexto do produto

Os fatos do produto vêm do próprio contexto do produto do usuário, nunca da memória. Percorra esta lista e pare na primeira fonte que fornecer o pacote de contexto:

1. Já está na conversa? O usuário executou uma skill de produto, colou um resumo ou anexou um documento de posicionamento. Use-o.
2. Config. Se config/product-context.md existir na pasta desta skill, ele mapeia segmentos para skills ou arquivos de produto e indica onde encontrá-los. Use o segmento que o usuário nomeou. Caso contrário, infira-o a partir do grupo de anúncios, palavras-chave e página de destino. Se for ambíguo ou o grupo de anúncios misturar segmentos, pergunte uma vez. Nunca misture dois segmentos em um anúncio.
3. Arquivos do projeto. Procure por .agents/product-marketing.md, .claude/product-marketing.md ou product-marketing-context.md no projeto (os arquivos que a skill product-marketing escreve).
4. Pergunte. Peça ao usuário para apontar para uma skill de produto, um arquivo ou uma URL, ou para colar um resumo: o que o produto faz, para quem, pontos de prova, claims que estão proibidos, quem são os concorrentes. Diga claramente que a cópia se baseia apenas nesse resumo.

Leia o SKILL.md de uma skill de produto pelo caminho. Não confie na ferramenta Skill: skills de produto geralmente são apenas de invocação manual (disable-model-invocation: true), e a ferramenta as recusa.

Em seguida, extraia o pacote de contexto (references/context-pack.md): o trabalho a ser feito para este grupo de anúncios, a persona, pontos de prova seguros, proteções de claims com suas notas, o quadro competitivo, pilares de mensagem. Anote quais pontos de prova você planeja usar. A célula de notas os cita posteriormente.

Aplique qualquer teste de qualificação ou desqualificadores que o contexto do produto declarar. Se um grupo de anúncios segmentar um comprador que ele descarta, diga isso e pergunte antes de escrever para ele.

Etapa 1: Reunir o resumo do grupo de anúncios

Por grupo de anúncios, você precisa de: nome da campanha, nome do grupo de anúncios, palavras-chave (com tipo de correspondência, intenção, prioridade), URL final. Informações úteis adicionais: oferta, CTA, geografia, público, anúncios existentes, concorrente em jogo.

Fontes, combinadas:

• Modelo. Se o usuário forneceu uma pasta de trabalho, execute scripts/read_template.py <xlsx>. As linhas de Palavras-chave e Intenção são o resumo. O mesmo dump mostra a cópia que já existe, para que você não a repita. Uma cópia em branco vem em assets/Google_Ads_Copy_Template.xlsx; use-a quando o usuário não tiver uma pasta de trabalho.
• Conector do Google Ads (quando a ferramenta ads_search estiver disponível). Somente leitura. Extraia os grupos de anúncios, palavras-chave, termos de pesquisa e RSAs ativos com seus rótulos de desempenho de ativos. As consultas e ressalvas estão em references/google-ads-connector.md. Pergunte pelo ID do cliente se você não o tiver. Nunca escreva na conta.
• Chat. Qualquer coisa que o usuário colou ou descreveu.

Use os nomes exatamente como aparecem na conta ou na planilha. Não invente nomes de campanha ou grupo de anúncios. Se algo bloqueador estiver faltando, pergunte uma vez, em uma mensagem, e liste tudo o que você precisa.

Intenção e prioridade da palavra-chave: se o usuário não as definiu, proponha-as a partir da redação da palavra-chave e diga quais você inferiu. A intenção decide o ângulo (consulte references/rsa-playbook.md).

Etapa 2: Ler a página de destino e o site

Busque cada URL final ativamente. WebFetch retorna um resumo de modelo pequeno e suas respostas de "não encontrado" não são confiáveis, então use-o para ler a página e, em seguida, confirme cada claim que a cópia usará contra o HTML bruto (curl -sL <url> | grep -i -o '.\(40\)<claim>.\(40\)'). Use o navegador para páginas que precisam de JavaScript. Se uma página não puder ser buscada, peça ao usuário para colar sua cópia. Nunca escreva a partir da memória de uma página.

Capture o H1, subtítulo, rótulo do CTA principal, a oferta e seus termos, visibilidade de preços, prova na página, o fluxo de formulário ou reserva e cada claim que a página fizer. Em seguida, leia a navegação do site ou o mapa do site para encontrar destinos de links do site e as páginas que suportam cada valor de frase de chamariz e snippet. Registre a página para cada um na célula de notas dessa linha.

O que a página pode e não pode mudar:

• Correspondência de mensagem. A promessa do anúncio, o CTA e os termos-chave devem aparecer na página. Uma headline que a página não suporta custa qualidade e confiança.
• Teto de claim. Não reivindique mais em um anúncio do que a página faz. Quando a skill de produto permite um claim que a página não tem, use-o apenas se você sinalizar a lacuna ("adicione isso à página antes do lançamento").
• Ofertas vêm da página. Skills de produto raramente listam ofertas. Use uma avaliação gratuita, duração de demonstração ou preço apenas quando a página o declarar. Se seus termos ou público não estiverem na página, sinalize isso em vez de adivinhar.
• Claims bloqueados na página. Se a página carrega um claim que as proteções da skill de produto bloqueiam, não o repita e informe o usuário. O site deles contradiz suas próprias regras.
• Uma página mais fraca do que eles poderiam usar. Se a URL do usuário não carrega as palavras-chave e uma página melhor existe, mantenha a URL deles, sinalize a lacuna e nomeie a página melhor. Se eles concordarem, altere final_url e o landing_page de cada palavra-chave juntos.

Liste as lacunas da página de destino para o resumo: oferta no anúncio, mas não na página, incompatibilidade de CTA, prova fraca.

Etapa 3: Contexto do concorrente

Comece pelo quadro competitivo da habilidade do produto: quem são os rivais, onde lutar, onde ceder. Para grupos de anúncios construídos em torno do nome de um concorrente, busque também os preços ou a página de destino desse concorrente (uma ou duas páginas) para que a cópia responda ao que eles reivindicam hoje. Não raspe as páginas de resultados do Google.

Use a pesquisa de concorrentes para escolher o ângulo (motivo de troca, transparência de custos, o que você faz que eles não podem) e para evitar claims que você não pode provar. Nunca é uma fonte de linhas para copiar.

Nomes de concorrentes:

• Permitidos em headlines, descrições e caminhos de exibição de anúncios cujo grupo de anúncios é construído sobre esse concorrente. Defina competes_with no anúncio no payload.
• Não permitidos em grupos de anúncios genéricos ou em links do site, frases de chamariz e snippets.
• Nunca "#1", "melhor" ou "mais barato que X" sem prova. Nunca depreciar.
• Cada uso nomeado é um risco de reclamação de marca registrada. O script de verificação registra cada um; leve isso para a célula de notas e o breve chat.

Etapa 4: Planejar antes de escrever

Por grupo de anúncios, escreva um plano curto: intenção primária, o único trabalho ao qual se dirige, três ou quatro ângulos (eco de palavra-chave, resultado, prova, diferencial, oferta, redutor de risco) e quais palavras-chave devem aparecer literalmente. Por quê: um RSA é recombinado pelo Google, então o que importa é a cobertura entre ângulos com cada linha independente, não uma frase organizada dividida em 15 partes.

Planeje também os ativos: quatro ou mais destinos de links do site (páginas reais da Etapa 2), quatro ou mais fatos de frase de chamariz com a página que suporta cada um e um cabeçalho de snippet cujos valores você pode preencher honestamente.

Observe quem mais as palavras-chave atraem (aprendizes, estudantes, hobistas, o segmento errado). Adicione uma headline qualificadora onde ajudar e recomende negativos no breve. Não adicione negativos você mesmo.

Decida um anúncio ou dois. Execute um segundo RSA em um grupo de anúncios apenas quando ele testar um ângulo diferente. Um grupo de anúncios de intenção mista ainda recebe um anúncio principal: sua mistura de CTA segue a palavra-chave de maior prioridade, e um CTA de descrição suave ao lado de CTAs de headline diretos é aceitável.

Etapa 5: Escrever

Siga references/rsa-playbook.md para receitas de headline e descrição, mapeamento de intenção para ângulo, caminhos, fixação e a célula de hipótese. Siga references/assets-playbook.md para links do site, frases de chamariz e snippets. Siga references/policy-checklist.md para o que o Google reprova e como lidar com claims.

A versão resumida:

• 15 headlines e 4 descrições para o anúncio principal. Cada headline lê corretamente ao lado de qualquer outra.
• Ecoe as palavras-chave de Alta prioridade em uma headline. Escolha a variante mais longa para que palavras-chave irmãs mais curtas estejam dentro dela. Headlines de eco estão isentas da regra "não abrir nas mesmas palavras". A legibilidade supera a verificação "Em uma headline?" do modelo: se uma palavra-chave parece um erro de digitação ("multi cloud"), escreva a forma natural ("Multi-Cloud") e diga nas notas que a verificação mostrará Não.
• Os claims vêm apenas da lista segura da skill de produto, dentro de suas proteções. Claims de nota D ou ALTO risco nunca aparecem. Claims de risco médio aparecem apenas quando a página de destino os repete.
• URLs de links do site são páginas reais que você buscou. Nunca invente um caminho.
• Escreva na voz da skill de produto. Palavras simples, substantivos específicos, sem "desbloquear", "perfeito", "simplificar".

Antes de prosseguir, execute a cópia através da skill stop-slop se estiver disponível. Use suas regras de preenchimento e estrutura em cada linha e sua pontuação nas descrições lidas como um rascunho; revise abaixo de 35/50. Em headlines de 30 caracteres, limites, política e correspondência de mensagem superam suas regras de advérbio e voz passiva. Mantenha "Confiado por" se a alternativa for uma headline pior, mas prefira a forma ativa quando não custar nada.

Etapa 6: Verificar, depois preencher

Escreva o payload JSON em um local de rascunho (não na pasta da skill, não no repositório do usuário). Esquema em references/template-map.md; um exemplo de aprovação é references/example-payload.json. Construa as listas de proteção a partir da tabela da skill de produto: uma regex por linha em blocked_claims ou hedged_claims. Onde a skill de produto se contradiz, a tabela de proteção vence. Coloque cada cliente nomeado dos pontos de prova em customers.

python3 <skill>/scripts/check_copy.py payload.json --template <template.xlsx> --verify-urls

Corrija todo ERRO. Leia todo AVISO e corrija-o ou mantenha-o por um motivo que você possa declarar. As linhas INFO (uso de nome de concorrente, clientes nomeados, palavras-chave não em uma headline) vão para o breve. Em seguida:

python3 <skill>/scripts/fill_template.py --template <template.xlsx> --payload payload.json \
    --out "<template stem> - filled.xlsx"

Salve a saída ao lado da pasta de trabalho do usuário, ou no diretório de trabalho quando você usou o modelo incluído. Nunca salve na pasta da skill. O script valida novamente, escreve nas primeiras linhas livres, limpa as linhas de amostra fictícias e verifica o arquivo salvo. Se sair com código não zero, não entregue o arquivo; corrija a causa. Se o Python não estiver disponível, ofereça as mesmas linhas como blocos separados por tabulação na ordem das colunas do modelo.

Etapa 7: Entregar

Dê o caminho para o arquivo preenchido, um bloco por grupo de anúncios e um bloco para os ativos da campanha. Mantenha curto; a cópia está no arquivo.

**AD-001 · alternativa rivalapp**  Pronto, 15 headlines, 4 descrições
Ângulo: troca e migração, custo como braço de teste.
Testa: H3, H4, D2 contra H8, H14, D4. Leia os rótulos de ativos assim que saírem do Aprendizado.
Bandeiras: nome do concorrente em H1, D1, path2 (risco de reclamação). H11 nomeia clientes (precisa de aprovação).
Lacunas da página de destino: importação gratuita ainda não está na página.

**Ativos · Pesquisa | Gerenciamento de Projetos | Alternativas a Concorrentes**  4 links do site, 5 frases de chamariz, 1 snippet (Tipos)
Páginas: cada link do site buscado e carregado. Frases de chamariz apoiadas pela página inicial e /import.
Bandeiras: link do site "Histórias de Clientes" nomeia Fabrikam (aprovação).

Em seguida, uma lista curta de Precisa da sua decisão: uma página de destino melhor, ofertas cujos termos a página omite, claims não aprovados que você deixou de fora, clientes a limpar, negativos a adicionar, palavras-chave muito longas para qualquer headline, grupos de anúncios que você dividiria, qualquer coisa que você assumiu. Diga o que você verificou (script de verificação, buscas de URL, claims pesquisados no HTML bruto) e o que você não verificou (a pasta de trabalho não foi aberta no Excel; consultas do conector não executadas a menos que você as tenha executado).

Atualizando anúncios ativos

Se o conector mostrar RSAs existentes para o grupo de anúncios, trate o trabalho como uma atualização. Mantenha ativos rotulados como MELHOR ou BOM, substitua BAIXO, deixe APRENDENDO em paz, preserve as fixações a menos que estejam erradas e liste o que você substituiu na célula de notas e no breve. Não reescreva um anúncio funcional do zero.