Специфікація даних про товари місцевого асортименту

Використовуйте цю специфікацію, щоб форматувати дані для реклами ваших товарів місцевого асортименту в Google. Указуйте дані про товар у правильному форматі. Так ви зможете створювати успішну рекламу місцевого асортименту й безкоштовно розміщувати інформацію про товари з місцевого асортименту.

Дані про товари, які ви надсилаєте за допомогою наведених нижче атрибутів, слугують основою для створення оголошень і безкоштовно розміщеної інформації про товари з місцевого асортименту. Тому надавайте якомога якіснішу й точнішу інформацію, оскільки її бачитимуть покупці.

У цій статті перелічено всі атрибути, які можна надсилати у фіді, щоб показувати рекламу й безкоштовно розміщену інформацію про товари з місцевого асортименту.

Основні фіди

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

1. Увійдіть у свій обліковий запис Merchant Center.
2. Перейдіть у розділ Товари.
3. Натисніть Фіди.
4. Виберіть потрібний основний фід.
5. Додайте рекламу місцевого асортименту або безкоштовно розміщену інформацію про товари з місцевого асортименту як цільові сервіси для всіх країн і мов цього фіду.

Примітка. Якщо ви надсилаєте окремі основні фіди для місцевих і онлайн-пропозицій (товарних оголошень і безкоштовно розміщеної інформації про товари), позиції в них не мають повторюватися.

Google рекомендує надсилати всі товари в єдиному фіді для всіх програм реклами місцевих пропозицій. У нових фідах усі відповідні цільові сервіси можна вибрати під час створення фіду. Дізнайтесь, як створити основний фід. Для наявних фідів нові цільові сервіси (зокрема рекламу місцевого асортименту та/або безкоштовно розміщену інформацію про товари з місцевого асортименту) можна додати в налаштуваннях основного фіду. Щоб виключити свої пропозиції з товарних оголошень або реклами місцевого асортименту й безкоштовно розміщеної інформації про товари з місцевого асортименту, укажіть атрибут виключені кампанії [excluded_destination]. Докладніше про цей атрибут

Якщо ви створили фід товарів до 3 жовтня 2019 року, ця інформація вас не стосується. Ви можете й далі надсилати пропозиції в окремих фідах.

Як надіслати основний фід

Тип файлу. Ви можете використовувати текстовий файл із роздільниками (рекомендовано), фід у форматі XML або API.

Реєстрація нового фіду. Щоб зареєструвати новий фід, дотримуйтеся стандартних вказівок.

Зверніть увагу, що показ товарів почнеться протягом 2 днів після надсилання даних.

Важливо. Деякі атрибути в цій специфікації даних про товари містять пробіли й символи підкреслення. Щоб надсилати атрибути з відповідними символами й пробілами, дотримуйтеся наведених нижче вказівок для різних типів файлів.

• Текстовий фід із роздільниками: використовуйте пробіли замість символів підкреслення ("_") в атрибутах.
• Фід у форматі XML або API для файлу XML: обов’язково використовуйте символи підкреслення – під час отримання фіду вони конвертуються в пробіли.
• API для файлу JSON: обов’язково використовуйте символи підкреслення – під час отримання фіду вони конвертуються в пробіли.

Опис вимог до атрибутів

Атрибут	Вимоги до надсилання
Опис [description] Ідентифікатор [id] Посилання на зображення [image_link] Назва [title]	Обов’язкові для всіх товарів, які ви продаєте в магазинах.
Глобальний номер товару [gtin]	Обов’язковий для всіх нових товарів, яким виробники надали глобальні номери. Необов’язковий (але рекомендований) для всіх інших товарів.
Бренд [brand]	Обов’язковий для всіх нових товарів (крім фільмів, книжок і музичних записів). Необов’язковий для всіх інших товарів.
Стан [condition]	Обов’язковий, якщо товар уживаний або відновлений. Необов’язковий для нових товарів.
Сертифікація [certification] Сертифікати, зокрема ті, що підтверджують класи енергоспоживання відповідних товарів Доступно лише для Великої Британії та країн – учасниць Європейського Союзу і Європейської асоціації вільної торгівлі Обов’язковий для позицій, які потребують показу інформації про сертифікацію в товарних оголошеннях або безкоштовно розміщеній інформації про товари (наприклад, згідно з місцевими нормами щодо необхідності вказувати клас енергоефективності) Необов’язковий для всіх інших товарів Примітка. Якщо вам не вдається знайти товар у базі даних EPREL, протягом обмеженого перехідного періоду можете натомість скористатися атрибутами класу енергоефективності.	Щоб визначити, чи потрібно надсилати цей атрибут, ознайомтеся з регламентами ЄС щодо енергоефективності або відповідними місцевими законами.
Клас енергоспоживання [energy_efficiency_class] Мінімальний клас енергоспоживання [min_energy_efficiency_class] Максимальний клас енергоспоживання [max_energy_efficiency_class]	Обов’язкові, якщо ваші товари націлено на країни ЄС, Велику Британію або Швейцарію. Необов’язкові, якщо ваші товари не націлено на країни ЄС, Велику Британію або Швейцарію. Примітка. Ці атрибути більше не підтримуватимуться. Натомість використовуйте атрибут сертифікація [certification], щоб показувати клас енергоефективності за стандартом ЄС.
Виключені кампанії [excluded_destination]	Рекомендований, якщо ви надсилаєте дані про товари для реклами місцевих і онлайн-пропозицій за допомогою того самого основного фіду. Використовуйте цей атрибут, щоб виключати товари, які не продаються у звичайних магазинах, з реклами місцевого асортименту й безкоштовно розміщеної інформації про товари з місцевого асортименту.
Глобальний номер товару [gtin] Код виробника товару (MPN) [mpn] Бренд [brand]	Необов’язкові Якщо ви надсилаєте дані про товари для показу місцевих пропозицій через застарілий фід місцевих товарів, використовуйте ці атрибути, щоб зіставляти товари, які ви продаєте у звичайних і онлайн-магазинах, у відповідних фідах. Для цього потрібно, щоб збігалися значення таких атрибутів: ідентифікатор [id] і "ідентифікатор зіставлення" [webitemid]; глобальний номер товару [gtin] і бренд [brand] або код виробника товару [mpn] і "бренд" [brand]. Якщо ви зіставляєте товари за допомогою унікальних ідентифікаторів товарів, додайте атрибут стан [condition] у цей фід.
Ціна [price] Ціна зі знижкою [sale_price] Строк дії знижки [sale_price_effective_date] Одиниця товару [unit_pricing_measure] Стандартна одиниця товару [unit_pricing_base_measure]	Рекомендовані: атрибути "ціна" [price], "ціна зі знижкою" [sale_price] і "строк дії знижки" [sale_price_effective_date] можна надіслати в основному фіді, якщо ціна товару однакова в усіх магазинах.   Обов’язкові: атрибути "ціна" [price], "ціна зі знижкою" [sale_price] і "строк дії знижки" [sale_price_effective_date] необхідно надіслати в основному фіді, якщо ви використовуєте каталог місцевого магазину на сайті продавця. Обов’язкові: атрибути "одиниця товару" [unit_pricing_measure] і "стандартна одиниця товару" [unit_pricing_base_measure] необхідні, коли це вимагається місцевим законодавством.
Спосіб отримання [pickup_method] Дата отримання [pickup_sla]	Щоб дозволити покупцям купувати товари онлайн і самостійно забирати їх із магазину, потрібно додати ці 2 атрибути. Атрибути "спосіб отримання" [pickup_method] і "дата отримання" [pickup_SLA] також можна вказати на рівні магазину у фіді ваших товарів місцевого асортименту. Важливо. Починаючи з 1 вересня 2024 року, вам більше не потрібно вказувати атрибут "спосіб отримання" [pickup_method], щоб увімкнути функцію самовивезення для своїх пропозицій. Докладніше про функції Забрати сьогодні, Забрати пізніше (для реклами місцевого асортименту) й Забрати пізніше (для товарних оголошень).
Посилання [link] Посилання для каталогу місцевого магазину на сайті продавця [link_template] Мобільне посилання для каталогу місцевого магазину на сайті продавця [mobile_link_template] Переспрямування в оголошенні [ads_redirect]	Необов’язкові, якщо ви хочете використовувати каталог місцевого магазину на сайті продавця. Атрибут посилання [link] обов’язковий, якщо ви використовуєте базову версію каталогу місцевого магазину на сайті продавця. Атрибут "посилання для каталогу місцевого магазину на сайті продавця" [link_template] обов’язковий, якщо ви використовуєте повну версію каталогу місцевого магазину на сайті продавця. Атрибути "мобільне посилання для каталогу місцевого магазину на сайті продавця" [mobile_link_template] і переспрямування в оголошенні [ads_redirect] необов’язкові.

Важлива примітка (тільки для фідів у форматі XML). Якщо ви оновлюєте будь-який із наведених нижче атрибутів для XML-фіду, потрібно додати опис простору імен для Google Merchant Center. Інакше фід може оброблятися неправильно.

Обов’язкові атрибути для ідентифікації

Ці атрибути надають основну інформацію про ваші товари і є обов’язковими.

Ідентифікатор [id] – ідентифікатор товару

Це унікальний ідентифікатор кожного товару у всіх ваших магазинах. Він не може повторно використовуватись у фідах одного типу для тієї самої країни та мови.

Використання. Обов’язковий для всіх товарів у фіді.

Тип	Рядок
Приклад текстового формату з роздільниками	421486
Приклад формату XML	<g:id>421486</g:id>

Важливо

• Початкові та кінцеві пробіли, а також символи повернення каретки (0x0D) вилучаються.
• Кожна послідовність повернення каретки (0x0D) і символів пробілу (символи Юнікод для позначення пробілу) замінюється одним пробілом (0x20).
• Підтримуються лише дійсні символи Юнікод. При цьому не допускаються:
  • керівні символи (крім символу повернення каретки 0x0D);
  • функціональні символи;
  • символи з областей для приватного використання;
  • сурогатні пари;
  • непризначені точки коду (зокрема будь-яка точка коду поза 0x10FFFF).
• Якщо дані про товар надіслано, значення атрибута "ідентифікатор" не можна змінювати під час оновлення фіду або використовувати його в майбутньому для інших позицій.
• Якщо ви використовуєте атрибут "ідентифікатор" для торгових кампаній, радимо застосовувати тільки малі літери або незалежні від регістру символи.

Назва [title] – назва товару

Назва вашого товару. Google радить включати в назву відмінні характеристики, як-от колір або бренд. Якщо дані збігаються, замість указаної назви може показуватись назва товару з вашого сайту або каталогу Google.

Використання. Обов’язковий для всіх товарів у фіді.

Тип	Текст (рядок) довжиною не більше ніж 70 символів
Приклад текстового формату з роздільниками	Netgear ReadyNAS Duo
Приклад формату XML	<g:title>Netgear ReadyNAS Duo</g:title>

Важливо

• Чітко дотримуйтеся наших редакційних правил. Наприклад, не використовуйте ВЕЛИКІ ЛІТЕРИ й рекламний текст, як-от "Безкоштовна доставка".
• Для схожих товарів потрібно вказувати спільну назву. Наприклад, для чоловічих сорочок поло червоного й синього кольорів із тканини піке можна використовувати одну з наведених нижче назв.
  • Футболка поло чоловіча піке (підійде для обох варіантів)
  • Футболка поло чоловіча піке червона (для футболки червоного кольору)
  • Футболка поло чоловіча піке синя (для футболки синього кольору)

Опис [description] – опис товару

Опис має містити лише найважливіші ознаки товару, як-от його розміри, матеріал, цільовий віковий діапазон, особливості й інші технічні характеристики. Також потрібно додавати інформацію про зовнішній вигляд товару (зокрема його форму, візерунок, текстуру й дизайн), оскільки вони можуть використовуватися для його пошуку.

Максимальна довжина опису – 5000 символів, проте радимо використовувати від 500 до 1000 символів. Описи мають відповідати стандартним правилам граматики й закінчуватися знаком пунктуації.

Використання. Обов’язковий для всіх товарів у фіді.

API вмісту, версія 2 (JSON)	"description": "Однотонні червоні постільні комплекти, півтораспальні, 100% тканий поліестер, щільністю 300 ниток/см². Комплект складається з простирадла, підковдри та двох стандартних наволочок. Придатні для машинного прання; підходять для дуже високих матраців."
API вмісту, версія 2 (XML)	<description>Однотонні червоні постільні комплекти, півтораспальні, 100% тканий поліестер, щільністю 300 ниток/см². Комплект складається з простирадла, підковдри та двох стандартних наволочок. Придатні для машинного прання; підходять для дуже високих матраців.</description>

Тип	Текст
Ліміт символів	5000
Текст (TSV)	Однотонний червоний постільний комплект, півтораспальний, 100% тканий поліестер щільністю 300 ниток/см². Комплект складається з простирадла, підковдри та двох стандартних наволочок. Придатний для машинного прання; підходить для дуже високих матраців.
XML (фіди)	<description>Однотонний червоний постільний комплект, півтораспальний, 100% тканий поліестер щільністю 300 ниток/см². Комплект складається з простирадла, підковдри та двох стандартних наволочок. Придатний для машинного прання; підходить для дуже високих матраців.</description>

Важливо

• Обов’язково дотримуйтесь редакційних правил Google. Наприклад, не використовуйте рекламний текст, як-от "Безкоштовна доставка", ВЕЛИКІ ЛІТЕРИ, опис свого бренду чи компанії.
• Також не включайте в описи таку інформацію:
  • посилання на свій магазин або інші веб-сайти;
  • платіжну інформацію або відомості про розпродажі;
  • власні категорії класифікації товарів, що використовуються у вашій компанії, наприклад, "Іграшки та ігри > Іграшки > Дитячі ляльки";
  • порівняння з іншими товарами, які ви не продаєте, як-от "ще кращий/швидший/більший, ніж товар X";
  • інформацію про інші товари, зокрема схожі, або аксесуари.

Посилання на зображення [image_link] – URL-адреса зображення товару

Це URL-адреса основного зображення товару, яке покупці першим бачать на сторінці з додатковими відомостями про товар.

Якщо у вас кілька різних зображень товару, надішліть основне зображення за допомогою цього атрибута, а всі інші – в атрибуті посилання на додаткове зображення [additional_image_link].

Розмір зображення:

• надсилайте зображення товару з найвищою роздільною здатністю та в повному розмірі (до 16 МБ);
• рекомендований мінімальний розмір зображення: 800x800 пікселів;
• для предметів одягу розмір зображення має бути не менше ніж 250x250 пікселів і не більше ніж 64 мегапікселі; для всіх інших товарів – не менше ніж 100x100 пікселів і не більше ніж 64 мегапікселі;
• забороняється збільшувати масштаб зображення або завантажувати ескізи (радимо надсилати зображення, на яких товар займає 75–90% площі).

Використання. Обов’язковий для всіх товарів у фіді.

API вмісту, версія 2 (JSON)	"imageLink": "http://www.example.com/image1.jpg"
API вмісту, версія 2 (XML)	<image_link>http://www.example.com/image1.jpg</image_link>

Тип	URL-адреса має починатися з префікса "http://" або "https://".
Ліміт символів	2000
Текст (TSV)	http://www.example.com/image1.jpg
XML (фіди)	<g:image_link>http://www.example.com/image1.jpg </g:image_link>

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

Вимоги

• Не можна надсилати товар, якщо у вас немає його зображення.
• Крім того, заборонено надсилати такі типи зображень:
  • типові або неправильні зображення товару;
  • загальні зображення, малюнки або ілюстрації, які не є зображеннями реальних товарів, за винятком товарів у категоріях "Hardware" [Апаратне забезпечення] (632) або "Vehicles and parts" [Транспортні засоби й деталі до них] (888), які дозволяють графіки або ілюстрації реального товару;
  • одноколірні зображення (прямокутники певного кольору), за винятком товарів у категоріях "Vehicle Paint" [Фарби для транспортних засобів] (3812), "Craft Paint, Ink & Glaze" [Фарби, чорнило та глазур для рукоділля] (505378) і "Painting Consumables" [Витратні матеріали для фарбування] (503740);
  • зображення, що містять елементи реклами (заклики до дії, як-от "купуйте"); інформацію про послуги (наприклад, "розширена гарантія", "безкоштовна доставка"); відомості про ціну або рекламні характеристики (як-от "найкращий", "дешевий") чи дані про стан або сумісність (наприклад, "новий", "2 шт.", "регульований"); назви та/або логотипи продавців, незалежно від того, чи накладаються ці елементи на зображення товару (це також стосується водяних знаків з елементами реклами, іменами чи назвами та/або логотипами продавців);
  • зображення з елементами, що накладаються на товар і перекривають його (як-от водяні знаки, назви брендів та/або логотипи);
  • зображення з рамками;
  • зображення пакета товарів, на якому не показано весь вміст;
  • зображення мультиупаковки, на якому не показано одиницю товару.
  • Також заборонено вказувати цільові сторінки без зображень або із зображеннями, що не відповідають реальним товарам.
• Переконайтеся, що зображення кожного товару відповідає значенням, указаним в атрибутах колір [color], візерунок [pattern] і матеріал [material]. Товари з невідповідними зображеннями може бути відхилено.

Рекомендації

• Якщо ви не маєте окремих зображень кожного варіанта й не можете надіслати їх як окремі товари, надішліть їх як один товар, додавши доступне зображення та вказавши різні значення в атрибуті варіанта.
• Зображення має точно показувати товар без зайвих предметів.
• Якщо ви надсилаєте дані про варіанти різних кольорів, для кожного варіанта потрібно надати зображення товару в одному кольорі.
• Основне зображення слід знімати на однотонному білому, сірому або світлому фоні.
• Основне зображення товару має чітко й повністю показувати товар, що продається. Вигляд товару з інших ракурсів (окрім основного) слід надсилати через атрибут посилання на додаткове зображення [additional_image_link].

Формат

• Допустимі формати зображень: GIF (.gif) (без анімації), JPEG (.jpg/.jpeg), PNG (.png), BMP (.bmp) і TIFF (.tif/.tiff). Розширення файлів для цих зображень мають відповідати їх формату.
• Допустимі протоколи URL-адреси: "http" і "https". Наявні символи потрібно замінити елементами кодування URL-адрес (наприклад, замість коми використовувати "%2C").
• Google радить надсилати статичні URL-адреси для зображень і оновлювати URL-адресу, лише якщо змінився вигляд товару. Це особливо важливо, якщо ви розміщуєте зображення в мережі доставки контенту. Тоді Google зможе сканувати їх правильно.

Обрізання

Ми можемо автоматично обрізати зображення, щоб акцентувати увагу на товарі.

Стан [condition] – стан товару

Google дозволяє рекламу якісних уживаних товарів. Крім того, можна рекламувати відремонтовані товари, якщо вони відповідають місцевим законам і нормативним актам, а також нашим правилам.

Цей атрибут має лише 3 допустимі значення, які наведено нижче.

• Новий [new] – товар новий, ним ніколи не користувалися. Оригінальна упаковка, яку не відкривали.
• Відновлений [refurbished] – товар професійно відновлено до робочого стану, він виглядає як новий і поставляється з гарантією. Може мати оригінальну упаковку. Іноді такі товари називають "переробленими".
• Уживаний [used] – застосовується, якщо попередні два значення не підходять. Наприклад, товаром користувалися раніше, оригінальна упаковка відкрита або відсутня. Це значення потрібно вказувати для повторно заправлених картриджів принтерів.

Використання. Обов’язковий, якщо товар уживаний або відремонтований. Необов’язковий для нових товарів.

API вмісту, версія 2 (JSON)	"condition": "уживаний"
API вмісту, версія 2 (XML)	<condition>уживаний</condition>

Тип	Може мати лише 3 значення: новий [new] відновлений [refurbished] уживаний [used]
Текст (TSV)	used
XML-формат	<g:condition>used</g:condition>

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

Глобальний номер товару [gtin] – глобальний номер товару (GTIN)

Використовуйте цей атрибут, щоб надсилати глобальні номери товарів в одному з наведених нижче форматів.

• UPC або GTIN-12 (у Північній Америці): 12-значний номер (8-значні коди UPC-E потрібно конвертувати у 12-значні).
• EAN або GTIN-13 (у Європі): 13-значний номер.
• JAN або GTIN-13 (у Японії): 8- або 13-значний номер.
• ISBN (для книг): 10- або 13-значний номер. Якщо у вас є обидва номери, укажіть 13-значний. ISBN-10 не підтримується – його потрібно конвертувати в ISBN-13.
• ITF-14 або GTIN-14 (для мультиупаковок): 14-значний номер.

Використання	Обов’язковий для всіх нових товарів, яким виробники надали глобальний номер
Тип	8-, 12-, 13- або 14-значний номер (UPC, EAN, JAN або ISBN)
Ліміт символів	50
Текст, розділений символами табуляції	3234567890126
XML (фіди)	<g:gtin>3234567890126</g:gtin>

Важливо

• Ми приймаємо лише дійсні глобальні номери товарів, що відповідають вимогам GS1, викладеним в офіційному посібнику, а саме:
  • містять правильну контрольну цифру;
  • не належать до номерів обмеженої сфери обігу (префікси 02, 04, 2 за GS1);
  • не містять коди купонів (префікси 98–99).

Бренд [brand] – бренд товару

Використання. Обов’язковий для всіх нових товарів (крім фільмів, книжок і музичних записів). Необов’язковий для всіх інших товарів.

API вмісту, версія 2 (JSON)	"brand": "Acme"
API вмісту, версія 2 (XML)	<brand>Acme</brand>

Тип	Текст
Ліміт символів	70
Текст (TSV)	Acme
XML (фіди)	<g:brand>Acme</g:brand>

Важливо. Указуйте замість бренду назву свого магазину, лише якщо ви виготовляєте товари самі.

Сертифікація [certification] – сертифікація товару

Використовуйте атрибут "сертифікація" [certification], щоб надати інформацію про сертифікацію відповідних товарів, зокрема класи їх енергоефективності.

Коли використовувати

Обов’язковий для позицій, які потребують показу певної інформації в товарних оголошеннях або безкоштовно розміщеній інформації про товари (наприклад, згідно з місцевими нормами щодо необхідності вказувати клас енергоефективності)

Необов’язковий для всіх інших товарів

Якщо ваші товари націлено на Велику Британію, країни Європейського Союзу і Європейської асоціації вільної торгівлі, ознайомтеся з нормами ЄС щодо енергоефективності або відповідними місцевими законами, щоб визначити, чи потрібно надсилати цей атрибут (наприклад, якщо його включено в базу даних EPREL).

Можливо, вам потрібно буде вказати клас енергоефективності за стандартом ЄС у товарних оголошеннях і безкоштовно розміщеній інформації про товари. Для цього в дані про відповідні товари додайте атрибут "сертифікація" [certification]. Система Google знайде ваш товар у базі даних EPREL і відобразить у графічній або текстовій формі його клас енергоефективності в товарних оголошеннях і інформації про товари, розміщеній безкоштовно. Нижче наведено приклад.

Примітка. Якщо вам не вдається знайти код EPREL і ви маєте інформацію про енергоефективність лише у формі оцінки, можете вказати всі 3 атрибути клас енергоефективності [energy_efficiency_class], перш ніж завершиться перехід (1 вересня 2024 року).

Підатрибути

• Організація [certification_authority] (обов’язковий): використовується для позначення організації або центру сертифікації, які видають сертифікати. Зараз підтримуються лише значення EC і European_Commission.
• Назва [certification_name] (обов’язковий): використовується для позначення назви сертифіката. Зараз підтримується лише значення EPREL (Європейський реєстр енергетичного маркування продуктів), у базі даних якого представлено сертифікати, що підтверджують класи енергоефективності товарів.
• Код [certification_code] (обов’язковий): використовується для позначення коду сертифіката. Наприклад, для сертифіката EPREL із посиланням https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 слід указати код 123456.

Тип	Текст
Текст (TSV)	EC:EPREL:123456
Формат XML	<g:certification> <g:certification_authority>EC</g:certification_authority> <g:certification_name>EPREL</g:certification_name> <g:certification_code>123456</g:certification_code> </g:certification>

Обов’язкові атрибути класу енергоефективності (лише для країн ЄС)

Примітка. 1 вересня 2024 року підтримку цих атрибутів буде припинено. Щоб показувати клас енергоефективності за стандартом ЄС в оголошеннях і безкоштовно розміщеній інформації про товари, натомість використовуйте атрибут сертифікація [certification].

Ви можете легко знайти код EPREL у QR-коді мітки із зазначенням класу енергоефективності на товарі. Якщо вам не вдається знайти код, але ви маєте надану виробником інформацію про енергоефективність, можете вказати всі 3 атрибути клас енергоефективності [energy_efficiency_class] протягом перехідного періоду, який завершиться 1 вересня 2024 року.

Клас енергоспоживання [energy_efficiency_class], мінімальний клас енергоспоживання [min_energy_efficiency_class], максимальний клас енергоспоживання [max_energy_efficiency_class]

За допомогою цих атрибутів можна вказувати клас енергоспоживання для ваших товарів.

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

Холодильники	Духовки
Морозильні камери	Бойлери
Пральні машини	Баки для гарячої води
Сушильні машини	Кондиціонери
Комбіновані прально-сушильні машини	Електричні лампи
Винні шафи	Світильники
Посудомийні машини	Телевізори

Тип	Допустимі значення: A+++ A++ A+ A B C D E F G
Текст (TSV)	A+
Приклад формату XML	<g:energy_efficiency_class>A+</g:energy_efficiency_class>

Важливо

• Значення атрибута мінімальний клас енергоспоживання [min_energy_efficiency_class] має бути меншим за значення атрибута максимальний клас енергоспоживання [max_energy_efficiency_class]. Тобто шкала має бути від A до D, а не від D до A.
• Указане значення атрибута клас енергоспоживання [energy_efficiency_class] має бути в діапазоні значень, надісланих в атрибутах "мінімальний клас енергоспоживання" та "максимальний клас енергоспоживання". Наприклад, якщо діапазон містить значення від A до D, значення атрибута "клас енергоспоживання" не може бути G.

Рекомендовані атрибути для виключення

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

Указуйте атрибут виключені кампанії [excluded_destination], щоб виключати товари, непридатні для певного цільового сервісу. Використовуйте цей атрибут, щоб визначати, у яких цільових сервісах можуть показуватися ваші товари. Наприклад, за допомогою цього атрибута ви можете дозволити показ товару в кампанії товарних оголошень і заборонити його в кампанії реклами місцевих пропозицій.

Використання. Радимо надсилати цей атрибут, щоб заборонити показ товару в оголошеннях і безкоштовно розміщеній інформації певного типу.

Допустимі значення

• Товарні оголошення [Shopping_ads]. Ваші товари не з’являтимуться в товарних оголошеннях. Докладніше про товарні оголошення
• Медійні оголошення [Display_ads]. Ваші товари не з’являтимуться в оголошеннях динамічного ремаркетингу. Докладніше про динамічний ремаркетинг для роздрібної торгівлі
• Реклама місцевого асортименту [Local_Inventoryory_ads]. Ваші товари не з’являтимуться в рекламі місцевого асортименту. Докладніше про рекламу місцевого асортименту
• Інформація про товар, розміщена безкоштовно [Free_listings]. Ваші товари не з’являтимуться в безкоштовно розміщеній інформації. (докладніше про безкоштовний показ товарів на різних платформах Google).
• Безкоштовні пропозиції поблизу [free_local_listings]. Інформація про товари місцевого асортименту не показуватиметься безкоштовно в Google (докладніше про безкоштовний показ товарів місцевого асортименту на різних платформах Google).

Примітка. Ми змінили назви деяких цільових сервісів. Раніше ви вказували для цільових сервісів такі значення: Shopping Actions, Surfaces across Google і Local surfaces across Google. Ці значення прийматимуться й надалі, але радимо включити в дані про товари нові значення для цих цільових сервісів: Buy_on_Google_listings, Free_listings і Free_local_listings.

Формат

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

Допустимі значення:	Shopping_ads, Display_ads, Local_inventory_ads, Free_listings, Free_local_listings
Поле для повторного введення даних	Так

Формат файлу	Приклад значення
Текстовий фід	Display_ads
XML-фід	<g:excluded_destination>Display_ads</g:excluded_destination>

Поля для повторного введення даних

Текстовий фід

Щоб виключити кілька цільових сервісів, надішліть цей атрибут кілька разів, по одному для кожного цільового сервісу (рекомендовано). Нижче наведено приклад.

Дані про ортопедичну лежанку для собаки
Атрибут	Значення
Назва [title]	Ортопедична лежанка для собаки, розмір XXL
Виключені кампанії [excluded_destination]	Display_ads
Виключені кампанії [excluded_destination]	Shopping_ads

Також цільові сервіси можна розділяти комою ( , ).

Display_ads, Shopping_ads

XML-формат

Щоб виключити кілька цільових сервісів для фіду у форматі XML, укажіть окремий атрибут для кожного виключеного сервісу.

<g:excluded_destination>Display_ads</g:excluded_destination>

<g:excluded_destination>Shopping_ads</g:excluded_destination>

Щоб дізнатися більше про формат фіду, що надсилається через API, перегляньте статтю про Content API for Shopping.

Атрибути зіставлення для застарілого фіду місцевих товарів (необов’язкові)

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

Ідентифікатор зіставлення [webitemid] – засіб для зіставлення місцевих і онлайн-ідентифікаторів

Якщо ви не можете використовувати ті самі значення атрибута ідентифікатор [id] у фіді місцевих товарів і у фіді товарів, які ви продаєте онлайн, скористайтесь атрибутом "ідентифікатор зіставлення". У такому разі значення атрибута "ідентифікатор" для товарів місцевого асортименту буде іншим, але значення атрибута "ідентифікатор зіставлення" має збігатися зі значенням атрибута "ідентифікатор" для відповідної позиції у фіді товарів (якщо цей товар також продається онлайн).

Оскільки ідентифікатор зіставлення використовується лише для зіставлення, він може мати однакові значення для різних позицій, якщо вони відповідають тій самій позиції у фіді.

Використання. Рекомендований для всіх товарів, ідентифікатори або артикули яких не збігаються у фідах для місцевих і онлайн-магазинів.

Тип	Текст (рядок)
Текст (TSV)	WB1011
Приклад формату XML	<g:webitemid>WB1011</g:webitemid>

Важливо

• Початкові та кінцеві пробіли, а також символи повернення каретки (0x0D) вилучаються.
• Кожна послідовність повернення каретки (0x0D) і символів пробілу (символи Юнікод для позначення пробілу) замінюється одним пробілом (0x20).
• Підтримуються лише дійсні символи Юнікод. При цьому не допускаються:
  • керівні символи (крім символу повернення каретки 0x0D);
  • функціональні символи;
  • символи з областей для приватного використання;
  • сурогатні пари;
  • непризначені точки коду (зокрема будь-яка точка коду поза 0x10FFFF).
• Якщо дані про товар надіслано, значення ідентифікатора зіставлення [webitemid] не можна змінювати під час оновлення фіду даних або використовувати його в майбутньому для інших товарів.

Глобальний номер товару [gtin] – глобальний номер товару (GTIN)

У цьому атрибуті потрібно вказувати глобальні номери товарів (GTIN).

Використання. Якщо ви продаєте товари у звичайних і онлайн-магазинах і не можете використовувати атрибут ідентифікатор [id] для зіставлення, застосовуйте атрибут "ідентифікатор зіставлення" [webitemid] або унікальні ідентифікатори товарів.

Якщо ви зіставляєте товари за допомогою унікальних ідентифікаторів, додавайте в цей фід атрибут "стан".

Тип	Текст (рядок)
Текст (TSV)	0606449056822
Приклад формату XML	<g:gtin>0606449056822</g:gtin>

Код виробника товару [mpn] – наданий виробником артикул товару (MPN)

Цей код установлює унікальний зв’язок між товаром і виробником. Зокрема, комбінація бренду й коду виробника чітко визначає один товар.

Використання. Якщо ви продаєте товари у звичайних і онлайн-магазинах і не можете використовувати атрибут ідентифікатор [id] для зіставлення, застосовуйте атрибут "ідентифікатор зіставлення" [webitemid] або унікальні ідентифікатори товарів.

Якщо ви зіставляєте товари за допомогою унікальних ідентифікаторів, додавайте в цей фід атрибут "стан".

Тип	Текст (рядок)
Текст (TSV)	RND2150
Приклад формату XML	<g:mpn>RND2150</g:mpn>

Бренд [brand] – бренд товару

Використання. Якщо ви продаєте товари у звичайних та онлайн-магазинах і не можете використовувати атрибут ідентифікатор [id] для зіставлення, застосовуйте атрибут "ідентифікатор зіставлення" [webitemid] або унікальні ідентифікатори товарів.

Якщо ви зіставляєте товари за допомогою унікальних ідентифікаторів, додавайте в цей фід атрибут "стан".

Тип	Текст (рядок)
Текст (TSV)	Netgear
Приклад формату XML	<g:brand>Netgear</g:brand>

Предмети одягу

Для предметів одягу в основному фіді потрібно обов’язково надсилати наведені нижче додаткові атрибути.

Ідентифікатор групи товарів [item_group_id] – спільний ідентифікатор для всіх варіантів одного товару

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

Використання. Обов’язковий у фідах, націлених на Бразилію, Велику Британію, Німеччину, США, Францію та Японію, для всіх варіантів товарів, які мають різні значення таких атрибутів: колір [color], розмір [size], візерунок [pattern], матеріал [material], вікова група [age_group], стать [gender], тип розміру [size_type] і система розмірів [size_system]. Рекомендований для всіх інших країн.

API вмісту, версія 2 (JSON)	"itemGroupId": "AB12345"
API вмісту, версія 2 (XML)	<item_group_id>AB12345</item_group_id>

Тип	Буквено-цифровий код
Ліміт символів	50
Текст (TSV)	AB12345
XML (фіди)	<g:item_group_id>AB12345</g:item_group_id>

Важливо

• Атрибути ідентифікатор групи товарів [item_group_id] та ідентифікатор [id] відрізняються. Атрибут "ідентифікатор групи товарів" має те саме значення для групи варіантів одного товару, тоді як атрибут "ідентифікатор" містить унікальні значення для кожного товару та вказується не лише для варіантів.
• Значення, задані в атрибуті "ідентифікатор групи товарів", мають бути унікальними й можуть збігатися лише у варіантах того самого товару.
• Якщо ви вкажете атрибут "ідентифікатор групи товарів", система автоматично шукатиме атрибути варіантів. Тому товар з атрибутом "ідентифікатор групи" повинен мати принаймні один атрибут варіанта.

Колір [color] – колір товару

Цей атрибут визначає основні кольори товару. Якщо товар різнокольоровий, крім основного кольору можна вказати до двох акцентних.

• Перелічіть кольори, розділяючи їх символом "/", за домінантністю (спочатку основний колір, а потім не більше ніж два акцентні). Наприклад, для чорних черевиків із зеленими вставками вкажіть значення "Чорний/Зелений". Для аксесуарів із категорії "Одяг", зокрема ювелірних або дерев’яних прикрас, в атрибуті колір [color] можна вказувати покриття або матеріал (наприклад, "Червоне дерево", "Сталь" або "Рожеве золото").
• Якщо ви використовуєте XML-фід, замість символу "/" указуйте "#47;".

Використання. Обов’язковий для всіх одиниць групи товарів, що відрізняються за кольором, а також для всіх предметів одягу у фідах, націлених на Бразилію, Велику Британію, Німеччину, США, Францію та Японію. Рекомендований для всіх товарів, для яких колір є важливим і визначальним атрибутом.

API вмісту, версія 2 (JSON)	"color": "Чорний"
API вмісту, версія 2 (XML)	<color>Чорний</color>

Тип	Текст
Ліміт символів	100
Текст (TSV)	Чорний
XML (фіди)	<g:color>Чорний</g:color>

Недійсні значення

• Значення кольорів, що містять цифри, як-от "0 2 4 6 8".
• Значення кольорів, що містять будь-які символи, крім буквено-цифрових, як-от "#fff000".
• Однобуквені позначення кольорів для мов із латиницею (наприклад, "G"). Однак однобуквені значення кольорів приймаються китайською, японською чи корейською мовами (наприклад, "红").
• Значення кольорів, де згадується сам товар чи його зображення, як-от "див. зображення".
• Описові значення, які насправді не є дійсними назвами кольорів (наприклад, "різнобарвний", "різний", "різноманітний", "див. зображення", "н/д").
• Значення кольорів, довжина яких перевищує 40 символів.
• Довгі значення, складені з назв кількох інших кольорів (наприклад, ЧервонийРожевийСиній). Дотримуйтеся порад нижче.
  • Якщо товар має кілька кольорів, першим потрібно вказувати основний, а потім – не більше ніж два додаткові. Усі кольори потрібно відокремити один від одного символом "/". Наприклад, замість червонийрожевийсиній введіть червоний/рожевий/синій.
  • Якщо у вас є варіанти товару, що різняться за кольором, надішліть їх як окремі позиції. Указуйте для них однаковий ідентифікатор групи товарів і різні значення атрибута "колір".

Примітка про недійсні значення

• Якщо ви вкажете значення кольору, яке порушує вищезазначені синтаксичні правила, Google може відхилити ваш товар під час надсилання фіду.
• Google регулярно перевіряє правильність значень атрибутів, зокрема вказаних кольорів. Якщо ми виявимо неправильні значення, то можемо вилучити всі ваші товари з вкладки "Покупки".

Важливо

• Варіанти товару кожного кольору (або комбінації кольорів) потрібно надсилати як окремі товари, додаючи атрибут "ідентифікатор групи товарів".
• Використовуйте однакові назви кольорів у різних варіантах одного товару, а також у різних товарах тієї самої категорії.
• Указуйте зрозумілі значення, адже вони можуть показуватися покупцям.

Розмір [size] – розмір товару

Цей атрибут позначає розмір товару. Для товарів категорії "Одяг і аксесуари" також можна вказувати атрибути тип розміру [size_type] та система розмірів [size_system], щоб надавати більше інформації про розмір ваших товарів.

• Указуйте лише один атрибут для кожного товару. Якщо зазначити кілька атрибутів розміру для одного товару, буде застосовано лише перший атрибут із переліку. Додаткові атрибути розміру буде відхилено, і ви отримаєте попередження.

Використання. Обов’язковий для всіх одиниць групи товарів, що відрізняються за розміром. Обов’язковий для всіх предметів одягу з категорій "Одяг і аксесуари > Одяг" і "Одяг і аксесуари > Взуття" в даних про товари, які націлено на Бразилію, Велику Британію, Німеччину, США, Францію та Японію. Рекомендований для всіх товарів, для яких розмір є важливим і визначальним атрибутом.

API вмісту, версія 2 (JSON)	"sizes": ["XL"]
API вмісту, версія 2 (XML)	<size>XL</size>

Тип	Текст Якщо ви націлюєте фід на США, указуйте значення з цього списку Приклади розмірів для всіх інших країн наведено тут.
Ліміт символів	100
Текст (TSV)	XL
XML (фіди)	<g:size>XL</g:size>

Важливо

• Варіанти товару кожного розміру (або комбінації розмірів) потрібно надсилати як окремі товари, додаючи атрибут ідентифікатора групи товарів. Докладніше про надсилання даних про предмети одягу.
• Якщо розмір має кілька параметрів, об’єднуйте їх в один. Наприклад, укажіть "41/86 Tall", якщо одяг призначений для високих і має довжину коміра 41 см та довжину рукава 86 см.
• Використовуйте однаковий формат розміру для різних варіантів того самого товару, а також товарів однієї категорії. Наприклад, для групи футболок указуйте розміри "S", "M" і "L", а не "S", "Medium" і "Lrg".
• Для варіантів товарів, що відрізняються за розміром, можна використовувати однакові зображення, але радимо зазначати в атрибуті "посилання" [link] URL-адресу сторінки з інформацією про потрібний варіант товару.
• Указуйте зрозумілі значення, адже вони можуть показуватися покупцям.
• Додаткові відомості про розмір можна надати в текстовому рядку (наприклад, "3.5 Kid" або "3.5 Toddler").
• Якщо товар підходить для всіх, укажіть значення "one size" або абревіатуру "OS", "one size fits all" або абревіатуру "OSFA", значення "one size fits most" або абревіатуру "OSFM".

Приклади значень розміру

Послідовно вказувати розміри для одягу різних типів може бути складно. Ми не наполягаємо на наведених нижче значеннях, проте радимо стандартизувати розміри для всіх предметів одягу. Крім того, ви можете вказувати атрибути тип розміру [size_type] і система розмірів [size_system], щоб надавати більше інформації про розмір ваших товарів.

Одяг на верхню частину тіла, верхній одяг і сукні

XXS, XS, S, M, L, XL, 1XL, 2XL, 3XL, 4XL, 5XL, 6XL
00, 0, 02, 04, 06, 08, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34

Одяг на нижню частину тіла

XXS, XS, S, M, L, XL, 1XL, 2XL, 3XL, 4XL, 5XL, 6XL
00, 0, 02, 04, 06, 08, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34
23, 24, 26, 27, 28, 29, 30, 32, 34, 36, 38, 40, 42, 44
Для штанів: 24x30, 24x32, 24x34

Спеціальні групи розмірів

• Якщо товар належить до спеціальної групи розмірів, наприклад "плюс", "для невисоких", "для вагітних" або "великий розмір" чи "для високих", указуйте атрибут тип розміру [size_type].
• Якщо розмір товару визначається за внутрішніми швами, указуйте розмір у такому форматі: 30 Short, 30 Regular, 30 Long.

Взуття

• Для США: 5, 5.5, 6, 6.5, 7, 7.5, 8, 8.5, 9, 9.5, 10, 10.5, 11, 11.5, 12, 12.5, 13, 13.5, 14, 14.5, 15, 15.5, 16.
• Для Європи: 37, 38, 39, 40, 41, 42, 43, 44, 45.

Примітка. Якщо той самий розмір взуття відрізняється за шириною, радимо вказати це так: 9.5 М, 8 W, 12 N.

Стать [gender] – стать, для якої призначений товар

Використання. Обов’язковий для всіх одиниць групи товарів, призначених для різних статей, а також для всіх предметів одягу у фідах, націлених на Бразилію, Велику Британію, Німеччину, США, Францію та Японію. Рекомендований для всіх товарів, для яких стать є важливим і визначальним атрибутом.

API вмісту, версія 2 (JSON)	"gender": "male"
API вмісту, версія 2 (XML)	<gender>male</gender>

Формат	Може мати лише 3 значення: male (чоловіки) female (жінки) unisex (унісекс)
Текст (TSV)	male
XML (фіди)	<g:gender>male</g:gender>

Важливо

• Якщо ви надсилаєте назви атрибутів англійською мовою, їх значення також потрібно вказувати англійською.
• Для деяких підкатегорій категорії "Одяг і аксесуари" цей атрибут не обов’язковий, але рекомендований. До них належать: "Значки на булавці", "Зажими для краваток", "Напульсники", "Бахіли", "Шнурки", "Шпори" та "Ремінці для годинників".

Вікова група [age_group] – вікова група, на яку націлений товар

Використовуйте цей атрибут, щоб указувати, для кого призначений ваш товар.

Використання. Обов’язковий для всіх одиниць групи товарів, що відрізняються за віковою групою, а також для всіх предметів одягу у фідах, націлених на Бразилію, Велику Британію, Німеччину, США, Францію та Японію. Рекомендований для всіх товарів, у яких вікова група є важливим і визначальним атрибутом.

API вмісту, версія 2 (JSON)	"ageGroup": "для дорослих"
API вмісту, версія 2 (XML)	<age_group>для дорослих</age_group>

Формат	Може мати лише 5 значень: новонароджені [newborn] немовлята [infant] малюки [toddler] діти [kids] дорослі [adult]
Текст (TSV)	adult
XML (фіди)	<g:age_group>adult</g:age_group>

Важливо

• Нижче описано вікові групи, яким відповідає кожне значення.
  • Новонароджені [newborn] – до 3 місяців. Розміри для новонароджених часто вказують за віковою групою (0–3 місяці) та/або значенням "новонароджені" [newborn].
  • Немовлята [infant] – від 3 до 12 місяців. Розміри для немовлят часто вказують за віковою групою (3–12 місяців).
  • Малюки [toddler] – від 1 до 5 років. Розміри для малюків часто вказують за віковою групою (12–24 місяці чи 1–5 років).
  • Діти [kids] – від 5 до 13 років. Ця група поєднує товари різних розмірів для дітей відповідного віку.
  • Дорослі [adult] – починаючи з підліткового віку. Ця вікова група поєднує товари різних розмірів для дорослих або підлітків.
• Якщо ви надсилаєте назви атрибутів англійською мовою, їх значення також потрібно вказувати англійською.
• Для деяких підкатегорій категорії "Одяг і аксесуари" цей атрибут не обов’язковий, але рекомендований. До них належать: "Значки на булавці", "Зажими для краваток", "Напульсники", "Бахіли", "Шнурки", "Шпори" та "Ремінці для годинників".
• Якщо товар призначений не лише для дітей, укажіть для нього значення "дорослі" [adult], оскільки для одного товару можна вибрати лише одну вікову групу.

Атрибути ціни (необов’язкові)

За потреби ви можете також надсилати перелічені нижче необов’язкові атрибути.

Ціна [price] – ціна товару за умовчанням на внутрішньому ринку

Використовуйте цей атрибут, щоб указати ціну за умовчанням, якщо вона однакова для всіх магазинів або якщо ви використовуєте базову версію каталогу місцевого магазину на сайті продавця.

Якщо у фід місцевого асортименту товарів додати ціни для окремих магазинів, вони замінять значення цього атрибута.

Якщо ви використовуєте базову версію каталогу місцевого магазину на сайті продавця, обов’язково надсилайте атрибут "ціна" та стежте, щоб ціна у фіді збігалася з ціною на цільовій сторінці товару.

Примітка. Система Google використовує валюти залежно від країни розташування магазину. Якщо валюту вказано на рівні товару, вона має відповідати стандарту ISO 4217.

Використання. Рекомендований для всіх товарів.

Тип	Ціна (число з рухомою комою)
Текст (TSV)	2990.99 UAH
Приклад формату XML	<g:price>2990.99</g:price>

Ціна зі знижкою [sale_price] – рекламована ціна товару зі знижкою

Використовуйте цей атрибут, щоб надсилати рекламовану ціну товару зі знижкою.

Google радить указувати атрибут термін дії знижки [sale_price_effective_date] для товарів, для яких діє ціна зі знижкою. Цей атрибут визначає, протягом якого часу ця ціна відображатиметься. Якщо цього не зробити, ціна зі знижкою діятиме для товару весь час, поки його включено у фід.

Використання. Рекомендований для товарів зі знижкою.

Тип	Число
Текст (TSV)	2499.99
Приклад формату XML	<g:sale_price>2499.99</g:sale_price>

Термін дії знижки [sale_price_effective_date] – діапазон дат, протягом якого діє знижка на товар

Використовується разом з атрибутом ціна зі знижкою [sale_price]. Цей атрибут визначає тривалість дії ціни зі знижкою. Докладніше про визначення атрибута "ціна зі знижкою".

Примітка. Додавати часовий пояс необов’язково. Щоб зробити це, укажіть кількість годин і хвилин зі знаком "+" або "-" відповідно до зміщення відносно UTC (наприклад, -08:00 для тихоокеанського стандартного часу). Якщо не вказати часовий пояс, система Google використовуватиме час UTC для всіх магазинів. Використовуйте 24-годинний формат.

Тип	Дати початку й завершення терміну дії знижки розділяються символом "/". Дата початку вказується у форматі "РРРР-ММ-ДД", після неї йде літера "T", потім час доби, коли починає діяти знижка, а за ним – відповідний часовий пояс за стандартом ISO 8601. Дату завершення потрібно зазначати в такому самому форматі. Якщо часовий пояс не вказано, використовуватиметься час UTC.
Текст (TSV)	Приклад для всесвітнього координованого часу (UTC): 2021-07-19T17:00:00/2021-07-27T05:00:00 Приклад для тихоокеанського стандартного часу (PST): 2021-07-19T09:00:00-08:00/2021-07-26T21:00:00-08:00
XML-формат	<g:sale_price_effective_date>2021-07-19T17:00:00/2021-07-27T05:00:00</g:sale_price_effective_date>

Одиниця товару [unit_pricing_measure] – визначає кількість і одиниці вимірювання товару

Укажіть атрибут одиниця товару [unit_pricing_measure], щоб визначити кількість і одиницю вимірювання товару. Цей атрибут дає покупцям змогу зрозуміти точну вартість одиниці товару.

Використання. Необов’язковий для всіх товарів (крім випадків, коли це вимагається місцевим законодавством).

Тип	Додатне число й одиниця вимірювання
Текст (TSV)	1.5kg
Приклад формату XML	<g:unit_pricing_measure>1.5kg</g:unit_pricing_measure>

Стандартна одиниця товару [unit_pricing_base_measure] – для показу в оголошенні ціни за одиницю товару

Базова одиниця для розрахунку ціни (наприклад, базова одиниця 100ml означає, що ціна обчислюється на основі такої одиниці вимірювання). Якщо ви додали атрибут одиниця товару [unit_pricing_measure], тоді вкажіть також атрибут "стандартна одиниця товару", щоб в оголошенні показувався знаменник для ціни за одиницю товару. Зверніть увагу, що одиниці вимірювання, які відображаються в оголошеннях та інформації про товари з місцевого асортименту, розміщеній безкоштовно, можуть відрізнятися від тих, що представлені у вашому фіді. Це може знадобитися, щоб забезпечити однорідність усіх оголошень на сторінці.

Використання. Необов’язковий (крім випадків, коли це вимагається місцевим законодавством).

Тип	Ціле число й одиниця вимірювання
Текст (TSV)	100g
Приклад формату XML	<g:unit_pricing_base_measure>100g</g:unit_pricing_base_measure>

Атрибути самовивезення з магазину (необов’язкові)

Інформацію про можливість самовивезення товарів із магазину можна вказати за допомогою 2 наведених нижче атрибутів. Додайте їх у свій основний фід для тих позицій товарів, які доступні в усіх магазинах (наприклад, покупець може забрати телевізор АБВ у будь-якому з ваших магазинів по всій країні).

Спосіб отримання [pickup_method] – можливість самовивезення товару з магазину

Важливо. Починаючи з 1 вересня 2024 року, вам більше не потрібно вказувати атрибут "спосіб отримання" [pickup_method], щоб увімкнути функцію самовивезення для своїх пропозицій.

Указує на доступність і умови самовивезення з магазину за допомогою одного зі значень, указаних нижче.

• Покупка [buy] – уся трансакція відбувається онлайн.
• Резервування [reserve] – товар резервується онлайн, а трансакція відбувається в магазині.
• Доставка в магазин [ship_to_store] – товар оплачується онлайн і доставляється в місцевий магазин, звідки його зможе забрати покупець.
• Не підтримується [not_supported] – товар недоступний для самовивезення з магазину.

Тип	Текст (рядок). Потрібно вказати одне з наведених вище значень.
Текст (TSV)	buy
Приклад формату XML	<g:pickup_method>buy</g:pickup_method>

Дата отримання [pickup_SLA] – термін самовивезення товару з магазину

Цей атрибут указує очікувану дату, коли товар можна забрати з магазину залежно від часу оформлення замовлення.

• Той самий день [same_day] – указує на те, що товар можна забрати з магазину в той самий день, коли було розміщено замовлення (з урахуванням часу припинення прийому замовлень).
• Наступний день [next_day] – указує на те, що товар можна забрати з магазину наступного дня після розміщення замовлення.
• 2 дні [2-day] – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати через 2 дні.
• 3 дні [3-day] – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати через 3 дні.
• 4 дні [4-day] – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати через 4 дні.
• 5 днів [5-day] – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати через 5 днів.
• 6 днів [6-day] – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати через 6 днів.
• 7 днів [7-day] – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати через 7 днів.
• Більше ніж за тиждень [multi-week] – указує на те, що товар буде відправлено в магазин, звідки покупець зможе його забрати більш ніж за тиждень.

Тип	Текст (рядок). Потрібно вказати одне з наведених вище значень.
Текст (TSV)	same_day
Приклад формату XML	<g:pickup_sla>same day</g:pickup_sla>

Атрибути каталогу місцевого магазину на сайті продавця (необов’язкові)

Щоб використовувати каталог місцевого магазину на сайті продавця, додайте атрибути переспрямування в оголошенні [ads_redirect] і "посилання для каталогу місцевого магазину на сайті продавця" [link_template] у свій основний фід. Крім того, можна додати необов’язковий атрибут "мобільне посилання для каталогу місцевого магазину на сайті продавця" [mobile_link_template], щоб розмістити мобільну версію цього каталогу й відстежувати кліки з мобільних пристроїв.

Посилання [link]

Якщо у вашому обліковому записі використовується базова версія каталогу місцевого магазину на сайті продавця, натиснувши оголошення або безкоштовно розміщену інформацію, покупець перейде на цільову сторінку рекламованого товару на вашому сайті. Щоб указати URL-адресу цієї сторінки, використовуйте атрибут посилання [link].

Важливо

• Використовуйте підтверджене доменне ім’я.
• Посилання має починатися префіксом http або https.
• Використовуйте кодовану URL-адресу, яка відповідає стандарту RFC 2396 або RFC 1738. Наприклад, код для символу коми має виглядати як "%2C".
• Не додавайте посилань на проміжну сторінку, якщо це не передбачено законодавством.

Тип	URL-адреса (має починатися префіксом "http://" або "https://")
Текст (TSV)	http://mikemart.com/123
XML-формат	<g:link>http://mikemart.com/123</g:link>

Посилання для каталогу місцевого магазину на сайті продавця [link_template]

Якщо у вашому обліковому записі використовується повна версія каталогу місцевого магазину на сайті продавця, натиснувши оголошення або безкоштовно розміщену інформацію, покупець перейде на цільову сторінку рекламованого товару на вашому сайті. Щоб указати URL-адресу цієї сторінки, використайте атрибут "посилання для каталогу місцевого магазину на сайті продавця" [link_template].

Важливо

• Додайте параметр ValueTrack для атрибута "код магазину" {store_code}. Структура URL-адреси відрізняється на різних вебсайтах. Код філії може бути як параметром URL-адреси, так і частиною її шляху.
• Підтвердьте URL-адресу веб-сайту й заявіть на неї права, а також переконайтеся, що ця зареєстрована в Merchant Center URL-адреса збігається з доменом, указаним в атрибуті "посилання для каталогу місцевого магазину на сайті продавця". Якщо URL-адреси не збігаються, дізнайтесь, як вирішити цю проблему.
• Додавайте параметри відстеження до URL-адрес лише в атрибуті переспрямування в оголошенні [ads_redirect].

Тип	URL-адреса (має починатися префіксом "http://" або "https://")
Текст (TSV)	http://mikemart.com/123?store={store_code}
XML-формат	<g:link_template>http://mikemart.com/123?store={store_code}</g:link_template>

Мобільне посилання для каталогу місцевого магазину на сайті продавця [mobile_link_template]

Якщо у вашому обліковому записі використовується повна версія каталогу місцевого магазину на сайті продавця, натиснувши оголошення або безкоштовно розміщену інформацію, покупець перейде на цільову сторінку рекламованого товару на вашому сайті.

Укажіть атрибут "мобільне посилання для каталогу місцевого магазину на сайті продавця" [mobile_link_template], щоб додати URL-адресу до версії цільової сторінки, оптимізованої для мобільних пристроїв. Ця мобільна версія буде показуватися покупцям телефонів, планшетів тощо.

Важливо

• Додайте параметр ValueTrack для атрибута "код магазину" {store_code}. Структура URL-адреси відрізняється на різних вебсайтах. Код філії може бути як параметром URL-адреси, так і частиною її шляху.
• Підтвердьте URL-адресу веб-сайту й заявіть на неї права, а також переконайтеся, що ця зареєстрована в Merchant Center URL-адреса збігається з доменом, указаним в атрибуті "посилання для каталогу місцевого магазину на сайті продавця" [link_template]. Якщо URL-адреси не збігаються, дізнайтесь, як вирішити цю проблему.
• Додавайте параметри відстеження до URL-адрес лише в атрибуті переспрямування в оголошенні [ads_redirect].

Тип	URL-адреса (має починатися префіксом "http://" або "https://")
Текст (TSV)	http://mikemart.com/123?store={store_code}
XML-формат	<g:mobile_link_template>http://mikemart.com/123?store={store_code}</g:mobile_link_template>

Переспрямування в оголошенні [ads_redirect]

Якщо у вашому обліковому записі використовується каталог місцевого магазину на сайті продавця, натиснувши оголошення, покупець перейде на цільову сторінку рекламованого товару на вашому сайті.

Щоб налаштувати URL-адресу для кращого відстеження трафіку до цільової сторінки, використовуйте атрибут "переспрямування в оголошенні".

Важливо

• Додайте параметр ValueTrack для атрибута "код магазину" {store_code}. Структура URL-адреси відрізняється на різних вебсайтах. Код філії може бути як параметром URL-адреси, так і частиною її шляху.
• Підтвердьте URL-адресу веб-сайту й заявіть на неї права, а також переконайтеся, що ця зареєстрована в Merchant Center URL-адреса збігається з доменом, указаним в атрибуті "посилання для каталогу місцевого магазину на сайті продавця". Якщо URL-адреси не збігаються, дізнайтесь, як вирішити цю проблему.
• Коли ви налаштуєте цей атрибут, покупець, натиснувши на оголошення, перейде на адресу, указану в атрибуті переспрямування в оголошенні [ads_redirect], а не на ту, що вказано в атрибутах "посилання для каталогу місцевого магазину на сайті продавця" [link_template] чи "мобільне посилання для каталогу місцевого магазину на сайті продавця" [mobile_link_template].

Тип	URL-адреса (має починатися префіксом "http://" або "https://")
Текст (TSV)	http://mikemart.com/123?store={store_code}
XML-формат	<g:ads_redirect>http://mikemart.com/123?store={store_code}</g:ads_redirect>

Додаткові атрибути (необов’язкові)

Щоб ваша реклама або безкоштовно розміщена інформація про товари була докладнішою, надсилайте додаткові відомості про свої пропозиції в основному фіді. Перелік усіх можливих атрибутів можна знайти в специфікації даних про товари.