Communitygithub.com

HTML5 ディスプレイ広告

Google Ads / Google ディスプレイネットワーク向けのアニメーション付き HTML5 バナーを、サイズごとに1つのZIPファイルとして自動生成します。動画、Figma フレーム、PNG 書き出し、または簡単な指示から制作。

HTML5 ディスプレイ広告 とは?

このスキルは、Google Ads の HTML5 チェックを通過するアニメーション HTML5 バナー群を、各サイズ自己完結型 ZIP としてビルドします。動画、Figma フレーム、PNG 書き出し、または簡単な指示(テキストベース)のいずれかをソースとして、クリックタグ(clickTag)によるトラッキング、標準 20 サイズセット対応、品質チェック(QA)、プレビュー生成まで一貫して行います。バナー制作のワークフローは、インテーク(サイズ・コピー・CTA・クリックURLの確認)、ソース画像の取得(Figma コネクタ、動画フレーム、PNG 書き出しなど)、各サイズのレイアウト設計、アセット準備(画像の2x/3x書き出し、150KB制限遵守)、JSON 仕様に基づくビルド、QA スクリプトによる自動チェック、プレビュー MP4/GIF 出力、そして納品という手順を踏みます。特に、デザインソースが不足している場合の対処法(動画からロゴを切り出す、フレームから位置を計測するなど)や、よくある失敗(クラス名衝突、150KB制限、CTAテキストのはみ出し)への対策も詳述されています。市場で最も一般的な広告ユースケースに対応し、デベロッパーやマーケターが効率的にGoogle ディスプレイ広告を制作・管理できるよう設計されています。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

HTML5 ディスプレイ広告 は何をしますか?

アニメーション付き HTML5 バナー群を、各サイズ自己完結型 ZIP としてビルドし、Google Ads の HTML5 チェックを通過させるためのスキルです。 scripts/ 内のスクリプトが機械的な作業(ビルド、QA、プレビュー、画像準備)を行います。あなたの役割はソースとレイアウトを正しく設定することであり、これがほとんどのやり取りの発生源です。

最初のビルド前に references/google-ads-html5.md を読んでください(制限、clickTag、サイズ、アップロード手順について)。Figma、動画、または書き出しフレームが関係する場合は、すぐに references/sources-and-figma.md を読んでください。レイアウト仕様を記述する際は references/spec-format.md を読んでください。references/example-closet-world-bf2026.md は完全な実例(21サイズ)で、パターンをコピーするために使用できます。

もし scripts/ と references/ がこのファイルの隣にない場合(例えば SKILL.md だけがアップロードされた場合)、同じワークフローを手動で実行します。各広告の index.html を、同じ構造(<meta name="ad.size">、<head> 内の var clickTag、全体広告の window.open(window.clickTag) による遷移、CSS クラスによるタイムライン、#end フック、1px ボーダー)で書き、各サイズを index.html をルートに含む ZIP に圧縮し、ヘッドレスブラウザで同じチェックを実行します。

もし作業が独自のデザインシステムスキルを持つブランド向けの場合(例: Closet World の cw-foundations や cw-social)、そのスキルも読んでください。ロゴ、色、タイポグラフィ、コピーのルールが定義されています。このスキルは広告フォーマットを決定します。

ワークフロー

1. インテーク(推測できないことだけを尋ねる)

取得するもの:サイズ(ユーザーが「すべてのサイズ」と言うか、何も指定しない場合は、以下の標準20サイズセットを使用)、オファーとヘッドラインのコピー、CTAの文言、クリックスルーURL(デフォルトで問題ありません。Google Ads が clickTag を最終URLに置き換えるため)、そしてデザインのソース情報:動画カット、Figma フレーム、PNG 書き出し、またはなし(その場合はブランドルールと概要からデザイン)。自分でアップロードを確認してください。ユーザーが言及したファイルが到着していない可能性があります。/mnt/user-data/uploads を確認しましょう。

標準セット(20サイズ)。 正方形:200x200、240x400、250x250、250x360、300x250、336x280、580x400。スカイスクレイパー:120x600、160x600、300x600、300x1050。リーダーボード:468x60、728x90、930x180、970x90、970x250、980x120。モバイル:300x50、320x50、320x100。このリストを変数に保持し、そこからビルドしてください。ラウンド間でサイズが欠落しないようにするためです。

2. ソース:実際のアートワークを十分な解像度で入手する

すべての広告の品質はこのステップに依存します。優先順位順:

  1. 公式ファイル(ロゴ、ロックアップ、写真)をユーザーがアップロード。レイヤー名と書き出しスケールを指定して依頼。
  2. Figma コネクタ経由:get_metadata でフレームサイズとレイヤー座標を取得。enableBase64Response を指定した get_screenshot でフレームを見ることができる。サンドボックスでは figma.com からのダウンロードがブロックされることが多い(curl が exit 6)ため、通常は Figma のピクセルを保存できません。ユーザーに特定のレイヤーを書き出すよう依頼してください。
  3. 動画フレーム(layers.py frames)、フラットな背景からアートワークを分離(layers.py key)、製品を切り抜き(layers.py cutout --region)。これらはシャープ(1080 px)ですが、フレームがタイトです。
  4. ユーザーからの 1x フレーム書き出し:正確なフレーミングですが、ソフトです。シャープなソースと組み合わせる(layers.py find でシャープな画像内のクロップ位置を特定、layers.py blend でシャープなレンダリングをソフトな書き出しに統合)。

各アセットがどこから来たのか、そしてそのコストを常に明確に伝えてください(例:「ロゴは動画から抽出したため、ややソフトです。修正するには公式ファイルを送ってください」)。ユーザーはまずソフトなロゴに気づきます。

3. サイズごとのレイアウト

  • そのサイズの Figma フレームまたは書き出しフレームが存在する場合、正確に一致させる。 PNG から位置を測定してください(パネルの色の連なり、アートのアルファまたは非背景バウンディングボックス)。目測はしないでください。PNG の実際のピクセルサイズを確認してください。フレームの名前が間違っていることがあります(「120x600」と名付けられたものが幅160pxで書き出されている、「970x90」が960pxで描かれている)。Google サイズでビルドし、余分なピクセルはニュートラルな場所(無地のパネル)に置き、その旨を伝えてください。
  • そのサイズのフレームがない場合、同じファミリー内で最も近い承認済みサイズから派生させる(ファミリーパターンについては references/spec-format.md を参照)、あなたの適応であることをユーザーに伝え、調整を申し出てください。
  • ユーザーはシーンごとにフレームを送ることがよくあります(フレーム1、2、3)。これらを写真、クロップ、および動く要素(例えば、タグラインが表示されるときに低く配置されるロゴ)のシーンごとの真実として扱ってください。
  • 反転された Figma レイヤーは混乱を招く x 位置を報告します。代わりにスクリーンショットまたは書き出しから測定してください。

4. アセットの準備

  • 画像は CSS サイズの 2倍(写真は JPG、品質 60-78)、アートワークはパレット PNG(量子化、16-64色)。ロゴは 3倍(人々が最初に見るもの。layers.py logo でこれを行います)。
  • 2色の背景にまたがる製品:各シーンを広告の背景全体に全幅で、ピクセル単位の分割行で平坦化し、画像の端が CSS と接する部分に目に見える継ぎ目がないようにします。
  • 各 ZIP を 150,000 バイト以下に保ってください。必要に応じて JPG 品質を調整するか、大きな写真を 1.5倍に縮小してください。

5. ビルド

サイズごとに1つの JSON 仕様を記述し(references/spec-format.md)、その後:

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

これにより build/300x250/index.html とアセット、および build/<prefix>_300x250.zip(ZIP ルートにファイル)が書き出され、バイト数とファイル数が表示されます。テンプレートにはすでに以下が含まれています:<meta name="ad.size">、<head> 内の var clickTag、全体広告の遷移 window.open(window.clickTag)、共有モーションタイムライン、1px ボーダー、モーション軽減サポート、#end URL フック(最終フレームにジャンプ)。

モーション(特に指示がない限りセット全体で同一に保つ):ヘッドライン登場(0.2秒)、オファーポップ(0.9秒)、シーン2(2.4秒)、シーン3(ヘッドラインからタグラインへの入れ替え 4.8〜5.1秒)、エンドカード(オファー、ロゴ、CTA とともにスライドアップ 7.6〜8.7秒)、CTA の輝き;2回再生し、約21秒でエンドカードで静止(Google の30秒制限内)。

6. QA(すべてのサイズ、毎回)

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

これにより、ad.size メタ、clickTag 宣言と遷移、CSS ブレースバランス、ページとコンソールのエラー、外部リクエスト、壊れた画像、広告外にはみ出した要素、エンドカードの表示、CTA テキストのクリッピング、クリックによる clickTag URL の開封、2回再生後の静止状態、ZIP ルート、バイト数とファイル数がチェックされます。修正してすべて合格するまで再実行してください。その後、結果を確認:各シーンの状態(クラス still s1 s2、still s1 s2 c2、still s1 s2 c2 c3 s3、およびエンド)をレンダリングし、参照フレームと並べて比較します。領域別(左ゾーン、写真、オファー)のピクセル差分ですぐに何がずれているかわかります。

7. プレビュー

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

これにより、等速の MP4 と GIF が書き出されます(ページ内クロックを使ってキャプチャを再タイミング)。提示前に4つのフレーム(約1.5秒、3.4秒、6.0秒、9.5秒)を確認:ヘッドラインとオファー、シーン2、タグライン、エンドカード。

8. 納品

  • まずカバレッジを確認: 納品された ZIP 名を要求されたサイズリストと比較し、不足があれば返信前にビルドすること(250x250 が何ラウンドか欠落したことがあります)。共有アセット(ロゴ、オファー、テンプレート)に変更があった場合は、セット全体で QA を再実行してください。
  • サイズごとに1つの ZIP、名前は <Brand>_<Campaign>_<WxH>.zip とし、/mnt/user-data/outputs/ にコピーし、最初にプレビュー GIF とともに提示。ZIP を再ビルドした場合は、納品ファイルの内容が変更されたことを確認(ファイル内の cmp)、タイムスタンプが古く見えることがあるため。
  • フルセットの場合は、全サイズパッケージ(README、全サイズの概要画像、ZIP)も納品。
  • 返信では:各ファイルの内容、モーションの簡単なシーケンス、サイズ(KB)、どのレイアウトが Figma フレームに従い、どれがあなたの適応か、および妥協点(ソフトなソース、CTA 文言の変更、960→970 など)。
  • 初回ユーザーには:HTML ファイルが ZIP の中にあり、ZIP 自体をアップロードすることを説明。ZIP を解凍して index.html をダブルクリックするとプレビューできる(画像はその隣に置く必要がある)。

苦労して学んだ落とし穴

  • クラス名が状態クラスと衝突する。 タイムラインは #ad に c2/c3 を追加。絶対に要素にこれらのクラス名を付けないでください(画像クラス .c2{opacity:0} がかつて広告全体を非表示にした)。テンプレートは sc2/sc3 を使用。
  • ブレースのタイプミスがその後のルールを無効にする。 迷子の } がエンドカードを静かに無効にした。ビルダーと QA の両方がブレースバランスをチェック。
  • 動画エンコードは色をわずかにシフトさせる;Figma は正確。 ブランドカラーは Figma(無地のレイヤーの get_design_context)またはブランドスキルから取得し、動画ピクセルからは取得しないこと。クリエイティブの赤色とブランド標準の矛盾を静かに「修正」するのではなく、その矛盾を記録すること。
  • ヘッドレスキャプチャは10〜35%遅く、不均一に動作する。 録画の生のタイミングを信頼しないでください。record_preview.py を使用。
  • テキストは50pxの高さ。 「無料相談を予約する」は300x50のエンドカードに収まりません。そこでは短いCTA(「今すぐ予約」)を使用し、完全な文言は収まる場所に置いてください。ユーザーに伝えてください。
  • Google は150 KB とカウント。 150,000 バイト以下に保ち、制限のどの解釈でも通過するように。
  • CTA テキストの混雑。 パディング内のスペースよりわずかに広いラベルは表示されたままですが、中央からずれます。qa_ads.py はこれについて警告します。ボタンのパディング(14px→10px)またはフォントサイズを減らしてください。
  • 共有アセットの変更はすべての ZIP に影響。 ロゴやロックアップが置き換えられた場合、すべてのサイズを再ビルドし、QA を再実行し、古いバンドル(例:古い全サイズ ZIP)を置き換えるか削除し、各納品ファイルが変更されたことを確認。
  • 一度だけ、正確に尋ねる。 ファイルが必要な場合、正確なレイヤー、フレーム、書き出しスケールを表にリストし、代替案(組織の所有者が www.figma.com を許可リストに追加できる)を示す。すでに回答済みのことを再度尋ねないでください。

関連スキル