Описание
Для автоматизации импорта товаров в систему AstraFit.Assistant с помощью AstraFit.Tags (аналог Open Graph Protocol, og: теги) необходимо в html-коде раздела <head> страницы товара разместить необходимые теги (далее Теги), которые будут считываться при посещении данной страницы посетителями Сайта.
Импорт происходит посредством считывания Тегов с тела страницы и автоматического добавления товаров в кабинет Assistant.
Каждый раз, когда посетители Сайта будут открывать страницу с товаром, будет отправляться запрос на проверку существования товара в системе AstraFit.Assistant. Если система AstraFit вернет ответ, что таковой товар отсутствует или не обновлялся в течении необходимого количества времени, то будут автоматически отправлен запрос с данными, прочитанными из Тегов страницы Сайта.
Данные представлены в виде объектов и их свойств с атрибутами.
Служба технической поддержки
По всем техническим вопросам следует обращаться по адресу: support@astrafit.com
Структура мета данных:
<meta property="af:item:some_one" content="Foo Bar"/>
| <meta property="…"/> |
Тег с метаданными |
| af: |
Аббревиатура префикс_=B0 “AstraFit” |
| item: |
Объект “item” |
| some_one |
Свойство “some_one” объекта “item” |
| content="Foo Bar" |
Значение свойства “some_one” объекта “item” |
Пример представления объекта “item” в виде массива данных состоящих из мета-тегов
<html> <head> <title>Страница товара</title> <meta property="af:item:sku" content="MH-15008"/> <meta property="af:item:url" content="http://modahunt.com.ua/catalog/casualua-mh-15008"/> <meta property="af:item:picture" content="http://modahunt.com.ua/uploads/large/cce0702a59b60df1f98800c8eabf5ef96f63d18a.jpg"/> <meta property="af:item:picture" content="http://modahunt.com.ua/uploads/large/90e3a2826bd3a0512eaea3b148fb987a1291810d.jpg"/> <meta property="af:item:picture" content="http://modahunt.com.ua/uploads/large/24905718aee86a57c82c5c0bc444ba5d94d86eb1.jpg"/> <meta property="af:item:vendor" content="CasualUA"/> <meta property="af:item:barcode" content="482654321098"/> <meta property="af:item:description" content="Майка CasualUA MH-15008"/> <meta property="af:item:country_of_origin" content="Украина"/> <meta property="af:item:type_prefix" content="Майка"/> <meta property="af:item:category" content="Женские майки"/> <meta property="af:item:gender" content="female"/> <meta property="af:item:size" content="42"/> <meta property="af:item:size:chart" content="RU"/> <meta property="af:item:size" content="44"/> <meta property="af:item:size:chart" content="RU"/> <meta property="af:item:price" content="770"/> <meta property="af:item:currency_id" content="UAH"/> </head> ... </html>
Порядок и приоритет элементов
Порядок каноничный - элементы должны идти именно в том порядке, в котором они перечислены в пункте Объект “item”.
Приоритет тегам отдается с верху вниз, при возникновении конфликтов.
Количество элементов
В разделе <head> должны присутствовать все объекты с обязательными свойствами.
Если свойство может иметь несколько значений, например несколько картинок или несколько размеров, просто поставьте несколько таких тегов <meta> на странице .
Имена свойств объекта “item”
Для описания имен свойств объектов мы используем спецификацию формата YML (Яндекс Маркет) Для категории “Одежда, обувь и аксессуары”.
Детальнее можно ознакомится, используя источник: https://yandex.ru/support/partnermarket/guides/clothes.xml
Внимание!
Недопустимо использование символа "пробел" в имени и свойствах объекта.
Все значения данных в элементах должны использовать маскирование сущностей для символов, перечисленных в таблице ниже:
|
Символ |
Маскирование |
|
& (амперсанд) |
& |
|
' (одинарные кавычки) |
' |
|
" (двойные кавычки) |
" |
|
> (больше) |
> |
|
< (меньше) |
< |
Стиль написания свойств объектов
Используемый стиль snake_case, при котором несколько слов разделяются символом подчеркивания, каждое слово пишется с маленькой буквы.
Например, свойство typePrefix при переводе в стиль snake_case будет имеет следующий вид: type_prefix.
Объект “item”
|
Cвойства объекта |
Тип объекта |
Описание |
| af:item:sku REQUIRED |
String |
Внутренний уникальный артикул или код товара. |
| af:item:url REQUIRED |
URL |
URL объекта, который выступает в качестве канонического URL. |
| af:item:picture REQUIRED |
String |
URL-адрес изображения. |
| af:item:vendor REQUIRED |
String |
Производитель. |
| af:item:vendor_сode |
String |
Артикул товара, указанный производителем. |
| af:item:barcode |
String |
Штрихкод товара, указанный производителем. |
| af:item:country_of_origin |
String |
Свойство предназначено для указания страны производства товара. |
| af:item:material |
String |
Необходимо кратко указать состав ткани (или нескольких тканей), например: cotton 60%, wool 40% |
| af:item:type_prefix REQUIRED |
String |
Тип товара (краткое представление), например: “платье”, “футболка”, “джинсы” и т.д. |
| af:item:gender REQUIRED |
String |
Гендерный признак категории товара (мужская рубашка, женская рубашка).
|
| af:item:category REQUIRED |
String |
Название категории, к которой принадлежит товар. |
| af:item:category:id |
String |
Внутренний идентификатор категории в системах учета товаров. |
| af:item:description |
String |
Рекомендуем указывать в описании:
|
| af:item:price |
Float |
Стоимость изделия. |
| af:item:currency_id |
Sting |
Трехбуквенный код валюты магазина, согласно международного стандарта: |
| af:item:size REQUIRED |
String |
Размер товара, например: “42”, “XL”, ”1Y”. |
| af:item:size:chart |
Enum |
Размерная сетка по странам. Используемый формат ISO 3166-1 alpha-2:
|
| af:item:size:color |
String |
Цвет товара. |
| af:item:size:barcode |
String |
Штрих код размера. |
| af:item:size:url |
URL |
В случае если размер товара имеет другой URL. |
| af:item:size:available |
Boolean |
Наличие размера: “false”, “true” или “0”, “1” |
0 Комментарии