Диагностика фидов — как быстро обнаружить и исправить ошибки программистов

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

XML-фид Google

XML-фид — один из самых удобных видов для интернет-магазинов. Главный плюс: возможность использовать фид в Google Ads, Facebook Criteo и так далее. Для просмотра данного вида фидов я использую бесплатный текстовый редактор Notepad++. Можно воспользоваться также бесплатным решением от Facebook. Для того чтобы понять, есть ли в структуре файла ошибки, просто добавьте в фид два-три товара и загрузите в отладчик ленты.

Какие ошибки можно найти:

1. В фиде не обнаружено ни одного товара:

Почему могла возникнуть такая ошибка — не учтены определённые требования:

• структура файла должна быть организована согласно стандартам W3C и Google;
• неверное название атрибутов — они должны соответствовать стандартам Google. Все подробности можно узнать в официальной справке. Например, для фидов в формате XML подходит только такое наименование атрибутов:

Также, возможно, не указаны все обязательные параметры. Сверьтесь со списком:

• id;
• title;
• description;
• link;
• image_link;
• availability;
• price;
• google_product_category;
• brand (кроме фильмов, книг, музыкальных произведений);
• gtin — если есть, когда gtin отсутствует, надо использовать Manufacturer Part Number MPN. Если нет уникального номера, используйте параметр identifier_exists с параметром «no»);
• condition;
• adult (если товар предназначен для взрослых).

Остальные параметры не обязательны или обязательны только для определенной группы товаров/геотаргетинга.

2. Фид загрузился, но часть или все товары отклонены.

В таком случае необходимо скачать отчет об ошибках и внести правки. Если рекламная система не предоставляет отчета, воспользуйтесь отладчиком ленты Facebook.

Зачастую при парсинге данных из CRM или сайта возникают ошибки и какой-то обязательный атрибут попадает в фид с ошибкой или вовсе в него не попадает. Чаще всего это атрибут price, который передается с запятой (123,00) или с неверным кодом валюты (123.00 $). Также может отсутствовать ссылка на некоторые изображения товара.

Атрибут price

CSV-фиды

В таком типе фидов, кроме стандартных ошибок с наименованием параметров и атрибутов, добавляется еще один распространенный вид ошибки — запятые в параметрах.

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

Наиболее удобный метод просмотра и диагностики — Excel:

1. Открываем файл.
2. Переходим на вкладку «Данные».
3. Выбираем получение данных из текстового или CSV-файла.

4. Выбираем источник файла — «Нет».
5. Разделитель — «Запятая».
6. Итого, вместо трёх столбцов получили четыре.

7. Просим программиста поместить описание в кавычки.

8. Проделываем пункты с первого по пятый и убеждаемся, что правки внесены верно.

В справке Google подробно описано, как должны называться параметры и атрибуты в фиде.