Communitygithub.com

HTML5 顯示廣告

構建可用於 Google Ads / Google 多媒體廣告聯播網及其他廣告伺服器的現成動畫 HTML5 顯示廣告(橫幅廣告),每種尺寸一個獨立的 ZIP 壓縮檔,支援從影片、Figma 設計稿、PNG 匯出或簡要說明中生成,並包含 clickTag 點擊追蹤。

HTML5 顯示廣告 是什麼?

這個技能專門用於為 Google 多媒體廣告聯播網 (GDN) 生成一組自包含的動畫 HTML5 橫幅廣告,每種螢幕尺寸一個 ZIP 壓縮檔。它能自動處理各種機械性工作(如構建、品質檢測與預覽),讓使用者可以專注於廣告的素材來源和版面佈局——這正是來回修改最頻繁的環節。支援的尺寸涵蓋方形(如 300x250)、摩天大樓式(如 160x600)、橫幅式(如 728x90)和行動裝置(如 320x50)等標準的 20 種尺寸組合。該技能也提供內建品質檢測、效能最佳化(將每個 ZIP 控制在 150 KB 以下),以及基於動畫時間軸的流暢動作指令碼。若相關腳本目錄不存在,它仍可透過遵循相同的手動工作流程來運作:按照指定的結構為每個廣告撰寫獨立的 index.html 檔案,並在無頭瀏覽器中執行檢測。它具備高度容錯設計,能處理素材來源不足的情況——例如從影片畫格中提取標誌,或從視覺相似的較高解析度影像中進行裁切。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Mgunther60/claude-skills-html/tree/HEAD

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

HTML5 顯示廣告 是做什麼的?

構建一組動畫 HTML5 橫幅廣告,每種尺寸一個獨立的 ZIP 壓縮檔,並能通過 Google Ads 的 HTML5 檢測。 scripts/ 目錄中的腳本負責執行機械性工作(構建、品質檢測、預覽、圖片處理);您的工作是準備好素材來源與版面佈局,這正是絕大多數反覆修改的根本原因。

在首次構建之前,請先閱讀 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,使用相同的結構(ad.size meta 標籤、<head> 中的 var clickTag、全廣告範圍的 window.open(window.clickTag) 退出連結、CSS 類別時間軸、#end 鉤子、1px 邊框),將每個尺寸連同根目錄下的 index.html 打包成 ZIP,並在無頭瀏覽器中執行相同的檢測。

如果工作是為一個擁有自己設計系統技能的品牌(例如 Closet World 的 cw-foundations 和 cw-social)服務,請一併閱讀該技能:它決定了標誌、顏色、字體與文案規則。本技能專門決定廣告格式。

工作流程

1. 需求接收(只詢問您無法推斷的事項)

取得:尺寸(如果使用者說「所有尺寸」或未指定,則使用下列標準 20 種尺寸組合);優惠與標題文案;CTA 用語;點擊連結網址(使用預設值即可,因為 Google Ads 會將 clickTag 替換為最終網址);以及設計的主要參考來源:影片剪輯、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 提供畫格尺寸與圖層座標;get_screenshot 搭配 enableBase64Response 可讓您看到畫格。從 figma.com 下載在沙箱中常被封鎖(curl 錯誤 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」匯出為 160 寬,「970x90」繪製為 960)。請以 Google 規定的尺寸進行構建,將多餘像素放置在中性區域(例如實色面板),並加以說明。
  • **如果某個尺寸沒有對應的畫格,請從同一系列中已核准的最接近尺寸衍生而來(系列模式請參閱 references/spec-format.md),告知使用者這是您的改編版本,並提供調整選項。
  • 使用者通常按場景(畫格 1、2、3)傳送畫格。請將它們視為照片、裁切區域以及任何會移動元素(例如當標語出現時,標誌位置會降低)的場景層級基準。
  • 被翻轉的 Figma 圖層會回報令人困惑的 X 軸位置。請從螢幕截圖或匯出圖中進行測量。

4. 準備素材

  • 圖片:CSS 尺寸的 2 倍(照片使用 JPG 格式,品質 60-78),圖稿使用調色板 PNG(quantize,16-64 色)。標誌:3 倍(這是最引人注目的元素;layers.py logo 執行此操作)。
  • 橫跨兩種顏色背景的產品:將每個場景以其廣告自有背景的全寬進行壓平,並在整數像素的行高處分開,以避免圖片邊緣與 CSS 之間出現明顯接縫。
  • 將每個 ZIP 保持在 150,000 位元組或以下;必要時降低 JPG 品質或將大照片降至 1.5 倍。

5. 構建

為每個尺寸撰寫一個 JSON 規格檔案(格式請參閱 references/spec-format.md),然後執行:

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

此命令會寫入 build/300x250/index.html 及相關素材,並產生 build/<前綴>_300x250.zip(檔案位於 ZIP 根目錄),同時顯示檔案大小與檔案數量。範本已包含:<meta name="ad.size">、<head> 中的 var clickTag、全廣告範圍的退出連結 window.open(window.clickTag)、共用的動畫時間軸、1px 邊框、減少動畫支援以及可跳到結束畫格的 #end 網址鉤子。

動畫(除非另有要求,否則保持整組一致):標題淡入(0.2 秒)、優惠彈出(0.9 秒)、場景二(2.4 秒)、場景三與標題轉標語切換(4.8 至 5.1 秒)、結束卡片上滑並顯示優惠、標誌與 CTA(7.6 至 8.7 秒)、CTA 光澤效果;播放兩次,然後在約 21 秒時停留在結束卡片上(符合 Google 的 30 秒限制)。

6. 品質檢測(每次構建、每個尺寸都必須執行)

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

此命令會檢查 ad.size meta 標籤、clickTag 宣告與退出連結、CSS 大括號平衡、頁面錯誤與主控台錯誤、外部請求、破圖、超出廣告範圍的元素、結束卡片是否顯示、CTA 文字是否被裁切、點擊是否開啟 clickTag 網址、兩次播放後的靜止狀態、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(透過頁面上的時鐘重新調整捕捉時間)。在呈現之前,檢查四個關鍵畫格(約 1.5、3.4、6.0 和 9.5 秒):標題與優惠、場景二、標語、結束卡片。

8. 交付

  • 首先檢查覆蓋率: 比對交付的 ZIP 名稱與要求的尺寸清單,並在回覆前構建任何遺漏的尺寸(250x250 曾多次被遺漏)。任何共用素材(標誌、優惠、範本)變更後,必須對整個組合重新執行品質檢測。
  • 每個尺寸一個 ZIP,命名為 <Brand>_<Campaign>_<WxH>.zip,複製到 /mnt/user-data/outputs/,並先以預覽 GIF 呈現。如果重新構建了 ZIP,請確認交付檔案內容已變更(使用 cmp 比較內部檔案),因為時間戳可能看起來過時。
  • 對於完整組合,請一併交付全尺寸套件(包含自述檔、所有尺寸的概覽圖以及所有 ZIP)。
  • 在回覆中說明:每個檔案包含的內容、動畫的簡短順序、各檔案 KB 大小、哪些版面遵循 Figma 設計稿、哪些是您的改編版本,以及任何妥協事項(例如來源模糊、CTA 用語變更、960 改成 970)。
  • 首次使用者:說明 HTML 檔案位於 ZIP 內部,他們需要上傳 ZIP 本身,並可透過解壓縮後雙擊 index.html 進行預覽(圖片必須與 HTML 檔案放在同一目錄)。

慘痛經驗教訓

  • 類別名稱與狀態類別衝突。 時間軸會為 #ad 加上 c2/c3 類別;切勿為元素賦予這些類別名稱(曾經有圖片的類別 .c2{opacity:0} 導致整個廣告被隱藏)。範本改用 sc2/sc3。
  • 大括號錯誤會導致後續規則失效。 一個多餘的 } 曾無聲無息地關閉了結束卡片。建構工具與品質檢測工具都會檢查大括號平衡。
  • 影片編碼會略微改變顏色;Figma 則完全精確。 應從 Figma(在純色圖層上使用 get_design_context)或品牌技能中取得品牌顏色,而非從影片像素中取得。如果創意作品的紅色與品牌標準衝突,應加以註明,而非默默地「修正」。
  • 無頭捕捉執行速度比實際慢 10-35%,且速度不均。 切勿信任錄製的原始時間;請使用 record_preview.py。
  • 50 像素高的文字區域。 "Schedule a free consultation" 無法放入 300x50 的結束卡片;應使用簡短的 CTA(如 "Book now"),並在空間允許的地方保留完整文案。告知使用者。
  • Google 限制 150 KB。 保持在 150,000 位元組以下,以應對任何一種解讀方式。
  • CTA 文字擁擠。 如果標籤的寬度略大於內邊距內的空間,則仍會顯示但會偏離中心。qa_ads.py 會對此發出警告;請減少按鈕內邊距(由 14 px 改為 10 px)或字型大小。
  • 共用素材的變更會影響每個 ZIP。 當標誌或聯名標誌被更換時,必須重新構建所有尺寸、重新執行品質檢測、替換或刪除舊套件(例如舊的全尺寸 ZIP),並確認每個交付的檔案都已變更。
  • 精準提問,一次完成。 當您需要檔案時,請以表格形式列出確切的圖層、畫格與匯出比例,並提供替代方案(網域擁有者可以允許清單 www.figma.com)。切勿再次詢問已經回答過的問題。

相關技能