Спецификация источника данных для местных промоакций

Информация, которую вы указываете для местных промоакций, показывается в местных объявлениях на вкладке "Покупки" и на компьютерах, и на мобильных устройствах. Чтобы показывать информацию о местных промоакциях, вам нужно создать соответствующий источник данных и включить в него все необходимые атрибуты.

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

Примечание. Для промоакций в магазинах и онлайн можно использовать один источник данных.

В этой статье рассказывается об атрибутах, которые доступны в источниках данных для местных промоакций. Чтобы посмотреть пример такого источника данных, нажмите кнопку ниже.

Скачать пример

Важно!

• Мы проверяем все промоакции на соответствие правилам программы промоакций и редакционным требованиям.
• Рекомендуем использовать для всех предложений, которые вы загружаете с помощью источников данных для промоакций, атрибуты со структурированными данными.
• В местные промоакции нельзя добавлять предложения, связанные с доставкой.
• Наличие источника данных для промоакций не влияет на ваши рейтинги в сервисах Google.

Обязательные атрибуты

Идентификатор промоакции [promotion_id]

В этом атрибуте указывается уникальный идентификатор промоакции. Если в акции, действующей только в магазинах, участвуют только некоторые товары, значения атрибута "идентификатор промоакции" [promotion_id] в источнике данных для промоакций и источнике данных о товарах должны совпадать. Это позволит Google определить, к каким товарам применить условия промоакции.

Важно!

• Значение атрибута "идентификатор промоакции" следует указывать с учетом регистра. Если вам нужно сопоставить промоакцию с набором товаров в источнике данных о товарах, идентификаторы промоакции должны полностью совпадать в обоих источниках данных.
• Идентификатор промоакции не должен содержать пробелов или специальных символов, таких как "%" и "!".
• Чтобы указать несколько значений атрибута "идентификатор промоакции" для одного товара, добавьте их в столбец "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]

Этот атрибут позволяет указать период, когда промоакция будет активна. Синтаксис:

• Дата: YYYY-MM-DD (ГГГГ-ММ-ДД).
• Время: HH:MM:SS (ЧЧ:ММ:СС) и разница со средним временем по Гринвичу (см. ниже).
  • Время указывается по Гринвичу. Соответственно, вам нужно сразу после метки времени указать разницу между нужным часовым поясом и временем по Гринвичу в часах и минутах (+HH:MM (+ЧЧ:ММ) или -HH:MM (-ЧЧ:ММ)).
    • Например, если акция проводится по североамериканскому тихоокеанскому стандартному времени, укажите "-08:00", поскольку оно на 8 часов отстает от времени по Гринвичу.
• Значения даты и времени должны быть разделены буквой T.
• Сначала укажите дату и время начала, а затем дату и время окончания, разделив их косой чертой (/).

Примеры:

• Если акция действует с 3:00 19 июля 2019 года по 21:00 26 июля 2019 года по североамериканскому восточному времени, значение будет выглядеть так:
  • 2019-07-19T03:00:00-05:00/2019-07-26T21:00:00-05:00
• Если акция действует с 3:00 19 июля 2019 года по 21:00 26 июля 2019 года по Гринвичу, значение будет выглядеть так:
  • 2019-07-19T03:00:00+00:00/2019-07-26T21:00:00+00:00

Важно!

• В случаях, когда это необходимо, учитывайте переход на летнее время:
  • Когда действует стандартное время, отметка "-05:00" соответствует североамериканскому восточному стандартному времени, а "-08:00" означает тихоокеанское стандартное время.
  • При летнем времени эти отметки меняются на "-04:00" для восточного времени и на "-07:00" для тихоокеанского.

Канал промоакции [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]

Ссылка на промоакцию должна указывать на страницу вашего сайта, на которой приведены подробные сведения о промоакции. Это может быть страница вашего сайта с описанием акции, баннером о промоакции или изображением такого баннера. Эта ссылка также используется во время проверки промоакции, чтобы подтвердить, что она действует там, где указано, и что товары можно купить в магазине или заказать и забрать с улицы. Она также нужна, чтобы подтвердить, что покупателям не нужно совершать дополнительные действия, чтобы воспользоваться акцией в магазине, кроме как предъявить код купона или штрихкод. Сведения на странице должны совпадать с информацией, отправленной в Google.

Целевой сервис промоакции [promotion_destination]

Этот атрибут указывает на целевой сервис промоакции.

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

• "Рекламе местного ассортимента" [promotion_destination: local_inventory_ads].
• "Товарная реклама" [promotion_destination: shopping_ads].
• "Программа "Купить через Google"" [promotion_destination: Buy_on_Google_listings].
• "Бесплатные предложения" [promotion_destination: free_listings].

Атрибуты, связанные с магазином

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

С помощью этого атрибута можно указать магазины, участвующие в промоакции.

Важно!

• Если в промоакции участвуют только определенные магазины, перечислите их коды. Они должны совпадать с кодами, которые вы указали в профилях компаний.
• Атрибут "включение кодов магазинов" [store_codes_inclusion] нельзя использовать одновременно с атрибутом "исключение кодов магазинов" [store_codes_exclusion].

Исключение кодов магазинов [store_codes_exclusion]

С помощью этого атрибута можно указать магазины, которые не участвуют в промоакции.

Важно!

• Если из промоакции необходимо исключить определенные магазины, перечислите их коды. Они должны совпадать с кодами, которые вы указали в профилях компаний.
• Атрибут "исключение кодов магазинов" [store_codes_exclusion] нельзя использовать одновременно с атрибутом "включение кодов магазинов" [store_codes_inclusion].

Дополнительные атрибуты

Атрибуты таргетинга на товары

Это необязательные атрибуты, которые позволяют указывать, какие товары участвуют в акции, прямо в источнике данных для промоакций.

Вы также можете добавлять атрибут "идентификатор промоакции" [promotion_id] к товарам прямо в источник данных о товарах.

Код товара, участвующего в промоакции [item_id]

Этот атрибут позволяет сопоставить промоакцию с товарами в источнике данных о товарах.

Если для атрибута "товары, участвующие в промоакции" [product_applicability] указано значение "некоторые товары" specific_products, укажите их идентификаторы в атрибуте "код товара, участвующего в промоакции" [item ID], чтобы сопоставить акцию с товарами.

Важно!

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

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

Этот атрибут позволяет сопоставить промоакцию с категориями товаров в источнике данных о товарах.

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

Важно!

• Не добавляйте этот атрибут, если в категории есть товары, которые не участвуют в промоакции. В этом случае необходимо вручную задать значение атрибута "идентификатор промоакции" [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], атрибут "бренд" [brand] позволяет связать промоакцию с выбранными вами брендами.

Важно!

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

Исключенный идентификатор товара [item_id_exclusion]

Этот атрибут позволяет исключать из промоакции некоторые товары.

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

Исключение категории товара в Google [google_product_category_exclusion]

Этот атрибут позволяет исключить из промоакции все товары категории.

Если в атрибуте "товары, участвующие в промоакции" [product_applicability] задано значение "некоторые товары" [specific_products], из промоакции будут исключены все товары этой категории в вашем источнике данных.

Важно!

• Не добавляйте этот атрибут, если среди товаров одной категории есть те, на которые распространяется промоакция. В этом случае необходимо вручную задать значение атрибута "идентификатор промоакции" [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
• Формат: {атрибут1: "значениеА", атрибут2: "значениеБ"}
• Максимальная длина – 500 символов.

Пример:

• {brand: "Nike", google_product_category: "Предметы одежды и принадлежности > Обувь"}

Важно!

• Атрибут "теги промоакции" [promotion_tags] следует использовать, когда в акции участвует часть товаров одной категории, типа или бренда, но их идентификаторы неизвестны.

НАЗАД – СПЕЦИАЛЬНЫЕ ПРЕДЛОЖЕНИЯ