Фід місцевого асортименту містить список товарів, які продаються в кожному з ваших магазинів. Деякі атрибути потрібно вказувати для всіх позицій, інші – лише для товарів певного типу, тоді як треті є рекомендованими.
Інформація про ціну й наявність товарів може часто змінюватися й залежати від конкретного магазину. Радимо частіше оновлювати дані про асортимент у фідах. Якщо у вас виникли проблеми з налаштуванням частоти оновлення фідів, зв’яжіться з нашою службою підтримки за допомогою цієї форми. Зверніть увагу, що синхронізація місцеположень компанії з обліковим записом Merchant Center може тривати до 24 годин, тому рекомендуємо завантажувати фід асортименту через 24 години після зв’язування облікових записів або зміни чи оновлення коду магазину в профілях компанії.
Якщо ви хочете надсилати дані про товари через API, дізнайтеся більше про Google Content API.
Як надсилати фіди місцевого асортименту товарів
Тип файлу. Фід місцевого асортименту товарів можна завантажити як текстовий файл із роздільниками табуляції, файл XML або через API.
Створіть новий фід місцевого асортименту товарів, дотримуючись цих вказівок.
Важливо. Деякі атрибути в специфікації фіду місцевого асортименту товарів містять пробіли й символи підкреслення. Щоб надіслати атрибути з відповідними символами й пробілами, дотримуйтеся наведених нижче вказівок для різних типів файлів.
- Текстовий фід із роздільниками: використовуйте пробіли замість символів підкреслення ("_") в атрибутах.
- Файл XML або JSON для завантаження через API: обов’язково використовуйте символи підкреслення – під час отримання фіду вони конвертуються в пробіли.
Опис вимог до атрибутів
| Атрибут | Вимоги до надсилання | |
|---|---|---|
| Обов’язкові дані про асортимент |
Код магазину |
Обов’язково для всіх товарів. Примітка. Атрибут "код магазину" |
| Необов’язкові дані про асортимент |
Строк дії знижки Кількість |
Рекомендується застосовувати до кожної позиції у фіді, щоб надати додаткову інформацію про ціну, кількість і доставку в той самий день. Зверніть увагу, що, якщо ціна є стандартною для всієї країни, вказувати її не обов’язково. Ціну потрібно вказувати, якщо її змінено в певному магазині. |
| Необов’язкові дані про самовивезення з магазину |
Спосіб отримання Дата отримання |
Рекомендується застосовувати для всіх товарів у фіді, які можна забрати в магазині. Важливо. Починаючи з 1 вересня 2024 року, вам більше не потрібно буде вказувати атрибут "спосіб отримання" |
| Необов’язкові дані про доставку товарів місцевого асортименту | Транспортна етикетка для товарів місцевого асортименту [local_shipping_label] |
Обов’язково, якщо ви хочете ввімкнути доставку в той самий день лише для певних товарів в окремому магазині. |
Обов’язкові дані про асортимент
Ці атрибути містять основну інформацію про кожен товар в асортименті певного магазину.
[store_code] – ідентифікатор магазину в профілях компанії
Унікальний буквено-цифровий ідентифікатор для кожної місцевої компанії. Цей атрибут враховує регістр. Його значення мають збігатися з кодами магазинів у профілях компанії.
Використання. Цей атрибут обов’язковий для всіх товарів у фіді.
| Тип | Текст (рядок) |
| Приклад текстового формату з роздільниками | store123 |
| Приклад формату XML | <g:store_code>store123</g:store_code> |
[id] – ідентифікатор товару
Унікальний буквено-цифровий ідентифікатор товару, який використовується для всіх ваших магазинів.
Якщо ви продаєте той самий товар у кількох магазинах, указуйте для них однакове значення атрибута "ідентифікатор". Для кожного магазину товар потрібно додавати за допомогою атрибута ідентифікатор [id], а наявність товару вказувати через атрибут "наявність" [availability].
Якщо у вас кілька фідів того самого типу для однієї країни, ідентифікатори товарів у них усе одно мають бути унікальними. Якщо артикули у вашому асортименті товарів унікальні й відповідають наведеним нижче вимогам, радимо використовувати їх для цього атрибута.
Використання. Цей атрибут обов’язковий для всіх товарів у фіді.
| Тип | Текст (рядок) |
| Приклад текстового формату з роздільниками | 421486 |
| Приклад формату XML | <g:id>421486</g:id> |
Важливо
- Використовуйте однакові значення атрибута ідентифікатора для основного фіду й фіду місцевого асортименту товарів.
- Початкові та кінцеві пробіли, а також символи повернення каретки (0x0D) вилучаються.
- Кожна послідовність повернення каретки (0x0D) і символів пробілу (символи Юнікод для позначення пробілу) замінюється одним пробілом (0x20).
- Підтримуються лише дійсні символи Юнікод. При цьому не допускаються:
- керівні символи (крім символу повернення каретки 0x0D);
- функціональні символи;
- символи з області приватного використання;
- сурогатні пари;
- непризначені точки коду (зокрема будь-яка точка коду, вища за 0x10FFFF).
- Якщо дані про товар надіслано, значення атрибута ідентифікатор
[id]не можна змінювати під час оновлення фіду або використовувати його в майбутньому для інших позицій. - Додавайте лише ті товари, які можна купити у ваших магазинах.
[availability] – статус наявності товару
- У наявності [in_stock] – указує на те, що товар можна купити в місцевому магазині.
- Немає в наявності [out_of_stock] – указує на те, що товар відсутній у місцевому магазині.
- Обмежена кількість [limited_availability] – указує на те, що в місцевому магазині залишилося лише кілька одиниць товару.
- Огляд і замовлення в магазині [on_display_to_order] – указує на те, що товар є лише на вітрині, але його можна замовити в місцевий магазин (наприклад, холодильник, який потрібно доставити зі складу). Якщо ви також надсилаєте атрибут кількість
[quantity], укажіть значення "1" для товарів, доступних для огляду й замовлення в магазині.
| Тип | Текст (рядок). Підтримуються такі 4 значення: у наявності [in_stock], немає в наявності [out_of_stock], обмежена кількість [limited_availability], огляд і замовлення в магазині [on_display_to_order]. |
| Приклад текстового формату з роздільниками | in stock |
| Приклад формату XML | <g:availability>in_stock</g:availability> |
Необов’язкові дані про асортимент
За допомогою цих атрибутів можна надати додаткову інформацію про ціну, кількість і наявність товарів.
[price] – ціна товару
Стандартна ціна товару. Якщо ви надсилаєте ціну у фіді асортименту й основному фіді, ціна у фіді асортименту перевизначить ціну в основному фіді для відповідного магазину.
Використання. Цей атрибут обов’язковий для всіх товарів у фіді.
| Тип | Число (валюта автоматично призначається залежно від країни, у якій розташовано магазин) |
| Приклад текстового формату з роздільниками | 2990.99 |
| Приклад формату XML | <g:price>2990.99</g:price> |
[sale_price] – рекламована ціна товару зі знижкою
Рекламована ціна зі знижкою, яка тимчасово замінює значення атрибута ціна [price] для певного магазину в цьому фіді й фіді місцевих товарів.
Радимо вказувати атрибут термін дії знижки [sale_price_effective_date] для товарів, для яких діє ціна зі знижкою. Цей атрибут визначає, протягом якого періоду ця ціна відображатиметься. Якщо не вказати цей атрибут, ціна зі знижкою діятиме для товару весь час, поки його включено у фід.
| Тип | Число |
| Приклад текстового формату з роздільниками | 2790.99 |
| Приклад формату XML | <g:sale_price>2790.99</g:sale_price> |
[sale_price_effective_date], що термін дії знижки вже минув.[sale_price_effective_date] – діапазон дат, протягом якого діє знижка на товар
Це дати, протягом яких діятиме рекламована ціна зі знижкою.
Докладніше про визначення атрибута "ціна зі знижкою".
| Тип | Текст (рядок), ISO 8601, з датами початку й завершення, розділеними скісною рискою (/) |
| Приклад текстового формату з роздільниками |
Приклад для всесвітнього координованого часу (UTC): Час потрібно вказувати у 24-годинному форматі. |
| Приклад формату XML | <g:sale_price_effective_date>2021-07-19T09:00-0800/2021-07-26T21:00-0800</g:sale_price_effective_date> |
[quantity] – кількість товару в наявності
Наявна в магазині кількість товару. Якщо ви надсилаєте дані про товари, яких тимчасово немає в наявності, укажіть для цього атрибута значення "0".
Атрибут кількість більше не є обов’язковим. Натомість надішліть атрибут наявність для всіх товарів з асортименту.
| Тип | Ціле число |
| Приклад текстового формату з роздільниками | 4 |
| Приклад формату XML | <g:quantity>4</g:quantity> |
Важливо
- У системі Google статус "у наявності" означає, що залишилися принаймні 3 одиниці товару, статус "обмежена кількість" відповідає 1–2 одиницям, а статус "немає в наявності" – 0 одиниць.
- Якщо ви вкажете кількість і наявність товарів, позиції з асортименту класифікуватимуться на основі їх меншого значення наявності й кількості.
Необов’язкові дані про самовивезення з магазину
Додайте ці атрибути у фід місцевого асортименту товарів, щоб указати інформацію про можливість самовивезення з певного магазину.
Спосіб отримання[pickup_method] – можливість самовивезення товару з магазину
[pickup_method] більше не потрібно.Укажіть спосіб отримання певного товару за допомогою одного з наведених нижче значень.
- buy: уся трансакція відбувається онлайн.
- reserve: товар резервується онлайн, а трансакція відбувається в магазині.
- ship_to_store: товар оплачується онлайн і доставляється в місцевий магазин, звідки його зможе забрати покупець.
- not_supported: товар не можна самостійно забрати в магазині.
| Тип | Текст (рядок). Підтримуються такі 4 значення:
buy, reserve, ship_to_store і not_supported. |
| Приклад текстового формату з роздільниками | buy |
| Приклад формату XML | <g:pickup_method>buy</g:pickup_method> |
[pickup_sla] – термін самовивезення товару з магазину.
Цей атрибут указує очікувану дату, коли товар можна забрати з магазину залежно від часу оформлення замовлення.
- same_day – указує на те, що товар можна забрати з магазину в той самий день, коли було розміщено замовлення (з урахуванням часу припинення прийому замовлень).
- next_day – указує на те, що товар можна забрати з магазину наступного дня після розміщення замовлення.
- 2_day – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати за 2 дні.
- 3_day – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати за 3 дні.
- 4_day – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати за 4 дні.
- 5_day – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати за 5 днів.
- 6_day – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати за 6 днів.
- multi_week – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати за тиждень або більше.
| Тип | Текст (рядок). Підтримуються такі 8 значень:
same_day, next_day, 2_day, 3_day, 4_day, 5_day, 6_day і multi_week. |
| Приклад текстового формату з роздільниками | same_day |
| Приклад формату XML | <g:pickup_sla>same_day</g:pickup_sla> |
Необов’язкові дані про доставку товарів місцевого асортименту
Додайте цей атрибут у фід місцевого асортименту товарів, щоб указати інформацію про доставку позицій місцевого асортименту.
Транспортна етикетка для місцевої доставки [local_shipping_label]
Якщо ви хочете ввімкнути доставку в той самий день лише для деяких товарів місцевого асортименту в окремому магазині, додайте атрибут "транспортна етикетка для місцевої доставки" [local_shipping_label] у фід місцевого асортименту товарів.
Значення цього атрибута має збігатися з назвою однієї чи більше міток доставки в той самий день, які ви створили в налаштуваннях на рівні облікового запису для доставки в той самий день. Кожна мітка доставки в той самий день є однією унікальною групою налаштувань і додається в дані про вибрані товари у фіді місцевого асортименту, що відповідають вимогам.
Щоб налаштувати позиції для доставки в той самий день, укажіть максимальний радіус доставки (у милях або кілометрах). Граничний час приймання замовлень для доставки в той самий день також можна вказати як кількість годин до закриття магазину, якщо замовлення для доставки приймаються протягом дня, або до певного часу. Ви можете вказати, чи ваші товари, доступні для доставки в той самий день, можуть доставлятися наступного дня, якщо замовлення буде розміщено після граничного часу приймання замовлень для обробки в той самий день.
Цей атрибут необов’язковий, якщо ви пропонуєте доставку в той самий день для всіх своїх магазинів і товарів або якщо вона доступна для всіх позицій у списку магазинів, що відповідають вимогам. Докладніше про доставку в той самий день.