Як перевірити XML-фід для Google Merchant Center: практичний чекліст

XML може відкриватися в браузері й водночас містити ціни не в тому форматі, дублікати ID або неправильні посилання. Merchant Center перевіряє не лише синтаксис файла, тому виправлення тегів не завжди вирішує проблему.

Нижче — перевірка вже сформованого фіда з XML-прикладом і безкоштовним локальним валідатором. Реєстрацію акаунта й налаштування експорту описує окрема інструкція Shopcore з підключення Merchant Center. Загальну готовність сайту варто перевірити за чеклістом Google Shopping.

Перевірка XML-фіда: м’ятний каталог, документ, лупа й чекліст

Дві перевірки: синтаксис XML і зміст товарних даних

Спочатку перевірте, чи файл є коректно сформованим XML: чи закриті теги, чи правильно вкладені елементи, чи немає обірваного документа. Потім перевірте формат Google: потрібні атрибути, допустимі значення, правильні посилання та актуальні ціни.

Наприклад, <g:price>790,00 грн</g:price> може бути синтаксично правильним XML. Однак це не правильний формат ціни для товарного фіда Google. Так само парсер не визначить, що посилання веде на іншу модель або товар уже закінчився. Специфікація товарних даних Google охоплює саме вимоги до даних; звичайна перевірка XML їх не замінює.

Власна схема Shopcore: ці перевірки доповнюють одна одну; жодна не гарантує схвалення Google.

1. Перевірте файл, кодування та namespace

Відкрийте саме адресу фіда, яку плануєте додати в Merchant Center. Переконайтеся, що відповідь містить товарний файл, а не сторінку входу, повідомлення про помилку чи HTML магазину. Збережіть копію з датою перевірки, щоб потім порівняти її з наступним експортом.

Для звичайного XML-файла використовуйте розширення .xml і кодування UTF-8. Перевірте, чи українські літери залишилися читабельними. Google описує підтримувані формати й типові помилки обробки в інструкції зі створення товарного файла.

У RSS 2.0 оголошення простору імен Google виглядає так: xmlns:g="http://base.google.com/ns/1.0". Атрибути цього простору мають відповідний префікс: наприклад, g:id, g:price, g:image_link. Написання адреси namespace потрібно зберегти точно, включно з http; це ідентифікатор простору імен, а не адреса вашого магазину. Структуру пояснює офіційна специфікація RSS 2.0 для Merchant Center.

Окремо знайдіть неекрановані спецсимволи. У звичайному тексті XML символ & записують як &, а < — як <. Це стосується й амперсанда між параметрами URL усередині елемента. Не екрануйте вже готові значення повторно: &amp; після читання дасть зайвий текст. Правила екранування визначає стандарт XML W3C.

2. Звірте структуру на одному товарі

Нижче — навчальний приклад синтаксично коректного RSS XML. Домен, товар і ціна умовні; це не готовий файл для завантаження.

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <title>Приклад українського магазину</title>
    <link>https://example.com/</link>
    <description>Навчальний приклад товарного фіда</description>
    <item>
      <g:id>cup-white-350</g:id>
      <g:title>Керамічна чашка, біла, 350 мл</g:title>
      <g:description>Біла керамічна чашка об'ємом 350 мл.</g:description>
      <g:link>https://example.com/products/cup-white-350</g:link>
      <g:image_link>https://example.com/images/cup-white-350.jpg</g:image_link>
      <g:availability>in_stock</g:availability>
      <g:price>790.00 UAH</g:price>
      <g:condition>new</g:condition>
    </item>
  </channel>
</rss>

Приклад показує базову структуру, а не повний набір вимог для кожного асортименту. Ідентифікатори, характеристики варіантів та інші атрибути додавайте відповідно до реального товару. Відсутність GTIN у прикладі не означає, що його можна прибрати з вашого каталогу. Перелік обов'язкових і залежних від умов полів дивіться в специфікації Google.

3. Перевірте значення ключових атрибутів

Атрибут	Що перевірити
`id`	Непорожній, унікальний, незмінний ідентифікатор конкретного товару або варіанта.
`title`	Зрозуміла назва саме того товару, який відкривається за посиланням.
`link`	Повна адреса відповідної товарної сторінки на підтвердженому домені.
`image_link`	Повна адреса справжнього зображення цього товару.
`availability`	Допустиме технічне значення, узгоджене з можливістю замовлення.
`price`	Число з крапкою та код валюти, наприклад `790.00 UAH`.

ID має переживати оновлення. Зручно використовувати стабільний SKU, якщо він унікальний. Не створюйте нові ID через зміну назви, ціни або дату експорту. Не передавайте ID знятого товару новій моделі. Для різних варіантів потрібні окремі ID; однаковий код для білої та чорної чашки створює неоднозначність. Довжина — від 1 до 50 символів. Вимоги Google до ID.

Назва повинна пояснювати товар. Додайте модель і важливу відмінність варіанта, уникайте рекламних вигуків та суцільних великих літер. Для звичайного title гранична довжина становить 150 символів. Для назв, створених генеративним ШІ, Google вимагає structured_title; для таких описів — structured_description. Не копіюйте звичайні поля прикладу замість відповідного структурованого формату. Назви та structured_title, описи в специфікації.

Посилання перевіряйте окремо від XML. Відкрийте картку без авторизації, потім на телефоні. Вона має показувати потрібний товар, бажано з уже вибраним варіантом. Перехід на головну, інший розмір чи закриту сторінку потребує виправлення. Правила атрибута link.

За image_link має завантажуватися зображення, а не сторінка перегляду файлів. Переконайтеся, що фото відповідає товару, доступне Googlebot і Googlebot-image, не містить рекламних накладок чи водяних знаків. Для розмірів і форматів звіряйтеся з поточними вимогами до зображень Google.

Наявність передавайте технічними значеннями: in_stock, out_of_stock, preorder, backorder. Не замінюйте їх українським «є в наявності». Для preorder і backorder потрібна дата availability_date; інформація має відповідати сторінці. Правила availability.

Ціну звіряйте до покупки. Для гривні використовуйте UAH, а десяткову частину відокремлюйте крапкою: 790.00 UAH. Не підставляйте грн замість коду валюти. Порівняйте суму у фіді, картці та оформленні замовлення. Окремо перевірте товари зі знижками й мінімальною кількістю покупки: ціна однієї одиниці може відрізнятися від мінімальної доступної пропозиції. Вимоги Google до price.

4. GTIN: перевірити походження, а не придумати цифри

Беріть GTIN з упаковки, даних виробника або перевіреного каталогу постачальника. Внутрішній артикул магазину не стає GTIN після додавання нулів. Код іншого кольору чи комплектації теж не підходить. Перевірка довжини та контрольної цифри корисна, але сама по собі не доводить, що номер належить вашому товару. Google прямо застерігає від вгадування і вигадування кодів у документації GTIN.

Якщо код не знайдений, спочатку уточніть дані. identifier_exists=false призначений для випадків, коли відповідних унікальних ідентифікаторів справді не існує, а не коли продавець їх поки не знає. Не застосовуйте цей прапорець до всього каталогу для приховування помилок. Умови використання identifier_exists.

5. Практичний чекліст перед передаванням фіда

Перевіряйте синтаксис і повтори ID по всьому файлу. Для ручного зіставлення виберіть кілька різних товарів: звичайний, акційний, відсутній, варіантний і нещодавно доданий.

XML читається парсером до кінця без помилок.
Namespace оголошений точно, префікси послідовні.
Кількість позицій відповідає запланованому експорту; пропуски пояснені.
ID не дублюються й зберігаються між двома оновленнями.
Назви та посилання стосуються одного товару й варіанта.
Фото відкриваються, ціни й наявність відповідають сайту.
GTIN підтверджені джерелом, сумнівні коди не вигадані.

Для основного RSS-фіда передавайте весь запланований набір товарів, а не лише останні зміни: видалення позиції з такого джерела впливає на її присутність у Merchant Center. Пояснення Google щодо RSS.

Перевірте файл локально у браузері

Для базової перевірки можна завантажити безкоштовний валідатор фіда у ZIP-архіві. Розпакуйте його та відкрийте feed-checker.html у браузері. Інструмент приймає Google RSS XML до 5 MiB, знаходить пропущені базові поля, повтори ID, проблеми формату ціни та наявності. Якщо GTIN передано, перевіряє довжину й контрольну цифру, але не належність коду товару.

Перевірка виконується на вашому пристрої: файл і його назва не надсилаються на сервер. Дані можна вставити в поле або вибрати XML із комп'ютера; звіт JSON завантажується лише за вашим кліком. Для перевірки не потрібні реєстрація та мережа.

Валідатор не відкриває картки чи фотографії, не перевіряє політики Google та не гарантує схвалення. Тому після виправлення базових помилок усе одно пройдіть ручне зіставлення зі сторінками товарів і перевірте результат обробки у Merchant Center.

Поширені запитання

Браузер відкрив XML. Цього достатньо?

Ні. Потрібно перевірити атрибути й фактичні дані. Навіть правильно сформований файл може містити неправильну валюту або посилання на інший товар.

Чи можна змінити всі ID після виправлення фіда?

Не змінюйте стабільні ID без необхідності. Для Google вони пов'язують оновлення з конкретними товарами та їхньою історією. Документація ID.

Правильний XML гарантує схвалення?

Ні. Після обробки перевірте товарні проблеми в Merchant Center: крім формату, Google оцінює дані та відповідність іншим вимогам. Виправлення файла не замінює перевірку результату його обробки. Специфікація й діагностика Google.

Наступний крок із Shopcore

Працюєте на Shopcore — скопіюйте фактичну адресу експорту зі свого магазину та пройдіть цей чекліст. Інструкція з Merchant Center пояснює потрібні налаштування. Обираєте платформу для власного магазину — створіть пробний акаунт Shopcore і перевірте доступні інструменти під свій каталог.

Технічні вимоги перевірено 20.10.2026. Матеріал та інструмент підготовлено Shopcore.