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

У цій статті перелічено всі атрибути, які можна надсилати в джерелі даних рекламних акцій.

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

Примітка. Кількість активних рекламних акцій в обліковому записі обмежено. Докладніше про обмеження.

Як надіслати джерело даних рекламних акцій

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

Реєстрація і завантаження нового джерела даних. Щоб зареєструвати й завантажити нове джерело даних для рекламної акції, дотримуйтеся цих вказівок. Завантажте джерело даних для рекламної акції в той самий обліковий запис Merchant Center, який використовується для джерела даних про товари онлайн-асортименту.

Усі рекламні акції проходять перевірку на відповідність правилам програми й редакційним вимогам.

Як створити рекламну акцію для певних товарів

Ви можете зробити це кількома способами.

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


Основні дані рекламних акцій

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

Атрибут Мінімальні вимоги
Ідентифікатор рекламної акції [promotion_id]

Required Обов’язковий

Синтаксис

  • Максимальна довжина – 50 символів.
  • Враховується регістр.
  • Не має містити пробілів і символів (наприклад, "%" або "!").

Значення цього атрибута є унікальним ідентифікатором рекламної акції.

Атрибут ідентифікатор рекламної акції [promotion_id] використовується, щоб зв’язувати рекламні акції з певними товарами.

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

Required Обов’язковий

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

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

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

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

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

Required Обов’язковий

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

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

Якщо для цього атрибута вибрано значення [generic_code] (тобто однаковий код для всіх покупців), потрібно вказати такий атрибут:

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

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

Примітка. Усі рекламні акції з доставкою мають включати дійсний код пропозиції.

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

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

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

Required Обов’язковий

Синтаксис

  • Максимальна довжина – 60 символів.

Приклад

  • Чашка в подарунок для всіх покупок

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

Важливо

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

Назва має точно й докладно описати відповідну рекламну акцію.

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

Required Обов’язковий

Синтаксис

  • Дати початку й завершення потрібно розділяти скісною рискою (/).
  • Дата вказується у форматі РРРР-ММ-ДД. Після неї іде латинська літера "T", потім час доби, коли починається або закінчується акція, а в кінці – відповідний часовий пояс.

Приклад

Якщо ваша рекламна акція діє з 03:00 19 липня 2009 року до 21:00 26 липня 2009 року за північноамериканським східним часом (EST), ви маєте надіслати таке значення:

2009-07-19T03:00:00-05:00/2009-07-26T21:00:00-05:00

Якщо ваша рекламна акція діє з 03:00 19 липня 2009 року до 21:00 26 липня 2009 року за Гринвічем (GMT), ви маєте надіслати таке значення:

2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00

Важливо

  • GMT – це середній час за Гринвічем. -5 означає північноамериканський східний час (EST), а -8 – тихоокеанський стандартний час (PST).
  • Рекламні акції можуть тривати не довше ніж 6 місяців (183 дні).
  • Літній час: -4 означає північноамериканський східний літній час (EDT), а -7 – тихоокеанський літній час (PDT).

Інструмент створення рекламних акцій підтримує лише атрибут "дата початку рекламної акції" [promotion_effective_dates] і застосовує часовий пояс, указаний у налаштуваннях вашого облікового запису Merchant Center. Якщо потрібно змінити часовий пояс рекламної акції, зробіть це вручну.

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

Допустимий канал для рекламної акції [redemption_channel]

Примітка. Цей атрибут доступний лише в класичній версії Merchant Center.

Required Обов’язковий

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

  • Онлайн [online]
  • У магазині [in_store]
  • Обидва значення: [in_store], [online]

Важливо

  • Якщо це значення залишити порожнім, рекламна акція за умовчанням матиме значення "онлайн" [online].
  • Це значення має включати [in_store], якщо для атрибута [promotion_destination] указано значення local_inventory_ads.
Цей атрибут указує, що рекламна акція діє онлайн і/або в магазині.

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

Required Обов’язковий

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

  • Товарні оголошення [Shopping_ads]
  • Інформація про товар, розміщена безкоштовно [Free_listings]
  • Партнерська програма YouTube [youtube_affiliate]
  • Реклама місцевого асортименту [local_inventory_ads]

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

  • promotion_destination: Local_inventory_ads
  • promotion_destination: Shopping_ads
  • promotion_destination: Free_listings

Важливо

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

Важливо

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

Щоб дізнатися більше про повторювані поля, перегляньте цю статтю.

Примітка

  • Щоб використовувати значення атрибута "безкоштовні пропозиції" [Free_listings] для цільового сервісу, потрібно мати схвалену пропозицію для безкоштовно розміщеної інформації про товари. Крім того, для швидшого схвалення рекомендуємо створювати пропозиції, надіслані через джерело даних для рекламної акції, у структурованому форматі.
  • Зараз ми тестуємо цільовий сервіс "Партнерська програма YouTube", і він доступний лише для деяких продавців.
  • Якщо ви націлите рекламну акцію на цей сервіс, її не можна буде націлювати на інші сервіси, оскільки через це зіставлення може бути скасовано.

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

Required Обов’язковий для місцевих рекламних акцій.

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

  • all_stores
  • specific_stores

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

Важливо

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

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

Required Обов’язковий, якщо для атрибута "магазини, що беруть участь в акції" [store_applicability] вибрано значення specific_stores.

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

Важливо

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

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

Required Обов’язковий, якщо для атрибута "магазини, що беруть участь в акції" [store_applicability] указано значення specific_stores.

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

Важливо

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

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

Required Обов’язковий для розпродажів і місцевих рекламних акцій.

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

Інформація на сторінці з відомостями про рекламну акцію має збігатися з надісланими даними про неї.

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

Фільтри товарів

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

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

Приклад

Наприклад, якщо ви створите рекламну акцію зі значеннями brand = "example1" (бренд = "приклад 1") і product_type = "Tshirt" (тип товару = "футболка"), вона застосовуватиметься лише до тих позицій у джерелі даних про товар, які матимуть значення brand = "example1" (бренд = "приклад 1") і product_type = "Tshirt" (тип товару = "футболка").

Можна також зв’язати товар із певною рекламною акцією, налаштувавши атрибут ідентифікатор рекламної акції [promotion_id] в джерелі даних про товари.

Атрибут Опис

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

Optional Необов’язковий

Синтаксис

  • Рядок.
  • Максимальна довжина – 50 символів.
  • Враховується регістр. Має відповідати значенню у фіді товарів.

Рекламна акція застосовується лише до товарів, ідентифікатор яких збігається зі значенням атрибута "ідентифікатор товару для рекламної акції" [item_id].

Примітка. Атрибут "ідентифікатор товару для рекламної акції" [item_id] збігається з атрибутом ідентифікатор [id] у специфікації джерела даних про товари.

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

Optional Необов’язковий

Синтаксис

  • Символи Юнікоду (рекомендовано лише ASCII).
  • Максимальна довжина – 750 символів.
  • Регістр не враховується.
Рекламна акція застосовується лише до позицій, які відповідають типу товару, указаному в цьому атрибуті.

Бренд [brand]

Optional Необов’язковий

Синтаксис

  • Символи Юнікоду (рекомендовано лише ASCII).
  • Максимальна довжина – 70 символів.
  • Регістр не враховується.

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

Ідентифікатор групи товарів [item_group_id]

Optional Необов’язковий

Синтаксис

  • Рядок.
  • Максимальна довжина – 50 символів.
  • Враховується регістр. Має збігатися зі значенням у джерелі даних про товари.

Рекламна акція застосовується лише до товарів, які збігаються зі значенням атрибута ідентифікатор групи товарів [item_group_id].

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

Optional Необов’язковий

Синтаксис

  • Рядок.
  • Один або кілька ідентифікаторів товару.
  • Максимальна довжина – 50 символів.
  • Враховується регістр. Має збігатися зі значенням у джерелі даних про товари.
Товари з одним із цих ідентифікаторів виключаються з рекламної акції.

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

Optional Необов’язковий

Синтаксис

  • Символи Юнікоду (рекомендовано лише ASCII).
  • Максимальна довжина – 70 символів.
  • Регістр не враховується.

Приклад

Каблучки

Товари з одним із цих типів виключаються з рекламної акції.

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

Optional Необов’язковий

Синтаксис

  • Рядок.
  • Максимальна довжина – 50 символів.
  • Регістр не враховується.

Приклад

Товари Acme

Товари з одним із цих брендів виключаються з рекламної акції.

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

Optional Необов’язковий

Синтаксис

  • Рядок.
  • Максимальна довжина – 50 символів.
  • Враховується регістр. Має збігатися зі значенням у джерелі даних про товари.
Товари з одним із цих ідентифікаторів групи виключаються з рекламної акції.

Спеціальна мітка 0–4 [custom_label_0–4]

Optional Необов’язковий

Синтаксис

  • Рядок.
  • Максимальна довжина – 50 символів.
  • Регістр не враховується.
Рекламна акція застосовується лише до товарів, позначених спеціальними мітками, указаними в цьому атрибуті.

Виключена спеціальна мітка 0–4 [custom_label_0–4_exclusion]

Optional Необов’язковий

Синтаксис

  • Рядок.
  • Максимальна довжина – 50 символів.
  • Регістр не враховується.
Товари з однією із цих спеціальних міток виключаються з рекламної акції.

Відомості про рекламну акцію

У наступних розділах описано атрибути, які ви можете використовувати для створення рекламних акцій зі структурованими даними, як-от "Купуйте Н, отримуйте М".

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

Передумови

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

Наприклад, щоб створити:

  • рекламну акцію "Безкоштовна доставка для покупок на суму від 50 дол. США", укажіть значення "50 дол. США" для атрибута "мінімальна загальна вартість покупки" [minimum_purchase_amount];
  • рекламну акцію "Безкоштовна сумка за покупку на суму 100 дол. США", укажіть значення "100 дол. США" для атрибута "мінімальна загальна вартість покупки" [minimum_purchase_amount].
Атрибут Опис
Мінімальна загальна вартість покупки [minimum_purchase_amount]

Optional Необов’язковий

Синтаксис

Джерела даних про рекламні акції підтримують валюти лише вказаних країн.

Приклад

20 USD

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

Наприклад, купуючи Х однакових або різних товарів, користувач отримає знижку Y.

Значення мінімальної загальної вартості покупки має бути не меншим за 1.

Мінімальна кількість товару, яку можна придбати під час рекламної акції [buy_this_quantity]

Optional Необов’язковий

Синтаксис

Має бути цілим числом.

Приклад

2

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

Обмеження щодо активації [redemption_restriction]

Optional Необов’язковий

Приклад

Перелічення

Список значень

  • subscribe_and_save
  • first_order
  • sign_up_for_email
  • sign_up_for_text
  • custom

Спеціальні умови активації [custom_redemption_restriction]

Optional Необов’язковий

Синтаксис

  • Рядок з умовою активації.
  • Максимальна довжина – 50 символів.
Якщо для атрибута redemption_restriction указано значення custom, цей атрибут визначає спеціальну умову активації.

Категорії рекламних акцій

У таблиці нижче перелічено категорії рекламних акцій. Укажіть категорію, щоб створити рекламну акцію зі структурованими даними (наприклад, "Купуйте 1 товар і отримайте 1 у подарунок"). Докладніше про атрибути, які використовуються в структурованих даних.

З атрибутом ідентифікатор рекламної акції [promotion_id] можна зв’язати лише одну категорію рекламної акції. Категорію рекламної акції можна також обмежити за допомогою лімітів. Докладніше про ліміти.

Атрибут Опис

Сума знижки у відсотках [percent_off]

Optional Необов’язковий

Синтаксис

Має бути цілим числом.

Приклад

10

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

Наприклад, 10% знижки.

Грошова сума знижки для рекламної акції [money_off_amount]

Optional Необов’язковий

Синтаксис

Потрібно вказати число й валюту.

Приклад

200.00 UAH

Цей атрибут визначає суму знижки.

Наприклад, 20 дол. США знижки.

Кількість товарів, які можна отримати за умовами акції [get_this_quantity_discounted]

Optional Необов’язковий

Синтаксис

Має бути цілим числом.

Приклад

2

Цей атрибут визначає кількість товарів, які потрібно купити для отримання бонусу або знижки, якщо тип рекламної акції – [buy_m_get_n_money_off] або [buy_m_get_n_percent_off].

Наприклад, для рекламної акції "Купіть 2 одиниці товару й отримайте ще 1 в подарунок (100% знижки)" укажіть у цьому атрибуті значення "1".

Безкоштовна доставка [free_shipping]

Optional Необов’язковий

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

  • Стандартна безкоштовна доставка [free_shipping_standard]
  • Безкоштовна доставка на наступний день [free_shipping_overnight]

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

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

Подарунок у грошовому еквіваленті [free_gift_value]

Optional Необов’язковий

Синтаксис

Потрібно вказати число й валюту.

Приклад

4000.00 UAH

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

Опис безкоштовного подарунка [free_gift_description]

Optional Необов’язковий

Синтаксис

Максимальна довжина – 100 символів.

Приклад

Безкоштовна сумка за покупку на суму від 1000 грн

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

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

Ідентифікатор безкоштовного подарунка [free_gift_item_id]

Optional Необов’язковий

Синтаксис

  • Символи Юнікоду (рекомендовано лише ASCII).
  • Максимальна довжина – 50 символів.

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

Значення атрибута "ідентифікатор товару для рекламної акції" [item_id] – це товар, який користувач отримає як безкоштовний подарунок.

Атрибут "ідентифікатор товару для рекламної акції" [item_id] має збігатися з ідентифікатором у вашому джерелі даних про товари.

Тип значення купона [coupon_value_type]

Optional Необов’язковий

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

  • no_structured_data
  • money_off
  • percent_off
  • buy_m_get_n_money_off
  • buy_m_get_percent_off
  • buy_m_get_money_off
  • buy_m_get_n_percent_off
  • free_gift
  • free_gift_with_value
  • free_gift_with_id
  • free_shipping_standard
  • free_shipping_overnight
  • free_shipping_two_day
  • free_shipping_with_shipping_config
  • cash_back
  • percentage_cash_back
  • money_off_range
  • percent_off_range

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

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

Наприклад, якщо для атрибута "тип значення купона" [coupon_value_type] вибрано значення "фіксована знижка" [money_off], потрібно також використовувати атрибут "грошова сума знижки для рекламної акції" [money_off_amount].

Примітка. Атрибути [money_off_range] і [percent_off_range] використовуються лише для розпродажів у США.

Залежно від значення атрибута "тип значення купона" [coupon_value_type], у джерело даних для рекламної акції можна включати додаткові атрибути (обов’язкові або необов’язкові).

Мінімальна сума фіксованої знижки [min_money_off_amount]

Optional Необов’язковий

Синтаксис

Потрібно вказати число й валюту.

Приклад

500.00 UAH

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

Якщо для атрибута coupon_value_type вибрано значення money_off_range, укажіть принаймні один із наведених нижче атрибутів.

  • min_money_off_amount
  • max_money_off_amount

Максимальна сума фіксованої знижки [max_money_off_amount]

Optional Необов’язковий

Синтаксис

Потрібно вказати число й валюту.

Приклад

500.00 UAH

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

Якщо для атрибута coupon_value_type вибрано значення money_off_range, укажіть принаймні один із наведених нижче атрибутів.

  • min_money_off_amount
  • max_money_off_amount
Якщо не вибрати значення money_off_range, ці поля ігноруватимуться.

Мінімальний відсоток знижки [min_percent_off]

Optional Необов’язковий

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

Якщо для атрибута coupon_value_type вибрано значення percent_off_range, укажіть принаймні один із наведених нижче атрибутів.

  • min_percent_off
  • max_percent_off

Максимальний відсоток знижки [max_percent_off]

Optional Необов’язковий

Значення цього атрибута має бути числом від 1 до 99 і перевищувати значення атрибута min_percent_off.

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

Якщо для атрибута coupon_value_type вибрано значення percent_off_range, укажіть принаймні один із наведених нижче атрибутів.

  • min_percent_off
  • max_percent_off
Якщо не вибрати значення percent_off_range, ці поля ігноруватимуться.

Атрибути, які можна використовувати разом з атрибутом [coupon_value_type] у джерелі даних для рекламної акції

У списку нижче наведено допустимі значення атрибута "тип значення купона" [coupon_value_type] і обов’язкові й необов’язкові атрибути джерела даних для кожного з них.

Без структурованих даних [no_structured_data]

  • Обов’язковий: немає.
  • Необов’язкові: "мінімальна загальна вартість покупки" [minimum_purchase_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "максимальна кількість товару, яку можна придбати під час рекламної акції" [limit_quantity], "ціна в межах акції" [promotion_price], "грошова сума знижки для рекламної акції" [money_off_amount], "сума знижки у відсотках" [percent_off], "кількість товарів, які можна отримати за умовами акції" [get_this_quantity_discounted], "грошова вартість безкоштовного подарунка" [free_gift_value], "ідентифікатор безкоштовного подарунка" [free_gift_item_id], "опис безкоштовного подарунка" [free_gift_description], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Фіксована знижка [money_off]

  • Обов’язковий: "грошова сума знижки для рекламної акції" [money_off_amount].
  • Необов’язкові: "мінімальна загальна вартість покупки" [minimum_purchase_amount], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Відсоткова знижка [percent_off]

  • Обов’язковий: відсоткова знижка [percent_off]
  • Необов’язкові: "мінімальна загальна вартість покупки" [minimum_purchase_amount], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Придбайте m і отримайте знижку n [buy_m_get_n_money off]

  • Обов’язкові: "грошова сума знижки для рекламної акції" [money_off_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "кількість товарів, які можна отримати за умовами акції" [get_this_quantity_discounted].
  • Необов’язкові: "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Придбайте m і отримайте відсоткову знижку n [buy_m_get_n_percent_off]

  • Обов’язкові: "сума знижки у відсотках" [percent_off], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "кількість товарів, які можна отримати за умовами акції" [get_this_quantity_discounted].
  • Необов’язкові: "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Придбайте m і отримайте знижку [buy_m_get_money_off]

  • Обов’язкові: "грошова сума знижки для рекламної акції" [money_off_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity].
  • Необов’язкові: "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Придбайте m і отримайте відсоткову знижку [buy_m_get_percent_off]

  • Обов’язкові: "сума знижки у відсотках" [percent_off], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity].
  • Необов’язкові: "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Безкоштовний подарунок [free_gift]

  • Обов’язковий: "опис безкоштовного подарунка" [free_gift_description].
  • Необов’язкові: "мінімальна загальна вартість покупки" [minimum_purchase_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Грошова вартість безкоштовного подарунка [free_gift_value]

  • Обов’язковий: "грошова вартість безкоштовного подарунка" [free_gift_value].
  • Необов’язкові: "мінімальна загальна вартість покупки" [minimum_purchase_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Ідентифікатор безкоштовного подарунка [free_gift_with_id]

  • Обов’язковий: "ідентифікатор безкоштовного подарунка" [free_gift_item_id].
  • Необов’язкові: "мінімальна загальна вартість покупки" [minimum_purchase_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Безкоштовна стандартна доставка [free_shipping_standard]

  • Обов’язковий: немає.
  • Необов’язкові: "тип безкоштовної доставки" [free_shipping_type], "мінімальна загальна вартість покупки" [minimum_purchase_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Безкоштовна термінова доставка [free_shipping_overnight]

  • Обов’язковий: немає.
  • Необов’язкові: "тип безкоштовної доставки" [free_shipping_type], "мінімальна загальна вартість покупки" [minimum_purchase_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Безкоштовна доставка протягом 2 днів [free_shipping_two_day]

  • Обов’язковий: немає.
  • Необов’язкові: "тип безкоштовної доставки" [free_shipping_type], "мінімальна загальна вартість покупки" [minimum_purchase_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Безкоштовна доставка з налаштуванням [free_shipping_with_shipping_config]

  • Обов’язковий: немає.
  • Необов’язковий: немає.

Кешбек [cash_back]

  • Обов’язковий: "сума кешбеку" [cash_back_amount].
  • Необов’язкові: "мінімальна загальна вартість покупки" [minimum_purchase_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Кешбек у відсотках [percentage_cash_back]

  • Обов’язковий: "відсоток кешбеку" [cash_back_percentage].
  • Необов’язкові: "мінімальна загальна вартість покупки" [minimum_purchase_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Діапазон фіксованої знижки [money_off_range]

  • Обов’язкові: "мінімальна грошова сума знижки для рекламної акції" [min_money_off_amount] і/або "максимальна грошова сума знижки для рекламної акції" [max_money_off_amount].
  • Необов’язкові: "мінімальна загальна вартість покупки" [minimum_purchase_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Діапазон відсотка знижки [percent_off_range], відсоток знижки [percent_off_range]

  • Обов’язкові: "мінімальна сума знижки у відсотках" [min_percent_off_amount] і/або "максимальна сума знижки у відсотках" [max_percent_off_amount].
  • Необов’язкові: "мінімальна загальна вартість покупки" [minimum_purchase_amount], "мінімальна кількість товару, яку можна придбати під час рекламної акції" [buy_this_quantity], "обмеження щодо активації" [redemption_restriction], "спеціальні умови активації" [custom_redemption_restriction].

Обмеження

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

Нижче наведено приклади.

  • У рекламній акції "Купуйте 1 товар і отримайте 1 безкоштовно. Акція діє до 10 товарів" укажіть "10" для атрибута "максимальна кількість товару, яку можна придбати під час рекламної акції" [limit_quantity].
  • У рекламній акції на зразок "Знижка 10%, максимум – 100 дол. США" укажіть значення 100 дол. США для атрибута "максимальна сума знижки" [max_discount_amount].
Атрибут Опис

Максимальна кількість товару, яку можна придбати під час рекламної акції [limit_quantity]

Optional Необов’язковий

Синтаксис

Має бути цілим числом.

Приклад

5

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

Максимальна сума знижки
[max_discount_amount]

Optional Необов’язковий

Синтаксис

Потрібно вказати число й валюту.

Приклад

500.00 UAH

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

Використовуйте його, якщо в атрибуті "тип значення купона" вибрано значення [percent_off].

Додаткові атрибути

Атрибут Опис

Дати показу пропозиції [promotion_display_dates]

Optional Необов’язковий

Синтаксис

Дати початку й завершення потрібно розділяти скісною рискою (/).

Дата вказується у форматі РРРР-ММ-ДД. Після неї йде літера "T", потім час доби, коли починається або закінчується акція, а в кінці – відповідний часовий пояс.

Приклад

Якщо ваша рекламна акція діяла з 03:00 19 липня 2009 року до 21:00 26 липня 2009 року за північноамериканським східним часом (EST), ви б мали надіслати таке значення:

2009-07-19T03:00:00-05:00/2009-07-26T21:00:00-05:00

Якщо ваша рекламна акція діяла з 03:00 19 липня 2009 року до 21:00 26 липня 2009 року за Гринвічем (GMT), ви б мали надіслати таке значення:

2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00

Важливо

  • GMT – це середній час за Гринвічем. -5 означає північноамериканський східний час (EST), а -8 – тихоокеанський стандартний час (PST).
  • Рекламні акції можуть тривати не довше ніж 6 місяців (183 дні).
  • Літній час: -4 означає північноамериканський східний літній час (EDT), а -7 – тихоокеанський літній час (PDT).

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

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

Опис [description]

Optional Необов’язковий

Синтаксис

  • Рядок.
  • Максимальна довжина – 2500 символів.

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

Опис не показується покупцям.

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

Optional Необов’язковий

Синтаксис

  • Рядок.
  • Максимальна довжина – 20 символів.

Приклад

EXTRA20

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

Примітка. Усі рекламні акції з доставкою мають включати дійсний код пропозиції.

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

Умови спеціальної пропозиції для рекламної акції [fine_print]

Optional Необов’язковий

Синтаксис

  • Рядок.
  • Максимальна довжина – 500 символів.

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

Умови використання відображатимуться разом із кодом, указаним в атрибуті "загальний код пропозиції".

Ціна в межах акції [promotion_price]

Optional Необов’язковий

Синтаксис

Потрібно вказати число й валюту.

Приклад

150.00 UAH

Цей атрибут визначає ціну зі знижкою на товар або категорію товарів (наприклад, "Усі джинси по 500 грн").

Акційна ціна доступна покупцям, які ввели промокод або виконали умови рекламної акції.

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


Як створити подію розпродажу у фіді

Щоб завантажувати дані про товари й події, скористайтеся зразком файлу CSV.

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

Розпродажі доступні лише для рекламних акцій, націлених на США.

Атрибут Формат Опис
Цільовий сервіс рекламної акції [promotion_destination]

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

  • [free_listings]
Зараз для подій підтримується лише один цільовий сервіс – безкоштовні пропозиції [free_listings].
Тип значення купона [coupon_value_type]

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

  • money_off
  • percent_off
  • buy_m_get_n_money_off
  • buy_m_get_n_percent_off
  • buy_m_get_percent_off
  • buy_m_get_money_off
  • free_gift
  • free_gift_with_value
  • free_gift_with_item_id
  • free_shipping_standard
  • free_shipping_overnight
  • free_shipping_two_day
  • cash_back
  • percentage_cash_back
  • money_off_range
  • percent_off_range
Усі наявні типи значень купона підтримуються в подіях.

Застосування події

[event_applicability]

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

  • Увесь сайт

[sitewide]

  • Конкретні категорії
[specific_categories]

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

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

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

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

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

Обов’язково для подій

Синтаксис

  • Рядок.
  • Дійсна URL-адреса цільової сторінки рекламної акції.
 
Категорія товару в Google
[google_product_category]

Необов’язковий

Використовуйте цей атрибут, якщо для атрибута event_applicability вибрано значення specific_category

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

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

Завантажте список усіх категорій товарів у Google:

Щоб уникнути спотворення тексту у файлі .txt, змініть кодування вебпереглядача на Unicode UTF-8.

  • Щоб завантажити цей список іншою мовою, виберіть її в меню внизу цієї сторінки.

Повторюване поле

Так. Приймається щонайбільше 5 категорій товарів у Google.

Приклад

2271

або

Одяг і аксесуари > Одяг > Сукні

 

Чи корисна ця інформація?

Як можна її покращити?
Пошук
Очистити пошук
Закрити пошук
Головне меню
13984805062150330611
true
Пошук у довідковому центрі
true
true
true
true
true
71525
false
false
false
false