Як вирішувати проблеми з об’єктами HTML5 у кампаніях для додатків

Під час завантаження об’єктів HTML5 у Google Ads інколи з’являються повідомлення про помилку. Здебільшого несправність можна виправити, якщо змінити файл, повторно зберегти й знову завантажити його.

У деяких випадках ви можете скористатись інструментом Засіб перевірки оголошень HTML5 у Google Ads, щоб перевірити об’єкти, перш ніж завантажувати їх у Google Ads, і виявити можливі проблеми заздалегідь.

З цієї статті ви дізнаєтесь, як усувати проблеми, що можуть виникати під час роботи з об’єктами HTML5 у кампаніях для додатків. Докладніше про оголошення HTML5 або оголошення з демо-версією гри в кампаніях для додатків

Проблеми із завантаженням

Розмір файлу завеликий

Розмір файлу об’єктів HTML5 у міжсторінкових оголошеннях (320 x 480 і 480 x 320) не повинен перевищувати 5,2 МБ. Об’єкти більшого розміру відразу буде відхилено, тому за потреби зменште розмір файлу об’єкта.

Примітка. Якщо розмір файлу майже досягає максимально дозволеного, іноді це може спричинити проблеми. У такому разі також рекомендуємо зменшити розмір файлу.

Неприпустимі розміри

Підтримуються лише 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. Додайте всі потрібні об’єкти у файл .zip і повторіть спробу.

Пакет має містити всі локальні об’єкти, посилання на які наведено у файлах. Якщо ви додасте посилання на шлях до зображення, яке не включено в пакет, файл буде відхилено.

Щоб усунути проблему, вилучіть посилання на файли, яких немає в пакеті, або додайте такі файли в пакет і завантажте його знову.

В оголошенні HTML5 немає основного файлу 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.

Щоб усунути проблему, переконайтеся, що об’єкт HTML5 містить основний файл .html із тегом розміру оголошення, який має бути розміщено в розділі <head> вихідного коду. Також додайте всі обов’язкові теги у вихідний код об’єкта:

• опис у тегу <!DOCTYPE html>;
• тег <html>;
• тег <body>;
• метатег орієнтації та формату оголошення в межах тегу <head> (наприклад, <meta name="ad.orientation" content="portrait">).

Недійсні теги, як-от <path><path />, не приймаються.

Щоб відповідати вимогам, вам може знадобитися видобути вбудовані теги .svg в окремі файли.

Примітка. Оскільки об’єкт показуватиметься в рекламних місцях міжсторінкових оголошень у форматі банера, розмір якого може змінюватися, об’єкт має бути адаптивним, хоча вам усе одно необхідно вказувати його розмір. Для показу міжсторінкових оголошень в альбомній орієнтації використовуйте розмір width=480,height=320.

Забагато файлів у пакеті оголошення. Максимальна кількість файлів – 512.

Об’єкти міжсторінкових оголошень можуть містити щонайбільше 512 файлів у пакеті оголошення. Якщо кількість файлів перевищує максимально дозволену, об’єкт буде відхилено.

Щоб усунути проблему, вилучіть зайві файли з архіву .zip, залишивши щонайбільше 512.

Примітка. Папки, що містяться в пакеті оголошення, не враховуються в загальну кількість файлів у пакеті.

Не вдалось обробити файл .zip, оскільки сам цей файл або якийсь із вкладених у нього файлів пошкоджено. Перевірте файли, заново стисніть їх і повторіть спробу.

Щоб усунути проблему, перевірте файли в пакеті й заново стисніть їх. Переконайтеся, що файл має правильний формат (.zip), і завантажте його знову.

Непідтримувана функція HTML5 в об’єкті HTML5

Ця помилка свідчить про те, що вихідний код файлів у пакеті містить функції, які не підтримуються в Google Ads.

Щоб усунути проблему, вилучіть непідтримувані функції з пакета оголошень HTML5. Для цього застосуйте Засіб перевірки оголошень HTML5 Google Ads.

Примітка. У розділі "Розширена перевірка HTML5" засобу перевірки оголошень HTML5 у Google Ads може відображатися таке повідомлення про помилку: UNSUPPORTED_HTML5_FEATURE: rdf:description

Якщо проблема пов’язана з непідтримуваними тегами .svg, у коді креативу можуть бути теги, які не належать до підтримуваних категорій (елементи контейнера, градієнта й графіки).

Щоб усунути проблему, перевірте всі файли в архіві .zip, знайдіть непідтримувані теги в коді креативу й вилучіть їх. Переглянути список усіх підтримуваних тегів .svg та їх категорії можна тут.

Наприклад, якщо відкрити зразок файлу .svg з пакета в текстовому редакторі, може з’явитися тег rdf:Description. Вилучіть цей тег з усіх файлів .svg та завантажте пакет.

Файл .zip із Google Web Designer не опубліковано

Не можна завантажувати вихідні файли, стиснуті вручну, які все ще можна редагувати в Google Web Designer після розпакування. Перш ніж об’єкти Google Web Designer можна буде завантажити в Google Ads, їх потрібно опублікувати локально.

Щоб усунути проблему, у Google Web Designer:

1. Натисніть Опублікувати.
2. Виберіть Опублікувати локально.
3. Завантажте отриманий файл .zip у Google Ads.

Google Web Designer не створено для середовища Google Ads

У метатегу environment об’єктів 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 на основі фідів.

Щоб усунути проблему, вручну вилучіть рядок <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 Studio

Об’єкти, створені в Studio (попередня назва – DoubleClick Studio), несумісні з Google Ads. Система перевіряє, чи є в об’єкті посилання на бібліотеку JS під назвою Enabler, яка використовується лише в Studio. Бібліотека Enabler.js не підтримується в об’єктах, які не належать до Google Web Designer, тому її не можна використовувати.

Примітка. Файли Google Web Designer містять бібліотеку Enabler.js за умовчанням, і вона повністю підтримується в цих файлах, але не в спеціальних пакетах HTML5.

Щоб усунути проблему, видаліть посилання на бібліотеку Enabler.js зі спеціального об’єкта HTML5.

Поведінку виходу з оголошення неправильно налаштовано

Скрипт ExitAPI не підтримується в креативах Google Web Designer. Щоб усунути проблему, вилучіть усі посилання на скрипт 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.
• Креативи AMPHTML і Google Web Designer.
  • Такі креативи містять теги, які починаються з префікса "amp" (наприклад, <amp-img> або <amp-ad-exit>), у вихідному коді. Також шукайте посилання на скрипти, розміщені в домені cdn.ampproject.org.

Крім того, на вкладці "Мережа" в Інструментах розробника Chrome можна перевірити, чи здійснює об’єкт певні виклики четвертої сторони. Для цього:

1. Правою кнопкою миші натисніть попередній перегляд об’єкта в Google Ads або засобі перевірки оголошень HTML5 у Google Ads.
2. У контекстному меню виберіть "Перевірити".
3. Натисніть вкладку Мережа.

Щоб усунути проблему, перевірте об’єкти, знайдіть непідтримувані елементи й теги за допомогою засобу перевірки оголошень HTML5 у Google Ads і внесіть потрібні зміни. Після цього спробуйте завантажити об’єкти знову. Докладніше про технічні вимоги, які стосуються проблеми "Неприйнятне оголошення HTML5".

Попередній перегляд оголошення не завантажується

Якщо завантажений об’єкт використовує ресурс, що порушує Правила щодо безпеки контенту, попередній перегляд оголошення не відображатиметься.

Щоб усунути проблему, перегляньте повідомлення веб-переглядача про ваш об’єкт на вкладці "Консоль" в Інструментах розробника Chrome. Можливо, веб-переглядач навмисно відхиляє певні ресурси в оголошенні HTML5. Для цього:

1. Правою кнопкою миші натисніть попередній перегляд об’єкта в Google Ads або засобі перевірки оголошень HTML5 у Google Ads.
2. У контекстному меню виберіть "Перевірити".
3. Перейдіть на вкладку Консоль.

Попередній перегляд оголошення відображається неправильно

Попередній перегляд оголошень може відображатися неправильно через певні об’єкти, що використовують бібліотеку PixiJS (або інші зовнішні бібліотеки), які не працюють в ізольованому програмному середовищі належним чином.

Щоб усунути проблему, переконайтеся, що об’єкти HTML5 можуть працювати в ізольованому програмному середовищі iframe за допомогою лише експериментального параметра allow-scripts.

Примітка. Оскільки оголошення HTML5 працюють в ізольованому програмному середовищі без параметра allow-same-origin, щоб використовувати зображення на макеті, їх потрібно завантажувати з параметром crossorigin="anonymous".

Неможливо натиснути об’єкт у попередньому перегляді

Інструмент попереднього перегляду оголошень блокує кліки навігації. Це означає, що ви можете взаємодіяти з об’єктом, але не можете переходити з нього на кінцеву URL-адресу.

Щоб усунути проблему, перевірте можливість натиснути оголошення, завантаживши об’єкт у засіб перевірки оголошень HTML5 у Google Ads.

Об’єкт HTML5 не відображається

Якщо об’єкт HTML5 не відображається (тобто не має жодного показу), перегляньте статтю Довідкового центру Як усунути проблеми з кампаніями для додатків у Google Ads, які неактивні або отримують низький трафік.

Високий показник CTR і низький коефіцієнт конверсії

Щоб усунути проблему, додайте скрипт ExitAPI як тег <script> у розділ <head>, а не через інші теги JavaScript. Інакше всю площу реального оголошення можна буде натиснути, що може призвести до значної кількості випадкових кліків і спричинити низьку ефективність.