АстраФит теги (AstraFit.Tags)

Описание

Для автоматизации импорта товаров в систему 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

 

Внимание!

Недопустимо использование символа "пробел" в имени и свойствах объекта.


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

Символ

Маскирование

& (амперсанд)

&amp;

'  (одинарные кавычки)

&apos;

" (двойные кавычки)

&quot;

> (больше)

&gt;

< (меньше)

&lt;

 

Стиль написания свойств объектов

Используемый стиль snake_case, при котором несколько слов разделяются символом подчеркивания, каждое слово пишется с маленькой буквы.
Например, свойство typePrefix при переводе в стиль snake_case будет имеет следующий вид: type­_prefix.

 

Объект “item”

Cвойства объекта

Тип объекта

Описание

af:item:sku
REQUIRED

String

Внутренний уникальный артикул или код товара.

af:item:url
REQUIRED

URL

URL объекта, который выступает в качестве канонического URL.
Обычно это URL страницы, на которой размещены теги свойств, например,

http://modahunt.com.ua/catalog/casualua-mh-15008
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

Гендерный признак категории товара (мужская рубашка, женская рубашка).
Корректны следующие значения:

  • male (взрослая одежда)
  • female (взрослая одежда)
  • unisex (нельзя использовать для детской одежды)
  • kids (детская одежда)
af:item:category
REQUIRED

String

Название категории, к которой принадлежит товар.

af:item:category:id

String

Внутренний идентификатор категории в системах учета товаров.

af:item:description

String

Рекомендуем указывать в описании:

  • преимущества и особенности товара;
  • основные характеристики товара;
  • способы применения товара;
af:item:price

Float

Стоимость изделия.

af:item:currency_id

Sting

Трехбуквенный код валюты магазина, согласно международного стандарта:
https://www.currency-iso.org/dam/downloads/lists/list_one.xml

af:item:size
REQUIRED

String

Размер товара, например: “42”, “XL”, ”1Y”.

af:item:size:chart

Enum

Размерная сетка по странам. Используемый формат ISO 3166-1 alpha-2:

  • AU — Австралия;
  • CN — Китай;
  • DE — Германия;
  • EU — Европа;
  • FR — Франция;
  • JP — Япония;
  • INT — международные обозначения
    (для одежды: XS, S, M, L, XL, XXL, 2XL и т. д., для бюстгальтеров: AA, A, B, C и т. д.);
  • IT — Италия;
  • MX — Мексика:
  • MY — Малайзия
  • PL — Польша;
  • PH — Филиппины;
  • RU — Россия;
  • TR — Турция;
  • UA — Украина;
  • UK — Англия;
  • US — США;
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 из 0
Еще есть вопросы? Отправить запрос

0 Комментарии

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