AggregateOffer - Микроразметка Schema.org
Микроразметка AggregateOffer на schema.su - применение и советы
AggregateOffer - Тип Schema.org
Описание: Когда один продукт связан с несколькими предложениями (например, одна и та же пара обуви предлагается разными продавцами), тогда может использоваться AggregateOffer. Примечание: AggregateOffer обычно ожидается связывать несколько предложений, которые все имеют одно и то же определенное значение businessFunction, или по умолчанию http://purl.org/goodrelations/v1#Sell, если businessFunction не является явно заданным.
Когда один продукт связан с несколькими предложениями (например, одни и те же туфли продают разные продавцы), тогда можно использовать AggregateOffer. Примечание: Обычно ожидается, что AggregateOffer сгруппирует несколько предложений, которые все имеют одно и то же значение businessFunction, или по умолчанию будут использовать http://purl.org/goodrelations/v1#Продать, если businessFunction не определено явно.
Свойство | Ожидаемый тип | Описание |
---|---|---|
Properties from AggregateOffer | ||
highPrice |
Number или Text | The highest price of all offers available.Usage guidelines:Use values from 0123456789 (Unicode 'DIGIT ZERO' (U+0030) to 'DIGIT NINE' (U+0039)) rather than superficially similar Unicode symbols.Use '.' (Unicode 'FULL STOP' (U+002E)) rather than ',' to indicate a decimal point. Avoid using these symbols as a readability separator. |
lowPrice |
Number или Text | The lowest price of all offers available.Usage guidelines:Use values from 0123456789 (Unicode 'DIGIT ZERO' (U+0030) to 'DIGIT NINE' (U+0039)) rather than superficially similar Unicode symbols.Use '.' (Unicode 'FULL STOP' (U+002E)) rather than ',' to indicate a decimal point. Avoid using these symbols as a readability separator. |
offerCount |
Integer | Количество предложений для продукта |
offers |
Demand или Offer | An offer to provide this itemâfor example, an offer to sell a product, rent the DVD of a movie, perform a service, or give away tickets to an event. Use businessFunction to indicate the kind of transaction offered, i.e. sell, lease, etc. This property can also be used to describe a Demand. While this property is listed as expected on a number of common types, it can be used in others. In that case, using a second type, such as Product or a subtype of Product, can clarify the nature of the offer. Обратное свойство: itemOffered |
Properties from Offer | ||
acceptedPaymentMethod |
LoanOrCredit или PaymentMethod | Методы оплаты, принятые продавцом для данного предложения. |
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 | Географическая область, где предоставляется услуга или продукт. Supersedes serviceArea. |
asin |
Text или URL | An Amazon Standard Identification Number (ASIN) is a 10-character alphanumeric unique identifier assigned by Amazon.com and its partners for product identification within the Amazon organization (summary from Wikipedia's article).Note also that this is a definition for how to include ASINs in Schema.org data, and not a definition of ASINs in general - see documentation from Amazon for authoritative details.ASINs are most commonly encoded as text strings, but the [asin] property supports URL/URI as potential values too. |
availability |
ItemAvailability | The availability of this itemâfor example In stock, Out of stock, Pre-order, etc. |
availabilityEnds |
Date или DateTime или Time | Микроразметка availabilityEnds определяет конец доступности продукта или услуги, включенных в предложение. |
availabilityStarts |
Date или DateTime или Time | Начало доступности продукта или услуги, включенных в предложение. |
availableAtOrFrom |
Place | Место(а), откуда можно получить предложение (например, местоположения магазинов). |
availableDeliveryMethod |
DeliveryMethod | Метод(ы) доставки, доступные для данного предложения. |
businessFunction |
BusinessFunction | Бизнес-функция (например, продажа, аренда, ремонт, утилизация) предложения или компонента пакета (TypeAndQuantityNode). По умолчанию http://purl.org/goodrelations/v1#Sell. |
category |
CategoryCode или PhysicalActivityCategory или Text или Thing или URL | Категория для элемента. Большие знаки больше или косые черты могут использоваться неформально для обозначения иерархии категорий. |
checkoutPageURLTemplate |
Text | URL шаблон (RFC 6570) для страницы оформления заказа для предложения. Этот подход позволяет продавцам указать URL для онлайн-оформления предлагаемого товара, интерполируя параметры, такие как идентификатор пользователя, идентификатор товара, количество, скидочный код и т. д. Наименования параметров и стандартизация не указаны здесь. |
deliveryLeadTime |
QuantitativeValue | Тип: Свойство Schema.org Путь: Вещь > Свойство :: deliveryLeadTime Описание: Типичная задержка между получением заказа и отправкой товаров со склада или подготовкой к самовывозу, в случае если метод доставки - самовывоз. |
eligibleCustomerType |
BusinessEntityType | Тип(ы) клиентов, для которых данное предложение действительно. |
eligibleDuration |
QuantitativeValue | Длительность, в течение которой предложение действительно. |
eligibleQuantity |
QuantitativeValue | Интервал и единица измерения заказных количеств для которых действительно предложение или спецификация цены. Это позволяет, например, указать, что определенная стоимость доставки действительна только для определенного количества. |
eligibleRegion |
GeoShape или Place или Text | The ISO 3166-1 (ISO 3166-1 alpha-2) or ISO 3166-2 code, the place, or the GeoShape for the geo-political region(s) for which the offer or delivery charge specification is valid.See also ineligibleRegion. |
eligibleTransactionVolume |
PriceSpecification | Объем транзакций, выраженный в денежной единице, для которого действительно предложение или спецификация цены, например, для обозначения минимального объема покупок, выражения бесплатной доставки при превышении определенного объема заказа или ограничения использования кредитных карт при покупках на определенную минимальную сумму. |
gtin |
Text или URL | A Global Trade Item Number (GTIN). GTINs identify trade items, including products and services, using numeric identification codes.The GS1 digital link specifications express GTINs as URLs (URIs, IRIs, etc.). Details including regular expression examples can be found in, Section 6 of the GS1 URI Syntax specification; see also schema.org tracking issue for schema.org-specific discussion. A correct gtin value should be a valid GTIN, which means that it should be an all-numeric string of either 8, 12, 13 or 14 digits, or a "GS1 Digital Link" URL based on such a string. The numeric component should also have a valid GS1 check digit and meet the other rules for valid GTINs. See also GS1's GTIN Summary and Wikipedia for more details. Left-padding of the gtin values is not required or encouraged. The gtin property generalizes the earlier gtin8, gtin12, gtin13, and gtin14 properties.Note also that this is a definition for how to include GTINs in Schema.org data, and not a definition of GTINs in general - see the GS1 documentation for authoritative details. |
gtin12 |
Text | The GTIN-12 code of the product, or the product to which the offer refers. The GTIN-12 is the 12-digit GS1 Identification Key composed of a U.P.C. Company Prefix, Item Reference, and Check Digit used to identify trade items. See GS1 GTIN Summary for more details. |
gtin13 |
Text | The GTIN-13 code of the product, or the product to which the offer refers. This is equivalent to 13-digit ISBN codes and EAN UCC-13. Former 12-digit UPC codes can be converted into a GTIN-13 code by simply adding a preceding zero. See GS1 GTIN Summary for more details. |
gtin14 |
Text | The GTIN-14 code of the product, or the product to which the offer refers. See GS1 GTIN Summary for more details. |
gtin8 |
Text | The GTIN-8 code of the product, or the product to which the offer refers. This code is also known as EAN/UCC-8 or 8-digit EAN. See GS1 GTIN Summary for more details. |
hasAdultConsideration |
AdultOrientedEnumeration | Используется для пометки товара, предназначенного или подходящего для потребления или использования только взрослыми. |
hasMeasurement |
QuantitativeValue | Измерение объекта, например, длина внутреннего шва брюк, размер колеса велосипеда, диаметр винта или углеродный след, измеренный для сертификации компетентным органом. Обычно точное измерение, но также может быть диапазон измерений для регулируемых продуктов, например, ремней и креплений для лыж. |
hasMerchantReturnPolicy |
MerchantReturnPolicy | Указывает на MerchantReturnPolicy, которая может быть применима. Supersedes hasProductReturnPolicy. |
includesObject |
TypeAndQuantityNode | This links to a node or nodes indicating the exact quantity of the products included in an Offer or ProductCollection. |
ineligibleRegion |
GeoShape или Place или Text | The ISO 3166-1 (ISO 3166-1 alpha-2) or ISO 3166-2 code, the place, or the GeoShape for the geo-political region(s) for which the offer or delivery charge specification is not valid, e.g. a region where the transaction is not allowed.See also eligibleRegion. |
inventoryLevel |
QuantitativeValue | Текущий приблизительный уровень запасов для товара или товаров. |
isFamilyFriendly |
Boolean | Указывает, является ли этот контент подходящим для семьи. |
itemCondition |
OfferItemCondition | Предопределенное значение из OfferItemCondition, указывающее состояние товара или услуги, или товары или услуги, включенные в предложение. Также используется для установления условий возврата продуктов, указывая состояние принимаемых для возврата продуктов. |
itemOffered |
AggregateOffer или CreativeWork или Event или MenuItem или Product или Service или Trip | An item being offered (or demanded). The transactional nature of the offer or demand is documented using businessFunction, e.g. sell, lease etc. While several common expected types are listed explicitly in this definition, others can be used. Using a second type, such as Product or a subtype of Product, can clarify the nature of the offer. Обратное свойство: offers |
leaseLength |
Duration или QuantitativeValue | Length of the lease for some Accommodation, either particular to some Offer or in some cases intrinsic to the property. |
mobileUrl |
Text | The mobileUrl property is provided for specific situations in which data consumers need to determine whether one of several provided URLs is a dedicated 'mobile site'.To discourage over-use, and reflecting intial usecases, the property is expected only on Product and Offer, rather than Thing. The general trend in web technology is towards responsive design in which content can be flexibly adapted to a wide range of browsing environments. Pages and sites referenced with the long-established url property should ideally also be usable on a wide variety of devices, including mobile phones. In most cases, it would be pointless and counter productive to attempt to update all url markup to use mobileUrl for more mobile-oriented pages. The property is intended for the case when items (primarily Product and Offer) have extra URLs hosted on an additional "mobile site" alongside the main one. It should not be taken as an endorsement of this publication style. |
mpn |
Text | Производственный номер детали (MPN) продукта или продукта, на который делается предложение. |
offeredBy |
Organization или Person | Указатель на организацию или человека, делающего предложение Обратное свойство: makesOffer |
price |
Number или Text | The offer price of a product, or of a price component when attached to PriceSpecification and its subtypes.Usage guidelines:Use the priceCurrency property (with standard formats: ISO 4217 currency format, e.g. "USD"; Ticker symbol for cryptocurrencies, e.g. "BTC"; well known names for Local Exchange Trading Systems (LETS) and other currency types, e.g. "Ithaca HOUR") instead of including ambiguous symbols such as '$' in the value.Use '.' (Unicode 'FULL STOP' (U+002E)) rather than ',' to indicate a decimal point. Avoid using these symbols as a readability separator.Note that both RDFa and Microdata syntax allow the use of a "content=" attribute for publishing simple machine-readable values alongside more human-friendly formatting.Use values from 0123456789 (Unicode 'DIGIT ZERO' (U+0030) to 'DIGIT NINE' (U+0039)) rather than superficially similar Unicode symbols. |
priceCurrency |
Text | The currency of the price, or a price component when attached to PriceSpecification and its subtypes.Use standard formats: ISO 4217 currency format, e.g. "USD"; Ticker symbol for cryptocurrencies, e.g. "BTC"; well known names for Local Exchange Trading Systems (LETS) and other currency types, e.g. "Ithaca HOUR". |
priceSpecification |
PriceSpecification | Одно или более детальных спецификаций цен, указывающих единичную цену и расходы на доставку или оплату. |
priceValidUntil |
Date | Дата, после которой цена больше не доступна. |
review |
Review | Рецензия на объект. Supersedes reviews. |
seller |
Organization или Person | Сущность, которая предлагает (продает/арендует/предоставляет в аренду/дает взаймы) услуги/товары. Продавец также может быть поставщиком. Supersedes merchant, vendor. |
serialNumber |
Text | Серийный номер или любой алфанумерический идентификатор определенного продукта. Когда он присоединен к предложению, это является ярлыком для серийного номера продукта, включенного в предложение. |
shippingDetails |
OfferShippingDetails | Indicates information about the shipping policies and options associated with an Offer. |
sku |
Text | Идентификатор товара (SKU) (номер складского номенклатурного обозначения), т. е. специфический для торговца идентификатор продукта или услуги или продукт, на который делается предложение. |
validFrom |
Date или DateTime | Дата, когда объект становится действительным. |
validThrough |
Date или DateTime | Свойство validThrough показывает дату, после которой элемент больше не является действительным. Например, окончание предложения или периода заработной платы. |
warranty |
WarrantyPromise | Гарантийные обещания(я), включенные в предложение. Supersedes warrantyPromise. |
Properties from Thing | ||
additionalType |
Text или URL | An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. Typically the value is a URI-identified RDF class, and in this case corresponds to the use of rdf:type in RDF. Text values can be used sparingly, for cases where useful information can be added without their being an appropriate schema to reference. In the case of text values, the class label should follow the schema.org style guide. |
alternateName |
Text | Псевдоним для элемента. |
description |
Text или TextObject | Описание элемента. |
disambiguatingDescription |
Text | Подсвойство описания. Краткое описание элемента, используемое для различения от других, схожих элементов. Для того чтобы описание было полезным для разрешения неоднозначности, может потребоваться информация из других свойств (в частности, name). |
identifier |
PropertyValue или Text или URL | The identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See background notes for more details. |
image |
ImageObject или URL | An image of the item. This can be a URL or a fully described ImageObject. |
mainEntityOfPage |
CreativeWork или URL | Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details. Обратное свойство: mainEntity |
name |
Text | Название элемента. |
potentialAction |
Action | Указывает на потенциальное действие, описывающее идеализированное действие, в котором этот объект мог бы выполнять роль 'объекта'. |
sameAs |
URL | URL страницы для ссылки, однозначно указывающей на идентичность объекта. Например, URL страницы объекта на Википедии, записи в Wikidata или официального веб-сайта. |
subjectOf |
CreativeWork или Event | Свойство Schema.org - subjectOf: A CreativeWork or Event about this Thing. Обратное свойство: about |
url |
URL | URL объекта. |
Instances of
AggregateOffer may appear as a value for the following properties
Свойство | On Types | Описание |
---|---|---|
itemOffered | Demand или Offer | An item being offered (or demanded). The transactional nature of the offer or demand is documented using businessFunction, e.g. sell, lease etc. While several common expected types are listed explicitly in this definition, others can be used. Using a second type, such as Product or a subtype of Product, can clarify the nature of the offer. |
Examples
Example 1
Copied
Example notes or example HTML without markup.
<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> ...
Example encoded as Microdata embedded in 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>
Example encoded as RDFa embedded in 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>
Example encoded as JSON-LD in a HTML script tag.
<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>
Structured representation of the JSON-LD example.
Example 2
Copied
Example notes or example HTML without markup.
<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
Example encoded as Microdata embedded in 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>
Example encoded as RDFa embedded in 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>
Example encoded as JSON-LD in a HTML script tag.
<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>
Structured representation of the JSON-LD example.