HTML5 디스플레이 광고
Google Ads의 HTML5 검사를 통과하는 애니메이션 HTML5 배너 세트를 크기별로 하나의 ZIP 파일로 빌드합니다.
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을 동일한 구조(ad.size 메타, head 내 var clickTag, 전체 광고를 위한 window.open(window.clickTag) 이탈, CSS 클래스 타임라인, #end 훅, 1px 테두리)로 작성하고, 각 크기를 index.html이 루트에 있는 ZIP으로 압축한 후 headless 브라우저에서 동일한 검사를 실행하십시오.
작업이 자체 디자인 시스템 스킬(예: 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. 소스: 충분한 해상도의 실제 아트워크 확보
모든 광고의 품질은 이 단계에 달려 있습니다. 선호도 순서:
- 사용자가 업로드한 공식 파일(로고, 잠금업, 사진). 레이어 이름과 내보내기 배율로 요청하십시오.
- 커넥터를 통한 Figma:
get_metadata는 프레임 크기와 레이어 좌표를 제공합니다.enableBase64Response와 함께get_screenshot을 사용하면 프레임을 볼 수 있습니다. figma.com에서의 다운로드는 샌드박스에서 종종 차단되므로(컬 6번 종료), 일반적으로 Figma 픽셀을 저장할 수 없습니다. 사용자에게 특정 레이어를 내보내도록 요청하십시오. - 동영상 프레임(
layers.py frames), 평평한 배경에서 아트워크를 분리(layers.py key)하고 제품을 잘라냅니다(layers.py cutout --region). 이들은 선명하지만(1080px) 프레임이 빡빡합니다. - 사용자의 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(양자화, 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/<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.85.1초), 오퍼, 로고 및 CTA와 함께 엔드 카드 슬라이드 업(7.68.7초), CTA 샤인; 두 번 재생 후 약 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을 여는 클릭, 두 번 재생 후 정지 상태, 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초)을 확인하십시오: 헤드라인 및 오퍼, 장면 2, 태그라인, 엔드 카드.
8. 전달
- 먼저 적용 범위를 확인하십시오: 전달된 ZIP 이름을 요청된 크기 목록과 비교하고 응답하기 전에 누락된 항목을 빌드하십시오(250x250이 여러 라운드 동안 누락된 적이 있습니다). 공유 자산(로고, 오퍼, 템플릿)이 변경된 후에는 전체 세트에 대해 QA를 다시 실행하십시오.
- 크기별 하나의 ZIP, 이름은
<Brand>_<Campaign>_<WxH>.zip으로 지정하여/mnt/user-data/outputs/에 복사하고 미리보기 GIF와 함께 먼저 제시하십시오. ZIP을 다시 빌드하는 경우 전달된 파일의 내용이 변경되었는지 확인하십시오(내부 파일을cmp). 타임스탬프가 오래된 것처럼 보일 수 있기 때문입니다. - 전체 세트의 경우 모든 크기 패키지(README, 모든 크기의 개요 이미지 및 ZIP)도 전달하십시오.
- 응답에서: 각 파일의 내용, 하나의 짧은 시퀀스의 모션, 크기(KB), Figma 프레임을 따르는 레이아웃과 사용자 적응 레이아웃, 그리고 모든 절충 사항(부드러운 소스, 변경된 CTA 문구, 960에서 970으로 변경).
- 첫 번째 사용자에게: HTML 파일이 ZIP 내부에 있으며, ZIP 자체를 업로드하고, 압축을 풀고
index.html을 두 번 클릭하여 미리보기(이미지가 옆에 있어야 함)를 설명하십시오.
힘들게 배운 함정
- 클래스 이름이 상태 클래스와 충돌합니다. 타임라인이
#ad에c2/c3를 추가합니다. 요소에 해당 클래스 이름을 절대 지정하지 마십시오(이미지 클래스.c2{opacity:0}가 한 번 광고 전체를 숨겼습니다). 템플릿은sc2/sc3를 사용합니다. - 중괄호 오타가 이후의 규칙을 죽입니다. 잘못된
}가 조용히 엔드 카드를 비활성화했습니다. 빌더와 QA 모두 중괄호 균형을 확인합니다. - 비디오 인코딩은 색상을 약간 이동시킵니다. Figma는 정확합니다. 브랜드 색상은 Figma(단색 레이어의
get_design_context) 또는 브랜드 스킬에서 가져오고 비디오 픽셀에서는 가져오지 마십시오. 크리에이티브의 빨간색과 브랜드 표준 간의 충돌을 조용히 "수정"하는 대신 기록하십시오. - Headless 캡처는 10-35% 느리고 불균일하게 실행됩니다. 녹화의 원시 타이밍을 절대 신뢰하지 마십시오.
record_preview.py를 사용하십시오. - 50px 높이의 텍스트. "무료 상담 예약"은 300x50 엔드 카드에 맞지 않습니다. 짧은 CTA("지금 예약")를 사용하고 전체 문구는 맞는 곳에 유지하십시오. 사용자에게 알리십시오.
- Google은 150KB를 계산합니다. 150,000바이트 이하를 유지하여 제한의 두 가지 해석 모두 통과하십시오.
- CTA 텍스트 밀집. 패딩 내부 공간보다 약간 더 넓은 레이블은 보이지만 중앙에서 벗어납니다.
qa_ads.py가 이에 대해 경고합니다. 버튼 패딩(14에서 10px) 또는 글꼴 크기를 줄이십시오. - 공유 자산 변경은 모든 ZIP에 영향을 미칩니다. 로고 또는 잠금업이 교체되면 모든 크기를 다시 빌드하고, QA를 다시 실행하고, 오래된 번들(예: 이전 모든 크기 ZIP)을 교체하거나 삭제하고, 각 전달된 파일이 변경되었는지 확인하십시오.
- 한 번만 정확하게 질문하십시오. 파일이 필요할 때 정확한 레이어, 프레임 및 내보내기 배율을 표에 나열하고 대안(조직 소유자가
www.figma.com을 허용 목록에 추가할 수 있음)을 추가하십시오. 이미 답변된 내용에 대해 다시 질문하지 마십시오.