Фид данных о местном ассортименте – это список товаров, которые продаются в каждом из ваших магазинов, и атрибутов со сведениями об этих позициях. Одни атрибуты должны быть обязательно указаны для всех товаров, другие – только для продукции определенного типа, а третьи являются рекомендованными, но необязательными.
Сведения о цене и наличии позиций в магазинах время от времени меняются. Можно увеличить частоту обновления фида ассортимента. Если у вас возникнут сложности, обратитесь в службу поддержки. Также учитывайте, что процесс синхронизации адресов компании с аккаунтом Merchant Center может занимать до 24 часов, поэтому рекомендуем загружать фид ассортимента через 24 часа после связывания аккаунтов или после изменения или обновления кода магазина в профилях компании.
О том, как загружать сведения о товарах с помощью Content API, написано на этой странице.
Как загрузить фид ассортимента местных товаров
Поддерживаемые типы файлов. Фид ассортимента местных товаров можно загрузить в виде текстового файла с разделителем-табуляцией, XML-файла или через API.
Создание фида. Чтобы создать и зарегистрировать фид ассортимента местных товаров, следуйте этим инструкциям.
Важная информация. В зависимости от того, в каком формате вы загружаете фид, атрибуты, названия которых состоят более чем из одного слова, нужно оформлять по-разному.
- Текст с разделителем. Используйте в названиях атрибутов пробелы. Если атрибут содержит символы подчеркивания ("_"), замените их на пробелы.
- API для XML и JSON. Разделяйте слова символами подчеркивания. После отправки файла вместо них будут поставлены пробелы. Подробнее…
Таблица требований к атрибутам
Атрибут | Требования | |
---|---|---|
Обязательные атрибуты с информацией об ассортименте |
Код магазина |
Это обязательные атрибуты для всех товаров. Примечание. Атрибут "код магазина" |
Необязательные атрибуты с информацией об ассортименте |
Срок действия скидки Количество |
Эти атрибуты содержат информацию о цене и количестве товара и возможности доставки в день заказа. Их рекомендуется добавлять в сведения о каждом товаре. Если это стандартная для страны цена, указывать ее необязательно, но если цены в отдельных магазинах различаются, то атрибут будет обязательным. |
Необязательные атрибуты с информацией о самовывозе из магазина |
Возможность самовывоза Дата самовывоза |
Эти атрибуты рекомендуется добавлять в сведения о тех товарах, для которых возможен самовывоз. Важно! С 1 сентября 2024 года указывать атрибут "возможность самовывоза" |
Необязательные атрибуты с информацией о местной доставке | Ярлык местной доставки [local shipping label] |
Эти атрибуты необходимо добавить, если вы хотите разрешить доставку в день заказа только для определенных товаров, представленных в отдельном магазине. |
Обязательные атрибуты с информацией об ассортименте
Эти атрибуты содержат основные данные о товарах, которые представлены в определенных магазинах.
[store_code]
(идентификатор магазина в профиле компании)
Уникальный буквенно-цифровой идентификатор, присваиваемый каждому магазину. Атрибут указывается с учетом регистра и должен совпадать с информацией в вашем профиле компании.
Когда использовать. Этот атрибут обязателен для всех товаров.
Тип | Текст (текстовая строка) |
Текст (TSV) | Магазин123 |
XML-формат (фиды) | <g:store_code>Магазин123</g:store_code> |
[id]
Уникальный буквенно-цифровой идентификатор товара, действующий во всех ваших магазинах.
Если вы продаете товар в разных магазинах, используйте для него один и тот же идентификатор. Необходимо использовать одно значение атрибута "идентификатор" [id]
для одного магазина. Чтобы указать, доступен ли в нем товар, добавьте атрибут "наличие" [availability]
.
Если у вас несколько фидов одного типа с таргетингом на определенную страну, идентификаторы товаров не должны повторяться. В качестве значения атрибута можно использовать коды SKU, но только если они не повторяются и соответствуют требованиям ниже.
Когда использовать. Этот атрибут обязателен для всех товаров.
Тип | Текст (текстовая строка) |
Текст (TSV) | 421486 |
XML-формат (фиды) | <g:id>421486</g:id> |
Важно!
- Идентификаторы в фиде данных о местном ассортименте должны совпадать с теми, которые указаны в основном фиде.
- Пробелы в начале и в конце текста, а также символы возврата каретки (0x0D) нужно удалять.
- Сочетание символа возврата каретки (0x0D) и символа пробела по стандарту Unicode нужно заменять одинарным пробелом (0x20).
- Разрешается использовать только допустимые символы Unicode. Исключение составляют следующие знаки:
- управляющие символы, кроме символа возврата каретки (0x0D);
- функциональные символы;
- символы частного использования;
- суррогатные пары;
- неназначенные кодовые точки, в том числе все кодовые точки выше 0x10FFFF.
- После добавления товара значение атрибута "идентификатор"
[id]
нельзя изменить или использовать для другой позиции. - Добавляйте только товары, которые доступны для покупки в магазинах.
[availability]
- "В наличии" [in_stock]: товар можно купить в магазине.
- "Нет в наличии" [out_of_stock]: товар недоступен для покупки в магазине.
- "Ограниченное количество" [limited_availability]: в магазине осталось всего несколько позиций товара.
- "Образец для заказа" [on_display_to_order]: товар можно заказать в магазине. Пример: холодильник, который будет доставлен со склада. Если вы используете атрибут "количество"
[quantity]
, укажите значение "1".
Тип | Текст (текстовая строка). Допустимые значения: "в наличии" [in_stock], "нет в наличии" [out_of_stock], "ограниченное количество" [limited_availability] и "образец для заказа" [on_display_to_order]. |
Текст (TSV) | in_stock |
XML-формат (фиды) | <g:availability>in_stock</g:availability> |
Необязательные атрибуты с информацией об ассортименте
Эти атрибуты содержат дополнительные данные о цене, количестве и наличии товаров.
[price]
Обычная цена вашего товара. Если вы укажете цену в фиде ассортимента и в основном фиде, то цена в первом будет иметь приоритет для связанного магазина.
Когда использовать. Этот атрибут обязателен для всех товаров.
Тип | Число (валюта указывается автоматически в зависимости от страны, где располагается магазин) |
Текст (TSV) | 299.99 |
XML-формат (фиды) | <g:price>299.99</g:price> |
[sale_price]
Временная цена со скидкой, которая показывается в объявлениях. Значение этого атрибута уникально для каждого магазина и используется вместо значения атрибута цена [price]
, указанного в этом фиде и фиде товаров местного ассортимента.
Чтобы покупатели могли узнать, в течение какого срока действует цена со скидкой, рекомендуем также добавить атрибут срок действия скидки [sale_price_effective_date]
. В противном случае цена со скидкой будет показываться, пока вы не удалите ее из фида.
Тип | Число |
Текст (TSV) | 279.99 |
XML-формат (фиды) | <g:sale_price>279.99</g:sale_price> |
[sale_price_effective_date]
с любой прошедшей датой.[sale_price_effective_date]
Диапазон дат, в течение которого действует рекламируемая цена со скидкой.
Подробнее об атрибуте "цена со скидкой" [sale_price]…
Тип | Текст (текстовая строка). Даты начала и окончания должны быть оформлены в соответствии со стандартом ISO 8601 и разделены косой чертой (/). |
Текст (TSV) |
Пример UTC: Время должно быть указано в 24-часовом формате. |
XML-формат (фиды) | <g:sale_price_effective_date>2021-07-19T09:00-0800/2021-07-26T21:00-0800</g:sale_price_effective_date> |
[quantity]
Количество товаров, имеющихся в наличии в магазине. Если товара временно нет в наличии, укажите значение "0".
Атрибут количество больше не обязателен. Вместо него для всех товаров необходимо указать значения атрибута наличие.
Тип | Целое число |
Текст (TSV) | 4 |
XML-формат (фиды) | <g:quantity>4</g:quantity> |
Важно!
- Количество от 3 товаров соответствует значению "в наличии", 1–2 товара – значению "ограниченное количество", а 0 товаров – значению "нет в наличии".
- Если вы отправляете сведения и о количестве, и о наличии, значение определяется на основе меньшего из них.
Необязательные атрибуты с информацией о самовывозе из магазина
Эти атрибуты содержат информацию об условиях самовывоза из отдельных магазинов.
Возможность самовывоза[pickup_method]
[pickup_method]
будет необязательно.С помощью этого атрибута можно указать, доступен ли самовывоз и как он осуществляется. Поддерживаются следующие значения:
- покупка [buy]: заказ оформляется и оплачивается онлайн;
- бронирование [reserve]: заказ оформляется онлайн, а оплата производится в магазине;
- доставка в магазин [ship to store]: товар оплачивается онлайн и доставляется в магазин, откуда покупатель может его забрать;
- не поддерживается [not supported]: возможность самовывоза отсутствует.
Тип | Текст (текстовая строка). Можно указать одно из следующих четырех значений:
"покупка" [buy], "бронирование" [reserve], "доставка в магазин" [ship to store] или "не поддерживается" [not supported]. |
Пример (для фидов в текстовом формате с разделителем-табуляцией) | 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]: товар можно забрать через шесть дней после оформления заказа;
- больше чем через неделю [multi-week]: товар можно забрать более чем через неделю после оформления заказа.
Тип | Текст (текстовая строка). Можно указать одно из следующих восьми значений:
"в день заказа" [same day], "на следующий день" [next day], "2 дня" [2-day], "3 дня" [3-day], "4 дня" [4-day], "5 дней" [5-day], "6 дней" [6-day] или "более чем через неделю" [multi-week] |
Пример (для фидов в текстовом формате с разделителем-табуляцией) | same day |
Пример (для фидов в формате XML) | <g:pickup_sla>same_day</g:pickup_sla> |
Необязательные атрибуты с информацией о местной доставке
Этот атрибут содержит информацию о местной доставке.
Ярлык местной доставки [local_shipping_label]
Чтобы разрешить доставку в день заказа для отдельных товаров, которые продаются в определенном магазине, нужно добавить атрибут "ярлык местной доставки" [local_shipping_label]
.
В значении атрибута нужно указать названия ярлыков доставки в день заказа, которые вы создали в настройках на уровне аккаунта. Каждый ярлык соответствует одной уникальной группе параметров и присваивается выбранным товарам.
Также вы можете задать максимальный радиус доставки (в милях или километрах) и крайний срок заказа для доставки в тот же день (определенное время или количество часов до закрытия магазина). Вы также можете указать, будут ли товары, для которых включена доставка в день заказа, доставлены на следующий день, если заказ был сделан после крайнего срока.
Этот атрибут необязателен, если доставка в день заказа доступна для всех товаров из всех магазинов или из определенного списка магазинов. Подробнее о доставке в день заказа…