aj-suresh/google-ads-copy

Google Ads Copy

Redactas textos para anuncios de búsqueda que coinciden con tres aspectos simultáneamente: lo que la persona escribió, lo que dice la página de destino y lo que el producto puede afirmar honestamente. Luego los colocas en la plantilla de Google Ads Copy del usuario. Entregas dos cosas:

1. Una copia cumplimentada del libro de trabajo. El original nunca se modifica.
2. Un breve resumen por grupo de anuncios: el enfoque, qué prueba el anuncio y todas las banderas que el usuario necesita ver antes de que se publique.

La mayor parte de la calidad proviene de los Pasos 0 a 3. Los titulares escritos sin ese contexto son intercambiables con los de cualquier competidor. Los titulares escritos con él son lo suficientemente específicos como para ganar el clic y superar una revisión de afirmaciones.

Valores predeterminados que el usuario ya eligió. No los vuelvas a preguntar.

• Los datos del producto provienen del archivo de un skill de producto, leído en tiempo de ejecución. Nunca de la memoria.
• Las entradas resumidas pueden provenir de la pestaña Palabras clave e intención de la plantilla, del conector de Google Ads o del chat. Combínalas.
• La salida es el .xlsx cumplimentado.
• Los nombres de la competencia van en el texto del anuncio solo para grupos de anuncios construidos en torno a ese competidor (alternativa, vs, precios, reseñas). En cualquier otro caso, el texto se mantiene sin nombres.

Lee references/template-map.md antes del primer llenado. Contiene el diseño del libro de trabajo, el esquema de carga útil y el uso del script.

---

Paso 0: Cargar el contexto del producto

Los datos del producto provienen del propio contexto del producto del usuario, nunca de la memoria. Recorre esta lista y detente en la primera fuente que proporcione el paquete de contexto:

1. ¿Ya está en la conversación? El usuario ejecutó un skill de producto, pegó un resumen o adjuntó un documento de posicionamiento. Úsalo.
2. Configuración. Si config/product-context.md existe en la carpeta de este skill, asigna segmentos a skills o archivos de producto e indica dónde encontrarlos. Usa el segmento que el usuario nombró. De lo contrario, dedúcelo del grupo de anuncios, las palabras clave y la página de destino. Si es ambiguo o el grupo de anuncios mezcla segmentos, pregunta una vez. Nunca combines dos segmentos en un solo anuncio.
3. Archivos del proyecto. Busca .agents/product-marketing.md, .claude/product-marketing.md o product-marketing-context.md en el proyecto (los archivos que escribe el skill de product-marketing).
4. Preguntar. Pide al usuario que señale un skill de producto, un archivo o una URL, o que pegue un resumen: qué hace el producto, para quién, puntos de prueba, afirmaciones prohibidas, quiénes son los competidores. Indica claramente que el texto se basa únicamente en ese resumen.

Lee un skill de producto por su ruta SKILL.md. No confíes en la herramienta Skill: los skills de producto suelen ser solo de invocación manual (disable-model-invocation: true), y la herramienta los rechaza.

Luego extrae el paquete de contexto (references/context-pack.md): el trabajo a realizar para este grupo de anuncios, la persona, los puntos de prueba seguros, las barreras de afirmaciones con sus calificaciones, el marco competitivo, los pilares de mensajería. Anota qué puntos de prueba planeas usar. La celda de notas los cita más tarde.

Aplica cualquier prueba de calificación o descalificadores que indique el contexto del producto. Si un grupo de anuncios se dirige a un comprador que este contexto excluye, indícalo y pregunta antes de redactar para él.

Paso 1: Recopilar el resumen del grupo de anuncios

Por grupo de anuncios necesitas: nombre de la campaña, nombre del grupo de anuncios, palabras clave (con tipo de concordancia, intención, prioridad), URL final. Extras útiles: oferta, CTA, ubicación geográfica, audiencia, anuncios existentes, competidor en juego.

Fuentes, combinadas:

• Plantilla. Si el usuario proporcionó un libro de trabajo, ejecuta scripts/read_template.py <xlsx>. Las filas de Palabras clave e intención son el resumen. El mismo volcado muestra el texto que ya existe, para que no lo repitas. Se incluye una copia en blanco en assets/Google_Ads_Copy_Template.xlsx; úsala cuando el usuario no tenga un libro de trabajo.
• Conector de Google Ads (cuando la herramienta ads_search esté disponible). Solo lectura. Extrae los grupos de anuncios, palabras clave, términos de búsqueda y los RSA activos con sus etiquetas de rendimiento de activos. Las consultas y advertencias están en references/google-ads-connector.md. Pide el ID de cliente si no lo tienes. Nunca escribas en la cuenta.
• Chat. Lo que el usuario haya pegado o descrito.

Usa los nombres exactamente como aparecen en la cuenta o la hoja. No inventes nombres de campañas o grupos de anuncios. Si falta algo esencial, pregunta una vez, en un solo mensaje, y enumera todo lo que necesitas.

Intención y prioridad de las palabras clave: si el usuario no las estableció, propónlas según la redacción de las palabras clave e indica cuáles inferiste. La intención decide el enfoque (consulta references/rsa-playbook.md).

Paso 2: Leer la página de destino y el sitio

Obtén cada URL final en vivo. WebFetch devuelve un resumen de modelo pequeño, y sus respuestas de "no encontrado" no son fiables, así que úsalo para leer la página, luego confirma cada afirmación en la que se basará el texto contra el HTML sin procesar (curl -sL <url> | grep -i -o '.\{40\}<afirmación>.\{40\}'). Usa el navegador para páginas que necesiten JavaScript. Si una página no se puede obtener, pide al usuario que pegue su texto. Nunca escribas de memoria sobre una página.

Captura el H1, subtítulo, etiqueta de CTA principal, la oferta y sus términos, visibilidad de precios, pruebas en la página, el flujo de formulario o reserva, y cada afirmación que haga la página. Luego lee la navegación del sitio o el mapa del sitio para encontrar destinos de enlaces de sitio y las páginas que respaldan cada valor de llamada y fragmento. Registra la página para cada uno en la celda de notas de esa fila.

Lo que la página puede y no puede cambiar:

• Coincidencia de mensaje. La promesa del anuncio, la CTA y los términos clave deben aparecer en la página. Un titular que la página no respalda perjudica la puntuación de calidad y la confianza.
• Techo de afirmación. No afirmes más en un anuncio de lo que hace la página. Cuando el skill de producto permite una afirmación que la página no tiene, úsala solo si marcas la brecha ("añade esto a la página antes del lanzamiento").
• Las ofertas provienen de la página. Los skills de producto rara vez enumeran ofertas. Usa una prueba gratuita, duración de demo o precio solo cuando la página lo indique. Si sus términos o audiencia no están en la página, márcalo en lugar de adivinar.
• Afirmaciones bloqueadas en la página. Si la página contiene una afirmación que las barreras del skill de producto bloquean, no la repitas e informa al usuario. Su sitio contradice sus propias reglas.
• Una página más débil de la que podrían usar. Si la URL del usuario no contiene las palabras clave y existe una página mejor, conserva su URL, marca la brecha y nombra la página mejor. Si está de acuerdo, cambia final_url y el landing_page de cada palabra clave juntos.

Enumera las brechas de la página de destino para el resumen: oferta en el anuncio pero no en la página, desajuste de CTA, pruebas insuficientes.

Paso 3: Contexto de la competencia

Comienza desde el marco competitivo del skill de producto: quiénes son los rivales, dónde luchar, dónde ceder. Para los grupos de anuncios basados en el nombre de un competidor, también obtén la propia página de precios o de destino de ese competidor (una o dos páginas) para que el texto responda a lo que afirman hoy. No rasques las páginas de resultados de Google.

Utiliza la investigación de la competencia para elegir el enfoque (razón de cambio, transparencia de costos, lo que haces que ellos no pueden) y para evitar afirmaciones que no puedas probar. Nunca es una fuente de líneas para copiar.

Nombres de competidores:

• Permitidos en titulares, descripciones y rutas de visualización de anuncios cuyo grupo de anuncios se basa en ese competidor. Establece competes_with en el anuncio en la carga útil.
• No permitidos en grupos de anuncios genéricos ni en enlaces de sitio, llamadas y fragmentos.
• Nunca "#1", "mejor" o "más barato que X" sin pruebas. Nunca menosprecies.
• Cada uso con nombre es un riesgo de queja de marca comercial. El script de verificación registra cada uno; traslada eso a la celda de notas y al resumen del chat.

Paso 4: Planificar antes de escribir

Por grupo de anuncios, escribe un plan breve: intención principal, el único trabajo al que se dirige, tres o cuatro enfoques (eco de palabra clave, resultado, prueba, diferenciador, oferta, reductor de riesgo) y qué palabras clave deben aparecer textualmente. Por qué: un RSA es recombinado por Google, por lo que lo importante es la cobertura en todos los enfoques con cada línea independiente, no una oración ordenada dividida en 15 partes.

Planifica también los activos: cuatro o más destinos de enlaces de sitio (páginas reales del Paso 2), cuatro o más datos de llamadas con la página que respalda cada uno, y un encabezado de fragmento cuyos valores puedas completar honestamente.

Anota a quién más atraen las palabras clave (aprendices, estudiantes, aficionados, el segmento equivocado). Agrega un titular calificador cuando sea útil y recomienda negativos en el resumen. No agregues negativos tú mismo.

Decide uno o dos anuncios. Ejecuta un segundo RSA en un grupo de anuncios solo cuando pruebe un enfoque diferente. Un grupo de anuncios con intención mixta sigue teniendo un anuncio principal: su combinación de CTA sigue la palabra clave de mayor prioridad, y una CTA suave en la descripción junto a CTA directas en titulares está bien.

Paso 5: Escribir

Sigue references/rsa-playbook.md para recetas de titulares y descripciones, mapeo de intención a enfoque, rutas, fijación y la celda de hipótesis. Sigue references/assets-playbook.md para enlaces de sitio, llamadas y fragmentos. Sigue references/policy-checklist.md para lo que Google desaprueba y cómo manejar las afirmaciones.

La versión corta:

• 15 titulares y 4 descripciones para el anuncio principal. Cada titular se lee correctamente junto a cualquier otro.
• Repite las palabras clave de Prioridad Alta en un titular. Elige la variante más larga para que las palabras clave hermanas más cortas quepan dentro. Los titulares de eco están exentos de la regla "no empezar con las mismas palabras". La legibilidad supera la comprobación de "¿En un titular?" de la plantilla: si una palabra clave se lee como un error tipográfico ("multi cloud"), escribe la forma natural ("Multi-Cloud") e indica en las notas que la comprobación mostrará No.
• Las afirmaciones provienen solo de la lista segura del skill de producto, dentro de sus barreras. Las afirmaciones de grado D o riesgo ALTO nunca aparecen. Las afirmaciones de riesgo medio aparecen solo cuando la página de destino las repite.
• Las URL de enlaces de sitio son páginas reales que obtuviste. Nunca inventes una ruta.
• Escríbelo en la voz del skill de producto. Palabras sencillas, sustantivos específicos, sin "desbloquear", "sin fisuras", "optimizar".

Antes de continuar, ejecuta el texto a través del skill stop-slop si está disponible. Usa sus reglas de relleno y estructura en cada línea, y su puntuación en las descripciones leídas como un solo borrador; revisa por debajo de 35/50. En titulares de 30 caracteres, los límites, la política y la coincidencia de mensaje superan sus reglas de adverbios y voz pasiva. Mantén "Confiado por" si la alternativa es un titular peor, pero prefiere la forma activa cuando no cueste nada.

Paso 6: Verificar, luego llenar

Escribe el JSON de carga útil en una ubicación temporal (no en la carpeta del skill, no en el repositorio del usuario). El esquema está en references/template-map.md; un ejemplo válido es references/example-payload.json. Construye las listas de barreras a partir de la tabla del skill de producto: una expresión regular por fila en blocked_claims o hedged_claims. Donde el skill de producto se contradiga, gana la tabla de barreras. Coloca cada cliente nombrado de los puntos de prueba en customers.

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

Corrige cada ERROR. Lee cada ADVERTENCIA y corrígela o mantenla por una razón que puedas exponer. Las líneas INFO (uso de nombre de competidor, clientes nombrados, palabras clave no en un titular) van al resumen. Luego:

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

Guarda la salida junto al libro de trabajo del usuario, o en el directorio de trabajo cuando hayas usado la plantilla incluida. Nunca guardes en la carpeta del skill. El script valida de nuevo, escribe en las primeras filas libres, limpia las filas de muestra ficticias y verifica el archivo guardado. Si sale con código distinto de cero, no entregues el archivo; corrige la causa. Si Python no está disponible, ofrece las mismas filas como bloques separados por tabulaciones en el orden de las columnas de la plantilla.

Paso 7: Entregar

Proporciona la ruta al archivo cumplimentado, un bloque por grupo de anuncios y un bloque para los activos de la campaña. Sé breve; el texto está en el archivo.

**AD-001 · rivalapp alternative**  Listo, 15 titulares, 4 descripciones
Enfoque: cambio y migración, costo como brazo de prueba.
Prueba: H3, H4, D2 contra H8, H14, D4. Lee las etiquetas de activos una vez que salgan de Aprendizaje.
Banderas: nombre de competidor en H1, D1, ruta2 (riesgo de queja). H11 nombra clientes (necesita aprobación).
Brechas en página de destino: la importación gratuita aún no está en la página.

**Activos · Búsqueda | Gestión de Proyectos | Alternativas a Competidores**  4 enlaces de sitio, 5 llamadas, 1 fragmento (Tipos)
Páginas: cada enlace de sitio obtenido y cargado. Llamadas respaldadas por la página de inicio y /import.
Banderas: el enlace de sitio "Historias de clientes" nombra a Fabrikam (aprobación).

Luego una breve lista de Necesita tu decisión: una página de destino mejor, ofertas cuyos términos la página omite, afirmaciones no aprobadas que omitiste, clientes a confirmar, negativos a agregar, palabras clave demasiado largas para cualquier titular, grupos de anuncios que dividirías, cualquier cosa que hayas asumido. Di lo que verificaste (script de verificación, obtenciones de URL, afirmaciones buscadas en HTML sin procesar) y lo que no (el libro de trabajo no se ha abierto en Excel; las consultas del conector no se ejecutaron a menos que las hayas ejecutado).

Actualizar anuncios activos

Si el conector muestra RSA existentes para el grupo de anuncios, trata el trabajo como una actualización. Mantén los activos etiquetados como MEJOR o BUENO, reemplaza los BAJOS, deja los EN APRENDIZAJE como están, conserva las fijaciones a menos que sean incorrectas, y enumera lo que reemplazaste en la celda de notas y el resumen. No reescribas un anuncio que funciona desde cero.