Communitygithub.com

html5-display-ads

Génère des bannières HTML5 animées prêtes pour Google Ads (GDN), une archive ZIP par format, avec suivi clickTag, à partir d'une vidéo, de maquettes Figma, d'exportations PNG ou d'un brief.

Qu'est-ce que html5-display-ads ?

Cette compétence (skill) permet de construire un ensemble de bannières HTML5 animées, professionnelles et conformes aux exigences de Google Ads (Google Display Network). Chaque format de bannière est livré dans sa propre archive ZIP, incluant le fichier HTML, les assets optimisés et le suivi des clics via la variable `clickTag`. Le processus couvre l'ensemble du cycle : de l'analyse des sources (vidéo, Figma, exportations PNG, brief) à la livraison finale, en passant par la préparation des assets, le build, le contrôle qualité automatisé, la prévisualisation et le respect de la limite de taille de 150 Ko par bannière. Le skill repose sur des scripts Python dédiés (build, QA, prévisualisation) et utilise un modèle de template standardisé incluant une timeline d'animation partagée, le support de `prefers-reduced-motion` et les métadonnées `ad.size`. Il est conçu pour les projets Google Ads, GDN ou tout serveur publicitaire compatible, et gère les redimensionnements, recadrages et adaptations de campagnes existantes. La documentation détaillée guide l'utilisateur à chaque étape, avec des références pour les spécifications Google Ads, les sources Figma, le format des specs et un exemple complet de 21 formats.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Mgunther60/claude-skills-html/tree/HEAD

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Bannières HTML5 display

Construit un ensemble de bannières HTML5 animées, une archive ZIP autonome par format, qui réussissent les contrôles HTML5 de Google Ads. Les scripts dans scripts/ effectuent le travail mécanique (build, QA, prévisualisation, préparation des images) ; votre travail consiste à obtenir les bonnes sources et les bons layouts, ce qui est à l'origine de presque tous les allers-retours.

Lisez references/google-ads-html5.md avant le premier build (limites, clickTag, formats, étapes d'upload). Lisez references/sources-and-figma.md dès que la demande implique Figma, une vidéo ou des images exportées. Lisez references/spec-format.md lors de la rédaction des spécifications de layout. references/example-closet-world-bf2026.md est un exemple complet (21 formats) dont vous pouvez copier les motifs.

Si scripts/ et references/ ne sont pas à côté de ce fichier (par exemple si seul SKILL.md a été uploadé), suivez le même workflow manuellement : écrivez le index.html de chaque bannière avec la même structure (meta ad.size, var clickTag dans le head, un exit window.open(window.clickTag) sur toute la bannière, une timeline en classes CSS, un hook #end, une bordure de 1px), zippez chaque format avec index.html à la racine, et effectuez les mêmes vérifications dans un navigateur headless.

Si le travail est pour une marque qui possède sa propre compétence de système de design (par exemple cw-foundations et cw-social pour Closet World), lisez également cette compétence : elle détermine les règles de logo, couleur, typographie et copie. Cette compétence détermine le format de la bannière.

Workflow

1. Recueil des informations (ne demandez que ce que vous ne pouvez pas déduire)

Obtenez : les formats (si l'utilisateur dit « tous les formats » ou n'en nomme aucun, utilisez le jeu standard de 20 formats ci-dessous) ; le texte de l'offre et du titre ; le libellé du CTA ; l'URL de clic (une URL par défaut convient, car Google Ads remplace clickTag par l'URL finale) ; et la source de vérité pour le design : un extrait vidéo, des maquettes Figma, des exportations PNG, ou rien (vous concevez alors à partir du brief et des règles de la marque). Vérifiez vous-même les fichiers uploadés : il se peut qu'un fichier mentionné par l'utilisateur ne soit pas arrivé. Regardez dans /mnt/user-data/uploads.

Jeu standard (20 formats). Carré : 200x200, 240x400, 250x250, 250x360, 300x250, 336x280, 580x400. Gratte-ciel : 120x600, 160x600, 300x600, 300x1050. Bannière : 468x60, 728x90, 930x180, 970x90, 970x250, 980x120. Mobile : 300x50, 320x50, 320x100. Gardez cette liste dans une variable et construisez à partir d'elle, afin qu'aucun format ne soit oublié entre les itérations.

2. Sources : obtenez les visuels réels, à une résolution suffisante

La qualité de chaque bannière dépend de cette étape. Par ordre de préférence :

  1. Fichiers officiels que l'utilisateur upload (logo, compositions, photos). Demandez-les par nom de calque et échelle d'exportation.
  2. Figma via le connecteur : get_metadata donne les tailles des cadres et les coordonnées des calques ; get_screenshot avec enableBase64Response vous permet de voir un cadre. Les téléchargements depuis figma.com sont souvent bloqués dans le sandbox (curl exit 6), donc vous ne pouvez généralement pas enregistrer les pixels Figma. Demandez à l'utilisateur d'exporter des calques spécifiques à la place.
  3. Images vidéo (layers.py frames), avec les visuels extraits d'arrière-plans unis (layers.py key) et les produits détourés (layers.py cutout --region). Elles sont nettes (1080 px) mais cadrées serrées.
  4. Exportations d'images en 1x de l'utilisateur : cadrage exact, mais floues. Combinez-les avec une source plus nette (layers.py find localise un recadrage dans une image plus nette ; layers.py blend fusionne un rendu net dans une exportation floue).

Dites toujours clairement d'où vient chaque asset et ce qu'il coûte (par exemple « logo extrait de la vidéo, donc flou ; envoyez le fichier officiel pour le corriger »). Les utilisateurs remarquent en premier les logos flous.

3. Layout par format

  • Lorsqu'un cadre Figma ou une image exportée existe pour un format, reproduisez-le exactement. Mesurez les positions à partir du PNG (couleurs dominantes pour les panneaux, bounding boxes alpha ou non- fond pour les visuels) ; ne faites pas au jugé. Vérifiez la taille réelle en pixels du PNG : les cadres sont souvent mal nommés (un « 120x600 » exporté en 160 de large, un « 970x90 » dessiné en 960). Construisez à la taille Google, placez les pixels supplémentaires dans une zone neutre (un panneau uni) et mentionnez-le.
  • Lorsqu'un format n'a pas de cadre, déduisez-le du format approuvé le plus proche dans la même famille (voir references/spec-format.md pour les motifs de famille), dites à l'utilisateur qu'il s'agit d'une adaptation, et proposez de l'ajuster.
  • Les utilisateurs envoient souvent des cadres par scène (image 1, 2, 3). Traitez-les comme la vérité par scène pour les photos, les recadrages et tout élément qui bouge (par exemple un logo qui se place plus bas lorsque le slogan apparaît).
  • Les calques Figma retournés signalent des positions x confuses. Mesurez plutôt à partir de la capture d'écran ou de l'exportation.

4. Préparation des assets

  • Images en 2x de la taille CSS (photos en JPG, qualité 60-78), visuels sous forme de PNG palettisés (quantize, 16-64 couleurs). Logos en 3x (ce sont ce que les gens regardent ; layers.py logo fait cela).
  • Produits qui chevauchent un fond bicolore : aplatissez chaque scène sur le fond de la bannière en pleine largeur à une ligne de séparation en pixels entiers, afin qu'il n'y ait pas de couture visible là où un bord d'image rencontre le CSS.
  • Gardez chaque ZIP à 150 000 octets ou moins ; réduisez la qualité JPG ou réduisez les grandes photos à 1,5x si nécessaire.

5. Build

Écrivez une spécification JSON par format (references/spec-format.md), puis :

python scripts/build_ad.py specs/300x250.json --assets prepared/300x250 --out build

Il écrit build/300x250/index.html plus les assets et build/<prefixe>_300x250.zip (fichiers à la racine du ZIP), et affiche les octets et le nombre de fichiers. Le template contient déjà : <meta name="ad.size">, var clickTag dans le head, un exit sur toute la bannière window.open(window.clickTag), la timeline d'animation partagée, une bordure de 1px, le support prefers-reduced-motion et un hook URL #end qui saute à l'image de fin.

L'animation (identique sur tout l'ensemble sauf demande contraire) : titre qui apparaît (0,2 s), offre qui surgit (0,9 s), scène 2 (2,4 s), scène 3 avec échange titre-slogan (4,8 à 5,1 s), carte de fin qui glisse avec offre, logo et CTA (7,6 à 8,7 s), brillance du CTA ; se joue deux fois, puis s'arrête sur la carte de fin à environ 21 s (sous la limite des 30 s de Google).

6. QA (chaque format, à chaque fois)

python scripts/qa_ads.py build/300x250 build/728x90 --zips build/*.zip --timing

Il vérifie la meta ad.size, la déclaration et l'exit de clickTag, l'équilibre des accolades CSS, les erreurs de page et de console, les requêtes externes, les images cassées, les éléments qui débordent de la bannière, l'affichage de la carte de fin, le texte du CTA tronqué, le clic ouvrant l'URL clickTag, l'état de repos après deux lectures, la racine du ZIP, le nombre d'octets et de fichiers. Corrigez et relancez jusqu'à ce que tout soit OK. Ensuite, examinez le résultat : rendez chaque état de scène (classes still s1 s2, still s1 s2 c2, still s1 s2 c2 c3 s3, et la fin) et comparez-le côte à côte avec les images de référence. Une différence de pixels par région (zone gauche, photo, offre) montre rapidement ce qui cloche.

7. Prévisualisation

python scripts/record_preview.py build/300x250 build/728x90 --out outputs/preview_name --zoom 2

Ceci écrit un MP4 et un GIF à vitesse réelle (il retarde la capture avec une horloge intégrée à la page). Vérifiez quatre images (environ 1,5, 3,4, 6,0 et 9,5 s) avant de présenter : titre et offre, scène 2, slogan, carte de fin.

8. Livraison

  • Vérifiez d'abord la couverture : comparez les noms des ZIP livrés avec la liste des formats demandés et construisez tout ce qui manque avant de répondre (un 250x250 a déjà été oublié pendant plusieurs itérations). Relancez le QA sur l'ensemble après tout changement d'un asset partagé (logo, offre, template).
  • Un ZIP par format, nommé <Marque>_<Campagne>_<LxH>.zip, copié dans /mnt/user-data/outputs/ et présenté avec le GIF de prévisualisation en premier. Si vous reconstruisez un ZIP, confirmez que le contenu du fichier livré a changé (cmp un fichier à l'intérieur), car les horodatages peuvent sembler obsolètes.
  • Pour un ensemble complet, livrez également un paquet tous-formats (README, image d'aperçu de chaque format, et les ZIP).
  • Dans la réponse : ce que contient chaque fichier, l'animation en une courte séquence, les tailles en Ko, les layouts qui suivent les cadres Figma et ceux qui sont votre adaptation, et tout compromis (source floue, libellé CTA modifié, 960 à 970).
  • Première fois : expliquez que le fichier HTML est à l'intérieur du ZIP, qu'ils uploadent le ZIP lui-même, et que décompresser et double-cliquer sur index.html le prévisualise (les images doivent rester à côté).

Pièges appris à la dure

  • Les noms de classe entrent en conflit avec les classes d'état. La timeline ajoute c2/c3 à #ad ; ne donnez jamais à des éléments ces noms de classe (une classe d'image .c2{opacity:0} a déjà caché toute la bannière). Le template utilise sc2/sc3.
  • Les erreurs d'accolade tuent les règles après elles. Une } mal placée a silencieusement désactivé la carte de fin. Le builder et le QA vérifient tous deux l'équilibre des accolades.
  • Les encodages vidéo décalent légèrement les couleurs ; Figma est exact. Prenez les couleurs de la marque depuis Figma (get_design_context sur un calque uni) ou la compétence de marque, pas depuis les pixels vidéo. Signalez tout conflit entre les rouges du créatif et la norme de la marque au lieu de le « corriger » silencieusement.
  • La capture headless est 10 à 35 % plus lente et irrégulière. Ne faites jamais confiance au timing brut d'un enregistrement ; utilisez record_preview.py.
  • Texte de 50 px de haut. « Planifiez une consultation gratuite » ne tient pas sur une carte de fin 300x50 ; utilisez un CTA court (« Réservez maintenant ») et gardez le libellé complet là où il tient. Prévenez l'utilisateur.
  • Google compte 150 Ko. Restez à 150 000 octets ou moins pour passer les deux interprétations de la limite.
  • Troncature du texte CTA. Un libellé légèrement plus large que l'espace à l'intérieur du padding reste visible mais n'est pas centré. qa_ads.py prévient de cela ; réduisez le padding du bouton (14 à 10 px) ou la taille de police.
  • Les modifications d'asset partagé touchent tous les ZIP. Lorsqu'un logo ou une composition est remplacé, reconstruisez chaque format, relancez le QA, remplacez ou supprimez les bundles obsolètes (par exemple un ancien ZIP tous-formats), et confirmez que chaque fichier livré a changé.
  • Demandez une fois, précisément. Lorsque vous avez besoin de fichiers, listez les calques exacts, les cadres et l'échelle d'exportation dans un tableau, ainsi que l'alternative (un propriétaire d'organisation peut autoriser www.figma.com). Ne demandez pas à nouveau quelque chose déjà répondu.

Skills associés