Как решать проблемы, связанные с объектами HTML5, в кампаниях для приложений

При загрузке объектов HTML5 в Google Рекламу может появиться сообщение об ошибке. Чтобы устранить неполадку, обычно бывает достаточно изменить файл, сохранить его и повторно загрузить.

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

Эта статья поможет вам решить проблемы, которые могут возникнуть при работе с объектами 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 содержится ссылка на объект, находящийся вне архива. Поддерживаются только ссылки на внутренние файлы (например, /path/to/asset/in-zip.png). Убедитесь, что все ваши объекты добавлены в ZIP-архив и используются только ссылки на внутренние файлы, а затем повторите попытку.

Загружая пакет объявлений HTML5, следите за тем, чтобы в нем не было ссылок на внешние файлы, поскольку они не поддерживаются. Есть лишь несколько исключений:

Библиотека CreateJS.
Плагин CSS.
Библиотека EaselJS.
Плагин EasePack.
Библиотека Google Fonts.
Библиотека CreateJS, размещенная в Google.
Библиотека Greensock, размещенная в Google (файлы должны работать в любой версии).
Библиотека jQuery, размещенная в Google.
Плагин TimelineLite.
Плагин TimelineMax.
Библиотека TweenJS.
Плагин TweenLite.
Плагин TweenMax.

Чтобы устранить эту проблему, удалите из пакета объявлений HTML5 все ссылки на внешние файлы, которые не поддерживаются, а затем загрузите его снова.

В объявлении HTML5 содержится ссылка на объект, который отсутствует в ZIP-архиве. Добавьте все необходимые объекты в архив и повторите попытку.

В пакете должны присутствовать все локальные объекты, указанные во всех файлах. Если в файле указан путь к изображению, которого нет в пакете, такой файл будет отклонен.

Чтобы устранить проблему, удалите ссылки на все файлы, которых нет в пакете, или же добавьте в пакет недостающие файлы, после чего повторите загрузку.

В объявлении HTML5 отсутствует основной файл HTML. В этом файле содержится тег размера объявления, представленный следующим образом: `<meta name="ad.size" content="width=320,height=480">`. Добавьте файл HTML с тегом в объявление HTML5 и повторите попытку.

Если для объекта показывается такое сообщение об ошибке, это означает, что у объекта отсутствует один из обязательных параметров метаданных, который должен содержаться в одном из 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".

В наборе рекламных материалов слишком много файлов. Количество файлов в ZIP-архиве не должно превышать 512.

В наборе рекламных материалов объекта, предназначенного для межстраничного показа, не может содержаться более 512 файлов. Иначе такой объект будет отклонен.

Чтобы устранить проблему, сократите количество файлов в ZIP-архиве, после чего повторите загрузку.

Примечание. При подсчете количества файлов в наборе рекламных материалов папки не учитываются.

Не удалось обработать ZIP-архив, поскольку он поврежден или содержит поврежденные файлы. Проверьте их, создайте новый архив и повторите попытку.

Получив такое сообщение, проверьте файлы в пакете и снова их заархивируйте, чтобы получился корректный ZIP-файл, а затем повторите загрузку.

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

Это сообщение означает, что в исходном коде файлов в пакете есть функции, не поддерживаемые Google Рекламой.

Чтобы исправить ошибку, удалите из пакета объявлений HTML5 функции, которые не поддерживаются. С этим вам поможет Валидатор HTML5 Google Рекламы.

Примечание. В разделе Advanced HTML5 check (Расширенная проверка HTML5) Валидатора HTML5 Google Рекламы может появляться такое сообщение об ошибке: UNSUPPORTED_HTML5_FEATURE: rdf:description.

Если проблема связана с неподдерживаемыми тегами SVG, то, возможно, в коде креатива присутствуют теги, не включенные ни в одну из поддерживаемых категорий, таких как элементы контейнера, градиента и графики.

Чтобы это исправить, проверьте все файлы, которые содержатся в ZIP-архиве, на предмет неподдерживаемых тегов в коде креатива, и если они есть – удалите эти теги. Можно ознакомиться с полным списком поддерживаемых тегов SVG и их категорий

Например, если открыть в текстовом редакторе один из файлов SVG, в нем может обнаружиться тег "rdf:Description". После того как вы удалите этот тег из всех файлов SVG, пакет можно будет загрузить.

ZIP-файл из Google Web Designer не опубликован.

Сжатые исходные файлы, которые после распаковки доступны для редактирования в Google Web Designer, загрузить вручную не получится. Чтобы объекты Google Web Designer можно было загрузить в Google Рекламу, их сначала нужно опубликовать локально.

Чтобы устранить эту проблему, в Google Web Designer выполните следующие действия:

Нажмите Опубликовать.
Выберите Опубликовать локально.
Загрузите полученный ZIP-файл в Google Рекламу.

Google Реклама не указана в качестве среды для объявления Google Web Designer.

В объектах Google Web Designer в метатеге "environment" в качестве рекламной платформы должно быть указано "gwd-googleads" или "gwd-admob". Если же в этом теге указана рекламная платформа "gwd-genericad" или "gwd-dv360", объявление будет отклонено. Это относится исключительно к объектам Google Web Designer.

Чтобы устранить проблему, откройте исходный файл (а не опубликованный объект) в Google Web Designer и в качестве среды выберите Google Рекламу. Подробнее об этом рассказывается в статье Выбор рекламной платформы.

Для набора рекламных материалов должен быть выбран динамический тип товара из правильной отрасли.

В исходном коде вашего объекта может присутствовать следующая строка, не содержащая тега отрасли товара: <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, не поддерживаются.

Обычно объекты, созданные в Креативной студии (ранее этот продукт назывался "DoubleClick Studio"), не совместимы с Google Рекламой. Где именно создан объект, система определяет по наличию характерной для Креативной студии ссылки на библиотеку JS под названием Enabler. Для пользовательских объектов, не являющихся объектами Google Web Designer, библиотека Enabler.js не поддерживается, и использоваться в них она не может.

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

Чтобы устранить эту проблему, удалите ссылки на библиотеку Enabler.js из своего пользовательского объекта HTML5.

Действия при переходе по объявлению настроены некорректно.

В креативах Google Web Designer не поддерживается ExitAPI. Чтобы устранить проблему, удалите все ссылки на 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 Web Designer и креативы AMPHTML.
- Поищите в исходном коде теги, которые начинаются с префикса "amp", такие как <amp-img> или <amp-ad-exit>. Можете также посмотреть, нет ли ссылок на скрипты, размещенные на cdn.ampproject.org.

Кроме того, стоит проверить, не совершает ли объект вызовы четвертой стороны, на вкладке "Сеть" в Инструментах разработчика в Chrome. Это делается так:

Нажмите правой кнопкой мыши на предварительную версию объекта в Google Рекламе или в Валидаторе HTML5 Google Рекламы.
В контекстном меню выберите "Проверить".
Откройте вкладку Сеть.

Чтобы устранить проблему, посмотрите свои объекты, найдите в них неподдерживаемые элементы и теги в Валидаторе HTML5 Google Рекламы и измените их. После этого повторите загрузку. Подробнее о технических требованиях в отношении недопустимых объявлений HTML5…

Предварительная версия объявления не загружается

Если в загруженном вами объекте используется ресурс, не соответствующий стандарту Content Security Policy, предварительную версию объявления загрузить не получится.

Чтобы устранить эту проблему, можно выяснить, какие данные передает браузер о вашем объекте, в частности отклоняет ли он целенаправленно определенные ресурсы, содержащиеся в объявлении HTML5. Это можно узнать на вкладке "Консоль" в Инструментах разработчика в Chrome. Это делается так:

Нажмите правой кнопкой мыши на предварительную версию объекта в Google Рекламе или в Валидаторе HTML5 Google Рекламы.
В контекстном меню выберите "Проверить".
Перейдите на вкладку Консоль.

Предварительная версия объявления отображается неправильно

Библиотека PixiJS или другие внешние библиотеки могут неправильно работать в тестовой среде, и если они используются в объектах объявления, его предварительная версия может также отображаться неправильно.

Чтобы проблема не возникала, объекты HTML5 должны предназначаться для работы в окне iframe тестовой среды; этот режим включается с помощью флага "allow-scripts".

Примечание. Поскольку объявления HTML5 работают в тестовой среде без флага allow-same-origin, то для того чтобы изображения можно было использовать в элементах canvas, они должны загружаться с атрибутом crossorigin="anonymous".

В режиме предварительного просмотра объект не кликабельный

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

Чтобы убедиться, что все в порядке, протестируйте кликабельность, когда загрузите объект в Валидатор HTML5 Google Рекламы.

Объект HTML5 не отображается

Если ваш объект HTML5 не отображается вовсе (ноль показов), ознакомьтесь со статьей Справочного центра Что делать, если кампания Google Рекламы для приложений неактивна или получает мало трафика.

Высокий показатель CTR при низком коэффициенте конверсии

Одно из возможных решений этой проблемы – включить скрипт ExitAPI в виде литерала как тег <script> внутри тега <head>, вместо того чтобы добавлять его как отдельный файл JavaScript. Иначе в реальной среде креативы будут полностью кликабельными во всем пространстве объявления, что может привести ко множеству случайных нажатий и в конечном счете – к низкой эффективности.

Эта информация оказалась полезной?

Как можно улучшить эту статью?