⚠️ Важно: данный сайт не имеет отношения к владельцам schema.org, это всего лишь любительский (неофициальный) перевод. Сайт сделан для тех, кто плохо воспринимает технический английский. Оригинал текста можно найти тут: schema.org/PriceSpecification. Если сайт оказался полезен, то можете пожертвовать 50 рублей создателями сайта.

PriceSpecification

Тип schema.org ?

Thing > Intangible > StructuredValue > PriceSpecification

⚠️ В микроразметке Schema.org важен регистр букв, поэтому не перепутайте с priceSpecification. Правило: Типы (types) записываются с заглавной буквы, Свойства (properties) записываются с маленькой буквы.

Содержание: Описание, Свойства которые можно использовать, Подходит для свойств, Более специфичные типы, Благодарности, Примеры использования.

PriceSpecification

Описание:

Структурированное значение, представляющее цену или диапазон цен. Обычно для разметки используются только подклассы этого типа. Рекомендуется использовать MonetaryAmount для описания независимых сумм денег, таких как зарплата, лимиты кредитных карт и т.д.

PriceSpecification — это тип данных в Schema.org, который используется для описания цен или диапазонов цен на товары и услуги. Он помогает структурировать информацию о ценах, чтобы поисковые системы и другие платформы могли легче понимать и обрабатывать эту информацию.

Основная цель PriceSpecification — предоставить четкую и однозначную информацию о стоимости, что полезно как для потребителей, так и для продавцов. Например, когда веб-сайты используют этот тип, поисковые системы могут отображать цены в результатах поиска, что помогает пользователям быстрее находить нужные товары и услуги.

PriceSpecification обычно не используется напрямую, а вместо этого применяются его подклассы, которые более конкретно описывают различные аспекты цен. Это может включать, например, фиксированные цены, акции или специальные предложения.

Важно отметить, что PriceSpecification не предназначен для описания независимых денежных сумм, таких как зарплаты или кредитные лимиты. Для таких случаев рекомендуется использовать другой тип данных — MonetaryAmount.

Таким образом, PriceSpecification является важным инструментом в области структурированных данных, который помогает улучшить видимость и понимание ценовой информации в интернете.

Свойство Ожидаемый тип Описание
Свойство из PriceSpecification
eligibleQuantity QuantitativeValue Интервал и единица измерения заказных количеств, для которых предложение или спецификация цены действительны. Это позволяет, например, указать, что определенная плата за груз действительна только для определенного количества.
eligibleTransactionVolume PriceSpecification Объем транзакций, в денежной единице, для которого предложение или спецификация цены действительны, например, для указания минимального объема покупки, для выражения бесплатной доставки при определенном объеме заказа или для ограничения приема кредитных карт на покупки на определенную минимальную сумму.
maxPrice Number Наивысшая цена, если цена представляет собой диапазон.
membershipPointsEarned Number, QuantitativeValue Количество баллов членства, заработанных участником. При необходимости можно использовать unitText для указания единиц, в которых начисляются баллы. (Например, звезды, мили и т.д.)
minPrice Number Наименьшая цена, если цена представлена в диапазоне.
price Number, Text Цена предложения продукта или компонента цены, когда он прикреплен к PriceSpecification и его подтипам.

Руководство по использованию:

  • Используйте свойство priceCurrency (в стандартных форматах: ISO 4217 currency format, например, "USD"; Ticker symbol для криптовалют, например, "BTC"; известные названия для Local Exchange Trading Systems (LETS) и других типов валют, например, "Ithaca HOUR"), вместо того чтобы включать неоднозначные символы, такие как '$' в значении.
  • Используйте '.' (Unicode 'FULL STOP' (U+002E)), а не ',' для обозначения десятичной точки. Избегайте использования этих символов в качестве разделителей для удобочитаемости.
  • Обратите внимание, что как RDFa, так и синтаксис Microdata позволяют использовать атрибут "content=" для публикации простых машинно-читаемых значений наряду с более удобным для человека форматированием.
  • Используйте значения из 0123456789 (Unicode 'DIGIT ZERO' (U+0030) до 'DIGIT NINE' (U+0039)), а не поверхностно похожие символы Unicode.
priceCurrency Text Валюта цены или компонент цены, когда он прикреплен к PriceSpecification и его подтипам.

Используйте стандартные форматы: ISO 4217 формат валюты, например, "USD"; Тикер для криптовалют, например, "BTC"; общеизвестные названия для Местных систем обмена валют (LETS) и других типов валют, например, "Ithaca HOUR".
validForMemberTier MemberProgramTier Уровень членства, для которого предложение (или спецификация цены, детали доставки предложения или политика возврата продавца в рамках предложения) является действительным.
validFrom Date, DateTime Дата, когда объект становится действительным.
validThrough Date, DateTime Дата, после которой элемент становится недействительным. Например, конец предложения, период зарплаты или период рабочих часов.
valueAddedTaxIncluded Boolean Указывает, включен ли применимый налог на добавленную стоимость (НДС) в спецификацию цены или нет.
Свойство из 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 предмета.

Экземпляры PriceSpecification могут использоваться в качестве значения для следующих свойств.

Свойство Типы Описание
baseSalary JobPosting, EmployeeRole Базовая зарплата работы или сотрудника в роли сотрудника.
eligibleTransactionVolume PriceSpecification, Offer, Demand Объем транзакций, в денежной единице, для которого предложение или спецификация цены действительны, например, для указания минимального объема покупки, для выражения бесплатной доставки при определенном объеме заказа или для ограничения приема кредитных карт на покупки на определенную минимальную сумму.
healthPlanCopay HealthPlanCostSharingSpecification Сумма соплатежа.
minimumPaymentDue Invoice Минимальный платеж, требуемый в настоящее время.
netWorth Person Общая финансовая стоимость человека, рассчитанная путем вычитания обязательств из активов.
priceSpecification TradeAction, Offer, DonateAction, Demand Одна или несколько детализированных спецификаций цены, указывающих цену за единицу и расходы на доставку или оплату.
totalPaymentDue Invoice Общая сумма к оплате.
totalPrice Ticket, Reservation Общая цена за бронирование или билет, включая применимые налоги, доставку и т.д.

Рекомендации по использованию:

  • Используйте значения от 0123456789 (Юникод 'DIGIT ZERO' (U+0030) до 'DIGIT NINE' (U+0039)), а не поверхностно похожие символы Юникода.
  • Используйте '.' (Юникод 'FULL STOP' (U+002E)), а не ',' для обозначения десятичной точки. Избегайте использования этих символов в качестве разделителей для удобочитаемости.

Благодарности

Классы словаря GoodRelations

Этот класс основан на словаре GoodRelations для электронной коммерции, созданном Мартином Хеппом. GoodRelations — это модель данных для обмена данными электронной коммерции в Интернете, которую можно выразить в различных синтаксисах, включая RDFa и HTML5 Microdata. Более подробную информацию о GoodRelations можно найти по адресу http://purl.org/goodrelations/.

Примеры

Пример 1

Пример заметки или HTML разметки.


An example of a credit card bill (invoice).

ACME Bank
Bill for: January 2015 Visa
invoice link: http://www.acmebank.com/invoice.pdf
Customer: Jane Doe
account ID: xxxx-xxxx-xxxx-1234
payment due: 2015-01-30
minimum payment: $15.00
total due: $200.00
billing period: 2014-12-21 to 2015-01-20
payment due

Пример, закодированный в формате Microdata, встроенный в HTML.


<div itemscope itemtype="https://schema.org/Invoice">
  <h1 itemprop="description">January 2015 Visa</h1>
  <a itemprop="url" href="http://acmebank.com/invoice.pdf">Invoice PDF</a>
  <div itemprop="broker" itemscope itemtype="https://schema.org/BankOrCreditUnion">
    <b itemprop="name">ACME Bank</b>
  </div>
  <span itemprop="accountId">xxxx-xxxx-xxxx-1234</span>
  <div itemprop="customer" itemscope itemtype="https://schema.org/Person">
    <b itemprop="name">Jane Doe</b>
  </div>
  <time itemprop="paymentDueDate">2015-01-30</time>
  <div itemprop="minimumPaymentDue" itemscope itemtype="https://schema.org/PriceSpecification">
    <span itemprop="price">15.00</span>
    <span itemprop="priceCurrency">USD</span>
  </div>
  <div itemprop="totalPaymentDue" itemscope itemtype="https://schema.org/PriceSpecification">
    <span itemprop="price">200.00</span>
    <span itemprop="priceCurrency">USD</span>
  </div>
  <meta itemprop="billingPeriod" content="P30D" />starts:2014-12-21 30 days
  <link itemprop="paymentStatus" href="https://schema.org/PaymentDue" />
</div>

Пример, закодированный в формате RDFa, встроенный в HTML.


<div vocab="https://schema.org/" typeof="Invoice">
  <h1 property="description">January 2015 Visa</h1>
  <a property="url" href="http://acmebank.com/invoice.pdf">Invoice PDF</a>
  <div property="broker" typeof="BankOrCreditUnion">
    <b property="name">ACME Bank</b>
  </div>
  <span property="accountId">xxxx-xxxx-xxxx-1234</span>
  <div property="customer" typeof="Person">
    <b property="name">Jane Doe</b>
  </div>
  <time property="paymentDueDate">2015-01-30T12:00:00</time>
  <div property="minimumPaymentDue" typeof="PriceSpecification">
    <span property="price">15.00</span>
    <span property="priceCurrency">USD</span>
  </div>
  <div property="totalPaymentDue" typeof="PriceSpecification">
    <span property="price">200.00</span>
    <span property="priceCurrency">USD</span>
  </div>
  <meta property="billingPeriod" content="P30D" />starts:2014-12-21 30 days
  <link property="paymentStatus" href="PaymentDue" />
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
{
    "@context": "https://schema.org/",
    "@type": "Invoice",
    "description": "January 2015 Visa bill.",
    "url": "http://acmebank.com/invoice.pdf",
    "broker": {
      "@type": "BankOrCreditUnion",
      "name": "ACME Bank"
    },
    "accountId": "xxxx-xxxx-xxxx-1234",
    "customer": {
      "@type": "Person",
      "name": "Jane Doe"
    },
    "paymentDueDate": "2015-01-30T12:00:00",
    "minimumPaymentDue": {
      "@type": "PriceSpecification",
      "price": 15.00,
      "priceCurrency": "USD"
    },
    "totalPaymentDue": {
      "@type": "PriceSpecification",
      "price": 200.00,
      "priceCurrency": "USD"
    },
    "billingPeriod": "P30D",
    "paymentStatus": "https://schema.org/PaymentDue"
}
</script>

Структурированное представление примера JSON-LD.

@context
https://schema.org/
@type
Invoice
description
January 2015 Visa bill.
url
http://acmebank.com/invoice.pdf
broker
@type
BankOrCreditUnion
name
ACME Bank
accountId
xxxx-xxxx-xxxx-1234
customer
@type
Person
name
Jane Doe
paymentDueDate
2015-01-30T12:00:00
minimumPaymentDue
@type
PriceSpecification
price
15
priceCurrency
USD
totalPaymentDue
@type
PriceSpecification
price
200
priceCurrency
USD
billingPeriod
P30D
paymentStatus
https://schema.org/PaymentDue

Пример 2

Пример заметки или HTML разметки.


Joes' Pizza
123 Main Street
Cambridge, MA 02142
delivers within 5 km of its store with a minimum order of $20.

Пример, закодированный в формате Microdata, встроенный в HTML.


<div itemscope itemtype="https://schema.org/FoodEstablishment">
  <span itemprop="name">Joe's Pizza</span>
  <div itemprop="location" itemscope itemtype="https://schema.org/PostalAddress">
    <span itemprop="streetAddress">123 Main Street</span>
    <span itemprop="addressLocality">Cambridge</span>
    <span itemprop="addressRegion">MA</span>
    <span itemprop="postalCode">02142</span>
  </div>
  delivers within 5 km of its store
  <div itemprop="makesOffer" itemscope itemtype="https://schema.org/Offer">
    <div itemprop="eligibleRegion" itemscope itemtype="https://schema.org/GeoCircle">
      <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
        <meta itemprop="streetAddress" content="123 Main Street" />
        <meta itemprop="addressLocality" content="Cambridge" />
        <meta itemprop="addressRegion" content="MA" />
        <meta itemprop="postalCode" content="02142" />
      </div>
      <meta itemprop="geoRadius" content="5000" />
    </div>

    with a minimum order of $20.
    <div itemprop="priceSpecification" itemscope itemtype="https://schema.org/DeliveryChargeSpecification">
      <meta itemprop="appliesToDeliveryMethod" link="http://purl.org/goodrelations/v1#DeliveryModeOwnFleet">
      <div itemprop="eligibleTransactionVolume" itemscope itemtype="https://schema.org/PriceSpecification">
        <meta itemprop="price" content="20.00" />
        <meta itemprop="priceCurrency" content="USD" />
      </div>
    </div>
  </div>
</div>

Пример, закодированный в формате RDFa, встроенный в HTML.


<div vocab="https://schema.org/" typeof="FoodEstablishment">
  <span property="name">Joe's Pizza</span>
  <div property="location" typeof="PostalAddress">
    <span property="streetAddress">123 Main Street</span>
    <span property="addressLocality">Cambridge</span>
    <span property="addressRegion">MA</span>
    <span property="postalCode">02142</span>
  </div>
  delivers within 5 km of its store with a minimum order of $20.
  <div property="makesOffer" typeof="Offer">
    <div property="priceSpecification" typeof="DeliveryChargeSpecification">
      <meta property="appliesToDeliveryMethod" link="http://purl.org/goodrelations/v1#DeliveryModeOwnFleet">
      <div property="eligibleTransactionVolume" typeof="PriceSpecification">
        <meta property="price" content="20.00" />
        <meta property="priceCurrency" content="USD" />
      </div>
      <div property="eligibleRegion" typeof="GeoCircle">
        <div property="address" typeof="PostalAddress">
          <meta property="streetAddress" content="123 Main Street" />
          <meta property="addressLocality" content="Cambridge" />
          <meta property="addressRegion" content="MA" />
          <meta property="postalCode" content="02142" />
        </div>
        <meta property="geoRadius" content="5000" />
      </div>
    </div>
  </div>
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
  {
    "@context": "https://schema.org/",
    "@type": "FoodEstablishment",
    "name": "Joe's Pizza",
    "location": {
      "@type": "PostalAddress",
      "@id": "http://example.com/address",
      "streetAddress": "123 Main Street",
      "addressLocality": "Cambridge",
      "addressRegion": "MA",
      "postalCode": "02142"
    },
    "makesOffer": {
      "@type": "Offer",
      "priceSpecification": {
        "@type": "DeliveryChargeSpecification",
        "appliesToDeliveryMethod": "http://purl.org/goodrelations/v1#DeliveryModeOwnFleet",
        "eligibleTransactionVolume": {
          "@type": "PriceSpecification",
          "price": "20.00",
          "priceCurrency": "USD"
        },
        "eligibleRegion": {
          "@type": "GeoCircle",
          "address": {
            "@id": "http://www.example.com/address"
          },
          "geoRadius": "5000"
        }
      }
    }
  }
</script>

Структурированное представление примера JSON-LD.

@context
https://schema.org/
@type
FoodEstablishment
name
Joe's Pizza
location
@type
PostalAddress
@id
http://example.com/address
streetAddress
123 Main Street
addressLocality
Cambridge
addressRegion
MA
postalCode
02142
makesOffer
@type
Offer
priceSpecification
@type
DeliveryChargeSpecification
appliesToDeliveryMethod
http://purl.org/goodrelations/v1#DeliveryModeOwnFleet
eligibleTransactionVolume
@type
PriceSpecification
price
20.00
priceCurrency
USD
eligibleRegion
@type
GeoCircle
address
@id
http://www.example.com/address
geoRadius
5000

Пример 3

Пример заметки или HTML разметки.


An example of a invoice for a purchase and installation.

ACME Home Heating
Bill for: New furnace and installation
Customer: Jane Doe
payment due: 2015-01-30
minimum payment: $0.00
total due: $0.00
payment status: paid
order: furnace model ABC123
order: installation labor

Пример, закодированный в формате Microdata, встроенный в HTML.


<div itemscope itemtype="https://schema.org/Invoice">
  <h1 itemprop="description">New furnace and installation</h1>
  <div itemprop="broker" itemscope itemtype="https://schema.org/LocalBusiness">
    <b itemprop="name">ACME Home Heating</b>
  </div>
  <div itemprop="customer" itemscope itemtype="https://schema.org/Person">
    <b itemprop="name">Jane Doe</b>
  </div>
  <time itemprop="paymentDueDate">2015-01-30</time>
  <div itemprop="minimumPaymentDue" itemscope itemtype="https://schema.org/PriceSpecification">
    <span itemprop="price">0.00</span>
    <span itemprop="priceCurrency">USD</span>
  </div>
  <div itemprop="totalPaymentDue" itemscope itemtype="https://schema.org/PriceSpecification">
    <span itemprop="price">0.00</span>
    <span itemprop="priceCurrency">USD</span>
  </div>
  <link itemprop="paymentStatus" href="https://schema.org/PaymentComplete" />
  <div itemprop="referencesOrder" itemscope itemtype="https://schema.org/Order">
    <span itemprop="description">furnace</span>
    <time itemprop="orderDate">2014-12-01</time>
    <span itemprop="orderNumber">123ABC</span>
    <div itemprop="orderedItem" itemscope itemtype="https://schema.org/Product">
      <span itemprop="name">ACME Furnace 3000</span>
      <meta itemprop="productID" content="ABC123" />
    </div>
  </div>
  <div itemprop="referencesOrder" itemscope itemtype="https://schema.org/Order">
    <span itemprop="description">furnace installation</span>
    <time itemprop="orderDate">2014-12-02</time>
    <div itemprop="orderedItem" itemscope itemtype="https://schema.org/Service">
      <span itemprop="description">furnace installation</span>
    </div>
  </div>
</div>

Пример, закодированный в формате RDFa, встроенный в HTML.


<div vocab="https://schema.org/" typeof="Invoice">
  <h1 property="description">New furnace and installation</h1>
  <div property="broker" typeof="LocalBusiness">
    <b property="name">ACME Home Heating</b>
  </div>
  <div property="customer" typeof="Person">
    <b property="name">Jane Doe</b>
  </div>
  <time property="paymentDueDate">2015-01-30</time>
  <div property="minimumPaymentDue" typeof="PriceSpecification">
    <span property="price">0.00</span>
    <span property="priceCurrency">USD</span>
  </div>
  <div property="totalPaymentDue" typeof="PriceSpecification">
    <span property="price">0.00</span>
    <span property="priceCurrency">USD</span>
  </div>
  <meta itemprop="paymentStatus" content="PaymentComplete" />
  <div property="referencesOrder" typeof="Order">
    <span property="description">furnace</span>
    <time property="orderDate">2014-12-01</time>
    <span property="orderNumber">123ABC</span>
    <div property="orderedItem" typeof="Product">
      <span property="name">ACME Furnace 3000</span>
      <meta property="productID" content="ABC123" />
    </div>
  </div>
  <div property="referencesOrder" typeof="Order">
    <span property="description">furnace installation</span>
    <time property="orderDate">2014-12-02</time>
    <div property="orderedItem" typeof="Service">
      <span property="description">furnace installation</span>
    </div>
  </div>
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
{
    "@context": "https://schema.org/",
    "@type": "Invoice",
    "broker": {
      "@type": "LocalBusiness",
      "name": "ACME Home Heating"
    },
    "accountId": "xxxx-xxxx-xxxx-1234",
    "customer": {
      "@type": "Person",
      "name": "Jane Doe"
    },
    "paymentDueDate": "2015-01-30",
    "minimumPaymentDue": {
      "@type": "PriceSpecification",
      "price": 0.00,
      "priceCurrency": "USD"
    },
    "totalPaymentDue": {
      "@type": "PriceSpecification",
      "price": 0.00,
      "priceCurrency": "USD"
    },
    "paymentStatus": "https://schema.org/PaymentComplete",
    "referencesOrder": [
      {
        "@type": "Order",
        "description": "furnace",
        "orderDate": "2014-12-01",
        "orderNumber": "123ABC",
        "paymentMethod": "http://purl.org/goodrelations/v1#ByInvoice",
        "orderedItem": {
          "@type": "Product",
          "name": "ACME Furnace 3000",
          "productID": "ABC123"
        }
      },
      {
        "@type": "Order",
        "description": "furnace installation",
        "orderDate": "2014-12-02",
        "paymentMethod": "http://purl.org/goodrelations/v1#ByInvoice",
        "orderedItem": {
          "@type": "Service",
          "description": "furnace installation"
        }
      }
    ]
}
</script>

Структурированное представление примера JSON-LD.

@context
https://schema.org/
@type
Invoice
broker
@type
LocalBusiness
name
ACME Home Heating
accountId
xxxx-xxxx-xxxx-1234
customer
@type
Person
name
Jane Doe
paymentDueDate
2015-01-30
minimumPaymentDue
@type
PriceSpecification
price
0
priceCurrency
USD
totalPaymentDue
@type
PriceSpecification
price
0
priceCurrency
USD
paymentStatus
https://schema.org/PaymentComplete
referencesOrder
0
@type
Order
description
furnace
orderDate
2014-12-01
orderNumber
123ABC
paymentMethod
http://purl.org/goodrelations/v1#ByInvoice
orderedItem
@type
Product
name
ACME Furnace 3000
productID
ABC123
1
@type
Order
description
furnace installation
orderDate
2014-12-02
paymentMethod
http://purl.org/goodrelations/v1#ByInvoice
orderedItem
@type
Service
description
furnace installation
Автор: Семён Авдосов [schema.su]
Дата публикации: 16.11.2024
Дата обновления: 20.11.2024
Комментарии
Новые материалы на сайте
Посмотреть все →
Микроразметка Schema.org для медицинских сайтов: Почему это важно?
Микроразметка Schema.org для медицинских сайтов: Почему это важно?
Микроразметка для местного бизнеса
Микроразметка для местного бизнеса
Микроразметка для интернет-магазинов
Микроразметка для интернет-магазинов
Обновление сайта - ноябрь 2024
Обновление сайта - ноябрь 2024
Микроразметка для сайта с новостями и статьями
Микроразметка для сайта с новостями и статьями
Ошибки при использовании микроразметки schema.org
Ошибки при использовании микроразметки schema.org
Обновление сайта schema.su: новые разделы и первая статья
Обновление сайта schema.su: новые разделы и первая статья
Для чего нужна микроразметка schema.org и как её использовать
Для чего нужна микроразметка schema.org и как её использовать