Специфікації джерела даних для місцевих рекламних акцій

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

Джерелом даних може бути файл XML, файл із роздільниками або електронна таблиця Google, завантажена в Google Merchant Center. Джерело даних може містити кілька значень. Завантажте джерело даних про рекламні акції в той самий обліковий запис Merchant Center, який використовується для джерела даних про товари.

Примітка. Те саме джерело даних про рекламні акції можна використовувати для відповідних акцій як онлайн, так і у звичайних магазинах.

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

Завантажити приклад джерела даних

Важливо

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

Обов’язкові атрибути

Ідентифікатор рекламної акції [promotion_id]

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

Важливо

• Атрибут "ідентифікатор рекламної акції" враховує регістр. Якщо ви зіставляєте певну рекламну акцію з набором товарів у джерелі даних, вони мають точно збігатися в обох джерелах даних.
• Ідентифікатор рекламної акції не має містити пробілів або символів (наприклад, "%", "!" тощо).
• Щоб додати кілька значень для атрибута "ідентифікатор рекламної акції" до одного товару (можна додати щонайбільше 10), указуйте значення, розділені комами, у стовпці "Ідентифікатор рекламної акції" в джерелі даних про товари.
• Ідентифікатор рекламної акції може містити не більше ніж 60 символів.

Товари, які беруть участь у рекламній акції [product_applicability]

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

Дійсні значення:

• Усі товари [all_products]
• Певні товари [specific_products]

Важливо

• Якщо вибрати значення specific_products, то для визначення товарів, на які поширюється рекламна акція, використовуватимуться атрибути для націлювання товарів (докладніше про націлювання товарів ви можете дізнатися нижче в розділі Необов’язкові атрибути).
• Якщо вибрати значення all_products, фільтри для націлювання товарів ігноруватимуться.

Потрібен код купона [offer_type]

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

Дійсні значення:

• Без коду [no_code]
• Загальний код [generic_code]

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

Загальний код пропозиції [generic_redemption_code]

Цей атрибут указує код (наприклад, EXTRA20), який покупці вводитимуть онлайн, щоб скористатися пропозицією.

Важливо

• Цей атрибут обов’язковий, якщо для атрибута "потрібен код купона" [offer_type] вибрано значення generic_code.
• Значення, указане в атрибуті "загальний код пропозиції" [generic_redemption_code], не має перевищувати 20 символів.

Назва рекламної акції [long_title]

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

Важливо

• За допомогою атрибута "назва рекламної акції" [long_title] потрібно точно й докладно описати відповідну рекламну акцію.
• Кількість символів у назві рекламної акції не повинна перевищувати 60.

Дата початку рекламної акції [promotion_effective_dates]

Цей атрибут визначає дати й час показу рекламної акції. Умови щодо синтаксису наведено нижче.

• Формат дати: РРРР-ММ-ДД.
• Формат часу: ГГ:ХХ:СС, без урахування коригування за Гринвічем (перегляньте інформацію нижче).
  • Час указується за Гринвічем (GMT). Вам також відразу потрібно вказати кількість годин і хвилин (+ГГ:ХХ або -ГГ:ХХ), на яку ваш час відрізняється від часу за Гринвічем.
    • Наприклад, якщо час рекламної акції вказано за тихоокеанським стандартним часом (PST), додайте "-08:00", оскільки цей часовий пояс на 8 годин випереджає час за Гринвічем.
• Дати й час потрібно розділяти літерою T.
• Спершу вкажіть дату й час початку, а потім – дату й час завершення, розділяючи їх скісною рискою (/).

Приклади

• Якщо ваша рекламна акція діяла з 03:00 19 липня 2019 року до 21:00 26 липня 2019 року за північноамериканським східним часом (EST), ви б мали надіслати таке значення:
  • 2019-07-19T03:00:00-05:00/2019-07-26T21:00:00-05:00
• Якщо ваша рекламна акція діяла з 03:00 19 липня 2019 року до 21:00 26 липня 2019 року за Гринвічем (GMT), ви б мали надіслати таке значення:
  • 2019-07-19T03:00:00+00:00/2019-07-26T21:00:00+00:00

Важливо

• Якщо у вашій країні діє перехід на літній час, зробіть відповідні коригування.
  • За стандартним часом значення "-05:00" означає північноамериканський східний час (EST), а "-08:00" – тихоокеанський стандартний час (PST).
  • За літнім часом значення "-04:00" означає північноамериканський східний літній час (EDT), а "-07:00" – тихоокеанський літній час (PDT).

Канал активації [redemption_channel]

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

Дійсні значення:

• in_store
• online
• online_and_in_store

Важливо

• Якщо ви застосовуєте багатоканальну рекламну акцію (і у звичайних, і в онлайн-магазинах), укажіть для неї значення online_and_in_store.
• Якщо це значення залишити порожнім, рекламна акція за умовчанням матиме значення "онлайн".
  • Рекламні акції онлайн не обмежуватимуться радіусом регіону магазину й показуватимуться в товарних оголошеннях онлайн.

Магазини, що беруть участь в акції [store_applicability]

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

Дійсні значення:

• all_stores
• specific_stores

Важливо

• Якщо ви вибрали значення specific_stores, потрібно також додати атрибут "включення кодів магазинів" [store_codes_inclusion] або "виключення кодів магазинів" [store_codes_exclusion].
• Якщо вибрати значення all_stores, атрибути "включення кодів магазинів" і "виключення кодів магазинів" (перегляньте інформацію нижче) ігноруватимуться.

Посилання на рекламну акцію [promotion_url]

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

Цільовий сервіс рекламної акції [promotion_destination]

Цей атрибут указує цільовий сервіс рекламної акції.

Дійсні значення:

• promotion_destination: local_inventory_ads
• promotion_destination: Shopping_ads
• promotion_destination: Buy_on_Google_listings
• promotion_destination: Free_listings

Атрибути, пов’язані з магазином

Включення кодів магазинів [store_codes_inclusion]

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

Важливо

• Якщо рекламна акція поширюється лише на певні магазини (specific_stores), зазначте їх коди, указані в профілі компанії.
• Ви можете використати лише один із двох атрибутів: "включення кодів магазинів" [store_codes_inclusion] або "виключення кодів магазинів" [store_codes_exclusion].

Виключення кодів магазинів [store_codes_exclusion]

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

Важливо

• Якщо рекламна акція виключає певні магазини (specific_stores), зазначте їх коди, указані в профілі компанії.
• Ви можете використати лише один із двох атрибутів: "виключення кодів магазинів" [store_codes_exclusion] або "включення кодів магазинів" [store_codes_inclusion].

Необов’язкові атрибути

Атрибути для націлювання товарів

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

Ви також можете додати атрибут ідентифікатор рекламної акції [promotion_id] безпосередньо до товарів у джерелі даних.

Ідентифікатор товару для рекламної акції [item_id]

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

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

Важливо

• З однією рекламною акцією в джерелі даних можна зіставити щонайбільше 20 ідентифікаторів товарів.
• Не використовуйте атрибут "ідентифікатор товару для рекламної акції" [item_id], якщо хочете призначити рекламну акцію для більше ніж 20 товарів. Натомість додайте атрибут "ідентифікатор рекламної акції" безпосередньо до позицій у джерелі даних про товари.

Категорія товару в Google [google_product_category]

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

Якщо для атрибута "товари, які беруть участь у рекламній акції" [product_applicability] вибрано значення specific_products, атрибут категорія товару в Google [google_product_category] дає змогу зіставити вашу рекламну акцію з певною категорією товару в Google.

Важливо

• Не надсилайте цей атрибут, якщо категорія товару містить виключення. У такому разі потрібно вручну зіставити атрибут ідентифікатор рекламної акції [promotion_id] з потрібними позиціями в джерелі даних про товари або скористатись атрибутом "ідентифікатор товару для рекламної акції" [item_id] (перегляньте інформацію вище), щоб зіставити товари, які відповідають вимогам, у джерелі даних про рекламні акції. Докладніше про зіставлення розповідається в розділі Виберіть товари для рекламних акцій нашого посібника з налаштування рекламних акцій.
• Категорії найвищого рівня, як-от "Одяг і аксесуари" (166) або "Медіа" (783), не підтримуються. Якщо ваші товари належать до однієї із цих категорій, укажіть вужчу. Наприклад: "Одяг і аксесуари > Одяг > Спортивний одяг > Спортивний одяг для велосипедистів" (5697).

Тип товару [product_type]

Атрибут "тип товару" зіставляє вашу рекламну акцію з певним типом (або типами) товарів у джерелі даних.

Якщо для атрибута "товари, які беруть участь у рекламній акції" [product_applicability] вибрано значення specific_products, атрибут "тип товару" [product_type] дає змогу зіставити рекламну акцію з одним або кількома типами товарів.

Важливо

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

Бренд [brand]

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

Якщо для атрибута "товари, які беруть участь у рекламній акції" [product_applicability] вибрано значення specific_products, атрибут "бренд" дає змогу зіставити вашу рекламну акцію з вибраними брендами.

Важливо

• Можна вказати щонайбільше 10 брендів. Відокремлюйте кожен указаний бренд комою.
• Назва бренду враховує регістр і пробіли й має точно відповідати вказаній у джерелі даних про товари.
• Не надсилайте цей атрибут, якщо бренд містить виключення. У такому разі потрібно вручну зіставити атрибут ідентифікатор рекламної акції [promotion_id] з потрібними товарами в джерелі даних або скористатись атрибутом "ідентифікатор товару для рекламної акції" [item_id] (перегляньте інформацію вище), щоб зіставити товари, які відповідають вимогам, у джерелі даних про рекламні акції (не більше ніж 20 товарів). Докладніше про зіставлення розповідається в розділі Виберіть товари для рекламних акцій нашого посібника з налаштування рекламних акцій.

Виключений ідентифікатор товару [item_id_exclusion]

За допомогою атрибута "виключений ідентифікатор товару" можна виключити певні товари у вашому джерелі даних про рекламні акції.

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

Виключення категорії товару в Google [google_product_category_exclusion]

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

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

Важливо

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

Виключені типи товарів [product_type_exclusion]

За допомогою атрибута "виключені типи товарів" із рекламної акції можна виключити принаймні один тип товару в джерелі даних про рекламні акції.

Якщо для атрибута "товари, які беруть участь у рекламній акції" [product_applicability] вибрано значення specific_products, за допомогою атрибута "виключені типи товарів" [product_type_exclusion] можна виключити всі товари однакового типу з рекламної акції в джерелі даних про товари.

Важливо

• Можна вказати щонайбільше 10 типів товарів. Відокремлюйте кожен указаний тип товару комою.
• Не надсилайте цей атрибут, якщо типи товарів містять позиції, що відповідають вимогам. У такому разі потрібно вручну зіставити атрибут ідентифікатор рекламної акції [promotion_id] з потрібними товарами в джерелі даних або скористатись атрибутом "ідентифікатор товару для рекламної акції" [item_id] (перегляньте інформацію вище), щоб зіставити товари, які відповідають вимогам, у джерелі даних про рекламні акції (не більше ніж 20 товарів). Докладніше про зіставлення розповідається в розділі Виберіть товари для рекламних акцій нашого посібника з налаштування рекламних акцій.

Виключені бренди [brand_exclusion]

За допомогою атрибута "виключені бренди" в джерелі даних про товари можна виключити принаймні один бренд із рекламної акції.

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

Важливо

• Можна вказати щонайбільше 10 брендів. Відокремлюйте кожен указаний бренд комою.
• Назва бренду враховує регістр і пробіли й має точно відповідати вказаній у джерелі даних про товари.
• Не надсилайте цей атрибут, якщо бренд містить товари, що відповідають вимогам. У такому разі потрібно вручну зіставити атрибут ідентифікатор рекламної акції [promotion_id] з потрібними товарами в джерелі даних або скористатись атрибутом "ідентифікатор товару для рекламної акції" [item_id] (перегляньте інформацію вище), щоб зіставити товари, які відповідають вимогам, у джерелі даних про рекламні акції (не більше ніж 20 товарів). Докладніше про зіставлення розповідається в розділі Виберіть товари для рекламних акцій нашого посібника з налаштування рекламних акцій.

Теги рекламної акції [promotion_tags]

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

Умови щодо синтаксису наведено нижче.

• Допустимі ключі: google_product_category, product_type, brand.
• Формат: {attribute1: "valueA", attribute2: "valueB"}.
• Максимальна довжина – 500 символів.

Приклад

• {brand: “Nike”, google_product_category: “Apparel & Accessories > Shoes”}

Важливо

• Атрибут "теги рекламної акції" [promotion_tags] слід використовувати, якщо акція стосується підмножини (але не всіх) товарів у категорії, типі чи бренді, а ідентифікатори конкретних товарів невідомі.

ПОВЕРНУТИСЯ НА ГОЛОВНУ СТОРІНКУ СПЕЦІАЛЬНИХ ПРОПОЗИЦІЙ