Документація Google Merchant Feed

Цей розділ описує специфіку обробки Google Merchant Center фідів у нашій системі.

Коренева структура

Фід Google Merchant має формат RSS 2.0 з додатковим простором імен g: для атрибутів товару.

<?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>
            ...
        </item>
    </channel>
</rss>

tip

Обов'язкова наявність простору імен xmlns:g="http://base.google.com/ns/1.0" в тезі <rss>. Без нього система не зможе коректно обробити ваш фід.

Обов'язкові поля товару (item)

Кожен товар <item> повинен містити мінімальний набір полів для валідації та індексації.

<item>
    <g:id>product123</g:id>
    <g:title>Назва товару</g:title>
    <g:description>Опис товару</g:description>
    <g:link>https://example.com/product</g:link>
    <g:image_link>https://example.com/image.jpg</g:image_link>
    <g:availability>in stock</g:availability>
    <g:price>999.99 UAH</g:price>
    <g:google_product_category>1234</g:google_product_category>
    <g:product_type>Електроніка</g:product_type>
</item>

Поле	Тип	Обов'язкове	Опис
`g:id`	String	Так	Унікальний ідентифікатор товару
`g:title`	String	Так	Назва товару
`g:description`	String	Так	Опис товару
`g:link`	String	Так	URL сторінки товару в інтернет-магазині
`g:image_link`	String	Так	URL основного зображення товару
`g:availability`	String	Так	Статус наявності товару
`g:price`	String	Так	Ціна з валютою (наприклад: "999.99 UAH")
`g:google_product_category`	String	Ні	ID категорії за таксономією Google. Також можна використовувати власний ID категорії
`g:product_type`	String	Так	Назва категорії товару
`g:product_type_url` / `product_type_url`	String	Ні	URL категорії товару

Поле	Тип	Опис	Приклад
`g:brand`	String	Бренд/виробник товару	"Samsung"
`g:sale_price`	String	Ціна зі знижкою з валютою	"799.99 UAH"

Статус наявності

Система розпізнає товар як наявний, якщо поле g:availability містить одне з наступних значень:

"in stock" (рекомендовано)
"in_stock"
"available"
"1"
"є в наявності"
"есть в наличии"

tip

Рекомендується використовувати "in stock" для позначення наявності товару. Це стандартне значення, яке краще підтримується системами Google.

Формат цін

Ціни в Google Merchant фіді мають бути у форматі {значення} {код_валюти}.

Приклади:

<g:price>15999 UAH</g:price>
<g:sale_price>13999 UAH</g:sale_price>

Логіка обробки цін:

Якщо вказано g:sale_price, вона стає поточною ціною, а значення з g:price використовується як стара ціна для відображення знижки.
Якщо g:sale_price відсутня, то значення g:price стає поточною ціною.
Код валюти витягується з рядка ціни. Якщо валюта не вказана, за замовчуванням використовується "UAH".

note

Використання g:sale_price — це рекомендований спосіб відображення знижок, оскільки це дозволяє системі правильно індексувати ціну та показувати ціну зі знижкою.

Категорії

Категорії автоматично створюються з поля g:product_type.

Обробка вкладених категорій:

<g:product_type>Електроніка</g:product_type>

Ідентифікатор категорії:

Береться з g:google_product_category

note

Google Merchant Center має власну ієрархію категорій. Ви можете використовувати власні ID категорій, але рекомендується використовувати стандартні ID Google для кращої сумісності.

Повний приклад Google Merchant Feed

<?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://electronics-shop.com</link>
        <description>Найкращі гаджети та електроніка</description>

        <item>
            <g:id>PHONE-001</g:id>
            <g:title>Смартфон Samsung Galaxy S23 8/256GB Чорний</g:title>
            <g:description>Флагманський смартфон з потужним процесором та чудовою камерою. Екран 6.1" Dynamic AMOLED 2X, тройна камера 50MP, батарея 3900 мАг.</g:description>
            <g:link>https://electronics-shop.com/smartphones/samsung-galaxy-s23</g:link>
            <g:image_link>https://electronics-shop.com/images/galaxy-s23-black.jpg</g:image_link>
            <g:additional_image_link>https://electronics-shop.com/images/galaxy-s23-black-2.jpg</g:additional_image_link>
            <g:availability>in stock</g:availability>
            <g:price>28999 UAH</g:price>
            <g:sale_price>25999 UAH</g:sale_price>
            <g:brand>Samsung</g:brand>
            <g:google_product_category>267</g:google_product_category>
            <g:product_type>Електроніка > Смартфони > Samsung</g:product_type>
            <g:condition>new</g:condition>
            <g:gtin>8806094667890</g:gtin>
            <g:mpn>SM-S911BZKDSEK</g:mpn>
        </item>

        <item>
            <g:id>LAPTOP-001</g:id>
            <g:title>Ноутбук Apple MacBook Air 13" M2 8/256GB Сірий космос</g:title>
            <g:description>Ультратонкий ноутбук з чіпом Apple M2. Retina дисплей 13.6", 8 ядер CPU, 8 ядер GPU, до 18 годин автономної роботи.</g:description>
            <g:link>https://electronics-shop.com/laptops/macbook-air-m2</g:link>
            <g:image_link>https://electronics-shop.com/images/macbook-air-m2-gray.jpg</g:image_link>
            <g:availability>in stock</g:availability>
            <g:price>49999 UAH</g:price>
            <g:brand>Apple</g:brand>
            <g:google_product_category>298</g:google_product_category>
            <g:product_type>Електроніка > Комп'ютери > Ноутбуки</g:product_type>
            <g:condition>new</g:condition>
        </item>

        <item>
            <g:id>HEADPHONES-001</g:id>
            <g:title>Навушники Sony WH-1000XM5 Чорні</g:title>
            <g:description>Бездротові навушники з активним шумозаглушенням. Час роботи до 30 годин, підтримка Hi-Res Audio, складна конструкція.</g:description>
            <g:link>https://electronics-shop.com/headphones/sony-wh-1000xm5</g:link>
            <g:image_link>https://electronics-shop.com/images/sony-xm5-black.jpg</g:image_link>
            <g:availability>available</g:availability>
            <g:price>13999 UAH</g:price>
            <g:brand>Sony</g:brand>
            <g:google_product_category>249</g:google_product_category>
            <g:product_type>Електроніка > Аудіо > Навушники</g:product_type>
            <g:condition>new</g:condition>
        </item>
    </channel>
</rss>

Валідація Google Merchant Feed

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

Обов'язкові теги структури:

<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0"> — кореневий елемент з правильним простором імен.
<channel> — контейнер для інформації про магазин та товарних позицій.
<item> — мінімум один товарний елемент усередині <channel>.

Обов'язкові поля кожного товару:

g:id — унікальний ідентифікатор товару.
g:title — назва товару.
g:description — опис товару.
g:link — посилання на сторінку товару.
g:image_link — посилання на зображення товару.
g:product_type — тип товару для категоризації.
g:google_product_category — категорія за таксономією Google.

caution

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

Поради щодо створення Google Merchant Feed

Використовуйте правильний простір імен: Обов'язково включіть xmlns:g="http://base.google.com/ns/1.0" в тег <rss>.
Формат цін: Завжди вказуйте валюту у форматі {значення} {код}
Зображення: Переконайтеся, що всі URL зображень доступні та ведуть до валідних файлів
Наявність: Використовуйте стандартні значення статусу наявності
Унікальність ID: Кожен g:id має бути унікальним у межах фіду
Повні URL: Всі посилання мають бути абсолютними URL з протоколом (https://)

Коренева структура​

Обов'язкові поля товару (item)​

Рекомендовані поля​

Статус наявності​

Формат цін​

Категорії​

Повний приклад Google Merchant Feed​

Валідація Google Merchant Feed​

Обов'язкові теги структури:​

Обов'язкові поля кожного товару:​

Поради щодо створення Google Merchant Feed​