Anuncios HTML5 display
Crea un conjunto de banners HTML5 animados, un ZIP autónomo por tamaño, que pasan las verificaciones HTML5 de Google Ads.
Los scripts en scripts/ hacen el trabajo mecánico (construcción, QA, vista previa, preparación de imágenes); tu trabajo es conseguir las
fuentes y diseños correctos, que es de donde proviene casi todo el ir y venir.
Lee referencias/google-ads-html5.md antes de la primera construcción (límites, clickTag, tamaños, pasos de subida).
Lee referencias/fuentes-y-figma.md tan pronto como la solicitud involucre Figma, un video o fotogramas exportados.
Lee referencias/formato-especificacion.md al escribir especificaciones de diseño. referencias/ejemplo-closet-world-bf2026.md
es un ejemplo completo (21 tamaños) para copiar patrones.
Si scripts/ y referencias/ no están junto a este archivo (por ejemplo, solo se subió SKILL.md), sigue el
mismo flujo de trabajo manualmente: escribe el index.html de cada anuncio con la misma estructura (meta ad.size, var clickTag en el
head, una salida window.open(window.clickTag) para todo el anuncio, línea de tiempo con clases CSS, gancho #end, borde de 1px), comprime cada tamaño
con index.html en la raíz y ejecuta las mismas comprobaciones en un navegador sin interfaz gráfica.
Si el trabajo es para una marca con su propia habilidad de sistema de diseño (por ejemplo, cw-foundations y cw-social de Closet World), lee también esa habilidad: ella decide las reglas de logotipo, color, tipografía y copia. Esta habilidad decide el formato del anuncio.
Flujo de trabajo
1. Recopilación (pregunta solo lo que no puedas inferir)
Obtén: los tamaños (si el usuario dice "todos los tamaños" o no nombra ninguno, usa el conjunto estándar de 20 tamaños a continuación); la oferta y el texto del titular; la redacción del CTA; la URL de clic (un valor predeterminado está bien,
porque Google Ads reemplaza clickTag con la URL final); y la fuente de verdad para el diseño: un corte
de video, fotogramas de Figma, exportaciones PNG, o nada (entonces diseñas a partir del brief y las reglas de la marca).
Revisa las subidas tú mismo: es posible que un archivo mencionado por el usuario no haya llegado. Busca en /mnt/user-data/uploads.
Conjunto estándar (20 tamaños). Cuadrado: 200x200, 240x400, 250x250, 250x360, 300x250, 336x280, 580x400. Rascacielos: 120x600, 160x600, 300x600, 300x1050. Banners horizontales: 468x60, 728x90, 930x180, 970x90, 970x250, 980x120. Móvil: 300x50, 320x50, 320x100. Mantén esta lista en una variable y construye a partir de ella, para que ningún tamaño se pierda entre rondas.
2. Fuentes: obtén el material gráfico real, con suficiente resolución
La calidad de cada anuncio depende de este paso. En orden de preferencia:
- Archivos oficiales que el usuario suba (logotipo, lockups, fotos). Pídelos por nombre de capa y escala de exportación.
- Figma a través del conector:
get_metadatada los tamaños de los fotogramas y las coordenadas de las capas;get_screenshotconenableBase64Responsete permite ver un fotograma. Las descargas de figma.com suelen estar bloqueadas en la zona de pruebas (curl exit 6), por lo que normalmente no puedes guardar píxeles de Figma. Pide al usuario que exporte capas específicas. - Fotogramas de video (
layers.py frames), con material gráfico extraído de fondos planos (layers.py key) y productos recortados (layers.py cutout --region). Son nítidos (1080 px) pero encuadrados de forma ajustada. - Exportaciones de fotogramas a 1x del usuario: encuadre exacto, pero suaves. Combínalos con una fuente más nítida
(
layers.py findlocaliza un recorte dentro de una imagen más nítida;layers.py blendfusiona un render nítido en una exportación suave).
Di siempre claramente de dónde proviene cada activo y qué costo tiene (por ejemplo, "logotipo extraído del video, por lo que es más suave; envía el archivo oficial para solucionarlo"). Los usuarios notan primero los logotipos suaves.
3. Diseño por tamaño
- Cuando exista un fotograma de Figma o un fotograma exportado para un tamaño, ajústalo exactamente. Mide las posiciones a partir del PNG (ejecuciones de color para paneles, cuadros delimitadores alfa o de no fondo para arte); no calcules a ojo. Verifica el tamaño real en píxeles del PNG: los fotogramas a menudo se nombran incorrectamente (un "120x600" exportado a 160 de ancho, un "970x90" dibujado a 960). Construye al tamaño de Google, coloca los píxeles extra en algún lugar neutral (un panel sólido) y dímelo.
- Cuando un tamaño no tenga fotograma, derívalo del tamaño aprobado más cercano en la misma familia (consulta
referencias/formato-especificacion.mdpara patrones de familia), informa al usuario que es tu adaptación y ofrece ajustarlo. - Los usuarios a menudo envían fotogramas por escena (fotograma 1, 2, 3). Trátalos como la verdad por escena para fotos, recortes y cualquier elemento que se mueva (por ejemplo, un logotipo que se sitúa más abajo cuando aparece el eslogan).
- Las capas invertidas de Figma reportan posiciones x confusas. Mide a partir de la captura de pantalla o la exportación.
4. Preparar activos
- Imágenes a 2x del tamaño CSS (fotos como JPG, calidad 60-78), material gráfico como PNGs con paleta
(
quantize, 16-64 colores). Logotipos a 3x (son lo que la gente mira;layers.py logohace esto). - Productos que cruzan un fondo de dos colores: aplana cada escena sobre el fondo propio del anuncio a ancho completo en una fila de división de píxeles enteros, para que no haya una costura visible donde el borde de una imagen se encuentra con el CSS.
- Mantén cada ZIP en o por debajo de 150,000 bytes; reduce la calidad JPG o baja las fotos grandes a 1.5x si es necesario.
5. Construir
Escribe una especificación JSON por tamaño (referencias/formato-especificacion.md), luego:
python scripts/build_ad.py especificaciones/300x250.json --assets prepared/300x250 --out build
Escribe build/300x250/index.html más activos y build/<prefijo>_300x250.zip (archivos en la raíz del ZIP),
e imprime bytes y número de archivos. La plantilla ya tiene: <meta name="ad.size">, var clickTag en el head,
una salida para todo el anuncio window.open(window.clickTag), la línea de tiempo de movimiento compartida, un borde de 1px, soporte
para movimiento reducido y un gancho de URL #end que salta al fotograma final.
El movimiento (mantenlo idéntico en todo un conjunto a menos que se pida lo contrario): titular entra (0.2 s), oferta aparece (0.9 s), escena 2 (2.4 s), escena 3 con intercambio de titular por eslogan (4.8 a 5.1 s), tarjeta final se desliza hacia arriba con oferta, logotipo y CTA (7.6 a 8.7 s), brillo del CTA; se reproduce dos veces, luego permanece en la tarjeta final alrededor de 21 s (por debajo de los 30 s de Google).
6. QA (cada tamaño, cada vez)
python scripts/qa_ads.py build/300x250 build/728x90 --zips build/*.zip --timing
Comprueba el meta ad.size, la declaración y salida de clickTag, el equilibrio de llaves CSS, errores de página y consola, solicitudes
externas, imágenes rotas, elementos que se salen del anuncio, visualización de la tarjeta final, recorte de texto del CTA, el clic que
abre la URL de clickTag, el estado de reposo después de dos reproducciones, la raíz del ZIP, bytes y número de archivos. Corrige y vuelve a ejecutar
hasta que todo pase. Luego mira el resultado: renderiza cada estado de escena (clases still s1 s2,
still s1 s2 c2, still s1 s2 c2 c3 s3, y el final) y compáralo lado a lado con los fotogramas de referencia.
Una diferencia de píxeles por región (zona izquierda, foto, oferta) muestra rápidamente qué está mal.
7. Vista previa
python scripts/record_preview.py build/300x250 build/728x90 --out outputs/nombre_vista_previa --zoom 2
Esto escribe un MP4 y un GIF a velocidad real (reajusta el tiempo de captura con un reloj en la página). Verifica cuatro fotogramas (alrededor de 1.5, 3.4, 6.0 y 9.5 s) antes de presentar: titular y oferta, escena 2, eslogan, tarjeta final.
8. Entrega
- Primero verifica la cobertura: compara los nombres de los ZIP entregados con la lista de tamaños solicitados y construye cualquier cosa que falte antes de responder (una vez faltó un 250x250 durante varias rondas). Vuelve a ejecutar QA en todo el conjunto después de cualquier cambio en un activo compartido (logotipo, oferta, plantilla).
- Un ZIP por tamaño, nombrado
<Marca>_<Campaña>_<WxH>.zip, copiado a/mnt/user-data/outputs/y presentado con el GIF de vista previa primero. Si reconstruyes un ZIP, confirma que el contenido del archivo entregado cambió (cmpun archivo dentro de él), porque las marcas de tiempo pueden parecer obsoletas. - Para un conjunto completo, entrega también un paquete de todos los tamaños (README, una imagen de resumen de cada tamaño y los ZIP).
- En la respuesta: qué hay en cada archivo, el movimiento en una secuencia corta, tamaños en KB, qué diseños siguen los fotogramas de Figma y cuáles son tu adaptación, y cualquier compromiso (fuente suave, redacción del CTA cambiada, 960 a 970).
- Usuarios primerizos: explica que el archivo HTML está dentro del ZIP, que suben el ZIP en sí y que
descomprimirlo y hacer doble clic en
index.htmllo previsualiza (las imágenes deben permanecer junto a él).
Errores aprendidos a la fuerza
- Los nombres de clase chocan con las clases de estado. La línea de tiempo añade
c2/c3a#ad; nunca des a los elementos esos nombres de clase (una clase de imagen.c2{opacity:0}ocultó una vez todo el anuncio). La plantilla usasc2/sc3. - Los errores de llaves matan las reglas posteriores. Una llave
}fuera de lugar deshabilitó silenciosamente la tarjeta final. El constructor y QA verifican ambos el equilibrio de llaves. - Las codificaciones de video cambian ligeramente los colores; Figma es exacta. Toma los colores de la marca de Figma (
get_design_contexten una capa sólida) o de la habilidad de la marca, no de los píxeles del video. Nota cualquier conflicto entre los rojos del creativo y el estándar de la marca en lugar de "corregirlo" silenciosamente. - La captura sin interfaz gráfica se ejecuta 10-35% más lento y de manera desigual. Nunca confíes en el tiempo bruto de una grabación; usa
record_preview.py. - Texto con 50 px de altura. "Agenda una consulta gratuita" no cabe en una tarjeta final de 300x50; usa un CTA corto ("Reserva ahora") ahí y mantén la redacción completa donde quepa. Informa al usuario.
- Google cuenta 150 KB. Mantente en o por debajo de 150,000 bytes para que cualquiera de las lecturas del límite pase.
- Texto del CTA apiñado. Una etiqueta ligeramente más ancha que el espacio dentro del relleno permanece visible pero se siente descentrada.
qa_ads.pyadvierte sobre esto; reduce el relleno del botón (14 a 10 px) o el tamaño de fuente. - Los cambios en activos compartidos afectan a cada ZIP. Cuando se reemplaza un logotipo o lockup, reconstruye cada tamaño, vuelve a ejecutar QA, reemplaza o elimina los paquetes obsoletos (por ejemplo, un ZIP antiguo de todos los tamaños) y confirma que cada archivo entregado cambió.
- Pregunta una vez, con precisión. Cuando necesites archivos, enumera las capas exactas, fotogramas y escala de exportación en una tabla, más la
alternativa (un propietario de la organización puede permitir
www.figma.comen la lista blanca). No preguntes de nuevo por algo ya respondido.