Обзор
Используйте точечную нотацию для сопоставления полей с вложенными объектами Schema.org.
Описание
Некоторые свойства Schema.org ожидают вложенные объекты вместо простых значений. Квалифицированные свойства используют точечную нотацию, чтобы указать и тип объекта, и свойство внутри этого объекта.
Например, цена товара — это не просто число. Она является частью объекта Offer, который включает цену, валюту и наличие. Использование Offer.price говорит ACF автоматически создать вложенную структуру.
Синтаксис
{ObjectType}.{propertyName}
Примеры:
– Offer.price: Цена внутри Offer
– Offer.priceCurrency: Код валюты внутри Offer
– NutritionInformation.calories: Калории в данных о питательной ценности
– HowToStep.text: Текстовое содержимое шага инструкции
Как это работает
Когда вы сопоставляете поле с квалифицированным свойством, ACF:
- Разбирает квалифицированное свойство на тип объекта и имя свойства
- Создает вложенную структуру объекта в выводе JSON-LD
- Назначает подходящий
@typeвложенному объекту - Помещает значение поля в нужное свойство
Пример: Ценообразование товара
Сопоставление полей:
– Поле цены → Offer.price
– Поле валюты → Offer.priceCurrency
– Поле наличия → Offer.availability
Вывод JSON-LD:
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Беспроводные наушники",
"offers": {
"@type": "Offer",
"price": 79.99,
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
Пример: Питательная ценность рецепта
Сопоставление полей:
– Поле калорий → NutritionInformation.calories
– Поле белка → NutritionInformation.proteinContent
– Поле жира → NutritionInformation.fatContent
Вывод JSON-LD:
{
"@context": "https://schema.org",
"@type": "Recipe",
"name": "Печенье с шоколадной крошкой",
"nutrition": {
"@type": "NutritionInformation",
"calories": "250 калорий",
"proteinContent": "3 г",
"fatContent": "12 г"
}
}
Распространённые квалифицированные свойства
Товар/электронная коммерция
| Квалифицированное свойство | Описание |
|---|---|
Offer.price | Цена товара |
Offer.priceCurrency | Код валюты (USD, EUR и т. д.) |
Offer.availability | Статус наличия |
Offer.priceValidUntil | Дата окончания действия цены |
Offer.itemCondition | Новый, б/у, восстановленный |
AggregateRating.ratingValue | Средний рейтинг |
AggregateRating.reviewCount | Количество отзывов |
Brand.name | Название бренда |
Рецепт
| Квалифицированное свойство | Описание |
|---|---|
NutritionInformation.calories | Количество калорий |
NutritionInformation.fatContent | Количество жира |
NutritionInformation.proteinContent | Количество белка |
NutritionInformation.carbohydrateContent | Количество углеводов |
NutritionInformation.servingSize | Размер порции |
HowToStep.text | Инструкции шага |
HowToStep.name | Название/заголовок шага |
HowToStep.image | Изображение шага |
Событие
| Квалифицированное свойство | Описание |
|---|---|
Place.name | Название площадки |
Place.address | Адрес площадки |
PostalAddress.streetAddress | Улица и номер дома |
PostalAddress.addressLocality | Город |
PostalAddress.addressRegion | Штат/регион |
PostalAddress.postalCode | Почтовый индекс |
PostalAddress.addressCountry | Страна |
Offer.price | Цена билета |
Offer.url | URL для покупки билета |
Организация/местный бизнес
| Квалифицированное свойство | Описание |
|---|---|
PostalAddress.streetAddress | Адрес компании |
ContactPoint.telephone | Номер телефона |
ContactPoint.email | Адрес электронной почты |
ContactPoint.contactType | Тип (продажи, поддержка) |
OpeningHoursSpecification.dayOfWeek | День недели |
OpeningHoursSpecification.opens | Время открытия |
OpeningHoursSpecification.closes | Время закрытия |
Человек
| Квалифицированное свойство | Описание |
|---|---|
Organization.name | Название работодателя |
PostalAddress.addressLocality | Город |
ContactPoint.email | Контактный email |
Несколько полей, один и тот же объект
Когда несколько полей сопоставляются с одним и тем же типом объекта, они объединяются в один вложенный объект:
Сопоставление полей:
– Поле улицы → PostalAddress.streetAddress
– Поле города → PostalAddress.addressLocality
– Поле региона/штата → PostalAddress.addressRegion
– Поле ZIP → PostalAddress.postalCode
Вывод JSON-LD:
{
"@type": "LocalBusiness",
"name": "Кофейня Джо",
"address": {
"@type": "PostalAddress",
"streetAddress": "123 Main St",
"addressLocality": "Austin",
"addressRegion": "TX",
"postalCode": "78701"
}
}
Примечания
- Тип объекта в квалифицированных свойствах должен быть допустимым типом Schema.org
- ACF автоматически определяет имя родительского свойства (например,
Offer→offers) - Несколько полей, сопоставленных с одним и тем же типом объекта, объединяются
- Пустые значения исключаются из вложенных объектов
- Если все свойства вложенного объекта пусты, весь объект исключается
Обновлено: 01.06.2026