Процесс подключение к онлайн торговому центру BСС Mall через Google Feed
Общие требования к фиду
| Формат | Google RSS 2.0. (Ссылка на спецификацию от Google Merchant Center) |
| Размер | Не должен превышать – 1 ГБ или 100 тысяч товаров |
| Аутентификация | Поддерживаются:
|
Содержимое — таблица тэгов фида
Таблица с описанием тэгов фида, используемых в BCC Mall.
| Тэг | Краткое описание | Подробное описание и рекомендации |
|---|---|---|
| Основные поля | ||
| g:id | Уникальный ID-товара. | Данный атрибут должен быть статичным в рамках обновления фида. Важно: если вы отправляете под ID товар “Adidas yeezy 500“, то при обновлении фида данный ID не должен изменяться (то есть, нельзя отправлять под данным ID иной товар) |
| g:title | Название товара. | Рекомендация: в названии товара лучше указывать необходимые данные для клиента и без лишних данных (о доставке, о городе и т.д.) Пример отправки заголовка: “Yeezy 500 limited edition“ |
| g:description | Описание товара с его основными характеристиками | Рекомендация: в описании товара лучше отправлять полное описание по товару, а характеристики товара лучше передавать в атрибуте <g:product_detail> |
| g:link | URL на страницу товара. | |
| g:image_link | URL на основную картинку товара. | Данный атрибут нужен для того, чтобы мы могли показать покупателю картинку товара. В случае если ссылка является нерабочей (404 ошибка), то в данном случае проставляется заглушка с текстом (Фото временно недоступно). |
| g:availability | Наличие товара. | Данный атрибут необходим для понимания доступности товара. В случае если товара уже нет в наличии у мерчанта, то необходимо передавать значение “out_of_stock“. (тогда в карточке товара появляется текст “Товара нет в наличии“) По данной причине необходимо держать feed-ы актуальными и чаще обновлять со стороны мерчанта. Доступные значения:
|
| g:price | Цена товара. | Изначальная цена товара. В случае наличия скидки, необходимо скидочную цену отправлять в атрибуте “sale_price“. Формат отправки цены: 9 999.0 KZT (указание валюты необязательно) |
| g:size | Размер. | В данном атрибуте отправляется значение размера товара. Рекомендация: для удобства выбора покупателя, желательно отправлять размер в рамках СНГ значений. Где для обуви используются цифры (39, 40, 41 и т.д.), а для одежды буквы (S, M, L и т.д.). Важно:
|
| g:size_system | Системы измерения (страна). | В данном атрибуте отправляется значение системы измерения размера. Доступные значения:
|
| g:product_type | Категория. | В данном атрибуте отправляется "категория" и "подкатегория" товара на стороне мерчанта. В данном теге необходимо передавать полное дерево категорий. Разделителем может быть запятая или знак больше ("," или ">"). Пример: Одежда > Верхняя одежда > Куртки > Ветровки |
| g:color | Цвет. | В данном атрибуте необходимо передавать значение "цвета" товара. Рекомендация: отправлять значение цвета на "русском языке" |
| g:additional_image_link | Массив с дополнительными картинками товара. | В данный атрибут отправляются дополнительные фотографии товара. Пример отправки нескольких фотографий: <g:additional_image_link>...</g:additional_image_link> (повторяется для каждой фотографии). По каждому товару необходимо не менее 3х дополнительных фото. |
| g:age_group | Возрастная группа. | В данном атрибуте отправляется возрастная категория товара. Возможные значения для передачи:
|
| g:gender | Пол. | В данном атрибуте отправляется значение пола, к которому относится товар. Доступные значения:
|
| g:item_group_id | ID группы товаров. | В данном атрибуте необходимо передавать ID, в рамках которого объединены 2 или более товаров. Важно: данный атрибут обязателен, если у товара имеется несколько размеров и цветов, для того чтобы покупатель смог выбрать нужный "размер" или "цвет". |
| g:brand | Бренд товара. | В данном атрибуте отправляется бренд товара. Наименование бренда на стороне BCC Mall выделяется в предпросмотре и в карточке товара. Пример отправки бренда: <g:brand>Apple</g:brand> |
| g:sale_price | Акционная/скидочная цена. | Акционная/скидочная цена, за которую сейчас мерчант продает товар. Данная цена не должна быть меньше или равна 0. |
| g:sale_price_effective_date | Период действия акционной цены. | Период времени, в течение которой действует акционная/скидочная цена. Формат отправки даты: 2023-12-31T23:59:00+0600 (ISO 8601) |
| Информация по точкам самовывоза | ||
| bnpl:pickup | Массив по адресам филиалов, в которых имеется товар | Необходимо передавать в рамках атрибута <bnpl:pickup>...</bnpl:pickup> данные по одному адресу |
| bnpl:id | ID | Уникальный ID точки самовывоза. Не должна повторяться с другими точками. Обязательное поле. |
| bnpl:region | Область | Область города. В случае, если город республиканского значения, значение может быть пустым. Условно-обязательное поле. |
| bnpl:city | Город | Точка в городе, из которого можно забрать товар. Обязательное поле. |
| bnpl:street | Улица | Улица точки в городе, из которого можно забрать товар. Обязательное поле. |
| bnpl:building | Номер здания | Номер здания в адресе. Обязательное поле. |
| bnpl:apartment | Номер офиса | Номер офиса, если есть. Необязательное поле. |
| bnpl:available | Признак наличия | Признак наличия товара в этой точке для самовывоза. Обязательное поле. Доступные значения: yes, no |
Пример оформления фида
<?xml version="1.0"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
<channel>
<item>
<g:id>100555</g:id>
<g:title>Название товара</g:title>
<g:description>
<![CDATA[
Это описание товара.
]]>
</g:description>
<g:link>https://example.com/link-to-product-page</g:link>
<g:image_link>https://example.com/images/main-image.jpg</g:image_link>
<g:availability>In stock</g:availability>
<g:price>9999</g:price>
<g:size>M</g:size>
<g:size_system>EU</g:size_system>
<g:product_type>Книги > Изучение языков > Какая-то литература</g:product_type>
<g:color>White</g:color>
<g:additional_image_link>https://example.com/images/additional-image-1.jpg</g:additional_image_link>
<g:additional_image_link>https://example.com/images/additional-image-2.jpg</g:additional_image_link>
<g:age_group>kids</g:age_group>
<g:gender>male</g:gender>
<g:item_group_id>100554</g:item_group_id>
<g:brand>Apple</g:brand>
<g:sale_price>9 899.0 KZT</g:sale_price>
<g:sale_price_effective_date>2023–09–25T00:00:00+0600/2023–09–30T23:59:00+0600</g:sale_price_effective_date>
<!--Точки самовывоза товара-->
<bnpl:pickup>
<bnpl:id>1</bnpl:id>
<bnpl:region>Акмолинская область</bnpl:region>
<bnpl:city>Кокшетау</bnpl:city>
<bnpl:street>Абая 1</bnpl:street>
<bnpl:building>100</bnpl:building>
<bnpl:apartment>1</bnpl:apartment>
<bnpl:available>yes</bnpl:available>
</bnpl:pickup>
<bnpl:pickup>
<bnpl:id>2</bnpl:id>
<bnpl:region></bnpl:region>
<bnpl:city>Алматы</bnpl:city>
<bnpl:street>Абая 1</bnpl:street>
<bnpl:building>100</bnpl:building>
<bnpl:apartment></bnpl:apartment>
<bnpl:available>no</bnpl:available>
</bnpl:pickup>
<!--Точки самовывоза товара-->
</item>
</channel>
</rss>