Тип schema.org ?
Содержание: Описание, Свойства которые можно использовать, Подходит для свойств, Примеры использования.
AggregateOffer — это тип из схемы Schema.org, который используется для представления информации о нескольких предложениях на один и тот же продукт. Этот тип полезен, когда один и тот же товар, например, обувь или электроника, предлагается разными продавцами.
Основная цель AggregateOffer — объединить данные о разных предложениях, чтобы пользователи могли видеть, какие варианты доступны, а также сравнить цены и условия. Это помогает улучшить пользовательский опыт, предоставляя информацию о том, где и по какой цене можно купить интересующий товар.
AggregateOffer обычно используется в контексте электронной коммерции и сайтов, где представлены товары от различных продавцов. При этом важно, чтобы все предложения имели одинаковую бизнес-функцию, что обычно подразумевает, что все они предназначены для продажи. Если бизнес-функция не указана, по умолчанию считается, что все предложения связаны с продажей.
Таким образом, AggregateOffer служит для структурирования информации о множественных предложениях одного товара, что облегчает покупателям процесс выбора и сравнения предложений.
Свойство | Ожидаемый тип | Описание |
---|---|---|
Свойство из AggregateOffer | ||
highPrice | Number, Text | Самая высокая цена среди всех доступных предложений. Руководство по использованию:
|
lowPrice | Number, Text | Самая низкая цена из всех доступных предложений. Руководство по использованию:
|
offerCount | Integer | Количество предложений для продукта. |
offers | Demand, Offer | Предложение предоставить этот товар — например, предложение продать продукт, арендовать DVD фильма, выполнить услугу или раздать билеты на мероприятие. Используйте businessFunction, чтобы указать вид предлагаемой транзакции, т.е. продажу, аренду и т.д. Это свойство также может быть использовано для описания Demand. Хотя это свойство указано как ожидаемое для ряда общих типов, оно может быть использовано и в других. В этом случае использование второго типа, такого как Product или подтипа Product, может прояснить природу предложения. |
Свойство из Offer | ||
acceptedPaymentMethod | PaymentMethod, LoanOrCredit | Метод(ы) оплаты, которые в целом принимаются организацией или для какого-либо конкретного запроса или предложения. |
addOn | Offer | Дополнительное предложение, которое можно получить только в сочетании с первым базовым предложением (например, добавки и расширения, доступные за дополнительную плату). |
additionalProperty | PropertyValue | Свойство-значение, представляющее дополнительную характеристику сущности, например, характеристику продукта или другую характеристику, для которой нет соответствующего свойства в schema.org. Примечание: Издатели должны учитывать, что приложения, предназначенные для использования конкретных свойств schema.org (например, https://schema.org/width, https://schema.org/color, https://schema.org/gtin13, ...), как правило, ожидают, что такие данные будут предоставлены с использованием этих свойств, а не с использованием механизма свойство/значение общего назначения. |
advanceBookingRequirement | QuantitativeValue | Количество времени, необходимое между принятием предложения и фактическим использованием ресурса или услуги. |
aggregateRating | AggregateRating | Общая оценка, основанная на совокупности отзывов или оценок, данного объекта. |
areaServed | AdministrativeArea, GeoShape, Place, Text | Географическая область, где предоставляется услуга или предлагаемый товар. |
asin | Text, URL | Amazon Standard Identification Number (ASIN) — это уникальный идентификатор из 10 алфавитно-цифровых символов, назначаемый Amazon.com и его партнерами для идентификации продуктов внутри организации Amazon (резюме из статьи Wikipedia). Также обратите внимание, что это определение того, как включать ASIN в данные Schema.org, а не определение ASIN в общем — смотрите документацию от Amazon для авторитетных деталей. ASIN чаще всего кодируются в виде текстовых строк, но свойство [asin] также поддерживает URL/URI в качестве потенциальных значений. |
availability | ItemAvailability | Доступность этого товара — например, В наличии, Нет в наличии, Предзаказ и т.д. |
availabilityEnds | Date, Time, DateTime | Конец доступности продукта или услуги, включенного в предложение. |
availabilityStarts | Date, DateTime, Time | Начало доступности продукта или услуги, включенного в предложение. |
availableAtOrFrom | Place | Место(а), откуда можно получить предложение (например, адреса магазинов). |
availableDeliveryMethod | DeliveryMethod | Метод(ы) доставки, доступный(е) для этого предложения. |
businessFunction | BusinessFunction | Бизнес-функция (например, продажа, аренда, ремонт, утилизация) предложения или компонента пакета (TypeAndQuantityNode). По умолчанию используется http://purl.org/goodrelations/v1#Sell. |
category | PhysicalActivityCategory, Text, Thing, URL, CategoryCode | Категория для элемента. Большие знаки или косые черты могут быть использованы для неформального указания иерархии категорий. |
checkoutPageURLTemplate | Text | Шаблон URL (RFC 6570) для страницы оформления заказа для предложения. Этот подход позволяет продавцам указать URL для онлайн-оформления заказа на предлагаемый продукт, интерполируя параметры, такие как идентификатор вошедшего пользователя, идентификатор продукта, количество, код скидки и т. д. Именование параметров и стандартизация здесь не указаны. |
deliveryLeadTime | QuantitativeValue | Типичное время задержки между получением заказа и отправкой товара из склада или его подготовкой к самовывозу, если способ доставки — самовывоз. |
eligibleCustomerType | BusinessEntityType | Тип(ы) клиентов, для которых данное предложение действительно. |
eligibleDuration | QuantitativeValue | Продолжительность, в течение которой данное предложение действительно. |
eligibleQuantity | QuantitativeValue | Интервал и единица измерения заказных количеств, для которых предложение или спецификация цены действительны. Это позволяет, например, указать, что определенная плата за груз действительна только для определенного количества. |
eligibleRegion | GeoShape, Place, Text | Код ISO 3166-1 (ISO 3166-1 alpha-2) или код ISO 3166-2, место или GeoShape для геополитической области(ей), для которых предложение или спецификация стоимости доставки действительны. См. также ineligibleRegion. |
eligibleTransactionVolume | PriceSpecification | Объем транзакций, в денежной единице, для которого предложение или спецификация цены действительны, например, для указания минимального объема покупки, для выражения бесплатной доставки при определенном объеме заказа или для ограничения приема кредитных карт на покупки на определенную минимальную сумму. |
gtin | Text, URL | Глобальный номер торгового товара (GTIN). GTIN идентифицирует торговые товары, включая продукты и услуги, с помощью числовых идентификационных кодов. Корректное значение gtin должно быть действительным GTIN, что означает, что это должна быть строка, состоящая только из цифр, длиной 8, 12, 13 или 14 цифр, или URL "GS1 Digital Link", основанный на такой строке. Числовая часть также должна иметь действительную контрольную цифру GS1 и соответствовать другим правилам для действительных GTIN. См. также Сводка GTIN от GS1 и Wikipedia для получения дополнительных деталей. Дополнительные нули слева для значений gtin не требуются и не рекомендуются. Свойство gtin обобщает более ранние свойства gtin8, gtin12, gtin13 и gtin14. Спецификации цифровых ссылок GS1 выражают GTIN как URL (URI, IRI и т.д.). Цифровые ссылки должны быть заполнены в атрибут hasGS1DigitalLink. Обратите внимание, что это определение того, как включать GTIN в данные Schema.org, а не определение GTIN в общем - см. документацию GS1 для получения авторитетных деталей. |
gtin12 | Text | Код GTIN-12 продукта или продукта, к которому относится предложение. GTIN-12 — это 12-значный идентификационный ключ GS1, состоящий из префикса компании U.P.C., ссылки на товар и контрольной цифры, используемый для идентификации торговых товаров. См. GS1 GTIN Summary для получения дополнительной информации. |
gtin13 | Text | Код GTIN-13 продукта или продукта, к которому относится предложение. Это эквивалентно 13-значным кодам ISBN и EAN UCC-13. Прежние 12-значные коды UPC можно преобразовать в код GTIN-13, просто добавив предшествующий ноль. См. GS1 GTIN Summary для получения дополнительных сведений. |
gtin14 | Text | GTIN-14 код продукта или продукта, к которому относится предложение. См. GS1 GTIN Summary для получения дополнительной информации. |
gtin8 | Text | Код GTIN-8 продукта или продукта, к которому относится предложение. Этот код также известен как EAN/UCC-8 или 8-значный EAN. См. GS1 GTIN Summary для получения дополнительной информации. |
hasAdultConsideration | AdultOrientedEnumeration | Используется для пометки элемента, предназначенного или подходящего для потребления или использования только взрослыми. |
hasGS1DigitalLink | URL | GS1 цифровая ссылка, связанная с объектом. Этот URL должен соответствовать определенным требованиям цифровых ссылок. Ссылка должна содержать только Идентификаторы Приложений (AI), которые имеют отношение к аннотируемой сущности, например, Продукт или Организация, и для правильной детализации. В частности, для продуктов:
|
hasMeasurement | QuantitativeValue | Измерение предмета. Например, длина внутреннего шва брюк, размер колеса велосипеда, диаметр винта или углеродный след, измеренный для сертификации органом власти. Обычно это точное измерение, но также может быть диапазон измерений для регулируемых продуктов, например, ремней и креплений для лыж. |
hasMerchantReturnPolicy | MerchantReturnPolicy | Указывает на политику возврата товара, которая может быть применима. |
includesObject | TypeAndQuantityNode | Это ссылается на узел или узлы, указывающие точное количество продуктов, включенных в Предложение или КоллекциюПродуктов. |
ineligibleRegion | GeoShape, Place, Text | Код ISO 3166-1 (ISO 3166-1 alpha-2) или ISO 3166-2, место или GeoShape для геополитического региона(ов), для которого спецификация предложения или стоимости доставки недействительна, например, регион, в котором транзакция не разрешена. Смотрите также eligibleRegion. |
inventoryLevel | QuantitativeValue | Текущий приблизительный уровень запасов для товара или товаров. |
isFamilyFriendly | Boolean | Указывает, является ли этот контент подходящим для семьи. |
itemCondition | OfferItemCondition | Предопределенное значение из OfferItemCondition, указывающее состояние продукта или услуги, или продуктов или услуг, включенных в предложение. Также используется для политик возврата продуктов, чтобы указать состояние продуктов, принимаемых для возврата. |
itemOffered | AggregateOffer, CreativeWork, Event, MenuItem, Product, Service, Trip | Предлагаемый (или запрашиваемый) предмет. Транзакционная природа предложения или запроса документируется с использованием businessFunction, например, продажа, аренда и т.д. Хотя несколько общепринятых ожидаемых типов перечислены явно в этом определении, могут использоваться и другие. Использование второго типа, такого как Product или подтипа Product, может прояснить природу предложения. |
leaseLength | QuantitativeValue, Duration | Длина аренды для некоторого жилища, либо специфичная для какого-то предложения, либо в некоторых случаях присущая самой собственности. |
mobileUrl | Text | Свойство mobileUrl предназначено для конкретных ситуаций, когда потребителям данных необходимо определить, является ли один из нескольких предоставленных URL-адресов специализированным «мобильным сайтом». Чтобы избежать чрезмерного использования и отражая первоначальные случаи использования, свойство ожидается только на Product и Offer, а не на Thing. Общая тенденция в веб-технологиях заключается в переходе к адаптивному дизайну, при котором контент может гибко адаптироваться к широкому спектру условий просмотра. Страницы и сайты, на которые ссылаются с помощью устоявшегося свойства url, в идеале также должны быть доступны на различных устройствах, включая мобильные телефоны. В большинстве случаев было бы бессмысленно и контрпродуктивно пытаться обновить все разметки url, чтобы использовать mobileUrl для более ориентированных на мобильные устройства страниц. Свойство предназначено для случаев, когда элементы (в основном Product и Offer) имеют дополнительные URL-адреса, размещенные на дополнительном «мобильном сайте» наряду с основным. Это не следует воспринимать как одобрение этого стиля публикации. |
mpn | Text | Номер детали производителя (MPN) продукта или продукта, к которому относится предложение. |
offeredBy | Organization, Person | Указатель на организацию или человека, делающего предложение. |
price | Number, Text | Цена предложения продукта или компонента цены, когда он прикреплен к PriceSpecification и его подтипам. Руководство по использованию:
|
priceCurrency | Text | Валюта цены или компонент цены, когда он прикреплен к PriceSpecification и его подтипам. Используйте стандартные форматы: ISO 4217 формат валюты, например, "USD"; Тикер для криптовалют, например, "BTC"; общеизвестные названия для Местных систем обмена валют (LETS) и других типов валют, например, "Ithaca HOUR". |
priceSpecification | PriceSpecification | Одна или несколько детализированных спецификаций цены, указывающих цену за единицу и расходы на доставку или оплату. |
priceValidUntil | Date | Дата, после которой цена больше не доступна. |
review | Review | Обзор предмета. |
seller | Organization, Person | Сущность, которая предлагает (продает / сдает в аренду / одалживает / предоставляет в кредит) услуги / товары. Продавец также может быть поставщиком. |
serialNumber | Text | Серийный номер или любой алфавитно-цифровой идентификатор конкретного продукта. Когда он прикреплён к предложению, это сокращение для серийного номера продукта, включённого в предложение. |
shippingDetails | OfferShippingDetails | Указывает информацию о политиках и вариантах доставки, связанных с Предложением. |
sku | Text | Единица учета запасов (SKU), т.е. идентификатор, специфичный для торговца, для товара или услуги, или товара, к которому относится предложение. |
validForMemberTier | MemberProgramTier | Уровень членства, для которого предложение (или спецификация цены, детали доставки предложения или политика возврата продавца в рамках предложения) является действительным. |
validFrom | Date, DateTime | Дата, когда объект становится действительным. |
validThrough | Date, DateTime | Дата, после которой элемент становится недействительным. Например, конец предложения, период зарплаты или период рабочих часов. |
warranty | WarrantyPromise | Обещание(я) гарантии, включенные в предложение. |
Свойство из Thing | ||
additionalType | URL, Text | Дополнительный тип для элемента, обычно используемый для добавления более специфичных типов из внешних словарей в синтаксисе микроданных. Это отношение между чем-то и классом, к которому это что-то относится. Обычно значение является URI-идентифицированным классом RDF, и в этом случае соответствует использованию rdf:type в RDF. Текстовые значения могут использоваться экономно, в случаях, когда полезная информация может быть добавлена без наличия соответствующей схемы для ссылки. В случае текстовых значений, метка класса должна следовать руководству по стилю schema.org. |
alternateName | Text | Псевдоним для элемента. |
description | Text, TextObject | Описание предмета. |
disambiguatingDescription | Text | Субсвойство описания. Краткое описание элемента, используемое для различения его от других, похожих элементов. Информация из других свойств (в частности, имени) может быть необходима для того, чтобы описание было полезным для различения. |
identifier | PropertyValue, Text, URL | Свойство identifier представляет собой любой вид идентификатора для любого рода Thing, такого как ISBN, коды GTIN, UUID и т.д. Schema.org предоставляет специальные свойства для представления многих из них, как в виде текстовых строк, так и в виде ссылок URL (URI). См. фоновую информацию для получения дополнительных деталей. |
image | ImageObject, URL | Изображение предмета. Это может быть URL или полностью описанный ImageObject. |
mainEntityOfPage | CreativeWork, URL | Указывает на страницу (или другое творческое произведение), для которой этот объект является основным описываемым объектом. См. фоновую информацию для получения деталей. |
name | Text | Название элемента. |
potentialAction | Action | Указывает на потенциальное действие, которое описывает идеализированное действие, в котором этот объект будет играть роль 'объекта'. |
sameAs | URL | URL страницы в Интернете, которая однозначно указывает на идентичность элемента. Например, URL страницы элемента в Википедии, запись в Викиданных или официальный сайт. |
subjectOf | CreativeWork, Event | Творческое произведение или событие, связанное с этой вещью. |
url | URL | URL предмета. |
Экземпляры AggregateOffer могут использоваться в качестве значения для следующих свойств.
Свойство | Типы | Описание |
---|---|---|
itemOffered | Offer, Demand | Предлагаемый (или запрашиваемый) предмет. Транзакционная природа предложения или запроса документируется с использованием businessFunction, например, продажа, аренда и т.д. Хотя несколько общепринятых ожидаемых типов перечислены явно в этом определении, могут использоваться и другие. Использование второго типа, такого как Product или подтипа Product, может прояснить природу предложения. |
Пример заметки или HTML разметки.
<img src="dell-30in-lcd.jpg" alt="A Dell UltraSharp monitor" />
Dell UltraSharp 30" LCD Monitor
87 out of 100 based on 24 user ratings
$1250 to $1495 from 8 sellers
Sellers:
<a href="save-a-lot-monitors.com/dell-30.html">
Save A Lot Monitors - $1250</a>
<a href="jondoe-gadgets.com/dell-30.html">
Jon Doe's Gadgets - $1350</a>
...
Пример, закодированный в формате Microdata, встроенный в HTML.
<div itemscope itemtype="https://schema.org/Product">
<img itemprop="image" src="dell-30in-lcd.jpg" alt="A Dell UltraSharp monitor"/>
<span itemprop="name">Dell UltraSharp 30" LCD Monitor</span>
<div itemprop="aggregateRating"
itemscope itemtype="https://schema.org/AggregateRating">
<span itemprop="ratingValue">87</span>
out of <span itemprop="bestRating">100</span>
based on <span itemprop="ratingCount">24</span> user ratings
</div>
<div itemprop="offers" itemscope itemtype="https://schema.org/AggregateOffer">
<meta itemprop="priceCurrency" content="USD" />
<span itemprop="lowPrice" content="1250">$1250</span>
to <span itemprop="highPrice" content="1495">$1495</span>
from <span itemprop="offerCount">8</span> sellers
Sellers:
<div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
<a itemprop="url" href="save-a-lot-monitors.com/dell-30.html">
Save A Lot Monitors - $1250</a>
</div>
<div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
<a itemprop="url" href="jondoe-gadgets.com/dell-30.html">
Jon Doe's Gadgets - $1350</a>
</div>
</div>
...
</div>
Пример, закодированный в формате RDFa, встроенный в HTML.
<div vocab="https://schema.org/" typeof="Product">
<img property="image" src="dell-30in-lcd.jpg" alt="A Dell UltraSharp monitor"> <span property="name">Dell UltraSharp 30" LCD Monitor</span>
<div property="aggregateRating" typeof="AggregateRating">
<span property="ratingValue">87</span> out of
<span property="bestRating">100</span> based on
<span property="ratingCount">24</span> user ratings
</div>
<div property="offers" typeof="AggregateOffer">
<meta property="priceCurrency" content="USD" />
<span property="lowPrice" content="1250">$1250</span> to
<span property="highPrice" content="1495">$1495</span> from
<span property="offerCount">8</span> sellers Sellers:
<div property="offers" typeof="Offer">
<a property="url" href="save-a-lot-monitors.com/dell-30.html">Save A Lot Monitors - $1250</a>
</div>
<div property="offers" typeof="Offer">
<a property="url" href="jondoe-gadgets.com/dell-30.html">Jon Doe's Gadgets - $1350</a>
</div>
...
</div>
</div>
Пример, закодированный в формате JSON-LD в теге <script> HTML.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"aggregateRating": {
"@type": "AggregateRating",
"bestRating": "100",
"ratingCount": "24",
"ratingValue": "87"
},
"image": "dell-30in-lcd.jpg",
"name": "Dell UltraSharp 30\" LCD Monitor",
"offers": {
"@type": "AggregateOffer",
"priceCurrency": "USD",
"highPrice": "1495",
"lowPrice": "1250",
"offerCount": "8",
"offers": [
{
"@type": "Offer",
"url": "save-a-lot-monitors.com/dell-30.html"
},
{
"@type": "Offer",
"url": "jondoe-gadgets.com/dell-30.html"
}
]
}
}
</script>
Структурированное представление примера JSON-LD.
Пример заметки или HTML разметки.
<a href="nba-miami-philidelphia-game3.html">
NBA Eastern Conference First Round Playoff Tickets:
Miami Heat at Philadelphia 76ers - Game 3 (Home Game 1)
</a>
Thu, 04/21/16
8:00 p.m.
<a href="wells-fargo-center.html">
Wells Fargo Center
</a>
Philadelphia, PA
Priced from: $35
1938 tickets left
Пример, закодированный в формате Microdata, встроенный в HTML.
<div itemscope itemtype="https://schema.org/Event">
<a itemprop="url" href="nba-miami-philidelphia-game3.html">
NBA Eastern Conference First Round Playoff Tickets:
<span itemprop="name"> Miami Heat at Philadelphia 76ers - Game 3 (Home Game 1) </span>
</a>
<meta itemprop="startDate" content="2016-04-21T20:00">
Thu, 04/21/16
8:00 p.m.
<div itemprop="location" itemscope itemtype="https://schema.org/Place">
<a itemprop="url" href="wells-fargo-center.html">
Wells Fargo Center
</a>
<div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
<span itemprop="addressLocality">Philadelphia</span>,
<span itemprop="addressRegion">PA</span>
</div>
</div>
<div itemprop="offers" itemscope itemtype="https://schema.org/AggregateOffer">
<meta itemprop="priceCurrency" content="USD" />
Priced from: <span itemprop="lowPrice" content="35">$35</span>
<span itemprop="offerCount">1938</span> tickets left
</div>
</div>
Пример, закодированный в формате RDFa, встроенный в HTML.
<div vocab="https://schema.org/" typeof="Event">
<a property="url" href="nba-miami-philidelphia-game3.html">
NBA Eastern Conference First Round Playoff Tickets:
<span property="name"> Miami Heat at Philadelphia 76ers - Game 3 (Home Game 1) </span>
</a>
<meta property="startDate" content="2016-04-21T20:00">
Thu, 04/21/16
8:00 p.m.
<div property="location" typeof="Place">
<a property="url" href="wells-fargo-center.html">
Wells Fargo Center
</a>
<div property="address" typeof="PostalAddress">
<span property="addressLocality">Philadelphia</span>,
<span property="addressRegion">PA</span>
</div>
</div>
<div property="offers" typeof="AggregateOffer">
<meta property="priceCurrency" content="USD" />
Priced from: <span property="lowPrice" content="35">$35</span>
<span property="offerCount">1938</span> tickets left
</div>
</div>
Пример, закодированный в формате JSON-LD в теге <script> HTML.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Event",
"name": "Miami Heat at Philadelphia 76ers - Game 3 (Home Game 1)",
"location": {
"@type": "Place",
"address": {
"@type": "PostalAddress",
"addressLocality": "Philadelphia",
"addressRegion": "PA"
},
"url": "wells-fargo-center.html"
},
"offers": {
"@type": "AggregateOffer",
"priceCurrency": "USD",
"lowPrice": "35",
"offerCount": "1938"
},
"startDate": "2016-04-21T20:00",
"url": "nba-miami-philidelphia-game3.html"
}
</script>
Структурированное представление примера JSON-LD.