episodeNumber

Свойство schema.org ^?

Канонический URL: https://schema.org/episodeNumber
👉 Проверить на наличие открытых проблем.

Содержание: Описание, Какие должны быть типы, В каких типах используется, Примеры использования.

Описание:

Позиция эпизода в упорядоченной группе эпизодов.

Что такое episodeNumber и зачем оно нужно?

Свойство episodeNumber из Schema.org — это небольшой, но невероятно важный элемент микроразметки, который помогает отслеживать порядок эпизодов в сериалах, подкастах или любых других упорядоченных группах контента. Если вы когда-либо смотрели сериал или слушали подкаст, то, скорее всего, сталкивались с этим понятием: "Сезон 1, Эпизод 5" или "Эпизод №3". Именно эту информацию можно структурировать с помощью episodeNumber.

Как это работает?

Проще говоря, episodeNumber указывает номер эпизода в последовательности. Например:

В сериале Друзья эпизод «The One with the Prom Video» — это эпизод №14 второго сезона.
В подкасте Stuff You Should Know выпуск «How Does the Internet Work?» может быть эпизод №123.

Это свойство принимает значения типа Integer (число) или Text (текст). То есть вы можете использовать как просто цифру (например, 5), так и текстовое описание (например, "Episode 5"). Это делает его гибким инструментом для разных типов контента.

Почему это важно?

Структура и порядок: Без четкой нумерации эпизоды могут запутаться. Представьте, что вы хотите найти конкретный выпуск любимого подкаста или сериала, но все эпизоды перемешаны. Свойство episodeNumber решает эту проблему, обеспечивая правильную сортировку.
Удобство для зрителей и слушателей: Когда платформы, такие как Netflix, Spotify или Apple Podcasts, используют episodeNumber, они могут показывать контент именно в том порядке, в котором он был задуман авторами. Это особенно важно для сериалов с сюжетной линией, где каждый эпизод продолжает предыдущий.
SEO и видимость в поиске: Поисковые системы, такие как Google, используют episodeNumber, чтобы лучше понимать структуру контента. Это помогает вашим эпизодам появляться в результатах поиска с дополнительной информацией, например, с указанием номера серии.

Пример использования

Представьте, что вы создаете подкаст о науке. Вот как может выглядеть разметка для одного из эпизодов:

{
  "@type": "PodcastEpisode",
  "name": "Как работают черные дыры?",
  "episodeNumber": 7,
  "url": "https://example.com/episode7"
}

Здесь episodeNumber четко указывает, что это седьмой выпуск подкаста. Теперь, если кто-то ищет этот эпизод, поисковик легко поймет его место в общей структуре.

Где это применяется?

Свойство episodeNumber чаще всего используется в типах данных, связанных с эпизодами, таких как:

TVEpisode (телевизионные эпизоды),
PodcastEpisode (эпизоды подкастов),
RadioEpisode (радиоэпизоды).

Оно особенно полезно для стриминговых сервисов, каталогов фильмов и подкаст-платформ. Например:

Netflix использует episodeNumber, чтобы показывать сезоны и серии в правильном порядке.
Apple Podcasts применяет его для организации эпизодов в библиотеках пользователей.

Чем это отличается от seasonNumber?

Если вы работаете с контентом, разделенным на сезоны, важно понимать разницу между episodeNumber и seasonNumber:

seasonNumber указывает номер сезона (например, "Сезон 2").
episodeNumber указывает номер эпизода внутри сезона (например, "Эпизод 5").

Эти два свойства часто работают вместе, чтобы создать полную картину структуры контента. Например:

Игра престолов, Сезон 1, Эпизод 3 — здесь seasonNumber = 1, а episodeNumber = 3.

Итог

episodeNumber — это простой, но мощный инструмент для структурирования контента. Он помогает платформам, поисковым системам и пользователям легко ориентироваться в огромном количестве эпизодов, будь то сериалы, подкасты или радиопередачи.

Используя это свойство, вы не только улучшаете организацию своего контента, но и делаете его более доступным для аудитории. А в мире, где контент становится все более объемным и разнообразным, такие стандарты играют ключевую роль.

Ожидается, что значения будут одного из этих типов

Используется в этих типах

Episode ^?

Примеры

Пример 1

Это пример от schema.su, его нету в официальной документации! Будьте внимательны, работоспособность не можем гарантировать. Проверяйте через валидатор.

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

Название серии: Эпизод 1 - "Отправление"
Сериал: "Приключения Геракла"
Описание сериала: Приключения Геракла, героя древнегреческих мифов, рассказывают о его великих подвигах.
Сезон: 1
Описание сезона: Первый сезон показывает начало увлекательного путешествия Геракла.
Номер эпизода: 1
Режиссер: Иван Иванов
Актеры: Алексей Смирнов, Мария Петрова
Музыка: Сергей Нестеров
Продюсеры: Кинокомпания "Золотая Пара"
Адрес продюсерской компании: Москва, ул. Кино, д. 10
Телефон: +7 (495) 123-45-67
Длительность: 45 минут
Трейлер: https://example.com/трейлер
URL: https://example.com/приключения-геркла/эпизод-1

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

<div itemscope itemtype="https://schema.org/Episode">
    <h2 itemprop="name">Эпизод 1 - "Отправление"</h2>
    <p itemprop="description">Эпизод 1 рассказывает о первых приключениях Геракла.</p>
    <div itemprop="partOfSeries" itemscope itemtype="https://schema.org/TVSeries">
        <span itemprop="name">"Приключения Геракла"</span>
        <p itemprop="description">Приключения Геракла, героя древнегреческих мифов, рассказывают о его великих подвигах.</p>
    </div>
    <div itemprop="partOfSeason" itemscope itemtype="https://schema.org/TVSeason">
        <span itemprop="seasonNumber">1</span>
        <p itemprop="description">Первый сезон показывает начало увлекательного путешествия Геракла.</p>
    </div>
    <p itemprop="episodeNumber">Номер эпизода: <span itemprop="episodeNumber">1</span></p>
    <p itemprop="director" itemscope itemtype="https://schema.org/Person">
        Режиссер: <span itemprop="name">Иван Иванов</span>
    </p>
    <p itemprop="actor" itemscope itemtype="https://schema.org/Person">
        Актеры: 
        <span itemprop="name">Алексей Смирнов</span>, 
        <span itemprop="name">Мария Петрова</span>
    </p>
    <p itemprop="musicBy" itemscope itemtype="https://schema.org/Person">
        Музыка: <span itemprop="name">Сергей Нестеров</span>
    </p>
    <p itemprop="productionCompany" itemscope itemtype="https://schema.org/Organization">
        Продюсеры: <span itemprop="name">Кинокомпания "Золотая Пара"</span>
        <span itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
            <span itemprop="streetAddress">ул. Кино, д. 10</span>, 
            <span itemprop="addressLocality">Москва</span>,
            <span itemprop="addressCountry">Россия</span>
        </span>
        <span itemprop="telephone">+7 (495) 123-45-67</span>
    </p>
    <p itemprop="duration" content="PT45M">Длительность: 45 минут</p>
    <a itemprop="trailer" href="https://example.com/трейлер">Трейлер</a>
    <a itemprop="url" href="https://example.com/приключения-геркла/эпизод-1">Ссылка на эпизод</a>
</div>

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

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Episode",
  "name": "Эпизод 1 - \"Отправление\"",
  "description": "Эпизод 1 рассказывает о первых приключениях Геракла.",
  "partOfSeries": {
    "@type": "TVSeries",
    "name": "\"Приключения Геракла\"",
    "description": "Приключения Геракла, героя древнегреческих мифов, рассказывают о его великих подвигах."
  },
  "partOfSeason": {
    "@type": "TVSeason",
    "seasonNumber": 1,
    "description": "Первый сезон показывает начало увлекательного путешествия Геракла."
  },
  "episodeNumber": 1,
  "director": {
    "@type": "Person",
    "name": "Иван Иванов"
  },
  "actor": [
    {
      "@type": "Person",
      "name": "Алексей Смирнов"
    },
    {
      "@type": "Person",
      "name": "Мария Петрова"
    }
  ],
  "musicBy": {
    "@type": "Person",
    "name": "Сергей Нестеров"
  },
  "productionCompany": {
    "@type": "Organization",
    "name": "Кинокомпания \"Золотая Пара\"",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "ул. Кино, д. 10",
      "addressLocality": "Москва",
      "addressCountry": "Россия"
    },
    "telephone": "+7 (495) 123-45-67"
  },
  "duration": "PT45M",
  "trailer": "https://example.com/трейлер",
  "url": "https://example.com/приключения-геркла/эпизод-1"
}
</script>

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

@context

https://schema.org

@type

Episode

name

Эпизод 1 - "Отправление"

description

Эпизод 1 рассказывает о первых приключениях Геракла.

partOfSeries

@type: TVSeries
name: "Приключения Геракла"
description: Приключения Геракла, героя древнегреческих мифов, рассказывают о его великих подвигах.

partOfSeason