Тип schema.org ?
Содержание: Описание, Свойства которые можно использовать, Примеры использования.
BuyAction — это специальный тип микроразметки из библиотеки schema.org, который описывает процесс покупки. Проще говоря, он помогает поисковым системам и другим платформам понять, что на вашей странице происходит именно "акт покупки", где один участник (агент) отдает деньги за товар или услугу второму участнику (продавцу).
Представьте, что вы владелец интернет-магазина. Конечно, вы хотите, чтобы ваши товары легко находили в поисковых системах, верно? Вот тут-то и приходит на помощь BuyAction. Он структурирует данные таким образом, чтобы Google и другие системы могли быстро "считать" ключевую информацию: кто продает, что продается, сколько стоит и как совершается покупка.
Эта разметка особенно полезна для:
Простыми словами: Это как подсказка для поисковиков, которая говорит: "Эй, здесь можно купить крутую вещь!"
Давайте разберем базовые элементы, которые обычно используются с этим типом:
Это самое важное свойство, которое указывает на продавца — того, кто предоставляет товар или услугу. Продавцом может быть как человек, так и организация.
Пример использования:
{
"@type": "BuyAction",
"seller": {
"@type": "Organization",
"name": "Онлайн-гипермаркет Техника"
}
}
Здесь мы указываем агента — человека или организацию, совершающего покупку. В реальной жизни это ваш потенциальный клиент.
Описывает сам объект покупки — товар или услугу. Это может быть смартфон, подписка на сервис или даже билет на концерт.
Вот простая аналогия: представьте, что вы заходите в магазин. Вы видите товар, решаетесь его купить и подходите к кассе. Происходит обмен — вы передаете деньги, а продавец отдает вам товар. Именно этот процесс и описывает BuyAction, но уже в цифровом мире.
Интересный момент: BuyAction тесно связан с SellAction (действием продажи). Это как две стороны одной медали — если есть покупатель, должен быть и продавец.
Допустим, у вас есть интернет-магазин бытовой техники. Используя BuyAction, вы можете помочь поисковикам лучше понять контент ваших страниц:
{
"@context": "https://schema.org",
"@type": "BuyAction",
"agent": {
"@type": "Person",
"name": "Иван Петров"
},
"object": {
"@type": "Product",
"name": "Смартфон X100",
"brand": "ТехноКорп"
},
"seller": {
"@type": "Organization",
"name": "Магазин Электроники",
"url": "https://example.com"
}
}
BuyAction — это мощный инструмент для всех, кто занимается онлайн-коммерцией. Он помогает сделать ваш контент более понятным для машин, а значит, более доступным для людей.
Помните: качественная микроразметка — это не просто техническая деталь, это мост между вашим бизнесом и вашими клиентами. Используйте её с умом!
Свойство | Ожидаемый тип | Описание |
---|---|---|
Свойство из BuyAction | ||
seller | Organization, Person | Сущность, которая предлагает (продает / сдает в аренду / одалживает / предоставляет в кредит) услуги / товары. Продавец также может быть поставщиком. |
Свойство из TradeAction | ||
price | Number, Text | Цена предложения продукта или компонента цены, когда он прикреплен к PriceSpecification и его подтипам. Руководство по использованию:
|
priceCurrency | Text | Валюта цены или компонент цены, когда он прикреплен к PriceSpecification и его подтипам. Используйте стандартные форматы: ISO 4217 формат валюты, например, "USD"; Тикер для криптовалют, например, "BTC"; общеизвестные названия для Местных систем обмена валют (LETS) и других типов валют, например, "Ithaca HOUR". |
priceSpecification | PriceSpecification | Одна или несколько детализированных спецификаций цены, указывающих цену за единицу и расходы на доставку или оплату. |
Свойство из Action | ||
actionStatus | ActionStatusType | Указывает текущее состояние Действия. |
agent | Organization, Person | Непосредственный исполнитель или движущая сила действия (живое или неживое). Например, Джон написал книгу. |
endTime | DateTime, Time | Время окончания чего-либо. Для зарезервированного события или услуги (например, FoodEstablishmentReservation) — время, когда ожидается его завершение. Для действий, которые занимают определенный период времени, это время выполнения действия. Например, Джон писал книгу с января по декабрь. Для медиа, включая аудио и видео, это временной смещение конца клипа в рамках более крупного файла. Обратите внимание, что событие использует startDate/endDate вместо startTime/endTime, даже когда описываются даты с указанием времени. Эта ситуация может быть уточнена в будущих редакциях. |
error | Thing | Для неудачных действий, дополнительная информация о причине неудачи. |
instrument | Thing | Объект, который помог агенту выполнить действие. Например, Джон написал книгу с помощью ручки. |
location | VirtualLocation, Text, PostalAddress, Place | Место, например, где проходит событие, где расположена организация или где происходит действие. |
object | Thing | Объект, над которым выполняется действие, состояние которого остается неизменным или изменяется. Также известен как семантические роли пациент, затронутый или подвергающийся (которые изменяют свое состояние) или тема (которая не изменяет своего состояния). Например, Джон прочитал книгу. |
participant | Organization, Person | Другие соучастники, которые косвенно участвовали в действии. Например, Джон написал книгу с Стивом. |
provider | Organization, Person | Поставщик услуг, оператор услуг или исполнитель услуг; производитель товаров. Другая сторона (продавец) может предлагать эти услуги или товары от имени поставщика. Поставщик также может выступать в качестве продавца. |
result | Thing | Результат, полученный в результате действия. Например, Джон написал книгу. |
startTime | DateTime, Time | Время начала чего-либо. Для зарезервированного события или услуги (например, FoodEstablishmentReservation) это время, когда ожидается его начало. Для действий, которые занимают определенный период времени, это время, когда действие было выполнено. Например, Джон писал книгу с января по декабрь. Для медиа, включая аудио и видео, это временной смещение начала клипа в рамках большего файла. Обратите внимание, что событие использует startDate/endDate вместо startTime/endTime, даже при описании дат с указанием времени. Эта ситуация может быть уточнена в будущих редакциях. |
target | EntryPoint, URL | Указывает целевую точку входа (EntryPoint) или URL для действия (Action). |
Свойство из 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 предмета. |
Пример заметки или HTML разметки.
John bought a Book on amazon.com.
Пример, закодированный в формате JSON-LD в теге <script> HTML.
<!-- John bought a Book on amazon.com.-->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BuyAction",
"agent": {
"@type": "Person",
"name": "John"
},
"object": {
"@type": "Book",
"name": "Outliers"
},
"seller": {
"@type": "Organization",
"name": "Amazon"
}
}
</script>
Структурированное представление примера JSON-LD.