Фід Google Merchant

Як створити шаблон

Вікно

«Вивантаження каталогу товарів» — ярлик на робочому столі або пункт меню

Створення

кнопка додавання → формат «Google Merchant (XML)»

Редагування

олівець у рядку шаблону

1

Перемикачі «Фото», «Атрибути», «Опції»

2

Блок «Шаблон XML»

1. Перемикачі визначають склад вивантажуваних даних — фото, атрибути, опції — а не наявність відповідного макросу в шаблоні.
2. Блок «Шаблон XML» містить тіло одного товару з тегами майданчика (g:title, g:price та інші), куди підставляються поля каталогу.

У шаблона дві вкладки: «Вибір даних для вивантаження» — усе про вміст файлу, і «Обмеження вивантаження (фільтр)» — умови, які звужують склад товарів.

Перша вкладка складається з кількох блоків:

«Що вивантажувати»

три перемикачі: «Фото», «Атрибути», «Опції»

«Шаблон XML»

увесь файл цілком: шапка фіда й тіло одного товару з макросами ваших полів

«Фото та файл»

адреса, з якої починаються посилання на знімки, і ім'я файлу

«Обмеження вивантаження»

магазин, склад і мова, у яких береться каталог, і галка «Лише в наявності в цьому магазині»

Ім'я файлу за замовчуванням — export_google_feed.xml, і його можна змінити. У назву підставляються макроси: {DATE} — дата, {DATETIME} — дата з часом, {TIME} — тільки час. Це зручно, коли файли складаються в архів, і зайве, коли Merchant Center забирає фід за постійною адресою: у другому випадку ім'я має лишатися незмінним.

Розклад, доставка файлу на FTP і решта спільних налаштувань описані в статті про шаблони вивантаження.

Теги фіда

Поле «Шаблон XML» містить увесь документ, а не окремий фрагмент: оголошення XML, шапку фіда з назвою й адресою магазину і один товар усередині тегу item. Службових маркерів на кшталт «початок циклу» немає — програма сама розмножує вузол товару, а який саме вузол повторювати, задано іменем тегу в розширених налаштуваннях (для Google це item).

Макроси полів вставляють не руками: Ctrl+Space або символ { відкривають список полів каталогу. Мінімальний набір тегів, без якого Merchant Center фід не прийме:

Три макроси працюють не як проста підстановка, а збирають цілі блоки:

• Список фото. Перший знімок стає g:image_link, решта — g:additional_image_link. Merchant приймає одне головне й десять додаткових, тому фід обривається на одинадцятому фото — решта просто не потрапляє у файл.
• Список характеристик. Кожна пара «назва — значення» стає блоком g:product_detail із вкладеними g:attribute_name і g:attribute_value.
• Опис. З нього вирізається розмітка, якої Google не приймає, і він обрізається до п'яти тисяч символів. Для Facebook розмітка вирізається повністю: ця площадка вимагає звичайний текст.

Далі — те, що впливає на показ і статистику:

• g:sale_price — акційна ціна. Google показує перекреслену звичайну й акційну поруч.
• g:gtin і g:mpn — штрихкод і артикул виробника. Без них частина категорій показується гірше; Google просить хоча б один із двох.
• g:product_type — ваша категорія повним шляхом.
• g:google_product_category — категорія з довідника Google; її беруть із зіставлення з маркетплейсами.

У теги можна ставити не тільки макроси, а й обчислення. Типовий приклад — брати рекомендовану ціну, коли вона є, і звичайну, коли її немає; так у фід не потрапляє ціна нижча за домовлену з постачальником.

Наявність: словник Google

У Google свій словник наявності, і Elbuz підставляє його автоматично замість вашого статусу:

Для TikTok той самий набір записується інакше: перша літера велика, підкреслення замінено пробілом — «In stock». Про це піклується програма, у шаблоні нічого міняти не треба.

Сама відповідність «ваш статус → значення Google» задається не у фіді, а в окремому вікні шаблона — «Налаштування оновлення за наявністю товару». Там рядок на кожен статус наявності з вашого довідника, і кожен рядок можна вимкнути. Якщо рядок статусу вимкнено, у фід піде запасне значення, і воно береться вже не зі статусу, а з активності товару: активний — in_stock, неактивний — out_of_stock. Через це буває так, що товар «під замовлення» їде у фід як in_stock: у шаблоні вимкнено рядок цього статусу.

Кнопка цього вікна — у блоці «Повʼязані налаштування» на першій вкладці шаблону. Новий шаблон отримує рядки для всіх статусів увімкненими й без власного тексту, тож у фід іде словник Google за позначками статусів у довіднику статусів наявності. Якщо рядки цього шаблону колись налаштовували, вони діють і далі.

Що потрапляє у фід

Склад даних вирішують два перемикачі з трьох — «Фото» і «Атрибути». На відміну від YML, тут вирішує саме перемикач, а не наявність макроса в шаблоні: знято «Фото» — блок знімків буде порожнім, навіть якщо макрос у шаблоні стоїть.

Третій перемикач, «Опції», у фідах Google, Meta й TikTok ні на що не впливає: товари-опції потрапляють у файл незалежно від нього, окремими позиціями поруч із головним товаром. Якщо вам потрібен у фіді лише головний товар, відсійте опції умовою відбору на вкладці «Обмеження вивантаження (фільтр)». Скільки таких товарів у відборі, показує рядок «Товари-опції» у вікні перед запуском.

Поле «Посилання на фото товару» задає початок адреси, до якої дописується ім'я файлу знімка. Без нього у фіді опиняться відносні адреси, а Google приймає тільки повні. Посилання на саму картку товару складається в тезі g:link у шаблоні — там до адреси вашого сайту додається макрос адреси товару.

Склад товарів звужують так само, як в інших вивантаженнях: фільтром по категоріях і умовами відбору — наприклад, тільки ті, що є в наявності, і тільки з фото. Це описано в шаблонах вивантаження.

Запуск: що відбувається і де це видно

Кнопка «Вивантажити» є і в рядку списку шаблонів, і в шапці картки шаблону. Спершу відкривається вікно «Що буде вивантажено» — зріз каталогу, порахований за умовами саме цього шаблону: «Усього товарів», скільки з них «В наявності», «Немає в наявності», «Під замовлення», «Без статусу наявності». Поруч — якість карток: «Без ціни», «Без фото», «Без опису», «В наявності, але залишок 0». У фідах Google і маркетплейсів у цьому переліку є ще «Без штрихкоду» — рахуються товари, у яких порожні всі чотири поля: EAN, GTIN, UPC і артикул виробника. Кнопка «Показати ці товари в каталозі» відкриває базовий каталог, відфільтрований по цьому ж відбору, — перевірити цифру можна до запуску, а не після відмов Merchant Center.

Тут же працюють стоп-правила: програма порівнює зріз із минулим успішним прогоном цього шаблону. За замовчуванням увімкнені три, усі в режимі «Попереджати»: наявність впала більш ніж на 30 %, загальна кількість товарів впала більш ніж на 50 %, у відборі менше одного товару. Попередження йде в журнал і в підсумок операції, але прогін продовжується. Якщо у вікні «Стоп-правила вивантаження» перевести правило в режим «Зупинити вивантаження», то при спрацюванні прогін обірветься до створення файлу: старий файл лишиться в хмарі недоторканим, а цифри аварійного прогону не запам'ятаються як зразок для наступного порівняння. Пороги діють і під час запуску за розкладом — там вікна ніхто не бачить, і рядок у журналі лишається єдиним слідом.

Далі прогін іде так:

1. у тимчасовій теці видаляється попередній файл цього шаблону, створюється новий, і в нього одразу пишеться шапка фіда;
2. товари дописуються у файл порціями по 500; на кожній порції в журналі з'являється рядок на кшталт «Вивантаження товарів 500 із 12345» — за ним видно, що робота йде і скільки лишилося;
3. у кінець файлу дописуються закривні теги;
4. файл віддається на FTP, якщо FTP налаштовано;
5. новий файл кладеться в теку цього шаблону в хмарному сховищі — рядок «Завантажуємо файл у хмарне сховище»; лише після того, як він туди ліг, з теки прибирається все інше;
6. у картці шаблону оновлюються посилання на файл, його розмір і дата останнього вивантаження.

Останній рядок журналу — посилання «Завантажити файл». Підсумок вдалого прогону — «Вивантаження даних завершено». Якщо файл не зібрався, у журналі стоїть «Вивантаження даних НЕ завершено: файл не сформовано». Так само закінчується прогін, під умови якого не підійшов жоден товар: порожній фід не публікується, і за адресою лишається попередній файл. Якщо новий файл не ліг у хмару, перед підсумком у журналі з'являється помилка «Файл не завантажився в хмарне сховище. Попередній файл і посилання на нього залишено без змін». В усіх цих випадках посилання в картці не змінюється, а дата останнього вивантаження в картці лишається старою навмисне: інакше провальний прогін виглядав би як свіжий фід.

Після прогону колонка «В наявності» в списку шаблонів показує цифри останнього прогону й різницю з попереднім, а другим рядком у тій самій комірці — скільки всього товарів пішло. Уся історія — кнопка «Історія запусків» у шапці картки; у вікні перед запуском показуються останні десять прогонів.

Кнопка «Зупинити» в «Операціях» зупиняє прогін на найближчому товарі. Зупинений прогін нічого не публікує: файл лишається недописаним у тимчасовій теці, у хмару не їде, посилання й дата не змінюються. Те саме з будь-яким обривом посеред прогону — Google до наступного вдалого вивантаження читає попередній файл. Повторювати прогін після обриву безпечно: він починається з чистого файлу, а не дописує до старого.

Пакетний прогін «Вивантажити всі шаблони» і запуск за розкладом виконуються окремим процесом на сервері — браузер їм не потрібен. Шаблони при цьому йдуть по черзі, по одному. Два вивантаження за розкладом одночасно не запускаються: якщо в момент старту вже працює інше, у журналі з'явиться «Скасовано вивантаження за розкладом, причина - вивантажується інший шаблон (конфлікт обробки даних)», і це задання просто пропускається до наступного разу.

Повторний прогін: що він переписує

Кожен прогін збирає файл наново з поточного стану каталогу. Дозбирування «тільки того, що змінилося» у фіді Google немає: галки «Вивантажувати лише нові дані» у формі цього формату не показують, і рушій її не застосовує, навіть якщо вона лишилася увімкненою від давніх налаштувань. У кожному файлі — повний набір товарів, що пройшли умови шаблону.

Попередній файл не зберігається. Щойно новий файл ліг у хмару, програма прибирає з теки цього шаблону все інше, тому зайві файли там не накопичуються — але й «узяти вчорашній фід» немає звідки. У тимчасовій теці на сервері програма тримає не більше трьох останніх файлів, і це технічний залишок, а не архів.

Ваш каталог вивантаження не змінює — воно тільки читає дані. Виняток один, і для фіда він важливий: якщо в налаштуваннях увімкнено «Унікальний внутрішній артикул», перед кожним вивантаженням, яке пройшло стоп-правила, програма проставляє випадковий артикул товарам із порожнім артикулом і розводить суфіксом однакові артикули. Артикул зазвичай і є g:id, а Google упізнає товар саме за цим полем: позиція зі зміненим g:id для нього — новий товар. Тому артикули заповнюють до першого фіда, а не після.

Закріпити своє значення у фіді можна двома способами, обидва — у полі «Шаблон XML»: написати значення текстом замість макроса (так зазвичай роблять із g:condition) або поставити формулу, яка сама вибирає джерело. Прибрати окремий товар із фіда — зняти в його картці позначку «Вивантажувати у файл (на сайт)» або відсікти товар умовою відбору.

Обмін тут односторонній: Elbuz кладе файл за адресою, далі його читає Google. Нічого з боку Merchant Center програма назад не забирає й не звіряє — ні статусів модерації, ні правок, зроблених там вручну чи додатковим фідом.

Коли товар зникає з фіда

Товар не потрапляє у файл, якщо спрацювала хоч одна умова:

• у картці товару знято «Вивантажувати у файл (на сайт)» — тоді товару немає в жодному вивантаженні;
• товар не прив'язаний до жодної категорії;
• категорія товару вимкнена або в ній знято «Вивантажувати у файл (на сайт)»;
• у шаблоні заданий фільтр категорій, і категорії товару в ньому немає;
• товар не проходить умови відбору на вкладці «Обмеження вивантаження (фільтр)»;
• у шаблоні обрано магазин, а товар не віднесено до складу цього магазину. Про це в журналі є окремий рядок: «Відбір за магазином «…»: до нього віднесено N товарів із M у каталозі» — а якщо склад магазину порожній, прямо сказано, що вивантажувати нічого;
• у шаблоні обрано магазин і ввімкнено «Лише в наявності в цьому магазині», а в цьому магазині в товару немає ні додатного залишку, ні статусу «в наявності»;
• у шаблоні обрано склад, а на цьому складі товару немає або він там із нульовим залишком і без статусу «в наявності».

Ніякої позначки «цей товар прибрано» у фіді не з'являється — рядка з товаром просто немає у файлі. Це не те саме, що зняти товар із продажу: out_of_stock замість нього теж не пишеться, бо писати його нема в чому. Якщо потрібно, щоб площадка побачила саме «немає в наявності», товар має лишитися у фіді зі статусом наявності «немає» — тоді у файл піде out_of_stock.

Масове зникнення ловить стоп-правило «обвал кількості товарів щодо минулого прогону»: за замовчуванням воно попереджає, коли товарів стало менше більш ніж наполовину. Порівняння йде з минулим прогоном цього ж шаблону, тому перше вивантаження порівнювати нема з чим — у вікні так і написано: «Шаблон ще не вивантажувався — порівнювати немає з чим».

Якщо фід уже поїхав неправильним

У каталозі відкочувати нічого не треба: вивантаження його не змінює. Помилковим був файл, а не ваші дані — за винятком артикулів, які міг проставити режим «Унікальний внутрішній артикул».

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

1. виправити те, що поїхало не так, — ціни, категорії, статуси наявності або сам шаблон XML;
2. натиснути «Перевірити» в шапці картки шаблону. Це пробний прогін по одному товару тим самим рушієм, що й бойовий: він показує готовий XML цього товару, нерозпізнані макроси (у справжньому файлі їх вирізає мовчки), помилки у формулах і помилки самої XML-розмітки із зазначенням рядка й позиції. Можна вказати ID конкретного товару — і побачити, чи проходить він умови шаблону взагалі. Пробний прогін пише в окремий файл і не чіпає ні посилання, ні FTP, ні файл у хмарі, тому повторювати його можна скільки завгодно;
3. запустити звичайне вивантаження. Адреса файлу не змінюється, у Merchant Center міняти нічого не треба — він забере новий файл за своїм розкладом.

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

Вимкнення і видалення шаблону

У шапці картки шаблону стоїть перемикач «Активність» зі станами «Активний» і «Вимкнений». Клік перемикає його одразу, зберігати форму не треба: змінюється рівно одне поле, решта налаштувань лишається на місці.

Вимкнений шаблон:

• розклад його пропускає — мовчки, рядка в журналі про це немає;
• пакетний прогін «Вивантажити всі шаблони» його не бере;
• кнопки запуску в рядку списку й у картці працюють як раніше: вимкнення не забороняє ручний запуск;
• файл від останнього прогону лишається в хмарі, і Google забирає його за тією самою адресою — з тими самими цінами й залишками, скільки б часу не минуло.

Звідси головна пастка: вимкнути шаблон — не означає прибрати товари з Google. Зупиняється оновлення, а не показ. Увімкнення повертає все як було, бо нічого й не зникало.

Видалення шаблону зносить його налаштування: сам шаблон XML, параметри FTP, прив'язку до розкладу, фільтр категорій і налаштування наявності. А файл у хмарі видалення не чіпає — його замінює тільки наступний вдалий прогін цього ж шаблону, а прогонів більше не буде. Тому й видалення шаблону фід із Google не прибирає: доки джерело даних підключене в Merchant Center, воно читає той самий, назавжди застиглий файл.

Facebook, Instagram і TikTok

Ці площадки читають той самий формат, тому в програмі вони зроблені окремими форматами на тому ж рушії: «Facebook / Instagram (Meta)» та «Tiktok». Створюються так само — кнопкою додавання, вибором формату зі списку.

Шаблон тіла товару в них свій, і набір тегів у кожної площадки трохи відрізняється, але логіка одна: теги площадки плюс ваші макроси. Наявність для TikTok, як сказано вище, записується словами з великої літери.

Сценарії

Не пустити в Google обвал наявності

Задача: якщо в базовому каталозі раптом «зникла» наявність або половина товарів, такий фід не має потрапити в Merchant Center.

Що зробити: у списку шаблонів виділіть рядок шаблону, у меню «Додаткові операції» оберіть «Стоп-правила вивантаження» і для потрібного правила поставте режим «Зупинити вивантаження». Те саме вікно відкривається посиланням «Налаштувати пороги» у зведенні перед запуском. Пороги за замовчуванням — 30 % для наявності й 50 % для загальної кількості товарів.

Що вийде: і ручний прогін, і прогін за розкладом обірвуться до створення файлу, у журналі — «Вивантаження зупинено стоп-правилом», у хмарі лишиться попередній файл, а цифри цього прогону не стануть зразком для наступного порівняння. Артикули такий прогін теж не чіпає — режим «Унікальний внутрішній артикул» спрацьовує лише після того, як стоп-правила пропустили вивантаження. Чого не станеться: на найпершому прогоні шаблону правила обвалу не спрацюють — порівнювати ще немає з чим; діє лише правило порожнього вивантаження.

1

Назва шаблону

2

Колонка «Режим»

3

Колонка «Поріг»

1. Назва шаблону — правила налаштовуються для виділеного в списку шаблону.
2. Режим — тут правило переводять із «Попереджати» в «Зупинити вивантаження», і прогін зупиняється.
3. Поріг — значення, після якого правило спрацьовує.

Призупинити оновлення фіда

Задача: на час інвентаризації чи переоцінки фід не має оновлюватися за розкладом.

Що зробити: у шапці картки шаблону переведіть «Активність» у стан «Вимкнений».

Що вийде: розклад і «Вивантажити всі шаблони» шаблон пропускають, кнопка «Вивантажити» працює як раніше. Чого не станеться: товари з Google не зникнуть — у хмарі лишається файл від останнього прогону, і Merchant Center читає його далі, з тими цінами й залишками, що були на момент прогону (вимкнення і видалення).

У фіді лише головні товари, без варіантів

Задача: Google має бачити одну позицію на товар, а не головний товар і кожну його опцію окремо.

Що зробити: на вкладці «Обмеження вивантаження (фільтр)» додайте умову, яка відсіює товари-опції. Скільки їх у відборі, показує рядок «Товари-опції» у зведенні перед запуском.

Що вийде: у файл підуть лише ті товари, що пройшли умову. Чого не станеться: зняти перемикач «Опції» замало — у фідах Google, Meta й TikTok він ні на що не впливає, опції їдуть у файл незалежно від нього.

Товар закінчився, але має лишитися в Google як «немає в наявності»

Задача: позиція тимчасово відсутня, і в Google вона має показуватися як відсутня, а не зникати.

Що зробити: лишіть товар у відборі шаблону й поставте йому статус наявності, позначений у довіднику як «немає».

Що вийде: товар іде у фід зі значенням out_of_stock. Чого не станеться: якщо замість цього виключити товар із відбору, жодного out_of_stock Google не отримає — рядка товару у файлі просто не буде. Врахуйте й умову відбору нового шаблону: новий шаблон створюється з умовою відбору лише активних товарів, тож неактивний товар у фід не потрапить зовсім, поки цю умову не змінено.

Змінили шаблон XML і хочете побачити результат до бойового прогону

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

Що зробити: натисніть «Перевірити» в шапці картки шаблону; за потреби вкажіть ID конкретного товару.

Що вийде: пробний прогін збирає XML тим самим рушієм і показує нерозпізнані макроси та помилки. Чого не станеться: файл у хмарі, посилання, FTP і цифри для стоп-правил лишаються як були — пробний прогін пише в окремий файл.

Чого вивантаження не робить

• Не заводить обліковий запис Merchant Center. Фід треба підключити на боці Google, вказавши адресу файлу.
• Не виправляє дані. Порожня назва, відсутнє фото чи нульова ціна поїдуть як є — і повернуться відмовою.
• Не рахує доставку й податки. Ці правила задаються в самому Merchant Center.
• Не знімає товари з показу. Файл лише перелічує те, що є. Ані зникнення товару з фіда, ані вимкнення чи видалення шаблону не є командою «прибрати з Google» — це рішення приймає Merchant Center за своїми правилами.
• Не зберігає попередніх версій файлу. Кожен вдалий прогін кладе в теку шаблону в хмарі новий файл і прибирає звідти все інше. Відкотитися до вчорашнього фіда неможливо — тільки виправити дані й вивантажити заново.

Розбір частих проблем

Часті питання

Як підключити готовий фід до Merchant Center?

У Elbuz ви отримуєте файл за постійною адресою; у Merchant Center додається джерело даних із цією адресою й розкладом оновлення. Важливо, щоб ім'я файлу не містило макроса дати — інакше адреса змінюватиметься.

Чому Google відхиляє наявність товарів?

Він приймає тільки in_stock, out_of_stock і preorder. Програма підставляє їх сама, але власний текст статусу з налаштувань наявності шаблону має пріоритет і поїде як є.

Звідки береться категорія Google у фіді?

g:product_type — це ваш шлях категорії, рівні через «>». Категорію з довідника Google беруть із вікна зіставлення з маркетплейсами й підставляють у g:google_product_category.

Як показати акційну ціну?

Звичайну ціну ставлять у g:price, акційну — у g:sale_price. Якщо акції немає, другий тег лишається порожнім, і Google показує одну ціну.

Чи потрібен окремий шаблон для Facebook та Instagram?

Так, це окремий формат у списку — «Facebook / Instagram (Meta)». Рушій той самий, що в Google Merchant, але набір тегів свій.

Чому у фіді немає фото, хоча макрос у шаблоні стоїть?

У фідах Google, Meta й TikTok склад даних визначають перемикачі «Фото» й «Атрибути», а не наявність макроса. Увімкніть потрібний перемикач.

Що буде з файлом, якщо прогін обірвався посередині?

Недописаний файл лишається в тимчасовій теці й у хмару не їде: посилання, розмір і дата останнього вивантаження не змінюються, тому Google продовжує забирати попередній файл. Повторити прогін безпечно — він починається з чистого файлу, а не дописує до обірваного.

Що дає вимкнення шаблону — товари зникнуть із Google?

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

Чи можна відкотити помилковий фід?

Попередніх версій файлу немає: кожен вдалий прогін лишає в теці шаблону в хмарі тільки новий файл. Каталог при цьому не постраждав — вивантаження його не змінює. Виправте дані, перевірте шаблон кнопкою «Перевірити» й вивантажте заново; адреса файлу лишиться та сама.

Суміжні теми

• Шаблони вивантаження — розклад, доставка файлу, умови відбору.
• Зіставлення з маркетплейсами — звідки береться категорія Google.
• Статуси наявності — те, що перетворюється на in_stock.
• Вивантаження у YML — сусідній формат на тому самому рушії.
• Фото товарів — без них фід відхиляють поштучно.