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

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

Содержание

Источник данных о товарах

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

  1. Войдите в аккаунт Merchant Center.
  2. Нажмите на значок Настройки и инструменты Значок меню "Настройки и инструменты" (значок шестеренки) и выберите Источники данных.
  3. Выберите источник, который хотите изменить.
  4. Откройте настройки и разрешите использование данных из этого источника в локальных кампаниях и в интернет-магазинах.
Примечание. Если вы добавляете отдельные источники данных для офлайн- и онлайн-ассортимента (для товарной рекламы и бесплатных местных предложений), то товары в этих источниках не должны повторяться.

Мы рекомендуем создать единый файл с данными обо всех товарах, которые вы планируете включить в рекламу местного ассортимента и бесплатные местные предложения. При создании нового источника данных вы можете выбрать для него любые типы кампаний. Выбрать дополнительные типы кампаний в уже созданных источниках (рекламу местного ассортимента и/или бесплатные местные предложения) можно в основных настройках источника данных. Вы также можете исключить из указанных типов рекламы отдельные товары, добавив атрибут исключенные кампании [excluded_destination] с нужными значениями. Подробнее об исключенных кампаниях…

Добавление источника данных о товарах

Тип файла: текстовый файл с разделителем (рекомендуемый формат), файл XML или передача данных через API.

Регистрация нового источника данных: следуйте стандартной процедуре.

Данные о товарах появляются в течение двух дней после загрузки фида.

Важно! В зависимости от формата источника данных, атрибуты с несколькими словами в названии нужно оформлять по-разному.

  • Данные с разделителями-табуляцией: используйте пробелы. Если атрибут содержит символы подчеркивания ("_"), замените их на пробелы.
  • Данные в формате XML или XML API: используйте символы подчеркивания – система заменит их на пробелы после отправки файла.
  • API для JSON: используйте символы подчеркивания – система заменит их на пробелы после отправки файла. Подробнее…

Таблица требований к атрибутам

Атрибут Требования к атрибуту

Описание [description]

Идентификатор [id]

Ссылка на изображение [image_link]

Название [title]		 Эти атрибуты обязательны для всех товаров в вашем магазине.
Код GTIN [gtin]

Атрибут обязателен для всех новых товаров, у которых есть код GTIN.

Для остальных позиций добавлять его необязательно, но настоятельно рекомендуется.
Бренд [brand]

Этот атрибут обязателен для всех новых товаров, кроме фильмов, книг и музыки.

Для товаров других категорий он необязателен.
Состояние [condition]

Этот атрибут обязателен для бывших в употреблении и восстановленных товаров.

Для новых товаров он необязателен.

Класс энергоэффективности [energy_efficiency_class]

Минимальный класс энергоэффективности [min_energy_efficiency_class]

Максимальный класс энергоэффективности [max_energy_efficiency_class]

Эти атрибуты обязательны для товаров с таргетингом на страны ЕС, Великобританию или Швейцарию.

Для товаров с таргетингом на другие страны он необязателен.
Исключенные кампании [excluded_destination]

Рекомендуется, если вы используете один и тот же источник данных о товарах для продвижения онлайн- и офлайн-ассортимента.

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

Код GTIN [gtin]

Код производителя товара [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]

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

  • Значения атрибутов "возможность самовывоза" [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 необходимо указать пространство имен Google Merchant Center. В ином случае при обработке источника могут возникнуть ошибки.

Обязательные идентификаторы

Эти атрибуты содержат самые важные сведения о товаре. Их необходимо указать для всех товаров.

Идентификатор товара [id]

Уникальный идентификатор товара во всех ваших магазинах. Не может повторяться в источниках данных одного типа, на одном языке и с таргетингом на одну и ту же страну.

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

Тип Строка
Текст (TSV) 421486
XML-формат (фиды) <g:id>421486</g:id>

Важно!

  • Пробелы в начале и в конце текста, а также символы возврата каретки (0x0D) нужно удалять.
  • Сочетание символа возврата каретки (0x0D) и символа пробела по стандарту Unicode нужно заменять одинарным пробелом (0x20).
  • Разрешается использовать только допустимые символы Unicode. Исключение составляют следующие знаки:
    • управляющие символы, кроме символа возврата каретки (0x0D);
    • функциональные символы;
    • символы частного использования;
    • суррогатные пары;
    • неназначенные кодовые точки, в том числе все кодовые точки выше 0x10FFFF.
  • Идентификатор добавленного товара нельзя изменить в источнике данных или использовать для другой позиции.
  • Если вы указываете атрибут "идентификатор" для торговой кампании, рекомендуем использовать строчные буквы или символы, не зависящие от регистра.

Название [title]

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

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

Тип Текст (текстовая строка) длиной до 70 символов
Текст (TSV) Netgear ReadyNAS Duo
XML-формат (фиды) <g:title>Netgear ReadyNAS Duo</g:title>

Важно!

  • Следуйте нашим редакционным правилам. Например, не включайте в название рекламный текст, такой как "Бесплатная доставка", и не добавляйте в предложение несколько ЗАГЛАВНЫХ БУКВ подряд.
  • Для вариантов одного товара необходимо указывать общее название. Например, для мужских рубашек поло красного и синего цвета можно использовать любое из следующих названий:
    • Рубашка поло, мужская, пике (подойдет для обоих вариантов).
    • Рубашка поло, мужская, пике, красная (для рубашки красного цвета).
    • Рубашка поло, мужская, пике, синяя (для рубашки синего цвета).

Описание товара [description]

Опишите товар, указав только существенное: размер, материал, целевой возрастной диапазон, важные технические характеристики и особенности. Также опишите внешний вид: форму, узор, текстуру, дизайн и т. д. Пользователи часто ищут товары в том числе и по этим параметрам.

Максимальная длина текста составляет 5000 символов, но мы рекомендуем использовать от 500 до 1000 символов. Кроме того, в описании не должно быть грамматических и пунктуационных ошибок.

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


Content API v2 (JSON): "description": "Двуспальный комплект постельного белья красного цвета из 100%-го полиэстера с плотностью ткани 300. Комплект включает простыню на резинке, пододеяльник и две стандартные наволочки. Можно стирать в стиральной машине".

Content API v2 (XML): <description>Двуспальный комплект постельного белья красного цвета из 100%-го полиэстера с плотностью ткани 300. Комплект включает простыню на резинке, пододеяльник и две стандартные наволочки. Можно стирать в стиральной машине.</description>

Тип Текст
Ограничение на количество символов 5000
Текст (TSV) Двуспальное постельное белье красного цвета из 100%-го полиэстера с плотностью ткани 300. Комплект включает простыню на резинке, пододеяльник и две стандартные наволочки. Можно стирать в стиральной машине.
XML (источники данных) <description>Двуспальный комплект постельного белья красного цвета из 100%-го полиэстера с плотностью ткани 300. Комплект включает простыню на резинке, пододеяльник и две стандартные наволочки. Можно стирать в стиральной машине.</description>

Важно!

  • Четко следуйте редакционным правилам Google. Например, не включайте в описание рекламный текст, такой как "Бесплатная доставка", описание компании или бренда. Кроме того, не добавляйте в предложение несколько ЗАГЛАВНЫХ БУКВ подряд.
  • В описании также не допускается следующая информация:
    • Ссылки на сайт вашего магазина или другие сайты.
    • Сведения о способе оплаты, платежах и распродажах.
    • Информация о категории товара в Google, например "Игры и игрушки > Игрушки > Куклы".
    • Сравнение с другими продуктами, не имеющими отношения к предлагаемому, включая фразы вроде "лучше/быстрее/эффективнее, чем товар X".
    • Информация о других товарах, аксессуарах и аналогичных предложениях.

Ссылка на изображение [image_link]

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

Дополнительные изображения добавляют с помощью атрибута "ссылка на дополнительное изображение" [additional_image_link].

Размер изображения

  • Используйте полноразмерные изображения с высоким разрешением. Допускаются файлы размером до 16 МБ.
  • Мы рекомендуем добавлять фотографии размером хотя бы 800 х 800 пикселей.
  • Для предметов одежды размер изображения должен быть не меньше 250 x 250 пикселей, но не больше 64 мегапикселей. Для остальных товаров – не меньше 100 х 100 пикселей, но не больше 64 мегапикселей.
  • Не загружайте значки и не увеличивайте логотипы программными средствами. Мы советуем выбирать фотографии, на которых товар занимает 75–90 % области изображения.

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

Content API v2 (JSON): "imageLink": "http://www.example.com/image1.jpg"

Content API v2 (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>

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

Требования

  • Товары без изображений отправлять нельзя.
  • Не допускаются следующие типы изображений:
    • Замещающие изображения и изображения других товаров.
    • Изображения, которые не соответствуют товарам. Это не касается категорий 632 – Оборудование и технические изделия и 888 – Транспортные средства и запчасти.
    • Одноцветные изображения. Это ограничение не распространяется на категории 3812 Vehicle Paint [Краска для автомобилей], 505378 Craft Paint, Ink & Glaze [Краски, чернила и глазурь для рукодельных работ] и 503740 Painting Consumables [Расходные материалы для покраски].
    • Изображения с элементами рекламы, например словами "лучший" или "дешевый", призывами к покупке, информацией о цене, расширенной гарантии или бесплатной доставке, сведениями о состоянии или совместимости товара. Сюда же относятся водяные знаки с любой рекламной информацией, включая название или логотип продавца, даже если они не закрывают товар.
    • Изображения с элементами, из-за которых товар не видно, например водяные знаки, логотипы и названия брендов.
    • Изображения в рамке.
    • Изображения неполного комплекта товаров.
    • Изображения нескольких товаров из мультиупаковки вместо одного.
    • Отсутствие изображения или замещающие картинки на целевых страницах.

  • Цвет, узор и материал товара на фотографии должны соответствовать значениям атрибутов "цвет" [color], "узор" [pattern] и "материал" [material], иначе товар может быть отклонен.

Рекомендации

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

  • На основном изображении должен быть представлен общий вид товара. Дополнительные фотографии, например те, на которых он показан с других ракурсов, нужно добавлять с помощью атрибута "ссылка на дополнительное изображение" [additional_image_link].

Форматирование

  • Допускаются следующие форматы: GIF без анимации (.gif), JPEG/JPG (.jpg/.jpeg), PNG (.png), BMP (.bmp) и TIF/TIFF (.tif/.tiff). Расширение файла должно соответствовать используемому формату.
  • Допустимые URL-протоколы: http и https. Символы следует заменять соответствующими кодами (например, вместо запятой нужно использовать %2C).
  • Мы настоятельно рекомендуем указывать для изображения постоянный URL и обновлять его, только если фотография товара изменилась. Это условие особенно важно для изображений, размещенных в сети доставки контента (CDN) – его соблюдение гарантирует их корректное сканирование.

Кадрирование

По умолчанию изображения кадрируются автоматически.

Состояние [condition]

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

Атрибут может иметь одно из трех значений:

  • Новый [new] – товар новый и никогда не использовался, находится в оригинальной нераспечатанной упаковке.
  • Восстановленный [refurbished] – товар не новый, но был приведен в исправное состояние и продается с гарантией. Упаковка может быть как оригинальной, так и неоригинальной.
  • Б/у [used] – для всех случаев, когда два предыдущих значения не подходят, например при описании ранее использованных товаров, а также предметов без оригинальной упаковки или со вскрытой оригинальной упаковкой. Кроме того, это значение всегда присваивается заправленным картриджам для принтеров.

Когда использовать. Этот атрибут обязателен для бывших в употреблении и восстановленных товаров. Для новых товаров он необязателен.

Content API v2 (JSON): "condition": "б/у"

Content API v2 (XML): <condition>б/у</condition>

Тип

Допускается три значения:

  • новый [new]
  • Refurbished [refurbished]
  • Used [used]
Текст (TSV) used
XML <g:condition>used</g:condition>

Примечание. Названия и значения атрибутов должны быть на одном языке.

Код GTIN [gtin] – уникальный международный идентификатор товара

Атрибут "код GTIN" должен содержать международный код маркировки и учета логистических единиц в одном из следующих форматов:

  • UPC или GTIN-12 (в Северной Америке) – 12-значный номер. Восьмизначные идентификаторы UPC-E необходимо конвертировать в 12-значные UPC-A.
  • EAN или GTIN-13 (в Европе) – 13-значный номер.
  • JAN или GTIN-13 (в Японии) – 8- или 13-значный номер.
  • ISBN (для книг) – 10- или 13-значный номер. Если у вас есть только идентификатор ISBN-10, его нужно конвертировать в формат ISBN-13. Если известны оба номера, укажите только 13-значный.
  • ITF-14 или GTIN-14 (для мультиупаковок) – 14-значный номер.
Когда использовать Атрибут обязателен для всех новых товаров, у которых есть код GTIN
Тип 8-, 12-, 13- или 14-значный номер (UPC, EAN, JAN или ISBN)
Ограничение на количество символов 50
Текст (разделитель – табуляция) 3234567890126
XML (источники данных) <g:gtin>3234567890126</g:gtin>

Важно!

  • Указывать можно только коды GTIN, которые соответствуют требованиям, подготовленным организацией GS1, то есть:
    • содержат верную контрольную цифру;
    • не включают коды запрещенных к продаже товаров (префиксы 2, 02, 04);
    • не включают коды купонов (префиксы 98-99).

Бренд [brand]

Атрибут обязателен для всех новых товаров, за исключением фильмов, книг и музыки. Для товаров других категорий он необязателен.

Content API v2 (JSON): "brand": "Acme"

Content API v2 (XML): <brand>Acme</brand>

Тип Текст
Ограничение на количество символов 70
Текст (TSV) Acme
XML (источники данных) <g:brand>Acme</g:brand>


Примечание. Не указывайте в этом атрибуте название магазина. Исключение составляют случаи, когда вы сами производите товар.

Обязательные атрибуты класса энергоэффективности (только в ЕС)

Атрибуты "класс энергоэффективности" [energy_efficiency_class], "минимальный класс энергоэффективности" [min_energy_efficiency_class] и "максимальный класс энергоэффективности" [max_energy_efficiency_class] относятся к необязательным, но их нужно указывать, если этого требует местное законодательство. Например, это может быть необходимо для товарных объявлений с таргетингом на страны ЕС, Великобританию или Швейцарию, где действует Директива 2017/1369.

Атрибуты "класс энергоэффективности" [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>

Важно!

Рекомендуемые атрибуты для исключения кампаний

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

Благодаря атрибуту исключенные кампании [excluded_destination] можно исключить отдельные товары из рекламы определенного типа, например из товарных объявлений или местных предложений.

Когда использовать. Если вы хотите, чтобы ваши позиции не появлялись в объявлениях определенного типа.

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

Примечание. Мы обновили названия некоторых целевых сервисов. Раньше вы могли указывать следующие значения: "Прямые покупки" [Shopping_Actions], "на разных платформах Google" [Surfaces_across_Google] и "местная реклама на разных платформах Google" [Local_surfaces_across_Google]. Добавлять их по-прежнему можно. Однако мы рекомендуем использовать новые значения: "бесплатные предложения" [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>

Подробнее о том, как оформлять сведения о товарах для Content API for Shopping…

Атрибуты для устаревших источников данных о местном ассортименте (необязательные)

Примечание. Информация из этого раздела применима только к устаревшим типам источников данных о местном ассортименте.

Идентификатор для сопоставления [webitemid]

Если вы не можете сопоставлять товары из источников данных о товарах и местном ассортименте по атрибуту идентификатор [id], используйте атрибут "идентификатор для сопоставления". Значения атрибута "идентификатор" у одинаковых товаров в двух источниках будут различаться, а значения атрибута "идентификатор для сопоставления" – совпадать.

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

Когда использовать. Атрибут рекомендуется для всех товаров, у которых не совпадают идентификаторы/SKU в местном и онлайн-ассортименте.

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

Важно!

  • Пробелы в начале и в конце текста, а также символы возврата каретки (0x0D) нужно удалять.
  • Сочетание символа возврата каретки (0x0D) и символа пробела по стандарту Unicode нужно заменять одинарным пробелом (0x20).
  • Разрешается использовать только допустимые символы Unicode. Исключение составляют следующие знаки:
    • управляющие символы, кроме символа возврата каретки (0x0D);
    • функциональные символы;
    • символы частного использования;
    • суррогатные пары;
    • неназначенные кодовые точки, в том числе все кодовые точки выше 0x10FFFF.
  • Значение атрибута "идентификатор для сопоставления" [webitemid] уже добавленного товара нельзя изменить или использовать для другой позиции.

Код GTIN [gtin] – уникальный международный идентификатор товара

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

Когда использовать. Если вам нужно сопоставить данные о товарах, которые вы продаете офлайн и онлайн, но это нельзя сделать с помощью атрибута идентификатор [id]. Вам понадобятся идентификаторы для сопоставления [webitemid] или уникальные идентификаторы товаров, например GTIN.

Если вы используете уникальные идентификаторы, вам также потребуется добавить в источник данных атрибут "состояние".

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

Код производителя товара [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]

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

Когда использовать. Атрибут обязателен для товаров с таргетингом на Бразилию, Великобританию, Германию, США, Францию и Японию с атрибутами цвет [color], размер [size], узор [pattern], материал [material], возрастная группа [age_group], пол [gender], тип размера [size_type] и система размеров [size_system]. Для остальных стран это рекомендуемый атрибут.

Content API v2 (JSON): "itemGroupId": "AB12345"

Content API v2 (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]

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

  • Указывайте цвета в порядке преобладания (сначала основной, затем дополнительные), разделяя их косой чертой "/". Например, если вы предлагаете черные туфли с зелеными вставками, значение атрибута "цвет" должно выглядеть так: "черный/зеленый". В качестве цвета также можно указать название материала или покрытия (например, "красное дерево", "нержавеющая сталь" или "розовое золото"). Такие значения допустимы для недеформируемых товаров из категории "Одежда и аксессуары", например украшений, чей материал или покрытие также является их цветом.
  • В формате XML косая черта указывается в виде кода "#47;".

Когда использовать. Атрибут обязателен для предметов одежды в источниках данных с таргетингом на Бразилию, Великобританию, Германию, США, Францию и Японию, а также для других товаров, которые различаются по цвету. Также рекомендуется использовать атрибут, если цвет является важным отличительным признаком для товара.

Content API v2 (JSON): "color": "черный"

Content API v2 (XML): <color>черный</color>

Тип Текст
Ограничение на количество символов 100
Текст (TSV) Черный
XML (источники данных) <g:color>Черный</g:color>

Чего нельзя делать:

  • Не используйте в значениях числа, например 0 2 4 6 8.
  • Не добавляйте символы, которые не относятся к буквенно-цифровым, например #fff000.
  • Не используйте только один символ, например букву "Ж", для западных языков. Использование одного символа (например, 红) возможно только для китайского, корейского и японского языков.
  • Не используйте отсылки на фотографии, например "см. изображение".
  • Не добавляйте описательные слова, например "многоцветный", "разный", "много" "нет" и т. д.
  • Не используйте значения длиннее 40 символов.
  • Не пишите названия нескольких цветов в одно слово, например красно-розово-синий. Вот как поступать в подобных случаях:
    • Если товар разноцветный и его варианты не различаются по цвету, укажите основной цвет и до двух дополнительных. При этом разделите значения косой чертой "/". Пример: красный/розовый/голубой.
    • Если же варианты товара различаются по цвету, добавьте их в качестве отдельных позиций с одним идентификатором группы товаров. В атрибуте "цвет" укажите разные значения.

Примечания

  • Если значение нарушает перечисленные выше правила синтаксиса, Google может отклонить товар после загрузки источника данных.
  • Мы регулярно проверяем все добавленные вами атрибуты. Если мы обнаружим, что значения указаны неверно, то можем удалить все ваши товары с вкладки "Покупки".

Важно!

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

Размер [size]

Этот атрибут нужен, чтобы указать размер товара. Для товаров из категории "Одежда и аксессуары" также можно добавить дополнительные сведения с помощью атрибутов "тип размера" [size_type] и "система размеров" [size_system].

  • Для каждого товара добавьте только один атрибут "размер". Если вы укажете больше, будет применено только первое значение. Остальные мы удалим, и вы получите предупреждение.

Когда использовать. Атрибут обязателен для всех вариантов в группе товаров, которые различаются по размеру. Он также обязателен для продукции из категорий "Одежда и аксессуары > Одежда" и "Одежда и аксессуары > Обувь" с таргетингом на Бразилию, Великобританию, Германию, США, Францию и Японию. Это рекомендуемый атрибут для товаров, для которых размер является важным отличительным признаком.

Content API v2 (JSON): "sizes": ["XL"]

Content API v2 (XML): <size>XL</size>

Тип

Текст

Для товаров с таргетингом на США используйте поддерживаемые значения.

Для всех других стран используйте эти примеры.
Ограничение на количество символов 100
Текст (TSV) XL
XML (источники данных) <g:size>XL</g:size>

Важно!

  • Если варианты товара различаются по размеру, их нужно загрузить в виде отдельных позиций, но с общим для всей группы значением атрибута "идентификатор группы товаров". Подробнее о том, как рекламировать одежду и аксессуары…
  • Составные размеры нужно объединять в одно значение. Пример: "41/86 – высокий" для размера воротника 41 см, длины рукава 86 см и роста "высокий".
  • Указывайте размеры в едином формате при описании вариантов одного и того же товара или позиций одной категории. Например, размеры для группы футболок должны выглядеть так: S, M и L, а не S, Medium и Lrg.
  • Для разных размеров одного товара можно загрузить одно и то же изображение. В то же время мы рекомендуем добавлять в атрибут "ссылка" [link] URL страниц с полной информацией об определенном варианте товара.
  • Значения, которые вы указываете, могут быть видны пользователям и должны быть понятными для них.
  • Если есть дополнительные сведения о размере, добавьте их в текстовую строку. Например, для американского товара можно указать "3,5 для детей" или "3,5 для маленьких детей"
  • Если товар подходит для всех, укажите одно из следующих значений: 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 короткий", "30 обычный", "30 длинный".

Обувь

  • Для США: 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 M, 8 W, 12 N.

Пол [gender]

Когда использовать. Атрибут обязателен для всех вариантов в группах товаров, предназначенных для потребителей разного пола, а также для предметов одежды в источниках данных с таргетингом на Бразилию, Великобританию, Германию, США, Францию и Японию. Также атрибут рекомендуется использовать, если пол является важным отличительным признаком для товара.
Content API v2 (JSON) "gender": "male" Content API v2 (XML) <gender>male</gender>
Формат

Допускается три значения:

  • male;
  • female;
  • unisex.
Текст (TSV) male
XML (источники данных) <g:gender>male</g:gender>

Важно!

  • Названия и значения атрибутов должны быть на одном языке.
  • Это рекомендуемый атрибут для некоторых товаров из категории "Одежда и аксессуары". Примеры таких подкатегорий: "Значки", "Зажимы для галстуков", "Манжеты", "Бахилы", "Шнурки для обуви", "Шпоры" и "Ремешки для часов".

Возрастная группа [age_group]

Используйте атрибут, чтобы указать демографическую группу товара.
Когда использовать. Этот атрибут обязателен для предметов одежды в источниках данных с таргетингом на Бразилию, Великобританию, Германию, США, Францию и Японию, а также для других товаров, предназначенных для потребителей разных возрастов. Кроме того, это рекомендуемый атрибут для товаров, для которых возрастная категория является важным отличительным признаком.
Content API v2 (JSON): "ageGroup": "взрослые"

Content API v2 (XML): <age_group>взрослые</age_group>

Формат

Допускается пять значений:

  • newborn;
  • infant;
  • toddler;
  • kids;
  • adult.
Текст (TSV) adult
XML (источники данных) <g:age_group>adult</g:age_group>

Важно!

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

Атрибуты с данными о ценах (необязательные)

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

"Цена" [price] – цена по умолчанию в этой стране

Добавьте этот атрибут, если цена товара одинакова во всех ваших магазинах или вы используете страницы товаров с данными о наличии в магазинах.

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

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

Примечание. Валюта зависит от страны, где располагается ваш магазин. Валюту на уровне товара необходимо задавать согласно стандарту ISO 4217.

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

Тип Цена (число с плавающей точкой)
Текст (TSV) 29999.00 RUB
XML-формат (фиды) <g:price>299.99</g:price>

Цена со скидкой [sale_price]

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

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

Когда использовать. Рекомендуем добавлять этот атрибут ко всем товарам, включенным в распродажи.

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

Срок действия скидки [sale_price_effective_date]

Добавьте этот атрибут, чтобы указать, когда перестанет действовать цена из атрибута "цена со скидкой" [sale_price].

Примечание. Указывать часовой пояс необязательно. Если вы решите его добавить, используйте такой формат: + или - количество часов и минут до или после всемирного координированного времени (UTC). Пример для тихоокеанского стандартного времени: -08:00. Если вы не добавите часовой пояс, система по умолчанию применит формат UTC для каждого магазина. Время необходимо указать в 24-часовом формате.
Тип Дата начала и дата окончания должны быть разделены косой чертой "/" и оформлены по стандарту ISO 8601: дата в формате ГГГГ-ММ-ДД, затем латинская T, затем точное время начала/окончания действия скидки и часовой пояс. Дата окончания должна иметь такой же формат. Если вы не добавите часовой пояс, система посчитает, что время указано в формате UTC.
Текст (TSV)

Всемирное координированное время: 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.5 kg
Пример (для фидов в формате XML) <g:unit_pricing_measure>1.5kg</g:unit_pricing_measure>

Базовое количество товара [unit_pricing_base_measure]

В этом атрибуте указывается базовая единица, за которую рассчитывается цена товара, например 100 мл. Чтобы в объявлении отображалась цена за базовую единицу товара, вместе с атрибутом количество единицы товара [unit_pricing_measure] добавьте также атрибут "базовое количество товара" [unit_pricing_base_measure]. Обратите внимание, что базовое количество товара, которое показывается в объявлении, может отличаться от того, что представлено в вашем источнике данных. Это иногда нужно, чтобы пользователям было удобнее сравнить предложения на странице.

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

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

Атрибуты со сведениями о самовывозе (необязательные)

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

Возможность самовывоза [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]: товар можно забрать через два дня после оформления заказа.
  • 3 дня [3-day]: товар можно забрать через три дня после оформления заказа.
  • 4 дня [4-day]: товар можно забрать через четыре дня после оформления заказа.
  • 5 дней [5-day]: товар можно забрать через пять дней после оформления заказа.
  • 6 дней [6-day]: товар можно забрать через шесть дней после оформления заказа.
  • 7 дней [7-day]: товар можно забрать через семь дней после оформления заказа.
  • Больше чем через неделю [multi-week]: товар можно забрать более чем через неделю после оформления заказа.
Тип Текст (текстовая строка). Допускаются только значения, перечисленные выше.
Текст (TSV) same_day
XML-формат (фиды) <g:pickup_sla>same_day</g:pickup_sla>

Атрибуты для страниц товара с данными о наличии и цене (необязательные)

Чтобы использовать страницы товаров в магазине с данными о наличии и цене, добавьте в основной источник данных атрибуты переадресация в объявлениях [ads_redirect] и "ссылка на витрину магазина у продавца" [link_template]. Если страница с витриной оптимизирована для мобильных устройств, можно также добавить необязательный атрибут "мобильная ссылка на витрину магазина у продавца" [mobile_link_template].

Ссылка [link]

Если в вашем аккаунте включены страницы товаров с данными о наличии в магазинах, то при нажатии на объявление или бесплатное местное предложение пользователь будет перенаправлен на целевую страницу товара. Атрибут ссылка [link] позволяет указать URL этой страницы.

Важно!

  • Используйте подтвержденное доменное имя.
  • В URL нужно включить префикс 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]

Если в вашем аккаунте включены страницы товаров с данными о наличии и ценах, то при нажатии на объявление или бесплатное местное предложение пользователь будет перенаправлен на целевую страницу товара. Атрибут "ссылка на витрину магазина у продавца" [link_template] позволяет указать URL этой страницы.

Важно!

Тип 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.
  • Подтвердите URL своего сайта и заявите на него права. Затем проверьте, совпадает ли домен сайта, зарегистрированного в Merchant Center, с доменом, который указан в атрибуте "ссылка на витрину магазина у продавца" [link_template]. Если домены не совпадают, исправьте эту проблему.
  • Добавлять в ссылку параметры отслеживания не нужно: укажите их в атрибуте переадресация в объявлениях [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.
  • Подтвердите URL своего сайта и заявите на него права. Затем проверьте, совпадает ли домен сайта, зарегистрированного в Merchant Center, с доменом, который указан в атрибуте "ссылка на витрину магазина у продавца". Если домены не совпадают, исправьте эту проблему.
  • Если атрибут переадресация в объявлениях [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>

Другие необязательные атрибуты

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

Эта информация оказалась полезной?

Как можно улучшить эту статью?

Требуется помощь?

Попробуйте следующее:

Опубликовать на справочном форуме Получите ответы от участников сообщества
Связаться с нами Расскажите о своей проблеме нашим сотрудникам
true
Поиск
Очистить поле поиска
Закрыть поиск
Приложения Google
Главное меню
1395893078329572248
true
Поиск по Справочному центру
true
true
true
true
true
71525
false
false
false
false