Структуровані дані для каруселі (Item)

Карусель – розширений результат у вигляді списку, елементи якого можна гортати на мобільних пристроях. У каруселі показується кілька картки з одного сайту. Щоб матеріали з вашого сайту могли показуватися в розширеному результаті у вигляді каруселі, додайте на нього структуровані дані ItemList у поєднанні зі структурованими даними типу:

Якщо додати розмітку ItemList разом із матеріалами підтримуваного типу, карусель виглядатиме в результатах пошуку так:

Як додати структуровані дані

Структуровані дані — стандартизований формат, який дозволяє надавати інформацію про сторінку та класифікувати її вміст. Детальніше про принципи роботи структурованих даних…

Нижче в загальних рисах описано, як додати структуровані дані на сайт.

Виберіть, де ви будете розміщувати структуровані дані для каруселі. Є два варіанти:
- Оглядова сторінка та сторінки інформації. Оглядова сторінка містить короткі описи всіх елементів списку. У кожному описі є посилання на сторінку інформації, присвячену окремому елементу. Приклад — оглядова сторінка, що містить список видів печива та описи з посиланнями на повний рецепт кожного з цих видів.
- Весь список на одній сторінці. Одна сторінка, на якій перераховані всі елементи разом з повним описом кожного з них. Приклад — список популярних фільмів 2020 року на одній сторінці.
Додайте обов’язкові властивості. Дізнайтеся, в яких частинах сторінки потрібно розміщувати структуровані дані обраного вами формату.
Якщо ви працюєте з системою управління контентом, вам може бути зручніше використовувати вбудований у неї плагін.
Якщо ви використовуєте мову JavaScript, ознайомтеся з інформацією про те, як створювати структуровані дані за допомогою JavaScript.
Додайте обов’язкові та рекомендовані властивості для типу контенту, який має відображатися в каруселі:
Дотримуйтесь рекомендацій.
Перевірте свій код за допомогою інструменту перевірки розширених результатів.
Опублікуйте сторінку й за допомогою інструменту перевірки URL з’ясуйте, як вона виглядає для робота Googlebot. Переконайтеся, що доступ Google до сторінки не заблоковано файлом robots.txt або метатегом з директивою noindex і для нього не потрібна авторизація. Якщо все в порядку, запросіть повторне сканування ваших URL.
Примітка. Обробка та індексація займе деякий час. З моменту публікації сторінки може пройти кілька днів, перш ніж Google виявить і просканує її.
Надайте нам файл Sitemap, щоб ми швидко дізналися про зміни на вашому сайті. Надсилання такого файлу можна автоматизувати за допомогою Search Console Sitemap API.

Оглядова сторінка та сторінки інформації

Оглядова сторінка містить короткі описи всіх елементів списку. У кожному описі є посилання на сторінку інформації, присвячену окремому елементу.

Оглядова сторінка

Оглядова сторінка містить тип ItemList. У кожного елемента ListItem є три властивості: @type (зі значенням ListItem), position (положення елемента в списку) та url (URL сторінки з повними відомостями про елемент списку).

Нижче наведено приклад оглядової сторінки.

<html>
  <head>
    <title>Best cookie recipes</title>
    <script type="application/ld+json">
    {
      "@context":"https://schema.org",
      "@type":"ItemList",
      "itemListElement":[
        {
          "@type":"ListItem",
          "position":1,
          "url":"https://example.com/peanut-butter-cookies.html"
        },
        {
          "@type":"ListItem",
          "position":2,
          "url":"https://example.com/triple-chocolate-chunk.html"
        },
        {
          "@type":"ListItem",
          "position":3,
          "url":"https://example.com/snickerdoodles.html"
        }
      ]
    }
    </script>
  </head>
  <body>
    <p>
      Here are the best cookie recipes of all time.
    </p>
    <h2>
      Peanut Butter Cookies
    </h2>
    <p>
      This <a href="https://example.com/peanut-butter-cookies.html">Peanut Butter Cookie recipe</a> is the tastiest one you'll find.
    </p>
    <h2>
      Triple Chocolate Chunk Cookies
    </h2>
    <p>
      This <a href="https://example.com/triple-chocolate-chunk.html">Triple Chocolate Chunk Cookies recipe</a> is the tastiest one you'll find.
    </p>
    <h2>
      Snickerdoodles
    </h2>
    <p>
      This <a href="https://example.com/snickerdoodles.html">Snickerdoodles recipe</a> is the tastiest one you'll find.
    </p>
  </body>
</html>

Сторінка інформації

На сторінці інформації доступна інформація про певний тип структурованих даних, представлений у каруселі. Наприклад, якщо оглядова сторінка присвячена рецептам печива, на сторінках інформації містяться структуровані дані Recipe для окремих рецептів.

Ось приклади сторінок інформації:

Печиво з арахісовою пастою Печиво з шоколадною крихтою Печиво з корицею

<html>
  <head>
    <title>Peanut Butter Cookies</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "name": "Peanut Butter Cookies",
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
      ],
      "author": {
        "@type": "Person",
        "name": "Wendy Darling"
      },
      "datePublished": "2024-03-10",
      "description": "This Peanut Butter Cookie recipe is everyone's favorite",
      "prepTime": "PT10M",
      "cookTime": "PT25M",
      "totalTime": "PT35M",
      "recipeCuisine": "French",
      "recipeCategory": "Cookies",
      "keywords": "peanut butter, cookies",
      "recipeYield": 24,
      "nutrition": {
        "@type": "NutritionInformation",
        "calories": "120 calories"
      },
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": 5,
        "ratingCount": 18
      },
      "recipeIngredient": [
        "2 cups of peanut butter",
        "1/3 cup of sugar"
      ],
      "recipeInstructions": [
        {
          "@type": "HowToStep",
          "text": "Mix together the peanut butter and sugar."
        },
        {
          "@type": "HowToStep",
          "text": "Roll cookie dough into small balls and place on a cookie sheet."
        },
        {
          "@type": "HowToStep",
          "text": "Bake for 25 minutes."
        }
      ],
      "video": {
        "@type": "VideoObject",
        "name": "How to Peanut Butter Cookies",
        "description": "This is how you make peanut butter cookies.",
        "thumbnailUrl": [
          "https://example.com/photos/1x1/photo.jpg",
          "https://example.com/photos/4x3/photo.jpg",
          "https://example.com/photos/16x9/photo.jpg"
         ],
        "contentUrl": "https://www.example.com/video123.mp4",
        "embedUrl": "https://www.example.com/videoplayer?video=123",
        "uploadDate": "2024-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2025-02-05T08:00:00+08:00"
       }
    }
    </script>
  </head>
  <body>
    <p>
      Here's how to make peanut butter cookies.
    </p>
    <ol>
      <li>Mix together the peanut butter and sugar.</li>
      <li>Roll cookie dough into small balls and place on a cookie sheet.</li>
      <li>Bake for 25 minutes.</li>
    </ol>
  </body>
</html>

Список категорії «все в одному»

Такий список містить всю інформацію з каруселі разом з повним описом кожного елемента. Приклад — список популярних фільмів 2020 року на одній сторінці. У цьому списку немає посилань на інші сторінки інформації.

Нижче наведено приклад списку категорії «все в одному».

<html>
  <head>
    <title>The Best Movies from the Oscars - 2024</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "ItemList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "item": {
            "@type": "Movie",
            "url": "https://example.com/2024-best-picture-noms#a-star-is-born",
            "name": "A Star Is Born",
            "image": "https://example.com/photos/6x9/photo.jpg",
            "dateCreated": "2024-10-05",
            "director": {
                "@type": "Person",
                "name": "Bradley Cooper"
              },
            "review": {
              "@type": "Review",
              "reviewRating": {
                "@type": "Rating",
                "ratingValue": 5
              },
              "author": {
                "@type": "Person",
                "name": "John D."
              }
            },
              "aggregateRating": {
                "@type": "AggregateRating",
                "ratingValue": 90,
                "bestRating": 100,
                "ratingCount": 19141
              }
            }
          },
        {
          "@type": "ListItem",
          "position": 2,
          "item": {
            "@type": "Movie",
            "name": "Bohemian Rhapsody",
            "url": "https://example.com/2024-best-picture-noms#bohemian-rhapsody",
            "image": "https://example.com/photos/6x9/photo.jpg",
            "dateCreated": "2024-11-02",
            "director": {
                "@type": "Person",
                "name": "Bryan Singer"
              },
            "review": {
              "@type": "Review",
              "reviewRating": {
                "@type": "Rating",
                "ratingValue": 3
              },
              "author": {
                "@type": "Person",
                "name": "Vin S."
              }
            },
              "aggregateRating": {
                "@type": "AggregateRating",
                "ratingValue": 61,
                "bestRating": 100,
                "ratingCount": 21985
              }
            }
          },
        {
          "@type": "ListItem",
          "position": 3,
          "item": {
            "@type": "Movie",
            "name": "Black Panther",
            "url": "https://example.com/2024-best-picture-noms#black-panther",
            "image": "https://example.com/photos/6x9/photo.jpg",
            "dateCreated": "2024-02-16",
            "director": {
                "@type": "Person",
                "name": "Ryan Coogler"
              },
            "review": {
              "@type": "Review",
              "reviewRating": {
                "@type": "Rating",
                "ratingValue": 2
              },
              "author": {
                "@type": "Person",
                "name": "Trevor R."
              }
            },
              "aggregateRating": {
                "@type": "AggregateRating",
                "ratingValue": 96,
                "bestRating": 100,
                "ratingCount": 88211
              }
            }
          }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Правила

Щоб ваша сторінка могла відображатися в розширеному результаті з каруселі, вона повинна відповідати правилам керівництва Головне про Пошук і загальним рекомендаціям щодо використання структурованих даних. Крім того, щодо структурованих даних для каруселі застосовуються наведені нижче вимоги.

Всі елементи списку повинні належати до одного типу. Наприклад, якщо в списку перераховані рецепти, слід включати тільки елементи Recipe. Не можна додавати елементи різних типів.
Структуровані дані каруселі повинні бути повними і містити всі елементи, перераховані на сторінці.
Текст, що відображається користувачам, повинен відповідати структурованим даним сторінки, на якій він знаходиться.
Елементи списку будуть показані в порядку, який визначається властивістю position.

Перевірка та розгортання структурованих даних

Перевірте свій код за допомогою інструменту перевірки розширених результатів. На оглядовій сторінці вам необхідно самостійно виконати наступні перевірки:
- Переконайтеся, що елемент itemListElement містить щонайменше два елементи ListItem.
- Переконайтеся, що всі елементи ListItem містять матеріали одного типу, наприклад рецепти.
- Перевірте кожну URL-адресу, вказану у списку, за допомогою інструменту перевірки розширених результатів. Кожна сторінка в списку повинна містити дійсні структуровані дані і відповідати документації для обраного типу контенту: Рецепт, Курс, Ресторан або Фільм.
Опублікуйте сторінку й за допомогою інструменту перевірки URL з’ясуйте, як вона виглядає для робота Googlebot. Переконайтеся, що доступ Google до сторінки не заблоковано файлом robots.txt або метатегом з директивою noindex і для нього не потрібна авторизація. Якщо все в порядку, запросіть повторне сканування ваших URL.
Примітка. Обробка та індексація займе деякий час. З моменту публікації сторінки може пройти кілька днів, перш ніж Google виявить і просканує її.
Надайте нам файл Sitemap, щоб ми швидко дізналися про зміни на вашому сайті. Надсилання такого файлу можна автоматизувати за допомогою Search Console Sitemap API.

Типи структурованих даних

Щоб ваш контент міг відображатися в розширених результатах, необхідно встановити всі обов’язкові властивості.

`ItemList`

ItemList – контейнер, який містить усі елементи списку. Якщо він розміщений на оглядовій сторінці, всі URL-адреси у списку повинні посилатися на різні сторінки в одному домені. Якщо список відноситься до категорії все в одному, всі його URL повинні вказувати на якір на сторінці, де розміщені структуровані дані списку.

Повний опис типу ItemList наведено на сторінці schema.org/ItemList.

Google підтримує наступні властивості:

Обов’язкові властивості

Обов’язкові властивості
`itemListElement`	`ListItem` Список елементів. Для створення списку вам необхідно використовувати контейнер `ItemList` як мінімум з двома елементами `ListItem` (усі вони повинні відноситися до одного типу). Рекомендуємо ознайомитися з більш детальними відомостями про елемент `ListItem`.

itemListElement

ListItem

Список елементів. Для створення списку вам необхідно використовувати контейнер ItemList як мінімум з двома елементами ListItem (усі вони повинні відноситися до одного типу). Рекомендуємо ознайомитися з більш детальними відомостями про елемент ListItem.

`ListItem`

ListItem містить інформацію про окремий елемент списку.

На оглядових сторінках для елемента ListItem повинні бути вказані тільки властивості type, position та url.
У випадку зі списками категорії «все в одному» елемент повинен містити всі додаткові властивості за стандартом schema.org для описуваного типу контенту. Підтримуються дані наступних типів:

Повний опис елемента ListItem наведено на сторінці schema.org/ListItem.

Оглядові сторінки Сторінка категорії «все в одному»

Нижче перераховані властивості для оглядових сторінок.

Обов’язкові властивості

Обов’язкові властивості
`position`	`Integer` Положення елемента в каруселі. Мінімальне значення дорівнює 1.
`url`	`URL` Містить канонічний URL сторінки з інформацією про елемент. Всі URL-адреси списку повинні бути унікальними і входити в той самий домен (верхнього або нижнього рівня), що і оглядова сторінка.

position

Integer

Положення елемента в каруселі. Мінімальне значення дорівнює 1.

url

URL

Містить канонічний URL сторінки з інформацією про елемент. Всі URL-адреси списку повинні бути унікальними і входити в той самий домен (верхнього або нижнього рівня), що і оглядова сторінка.

Усунення несправностей

Якщо у вас виникли труднощі з додаванням або налагодженням структурованих даних, вам допоможуть ресурси та інформація, доступні за наведеними нижче посиланнями.

Якщо ви використовуєте систему управління контентом (CMS) або доручили налаштування сайту іншій людині, зверніться за допомогою до неї або розробника CMS. Не забудьте переслати йому повідомлення про проблему, отримані вами в Search Console.
Google не гарантує відображення вашого контенту в результатах пошуку, які формуються на основі структурованих даних. Можливі причини, з яких ваші матеріали можуть не відображатися у вигляді розширених результатів, перераховані в загальних рекомендаціях щодо використання структурованих даних.
Ознайомтеся зі списком типових помилок у структурованих даних та звітом про структуровані дані, які неможливо обробити, і перевірте, чи правильно ви додали розмітку.
Якщо ми вжили заходів щодо сторінки вручну, неприпустимі структуровані дані на ній будуть проігноровані доти, доки ви не виправите код. При цьому сама сторінка може з’являтися в результатах пошуку й далі. Щоб усунути проблеми зі структурованими даними, скористайтеся звітом про заходи, вжиті вручну.
Ще раз вивчіть рекомендації, щоб з’ясувати, чи відповідає їм ваш контент. Проблема може бути пов’язана зі спамом у контенті або розмітці, а не з помилками в синтаксисі. Тоді її не вдасться виявити за допомогою інструменту перевірки розширених результатів.
Дізнайтеся, що може спричинити відсутність розширених результатів або зменшення їх загальної кількості.
Робот Googlebot сканує та індексує сторінки не одразу після оновлення контенту. З моменту публікації сторінки може пройти кілька днів, поки Google не виявить і просканує її. Ми зібрали на окремій сторінці відповіді на поширені запитання про сканування та індексацію.
При необхідності ставте запитання на форумі Центру Пошуку Google

Search Control

Як додати структуровані дані

Оглядова сторінка та сторінки інформації

Оглядова сторінка

Сторінка інформації

Список категорії «все в одному»

Правила

Перевірка та розгортання структурованих даних

Типи структурованих даних

`ItemList`

`ListItem`

Усунення несправностей

Ваш кошик (елементи: 0)

Структуровані дані для каруселі (Item)

Як додати структуровані дані

Оглядова сторінка та сторінки інформації

Оглядова сторінка

Сторінка інформації

Список категорії «все в одному»

Правила

Перевірка та розгортання структурованих даних

Типи структурованих даних

ItemList

ListItem

Усунення несправностей

ІНші записи

Що робити, якщо ваш сайт помилково позначений як призначений для дорослих

Рекомендації для сайтів з контентом для дорослих

Як Google сканує регіонозалежні сторінки

Надсилання локалізованих версій сторінки в Google

`ItemList`

`ListItem`