앱 캠페인의 HTML5 애셋 관련 문제 해결하기

Google Ads에서 HTML5 애셋을 업로드할 때 오류 메시지가 나타날 수 있습니다. 대부분의 경우 파일을 변경하고 다시 저장하면 문제를 해결할 수 있습니다. 그런 다음 파일을 다시 업로드할 수 있습니다.

필요에 따라 Google Ads HTML5 검사기와 같은 도구를 사용하여 애셋을 Google Ads에 업로드하기 전에 먼저 테스트하고 잠재적 문제를 미리 확인할 수 있습니다.

이 도움말에서는 앱 캠페인에서 HTML5 애셋을 사용하는 동안 발생할 수 있는 특정 문제에 대처하는 방법을 설명합니다. 앱 캠페인용 HTML5/플레이어블 광고에 대해 자세히 알아보기

업로드 시 발생한 문제

파일 크기가 너무 큽니다.

전면 광고 크기(320x480 및 480x320)의 HTML5 애셋을 업로드할 때 허용되는 최대 파일 크기는 5.2MB입니다. 이 크기보다 큰 애셋은 즉시 거부되니 필요에 따라 애셋의 파일 크기를 줄이세요.

참고: 파일 크기 한도에 근접한 애셋을 업로드하면 문제가 발생할 수 있습니다. 이럴 때는 파일 크기를 약간 줄이는 것이 좋습니다.

허용되지 않는 크기입니다.

지원되는 애셋 크기는 다음과 같이 2가지입니다.

320x480(세로 모드)
480x320(가로 모드)

이 문제를 해결하려면 애셋 크기를 지원되는 크기로 변경하거나 "ad.orientation" 메타 태그를 사용하고 애셋이 렌더링되어야 하는 올바른 방향 값을 설정하세요.

참고: "ad.size" 메타 태그를 사용하지 않는 대신 새 "ad.orientation" 메타 태그를 사용하여 원하는 애셋 방향 값을 설정할 수 있습니다.

"portrait"(세로 모드 애셋용)
"landscape"(가로 모드 애셋용)
"portrait,landscape" 또는 "landscape,portrait"(양방향으로 작동하는 완전 반응형 애셋용)

"ad.size" 메타 태그를 그대로 사용하고 지원되는 크기를 벗어난 크기로 애셋을 업로드하면 오류 메시지가 계속 표시됩니다.

두 메타 태그가 모두 HTML에 지정되면 "ad.orientation" 값이 사용됩니다.

메타 태그를 전혀 사용하지 않거나 방향 값을 잘못 설정하는 경우 애셋 업로드 시 거부되지는 않지만 세로 모드 방향으로만 렌더링됩니다.

해당 파일은 지원되지 않는 문자가 하나 이상 포함된 경로에 있습니다. 파일 이름 및 모든 디렉터리에서 이 문자가 포함된 모든 인스턴스를 삭제한 다음 다시 시도하세요.

.ZIP 파일 내의 폴더 및 파일 이름을 지정할 때 글자, 숫자, 마침표(.), 하이픈(-), 밑줄(_) 등 지원되는 문자만 포함할 수 있습니다. 폴더 또는 파일 이름에 공백을 비롯한 지원되지 않는 다른 문자를 사용하면 오류가 발생할 수 있습니다.

이 문제를 해결하려면 지원되는 문자를 사용해 폴더 및 파일의 이름을 변경하고 파일 이름과 모든 디렉터리에서 지원되지 않는 문자의 모든 인스턴스를 삭제한 다음 다시 시도하세요.

이러한 영향을 받은 파일이 파일 경로 매개변수의 위치에 있으며 지원되지 않는 문자가 포함된 파일이 잘못된 문자 경로 매개변수의 위치에 있다는 오류 메시지가 표시됩니다.

참고: 이름을 변경한 파일이 소스 코드에서도 참조되는 경우 해당 파일도 함께 업데이트해야 파일이 올바르게 렌더링됩니다.

다음 파일은 지원되지 않는 형식입니다. 이 파일을 삭제하거나 교체한 후 다시 시도하세요.

현재 HTML5 광고 번들에서만 지원되는 파일 형식은 다음과 같습니다.

.CSS
.GIF
.HTML
.JPEG
.JS
.PNG
.SVG

지원되지 않는 파일 형식(예: .MPEG, .FLA)을 업로드하면 오류가 발생할 수 있습니다. 이 문제를 해결하려면 해당 파일을 삭제하거나 교체한 다음 다시 업로드하세요.

HTML5 광고가 .ZIP 파일 외부의 애셋을 참조하려고 합니다. 여기서는 내부 파일 참조(예: 'path/to/asset/in-zip.png')만 허용됩니다. .ZIP 파일에 모든 애셋이 포함되어 있고 모든 파일 참조가 내부 참조인지 확인한 후 필요에 따라 수정하고 다시 시도하세요.

HTML5 광고 번들을 업로드할 때 다음을 제외하고는 외부 파일 참조가 허용되지 않습니다.

createjs
cssplugin
easeljs
easepack
Google Fonts
Google에서 호스팅하는 CreateJS
Google에서 호스팅하는 Greensock(파일 버전에 관계없이 작동)
Google에서 호스팅하는 jQuery
timelinelite
timelinemax
tweenjs
tweenlite
tweenmax

이 문제를 해결하려면 HTML5 광고 번들에서 허용되지 않는 외부 파일 참조를 모두 삭제하세요. 필요에 따라 변경한 다음 다시 업로드합니다.

HTML5 광고가 .ZIP 파일 내에 없는 애셋을 참조하려고 합니다. 모든 애셋을 .ZIP 파일에 포함했는지 확인한 다음 다시 시도하세요.

모든 파일 내에서 참조된 전체 로컬 애셋이 번들에 있어야 합니다. 번들에 없는 이미지에 대한 경로를 참조하는 경우 파일이 거부됩니다.

이 문제를 해결하려면 번들에 없는 파일에 대한 참조를 삭제하거나 참조된 파일을 번들에 추가한 다음 다시 업로드하세요.

HTML5 광고에 기본 .HTML 파일이 누락되었습니다. 기본 .HTML 파일에는 `<meta name="ad.size" content="width=320,height=480">`과 같은 광고 크기 태그가 포함되어 있습니다. HTML5 광고에 광고 크기 태그가 포함된 .HTML 파일이 있는지 확인한 다음 다시 시도하세요.

이 오류가 표시되는 애셋에는 광고 크기 태그와 같은 번들의 .HTML 파일에 필수인 메타데이터 매개변수 중 하나가 포함되어 있지 않습니다(예: <meta name="ad.size" content="width=320,height=480">). 이 사항은 Google Web Designer 애셋에는 적용되지 않습니다.

이 문제를 해결하려면 소스 코드에 있는 <head> 섹션 안에 광고 크기 태그가 포함된 기본 .HTML 파일이 현재 HTML5 애셋에 있는지 확인하세요. 또한 다음과 같이 모든 필수 태그를 애셋의 소스 코드에 추가해야 합니다.

<!DOCTYPE html> 선언
<html> 태그
<body> 태그
<head> 태그 내의 광고 형식 방향 메타 태그. 예: <meta name="ad.orientation" content="portrait">

<path><path />와 같이 잘못된 태그는 사용할 수 없습니다.

이러한 요건을 충족하려면 인라인 .SVG 태그를 별도의 파일에 추출해야 할 수도 있습니다.

참고: 크기가 지정되어 있어도 애셋이 다양한 크기의 배너를 사용하는 전면 광고 슬롯에 게재되므로 반응형 애셋이어야 합니다. 가로 모드 방향인 전면 광고의 경우 "width=480,height=320"을 사용합니다.

미디어 번들에 파일이 너무 많습니다. .ZIP 파일에 포함된 파일 개수를 512개 이하로 줄이세요.

전면 광고 크기일 경우 애셋의 미디어 번들 내에 최대 512개의 파일을 포함할 수 있습니다. 허용된 파일 개수를 초과하는 애셋은 거부됩니다.

이 문제를 해결하려면 .ZIP 파일에 포함된 파일 개수가 512개 이하인지 확인하세요.

참고: 미디어 번들 내의 폴더로 인해 번들 내 전체 파일 수가 증가하지는 않습니다.

.ZIP 파일 자체 또는 .ZIP 내의 파일 중 하나가 손상되어 .ZIP 파일을 처리할 수 없습니다. 파일을 확인하고 재압축한 다음 다시 시도하세요.

이 문제를 해결하려면 번들에 있는 파일을 확인하고, 다시 압축하여 해당 파일이 올바른 ZIP 파일인지 확인한 다음 다시 업로드하세요.

HTML5 애셋에 지원되지 않는 HTML5 기능이 있습니다.

이 오류는 번들에 포함된 파일의 소스 코드에 Google Ads에서 지원하지 않는 기능이 포함되어 있음을 나타냅니다.

이 문제를 해결하려면 지원되지 않는 기능을 HTML5 광고 번들에서 삭제하세요. 이런 경우에 Google Ads HTML5 검사기를 유용하게 사용할 수 있습니다.

참고: Google Ads HTML 5 검사기의 '고급 HTML5 검사' 섹션에 'UNSUPPORTED_HTML5_FEATURE: rdf:description'이라는 오류 메시지가 표시될 수 있습니다.

지원되지 않는 .SVG 태그에 문제가 있는 경우, 지원되는 카테고리(예: 컨테이너 엘리먼트, 그라데이션 엘리먼트, 그래픽 엘리먼트) 중 하나에 포함되지 않는 태그가 광고 소재 코드에 있어서 그럴 수 있습니다.

이 문제를 해결하려면 .ZIP 파일에 저장된 모든 파일을 확인하고 광고 소재 코드에서 지원되지 않는 태그를 검색한 다음 해당 태그를 삭제하세요. 지원되는 모든 .SVG 태그 목록을 확인할 수 있습니다. 지원되는 .SVG 태그 및 해당 카테고리 목록에 대해 자세히 알아보기

예를 들어 번들 내의 샘플용 .SVG 파일이 텍스트 편집기에서 열릴 때 'rdf:Description' 태그가 표시됩니다. 해당 태그가 모든 .SVG 파일에서 삭제되면 번들을 업로드할 수 있습니다.

Google Web Designer의 ZIP 파일이 게시되지 않았습니다.

Google Web Designer에서 여전히 수정할 수 있는 압축 소스 파일을 압축 해제한 이후에는 이를 수동으로 업로드할 수 없습니다. Google Web Designer 애셋을 Google Ads에 업로드하기 전에 먼저 로컬에서 게시해야 합니다.

이 문제를 해결하려면 Google Web Designer에서 다음 단계를 따르세요.

게시를 클릭합니다.
로컬에서 게시를 선택합니다.
최종 .ZIP 파일을 Google Ads에 업로드합니다.

Google Web Designer가 'Google Ads' 환경용으로 만들어지지 않았습니다.

Google Web Designer 애셋에는 '환경' 메타 태그에서 광고 환경으로 지정된 'gwd-googleads' 또는 'gwd-admob'이 포함되어야 합니다. 다만 광고 환경이 'gwd-genericad' 또는 'gwd-dv360'이면 광고가 거부됩니다. 이 사항은 Google Web Designer 이외의 애셋에는 적용되지 않습니다.

이 문제를 해결하려면 Google Web Designer에서 게시된 애셋이 아닌 소스 파일을 열고 환경을 'Google Ads'로 변경하세요. 광고 환경 선택 방법에 대해 알아보기

미디어 번들에 올바른 카테고리가 적용된 동적 제품 유형이 필요합니다.

제품 카테고리 태그(<meta name="productType" content="dynamic">)를 포함하지 않고 소스 코드에 다음 행을 포함할 수 있습니다. 이는 피드 기반 HTML5 애셋의 동적 리마케팅에 사용되도록 정의된 태그입니다.

이 문제를 해결하려면 현재 앱 캠페인에서는 피드 기반 맞춤 HTML5 애셋을 지원하지 않으니 소스 코드에서 <meta name="productType" content="dynamic"> 행을 수동으로 삭제하세요.

미디어 번들이 현재 제품 유형과 호환되지 않습니다.

애셋에 <meta name="productType" content="dynamic"> 태그를 참조할 수 있지만 일반적으로 동적 HTML5 애셋은 앱 캠페인에서 지원되지 않습니다.

이 문제를 해결하려면 index.html 파일의 소스 코드에서 <meta name="productType" content="dynamic"><meta name="vertical" content="{content_type}">을 삭제하세요.

참고: {content_type} 자리표시자에는 RETAIL, CUSTOM 등의 다른 값이 있을 수 있습니다.

DoubleClick Studio에서 만든 ZIP 파일을 사용하는 HTML5 광고는 지원되지 않습니다.

일반적으로 Studio(이전 명칭: 'DoubleClick Studio')에서 만든 애셋은 Google Ads와 호환되지 않습니다. 시스템에서는 'Enabler'라는 Studio 관련 JS 라이브러리 참조가 있는지 확인하여 지원 여부를 결정합니다. Google Web Designer 이외의 맞춤 애셋의 경우 Enabler.js 라이브러리가 지원되지 않기에 사용할 수 없습니다.

참고: Google Web Designer 파일에는 기본적으로 Enabler.js 라이브러리가 포함되어 있습니다. 여기서는 이 라이브러리가 완벽하게 지원되지만 맞춤 HTML5 번들에서는 지원되지 않습니다.

이 문제를 해결하려면 맞춤 HTML5 애셋에서 Enabler.js 라이브러리에 대한 참조를 삭제하세요.

광고 이탈 동작이 잘못 구성되었습니다.

ExitAPI는 Google Web Designer 광고 소재에서 지원되지 않습니다. 이 문제를 해결하려면 ExitAPI에 대한 참조를 모두 삭제하고 대신 탭 영역 요소를 사용하여 맞춤형 클릭 가능 영역을 할당합니다.

업로드 후 발생한 문제

HTML5 애셋이 '잘못된 제4자 호출', '허용되지 않는 HTML5 광고' 또는 두 가지 이유로 인해 승인되지 않았습니다.

'잘못된 제4자 호출' 또는 '허용되지 않는 HTML5 광고'로 인해 다음 엘리먼트 중 하나가 포함된 HTML5 애셋이 승인되지 않을 것으로 예상됩니다.

src 속성이 없는 <video> 태그
감지되지 않은 외부 참조
파일에 직접 삽입되어 있으며 fonts.googleapis.com 도메인에서 참조되지 않는 Google 이외의 글꼴은 다음에 나열된 글꼴 형식을 제외하고는 비승인될 수 있습니다.
- .dfont
- .eot
- .otf
- .tte
- .ttf
- .woff
- .woff2
  - 참고: Google Fonts에서 지원되는 모든 글꼴 목록을 확인할 수 있습니다.
하위 프레임에 삽입된 애셋
- 소스 코드에서 <frameset>, <frame>, <iframe> 등의 태그를 찾습니다. 프레임을 사용하면 HTML 파일 내에 외부 콘텐츠와 전체 웹사이트까지도 삽입할 수 있지만 이는 HTML5 애셋에서 지원되지 않습니다.
Google Web Designer 및 AMP HTML 광고 소재
- 소스 코드에서 <amp-img> 또는 <amp-ad-exit> 등 'amp' 접두사로 시작하는 태그를 찾습니다. cdn.ampproject.org에서 호스팅되는 스크립트에 대한 참조도 확인할 수 있습니다.

또한 애셋이 Chrome 개발자 도구의 '네트워크' 탭을 통해 특정한 제4자 호출을 하고 있는지 확인할 수 있습니다. 여기에 액세스하려면 다음을 따르세요.

Google Ads 또는 Google Ads HTML5 검사기에서 애셋 미리보기를 마우스 오른쪽 버튼으로 클릭합니다.
컨텍스트 메뉴에서 '검사'를 선택합니다.
네트워크 탭을 클릭합니다.

이 문제를 해결하려면 내 애셋을 검토하고 Google Ads HTML5 검사기를 사용하여 지원되지 않는 엘리먼트 및 태그를 찾아 필요한 사항을 수정한 다음 다시 업로드하세요. '허용되지 않는 HTML5 광고'에 대한 기술 요구사항에 대해 자세히 알아볼 수 있습니다.

광고 미리보기가 로드되지 않습니다.

업로드한 애셋에 콘텐츠 보안 정책을 위반하는 리소스가 사용되면 광고 미리보기가 로드되지 않을 수 있습니다.

이 문제를 해결하려면 Chrome 개발자 도구의 '콘솔' 탭을 통해 브라우저에서 애셋 관련하여 전달하는 위반 사항이 무엇인지 확인하세요(예: 브라우저에서 HTML5 광고 내 일부 리소스를 어떤 사유로 거부하는지). 여기에 액세스하려면 다음을 따르세요.

Google Ads 또는 Google Ads HTML5 검사기에서 애셋 미리보기를 마우스 오른쪽 버튼으로 클릭합니다.
컨텍스트 메뉴에서 '검사'를 선택합니다.
콘솔 탭을 클릭합니다.

광고 미리보기 렌더링이 잘못되었습니다.

잘못된 광고 미리보기 렌더링은 PixiJS 라이브러리 또는 기타 외부 라이브러리를 사용하는 일부 애셋으로 인해 발생할 수 있으며, 이렇게 되면 샌드박스에서 올바르게 작동하지 않을 수 있습니다.

이 문제를 해결하려면 HTML5 애셋이 'allow-scripts' 플래그만으로 샌드박스 처리된 iframe에서 작동하도록 빌드해야 합니다.

참고: HTML5 광고는 allow-same-origin 없이 샌드박스 처리되므로 캔버스에서 사용하려면 이미지를 crossorigin="anonymous"를 사용해 로드해야 합니다.

미리보기에서 애셋을 클릭할 수 없습니다.

광고 미리보기 서비스에서 클릭으로 이동할 수 있는 기능이 차단된 것으로 예상됩니다. 이럴 경우 애셋과 상호작용할 수는 있지만 애셋 이외의 것을 클릭하여 최종 URL로 이동할 수는 없게 됩니다.

이 문제를 해결하려면 애셋을 Google Ads HTML5 검사기에 업로드하여 클릭 가능 여부를 테스트하세요.

HTML5 애셋이 게재되지 않습니다.

HTML5 애셋이 전혀 게재되지 않는 경우(노출수 없음), 이 고객센터 도움말을 참고하여 Google Ads 앱 캠페인이 운영되지 않거나 트래픽이 적은 문제를 해결하는 방법을 알아보세요.

전환율(CVR)은 낮은데 클릭률(CTR)이 높게 나타납니다.

이 문제를 해결할 수 있는 한 가지 솔루션은 ExitAPI 스크립트가 <head>에 리터럴 <script> 태그로 포함되고 다른 자바스크립트를 통해 추가되지 않는 것입니다. 이렇게 하지 않으면 광고 영역 전체에서 지금 게재 중인 광고 소재를 어디서든 클릭할 수 있으며, 이럴 경우 의도하지 않은 클릭이 대량으로 발생하여 실적이 저조해질 수 있습니다.

도움이 되었나요?

어떻게 하면 개선할 수 있을까요?