Отстраняване на проблеми с активи с HTML5 за кампании за приложения

Когато качвате активи с HTML5 в Google Ads, може да получите съобщение за грешка. В повечето случаи проблемът може да бъде отстранен, като промените файла си и го запазите повторно. След това можете да опитате да го качите отново.

В някои ситуации можете да използвате инструмент, като например инструмента на Google Ads за проверка на HTML5, който Ви дава възможност да тествате активите си, преди да ги качите в Google Ads, и да проверите за потенциални проблеми.

Тази статия ще Ви помогне при конкретни проблеми, които може да възникнат при работата с активи с HTML5 в кампаниите Ви за приложения. Научете повече за рекламите с HTML5/рекламите с изпробване на игра за кампании за приложения

Проблеми с качването

Размерът на файла е прекалено голям

Активите с HTML5 в размерите на заставки (320 x 480 и 480 x 320) могат да са с размер до 5,2 МБ. По-големите активи незабавно ще бъдат отхвърлени, затова намалете размера на файла, когато е необходимо.

Забележка: Понякога файлът може да причини проблеми, тъй като е близо до ограничението за размер. Добре е също да намалите размера на файла.

Размерите не се допускат

Има само две поддържани величини на активи:

• 320 x 480 (вертикално)
• 480 x 320 (хоризонтално).

За да отстраните проблема, променете величините на актива си на поддържаните или използвайте мета маркера 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
• CreateJS, хоствана от Google
• Greensock, хоствана от Google (файловете трябва да работят, независимо от версията)
• jQuery, хоствана от Google
• timelinelite
• timelinemax
• tweenjs
• tweenlite
• tweenmax.

За да коригирате проблема, уверете се, че сте премахнали всички непозволени външни препратки към файлове от рекламната си група с HTML5. След като направите промените, опитайте да качите файла отново.

Рекламата Ви с HTML5 препраща към актив, който не бе намерен в .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 Уеб дизайнер.

За да коригирате проблема, уверете се, че активът Ви с HTML5 има основен .HTML файл с маркер за размер на рекламата, съдържащ се в секцията <head> в изходния код. Трябва също да добавите всички задължителни маркери в изходния код на актива си:

• <!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 файл, и след това опитайте да го качите отново.

Неподдържана HTML5 функция в HTML5 актива

Тази грешка показва, че изходният код на файловете в групата съдържа някои функции, които Google Ads не поддържа.

За да коригирате този проблем, премахнете неподдържаните функции от рекламната си група с HTML5. Инструментът на Google Ads за проверка на HTML5 трябва да може да Ви помогне с това.

Забележка: В секцията „Разширена проверка на HTML5“ на инструмента на Google Ads за проверка на HTML5 може да намерите следното съобщение за грешка: UNSUPPORTED_HTML5_FEATURE: rdf:description.

Ако проблемът е с неподдържани .SVG маркери, в кода на рекламното Ви послание може да има маркери, които не са включени в една от поддържаните категории, като например контейнери, елементи на градиенти и графични елементи.

За да коригирате този проблем, проверете всички файлове, съхранявани в .ZIP файла, и потърсете неподдържани маркери в кода на рекламното послание, след което ги изтрийте. Можете да видите списъка с всички поддържани .SVG маркери. Научете повече за списъка с поддържани .SVG маркери и категориите им

Например, когато в текстов редактор бъде отворен примерен .SVG файл в рамките на групата, може да се покаже маркерът „rdf:Description“. Когато този маркер бъде премахнат от всички .SVG файлове, групата може да бъде качена.

ZIP файлът от Google Уеб дизайнер не е публикуван

Не можете да качвате ръчно компресирани изходни файлове, които пак могат да бъдат редактирани в Google Уеб дизайнер, след като ги разархивирате. Активите в Google Уеб дизайнер трябва да бъдат публикувани локално, преди да отговарят на условията за качване в Google Ads.

За да коригирате проблема, в Google Уеб дизайнер:

1. Кликнете върху Публикуване.
2. Изберете Локално публикуване.
3. Качете получилия се .ZIP файл в Google Ads.

Google Уеб дизайнер не създаде среда на Google Ads

Активите в Google Уеб дизайнер трябва да съдържат атрибута gwd-googleads или gwd-admob, посочен като рекламна среда в мета маркера environment. Ако обаче рекламната среда е gwd-genericad или gwd-dv360, рекламата ще бъде отхвърлена. Това не се отнася за активи, които не са в Google Уеб дизайнер.

За да коригирате проблема, отворете изходния файл (а не публикувания актив) в Google Уеб дизайнер и променете средата на Google Ads. Научете как да изберете рекламната среда

Медийната група изисква динамичен тип продукт с правилен сектор

Активите Ви може да съдържат следния ред в изходния код, без да съдържат вертикалния маркер на продукта: <meta name="productType" content="dynamic">. Този маркер е определен за динамичен ремаркетинг за базирани на емисии активи с HTML5.

За да коригирате проблема, премахнете ръчно реда <meta name="productType" content="dynamic"> от изходния код, тъй като кампаниите за приложения понастоящем не поддържат базирани на емисии персонализирани активи с HTML5.

Медийната група не е съвместима с текущия тип продукт

Активът Ви може да препраща към маркера <meta name="productType" content="dynamic">, но обикновено динамичните активи с HTML5 не се поддържат в кампании за приложения.

За да отстраните проблема, премахнете <meta name="productType" content="dynamic"><meta name="vertical" content="{content_type}"> от изходния код на файла index.html.

Забележка: В заместващия текст за {content_type} може да има различни стойности, като RETAIL, CUSTOM и др.

Реклами с HTML5, използващи ZIP файлове, създадени с DoubleClick Студио, не се поддържат

По принцип активите, създадени в Студио (наричано по-рано DoubleClick Студио), не са съвместими с Google Ads. Системата определя това, като проверява за наличието на препратка към библиотека на JS конкретно за Студио, наречена Enabler. За персонализираните активи, които не са в Google Уеб дизайнер, библиотеката Enabler.js не се поддържа и не може да се използва.

Забележка: По подразбиране файловете в Google Уеб дизайнер съдържат библиотеката Enabler.js и я поддържат изцяло, но тя не се поддържа в персонализираните групи с HTML5.

За да коригирате проблема, премахнете препратките към библиотеката Enabler.js от персонализирания си актив с HTML5.

Поведението при изход от рекламата е конфигурирано неправилно

ExitAPI не се поддържа в рекламните послания в Google Уеб дизайнер. За да отстраните проблема, премахнете всички препратки към ExitAPI и използвайте компонента за област за докосване, за да зададете персонализираната област, върху която може да се кликва.

Проблеми след качване

Активите Ви с HTML5 не са одобрени поради „Невалидно повикване на четвърта страна“, „Неприемлива реклама с HTML5“ или и двете.

Очаква се активи с HTML5 с един от следните елементи да бъдат неодобрени поради „Невалидно повикване на четвърта страна“ или „Неприемлива реклама с HTML5“:

• Маркер <video> без атрибут src
• Не са открити външни препратки
• Шрифтове, които не са на Google, вградени директно във файла и не са посочени от домейна fonts.googleapis.com, ще доведат до неодобрение с изключение на шрифтовете в посочените по-долу формати:
  • .dfont
  • .eot
  • .otf
  • .tte
  • .ttf
  • .woff
  • .woff2
    • Забележка: Може да проверите списъка с всички поддържани шрифтове в Google Fonts.
• Активи, вградени в дъщерни рамки
  • Потърсете маркери, като <frameset>, <frame> или <iframe>, в изходния код. Рамките Ви позволяват да вграждате външно съдържание и дори цели уебсайтове в HTML файл, но не се поддържат в активи с HTML5.
• Файлове за създаване на реклами с Google Уеб дизайнер и AMPHTML
  • Потърсете маркери, които започват с префикса amp, като например <amp-img> или <amp-ad-exit> в изходния код. Можете също да намерите препратки към скриптове, хоствани на cdn.ampproject.org.

Освен това можете да проверите дали активът Ви извършва определени повиквания на четвърта страна чрез раздела „Мрежа“ в инструментите за програмисти в Chrome. За достъп:

1. Кликнете с десния бутон на мишката върху визуализацията на актива в Google Ads или в инструмента на Google Ads за проверка на HTML5.
2. Изберете „Инспектиране“ от контекстното меню.
3. Кликнете върху раздела Мрежа.

За да коригирате проблема, прегледайте активите, потърсете неподдържани елементи и маркери с инструмента на Google Ads за проверка на HTML5 и направете необходимите редакции. След това опитайте да качите отново. Можете също да научите повече за техническите изисквания за „Неприемлива реклама с HTML5“.

Визуализацията на рекламата не се зарежда

Не се очаква визуализация на рекламата да се зареди, ако каченият от Вас актив използва ресурс, който нарушава правилата за сигурност на съдържанието.

За да отстраните проблема, можете да проверите какво комуникира за актива Ви браузърът (независимо дали браузърът целенасочено отхвърля някои ресурси в рекламата с HTML5) чрез раздела „Конзола“ в инструментите за програмисти в Chrome. За достъп:

1. Кликнете с десния бутон на мишката върху визуализацията на актива в Google Ads или в инструмента на Google Ads за проверка на HTML5.
2. Изберете „Инспектиране“ от контекстното меню.
3. Кликнете върху раздела Конзола.

Визуализацията на рекламите се рендерира неправилно

Неправилните рендерирания на визуализациите на рекламите може да са причинени от определени активи, които използват библиотеката PixiJS (или други външни библиотеки), които може да не работят правилно в тестова среда.

За да коригирате проблема, уверете се, че активите Ви с HTML5 са създадени така, че да работят във вложена рамка в тестова среда само с флага allow-scripts.

Забележка: Тъй като рекламите с HTML5 са в тестова среда без allow-same-origin, изображенията трябва да се зареждат с crossorigin="anonymous", за да се използват в платно.

Върху актива във визуализацията не може да се кликва

Очаква се услугата за визуализация на рекламите да блокира навигацията с възможност за кликване, което означава, че трябва да можете да взаимодействате с актива, но не и да кликнете върху него в крайния URL адрес.

За да коригирате проблема, можете да тествате възможността за кликване, когато качвате актива си в инструмента на Google Ads за проверка на HTML5.

Не се показва актив с HTML5

Ако активът Ви с HTML5 изобщо не се показва (нула импресии), може да разгледате тази статия в Помощния център, за да научите как да коригирате кампании за приложения в Google Ads, които не се провеждат или са с нисък трафик.

Висока честота на кликване (CTR) с нисък процент на реализация (CVR)

Едно от възможните решения, които може да решат проблема, е, че скриптът ExitAPI трябва да бъде включен като литерален маркер <script> в <head>, а не чрез друг JavaScript. В противен случай рекламните послания, които се показват на живо, ще са с възможност за кликване върху цялата зона на рекламата, което може да доведе до голям брой неумишлени кликвания и до ниска ефективност.