Udostępnianie przepisów w Google

Pomóż użytkownikom znaleźć treść przepisu, informując o nim Google za pomocą uporządkowanych danych. Jeśli podasz takie informacje jak oceny recenzentów, czas przygotowywania i gotowania potraw oraz informacje o wartościach odżywczych, możemy zaprezentować Twój przepis w atrakcyjny sposób. Przepisy mogą pojawiać się w wynikach wyszukiwania Google i Grafice Google.

Przepisy w wyszukiwarce Google i Grafice Google

W zależności od tego, jak oznaczysz swoje treści, możesz korzystać z tych ulepszeń przepisów:

Ulepszenia przepisów
Przepisy kulinarne krok po kroku: dodaj uporządkowane dane Recipe, by umożliwić Asystentowi Google podawanie na głośnikach Google Home i inteligentnych ekranach wskazówek dotyczących przyrządzania dań według Twoich przepisów. Istnieje kilka dodatkowych właściwości, które są wymagane w przypadku przepisów kulinarnych krok po kroku, ale tylko zalecane w wyszukiwarce Google. Pamiętaj o dodaniu właściwości recipeIngredientrecipeInstructions.

Aby uzyskać więcej informacji o przepisach w Asystencie Google, dowiedz się, jak tworzyć akcje na podstawie treści internetowych.

Przepis w Asystencie
Karuzela hosta z przepisami: dodanie uporządkowanych danych ItemList umożliwi użytkownikom przeglądanie stron galerii przepisów. Karuzela przepisów w wyszukiwarce Google

Dodawanie uporządkowanych danych

Uporządkowane dane to standardowy format udostępniania informacji o stronie i klasyfikowania jej zawartości. Jeśli dopiero zaczynasz, dowiedz się, jak działają uporządkowane dane.

Oto omówienie tworzenia, testowania i udostępniania uporządkowanych danych. Szczegółowe instrukcje dodawania uporządkowanych danych do strony internetowej znajdziesz w ćwiczeniach z programowania poświęconych uporządkowanym danym.

  1. Dodaj wymagane właściwości. Informacje o tym, w którym miejscu na stronie umieścić uporządkowane dane, znajdziesz w artykule Uporządkowane dane JSON-LD: w którym miejscu na stronie je umieścić.
  2. Przestrzegaj wskazówek.
  3. Zweryfikuj kod za pomocą testu wyników z elementami rozszerzonymi.
  4. Możesz wdrożyć kilka stron z uporządkowanymi danymi i dzięki narzędziu do sprawdzania adresów URL zobaczyć, jak Google je odczytuje. Upewnij się, że Twoja strona jest dostępna dla Google i nie jest blokowana przez plik robots.txt lub tag noindex ani nie wymaga logowania. Jeśli strona wygląda dobrze, możesz poprosić Google o ponowne zindeksowanie adresów URL.
  5. Aby na bieżąco informować Google o przyszłych zmianach, prześlij mapę witryny. Możesz zautomatyzować ten proces za pomocą interfejsu Search Console Sitemap API.

Przykłady

Oto kilka przykładowych przepisów zapisanych w postaci kodu JSON-LD.

Przepisy kulinarne krok po kroku

Oto przykład strony, która może pokazywać się w wyszukiwarce Google i w formie przepisów kulinarnych krok po kroku w Asystencie.

<html>
  <head>
    <title>Party Coffee Cake</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "name": "Party Coffee Cake",
      "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": "Mary Stone"
      },
      "datePublished": "2018-03-10",
      "description": "This coffee cake is awesome and perfect for parties.",
      "prepTime": "PT20M",
      "cookTime": "PT30M",
      "totalTime": "PT50M",
      "keywords": "cake for a party, coffee",
      "recipeYield": "10",
      "recipeCategory": "Dessert",
      "recipeCuisine": "American",
      "nutrition": {
        "@type": "NutritionInformation",
        "calories": "270 calories"
      },
      "recipeIngredient": [
        "2 cups of flour",
        "3/4 cup white sugar",
        "2 teaspoons baking powder",
        "1/2 teaspoon salt",
        "1/2 cup butter",
        "2 eggs",
        "3/4 cup milk"
        ],
      "recipeInstructions": [
        {
          "@type": "HowToStep",
          "name": "Preheat",
          "text": "Preheat the oven to 350 degrees F. Grease and flour a 9x9 inch pan.",
          "url": "https://example.com/party-coffee-cake#step1",
          "image": "https://example.com/photos/party-coffee-cake/step1.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Mix dry ingredients",
          "text": "In a large bowl, combine flour, sugar, baking powder, and salt.",
          "url": "https://example.com/party-coffee-cake#step2",
          "image": "https://example.com/photos/party-coffee-cake/step2.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Add wet ingredients",
          "text": "Mix in the butter, eggs, and milk.",
          "url": "https://example.com/party-coffee-cake#step3",
          "image": "https://example.com/photos/party-coffee-cake/step3.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Spread into pan",
          "text": "Spread into the prepared pan.",
          "url": "https://example.com/party-coffee-cake#step4",
          "image": "https://example.com/photos/party-coffee-cake/step4.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Bake",
          "text": "Bake for 30 to 35 minutes, or until firm.",
          "url": "https://example.com/party-coffee-cake#step5",
          "image": "https://example.com/photos/party-coffee-cake/step5.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Enjoy",
          "text": "Allow to cool and enjoy.",
          "url": "https://example.com/party-coffee-cake#step6",
          "image": "https://example.com/photos/party-coffee-cake/step6.jpg"
        }
      ],
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": "5",
        "ratingCount": "18"
      },
      "video": {
        "@type": "VideoObject",
        "name": "How to make a Party Coffee Cake",
        "description": "This is how you make a Party Coffee Cake.",
        "thumbnailUrl": [
          "https://example.com/photos/1x1/photo.jpg",
          "https://example.com/photos/4x3/photo.jpg",
          "https://example.com/photos/16x9/photo.jpg"
         ],
        "contentUrl": "http://www.example.com/video123.mp4",
        "embedUrl": "http://www.example.com/videoplayer?video=123",
        "uploadDate": "2018-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "http://schema.org/WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2019-02-05T08:00:00+08:00"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Przepis wyświetlany tylko w wyszukiwarce

Oto przykład strony, która może się wyświetlać w wyszukiwarce. Nie może pokazywać się w formie przepisów kulinarnych krok po kroku w Asystencie.

<html>
  <head>
    <title>Non-alcoholic Pina Colada</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "name": "Non-alcoholic Pina Colada",
      "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": "Mary Stone"
      },
      "datePublished": "2018-03-10",
      "description": "This non-alcoholic pina colada is everyone's favorite!",
      "recipeCuisine": "American",
      "prepTime": "PT1M",
      "cookTime": "PT2M",
      "totalTime": "PT3M",
      "keywords": "non-alcoholic",
      "recipeYield": "1 serving",
      "recipeCategory": "Drink",
      "nutrition": {
        "@type": "NutritionInformation",
        "calories": "120 calories"
      },
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": "5",
        "ratingCount": "18"
      },
      "recipeIngredient": [
        "2 cups of pineapple juice",
        "5/8 cup cream of coconut",
        "ice"
      ],
      "recipeInstructions": [
        {
          "@type": "HowToStep",
          "text": "Blend 2 cups of pineapple juice and 5/8 cup cream of coconut until smooth."
        },
        {
          "@type": "HowToStep",
          "text": "Fill a glass with ice."
        },
        {
          "@type": "HowToStep",
          "text": "Pour the pineapple juice and coconut mixture over ice."
        }
      ],
      "video": {
        "@type": "VideoObject",
        "name": "How to make a Party Coffee Cake",
        "description": "This is how you make a Party Coffee Cake.",
        "thumbnailUrl": [
          "https://example.com/photos/1x1/photo.jpg",
          "https://example.com/photos/4x3/photo.jpg",
          "https://example.com/photos/16x9/photo.jpg"
         ],
        "contentUrl": "http://www.example.com/video123.mp4",
        "embedUrl": "http://www.example.com/videoplayer?video=123",
        "uploadDate": "2018-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "http://schema.org/WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2019-02-05T08:00:00+08:00"
       }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Oto przykład strony z podsumowaniem przepisów (strony z listą przepisów) zawierającej uporządkowane dane itemList. Te treści mogą kwalifikować się do wyświetlania w wynikach wyszukiwania w postaci siatki.

<html>
  <head>
    <title>Grandma's Best Pie Recipes</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "ItemList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "url": "https://example.com/apple-pie.html"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "url": "https://example.com/blueberry-pie.html"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "url": "https://example.com/cherry-pie.html"
        }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Wytyczne

Aby Twój przepis kwalifikował się do wyświetlenia w wynikach wyszukiwania, musisz przestrzegać ogólnych wytycznych dotyczących uporządkowanych danych. Jeśli chcesz, by Twój przepis pokazywał się jako przepis kulinarny krok po kroku w Asystencie, Twoje treści muszą być zgodne z zasadami Asystenta dotyczącymi ograniczeń treści.

Uporządkowane dane Recipe muszą być zgodne z tymi wytycznymi.

  • Używaj uporządkowanych danych Recipe do treści związanych z przygotowywaniem konkretnej potrawy. Na przykład określenia typu „peeling do twarzy” czy „pomysły na przyjęcie” nie są prawidłowymi nazwami potraw.
  • Aby Twoje przepisy mogły się wyświetlać w karuzeli lub siatce, musisz przestrzegać tych wytycznych:
    • Użyj uporządkowanych danych ItemList, by zrobić zestawienie przepisów, które zostaną dodane do listy. Uporządkowane dane ItemList możesz podawać osobno lub razem ze znacznikami Recipe.
    • W swojej witrynie musisz mieć stronę podsumowania z listą wszystkich przepisów, jakie się w niej znajdują. Jeśli np. użytkownik kliknie link do podsumowania w wynikach wyszukiwania, otworzy mu się strona w Twojej witrynie z listą przepisów związanych z jego zapytaniem.

Definicje typów uporządkowanych danych

Aby treści mogły się wyświetlać w wynikach z elementami rozszerzonymi, musisz w nich stosować wymagane właściwości. Możesz też dodawać do nich właściwości zalecane, by wzbogacać informacje o treściach dla wygody użytkowników.

Recipe

Dodaj do swojego przepisu poniższe właściwości typu Recipe schema.org. Pełną definicję znaczników Recipe znajdziesz na schema.org/Recipe.

Właściwości wymagane

image

URL lub ImageObject

Zdjęcie gotowego dania.

Dodatkowe wytyczne dotyczące obrazów:

  • Na każdej stronie musi się znajdować co najmniej 1 obraz (niezależnie od tego, czy są do niego dodane znaczniki). Google wybierze obraz najlepiej pasujący do wyników wyszukiwania pod względem rozdzielczości i współczynnika proporcji.
  • Adresy URL obrazów muszą być dostępne do pobrania i zindeksowania.
  • Obrazy muszą symbolizować treści objęte znacznikami.
  • Pliki graficzne muszą być w formacie obsługiwanym przez Grafikę Google.
  • Najlepsze efekty zapewni użycie wielu obrazów o wysokiej rozdzielczości (o iloczynie szerokości i wysokości wynoszącym co najmniej 50 tys. pikseli) i o tych współczynnikach proporcji: 16:9, 4:3 i 1:1.

Przyklad:

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]

name

Text

Nazwa potrawy.

Właściwości zalecane

aggregateRating

AggregateRating

Adnotacja ze średnią oceną elementu. Przestrzegaj wytycznych dotyczących fragmentów opinii oraz zapoznaj się z listą wymaganych i zalecanych właściwości AggregateRating.

Jeśli uporządkowane dane Recipe zawierają pojedynczą opinię, imię i nazwisko jej autora musi być prawidłowym imieniem i nazwiskiem osoby lub prawidłową nazwą organizacji. Na przykład „50% zniżki na składniki” nie jest prawidłowym imieniem i nazwiskiem autora opinii.

author

Person lub Organization

Imię i nazwisko osoby lub nazwa organizacji będącej autorem przepisu.

cookTime

Duration

Czas gotowania potrawy podany w formacie ISO 8601. Do określenia przedziału czasu możesz użyć elementów podrzędnych min i max.

Zawsze używaj ich w połączeniu z właściwością prepTime.

datePublished

Date

Data publikacji przepisu podana w formacie ISO 8601.

description

Text

Krótki opis potrawy.

keywords

Text

Dodatkowe określenia związane z przepisem, np. pora roku („lato”), święto („Boże Narodzenie”) lub inne jego cechy („szybki”, „łatwy”, „autentyczny”).

Dodatkowe wytyczne

  • Jeśli na liście słów kluczowych masz wiele pozycji, rozdziel je przecinkami.
  • Nie używaj określeń, które powinny występować we właściwości recipeCategory lub recipeCuisine.

    Niezalecane

    
    "keywords": "dessert, American"
    

    Zalecane

    
    "keywords": "winter apple pie, nutmeg crust"
    

nutrition.calories

Energy

Liczba kalorii w każdej porcji przygotowanej według tego przepisu. Jeśli podasz właściwość nutrition.calories, musisz określić liczbę porcji we właściwości recipeYield.

prepTime

Duration

Ilość czasu potrzebna na przygotowanie potrawy podana w formacie ISO 8601. Do określenia przedziału czasu możesz użyć elementów podrzędnych min i max.

Zawsze używaj ich w połączeniu z właściwością cookTime.

recipeCategory

Text

Rodzaj posiłku lub dania, którego dotyczy przepis, np. „kolacja”, „danie główne” lub „deser, przekąska”.

recipeCuisine

Text

Region, z którym kojarzy się Twój przepis, np. „francuski”, „śródziemnomorski” lub „polski”.

recipeIngredient

Text

Składnik używany w przepisie.

Na przykład:


"recipeIngredient": [
  "1 (15 ounce) package double crust ready-to-use pie crust",
  "6 cups thinly sliced, peeled apples (6 medium)",
  "3/4 cup sugar",
  "2 tablespoons all-purpose flour",
  "3/4 teaspoon ground cinnamon",
  "1/4 teaspoon salt",
  "1/8 teaspoon ground nutmeg",
  "1 tablespoon lemon juice"
]

Dodatkowe wskazówki:

  • Podawaj tylko te składniki, które są niezbędne do przygotowania potrawy.
  • Nie podawaj zbędnych informacji, np. definicji składnika.

recipeInstructions

HowToStep, HowToSection lub Text

Czynności, które trzeba wykonać, by przyrządzić potrawę.

Wartość właściwości recipeInstructions można podać na kilka sposobów. Zalecamy użycie znacznika HowToStep. Jeśli przepis zawiera sekcje, można też użyć znacznika HowToSection, by pogrupować elementy HowToSteps.

  • HowToStep: właściwość HowToStep pozwala określić etapy wykonywania tego przepisu.
  • HowToSection (właściwość używana tylko wtedy, gdy przepis składa się z wielu sekcji): służy do grupowania czynności w wiele sekcji. Przykład znajdziesz w sekcji HowToSection.
  • Pojedyncze lub powtórzone pole tekstowe właściwości: blok tekstu, który zawiera co najmniej jeden krok. Google traktuje wszystkie kroki jako należące do jednej sekcji. Powtórzone wartości właściwości są łączone w pojedynczy blok tekstu. Google próbuje potem automatycznie podzielić ten blok na poszczególne kroki. Stara się przy tym znajdować i usuwać wszystkie nazwy sekcji, numery kroków, słowa kluczowe i wszelkie inne elementy, które mogłyby niepotrzebnie wystąpić w treści kroku przepisu. Aby uzyskać najlepsze efekty, zalecamy jednoznaczne wskazywanie poszczególnych kroków za pomocą właściwości HowToStep.

Dodatkowe wytyczne

  • Nie dodawaj metadanych, które nie pasują do przepisów kulinarnych. W szczególności używaj pola author, by wskazać autora, a pola recipeCuisine, by podać nazwę potrawy. Poza tym kategorię wpisz w polu recipeCategory, a inne słowa kluczowe – w polu keywords.
  • Podawaj tylko sposób przyrządzenia potrawy bez dodatkowego tekstu takiego jak „Wskazówki”, „Obejrzyj film” czy „Krok 1”. Takie wyrażenia należy dodawać poza uporządkowanymi danymi.

    Niezalecane

    
    "recipeInstructions": [{
      "@type": "HowToStep",
      "text": "Step 1. Heat oven to 425°F."
    }]
    

    Zalecane

    
    "recipeInstructions": [{
      "@type": "HowToStep",
      "text": "Heat oven to 425°F."
    }]
    

recipeYield

Text lub Integer

Ilość potrawy, jaką można przygotować według tego przepisu. Określ, ile porcji można przygotować według tego przepisu, podając tylko liczbę. Jeśli chcesz użyć innej jednostki (np. liczby elementów), możesz je dodać. Jest to wymagane, jeśli podasz informacje o wartościach odżywczych porcji (np. nutrition.calories).

Przykład


"recipeYield": [
  "6",
  "24 cookies"
]

totalTime

Duration

Łączny czas przygotowywania i gotowania potrawy podany w formacie ISO 8601. Do określenia przedziału czasu możesz użyć elementów podrzędnych min i max.

Możesz używać właściwości totalTime lub kombinacji właściwości cookTimeprepTime.

video

VideoObject

Film przedstawiający czynności, które trzeba wykonać, by przygotować potrawę. Zapoznaj się z listą wymaganych i zalecanych właściwości Video.

  • Video without clips
  • Video with clips: film z klipami odpowiadającymi jego segmentom. Inne części przepisu (takie jak kroki) mogą odnosić się do klipów, które są zdefiniowane w polu video.hasPart.

video.hasPart

Clip

Klip wideo, który jest częścią całego filmu.

video.hasPart.endOffset

Number

Czas zakończeniu klipu wyrażony w postaci liczby sekund, które upłynęły od rozpoczęcia filmu.

video.hasPart.name

Text

Nazwa klipu. Na przykład „Ułóż kruchą warstwę” może być nazwą klipu, który pokazuje, jak ułożyć kruche ciasto w formie.

video.hasPart.startOffset

Number

Czas rozpoczęcia klipu wyrażony w postaci liczby sekund, które upłynęły od początku filmu.

video.hasPart.url

URL

Link do początku klipu. Początek klipu musi odpowiadać wartości określonej we właściwości video.hasPart.startOffset, np.:


"startOffset": 20,
"endOffset": 29,
"url": "https://www.example.com/example?t=20"

HowToSection

Za pomocą właściwości HowToSection pogrupuj sekwencję kroków (podsekcje), które stanowią część instrukcji w ramach przepisu. Określ właściwość HowToSection bezpośrednio w obrębie definicji właściwości recipeInstructions lub jako właściwość itemListElement innego elementu HowToSection.

Typ HowToSection określa sekcję pojedynczego przepisu i zawiera co najmniej jeden krok. Nie określaj różnych przepisów na tę samą potrawę za pomocą znacznika HowToSection. Typ HowToSection powinien być raczej częścią jednego przepisu. Aby wymienić wiele przepisów na określoną potrawę, użyj wielu obiektów Recipe, np. wiele sposobów na wykonanie szarlotki powinno być wymienionych jako wiele obiektów Recipe, a nie obiektów HowToSection.

Pełną definicję znaczników HowToSection znajdziesz na schema.org/HowToSection.

Właściwości wymagane

itemListElement

HowToStep

Lista szczegółowych kroków danej sekcji lub podsekcji. Na przykład przepis na pizzę może zawierać jedną sekcję ze wskazówkami, jak przygotować kruchą warstwę spodnią, inną sekcję z opisem wykonania warstwy wierzchniej oraz jeszcze jedną z opisem łączenia tych warstw i pieczenia. Jeśli przepis zawiera sekcje, ale nie oznaczysz ich za pomocą właściwości HowToSections, Asystent może przez pomyłkę przedstawić nazwę sekcji jako kolejny krok (np. poda wskazówkę „Zrób kruchą warstwę”, a po niej jako następną: „Zmieszaj mąkę z drożdżami”).

Przykład


{
  "@type": "HowToSection",
  "name": "Assemble the pie",
  "itemListElement": [
    {
      "@type": "HowToStep",
      "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate."
    }, {
      "@type": "HowToStep",
      "text": "Top with second crust. Cut slits or shapes in several places in top crust."
    }
  ]
}

name

Text

Nazwa sekcji.

HowToStep

Za pomocą typu HowToStep możesz oznaczyć jedno lub kilka zdań, które wyjaśniają, jak wykonać część przepisu. Podaj te zdania we właściwości text lub określ wartości HowToDirection albo HowToTip właściwości itemListElement w przypadku każdego zdania.

Oznacz kroki przepisu za pomocą poniższych właściwości typu HowToStep. Określ właściwość HowToStep w obrębie definicji właściwości recipeInstructions lub jako właściwość itemListElement elementu HowToSection.

Pełną definicję znaczników HowToStep znajdziesz na schema.org/HowToStep.

Właściwości wymagane

itemListElement

HowToDirection lub HowToTip

Lista szczegółowych podetapów, w tym wskazówek.

Opcjonalne, jeśli używana jest właściwość text.

text

Text

Pełna treść instrukcji zawartej w danym kroku.

Opcjonalne, jeśli używana jest właściwość itemListElement. Dodatkowe wskazówki:

  • Podawaj tylko treść instrukcji bez dodatkowego tekstu takiego jak „Wskazówki”, „Obejrzyj film” czy „Krok 1”. Takie wyrażenia należy dodawać poza treściami zawierającymi znaczniki.
Właściwości zalecane

image

ImageObject lub URL

Obraz ilustrujący dany krok. Dodatkowe wytyczne dotyczące obrazów:

name

Text

Słowo lub krótkie wyrażenie podsumowujące krok (np. „Ułóż kruchą warstwę”. Nie używaj nieopisowego tekstu, np. „Krok 1: [tekst]”, ani innych form z numerem kroku, np. „1. [tekst]”.

url

URL

Adres URL prowadzący bezpośrednio do kroku (jeśli jest dostępny), np. fragment linku kotwiczącego.

video

VideoObject lub Clip

Wideo lub klip wideo przedstawiające dany krok.

W przypadku właściwości VideoObject postępuj zgodnie z listą wymaganych i zalecanych właściwości Video lub Clip.

HowToDirection i HowToTip

Użyj typów HowToDirectionHowToTip, by opisać wskazówki. Mają te same właściwości wymagane i zalecane.

Pełne definicje typów HowToDirectionHowToTip znajdziesz na schema.org/HowToDirection oraz schema.org/HowToTip.

Właściwości wymagane

text

Text

Treść wskazówki.

ItemList

Oprócz właściwości Recipe dodaj też poniższe właściwości związane z listami zależnymi od hosta. Chociaż znaczniki ItemList nie są wymagane, musisz dodać te właściwości, jeśli chcesz, by Twój przepis kwalifikował się do karuzeli hosta. Więcej informacji o karuzeli hosta znajdziesz w artykule Karuzela.

Pełną definicję znaczników ItemList znajdziesz na schema.org/ItemList.

Właściwości wymagane

itemListElement

ListItem

Adnotacja o pojedynczej stronie elementu.

ListItem.position

Integer

Pozycja porządkowa strony elementu na liście, np.:


"itemListElement": [
  {
    "@type": "ListItem",
    "position": 1,
  }, {
    "@type": "ListItem",
    "position": 2,
  }
]

ListItem.url

URL

Kanoniczny URL strony elementu. Każdy element powinien mieć niepowtarzalny adres URL.

Monitorowanie wyników z elementami rozszerzonymi w Search Console

Search Console to narzędzie, które pomaga monitorować skuteczność stron w wyszukiwarce Google. Aby Twoja witryna mogła pojawiać się w wynikach wyszukiwania Google, nie musisz rejestrować jej w Search Console. Jeśli jednak to zrobisz, lepiej zrozumiesz, jak robot Google widzi Twoją witrynę i jak możesz mu ułatwić jej skanowanie. Zalecamy sprawdzenie danych w Search Console w tych przypadkach:

  1. po pierwszym wdrożeniu uporządkowanych danych,
  2. po opublikowaniu nowych szablonów lub zaktualizowaniu kodu,
  3. podczas okresowego analizowania ruchu.

Po pierwszym wdrożeniu uporządkowanych danych

Gdy Google zindeksuje Twoje strony, poszukaj problemów w odpowiednim raporcie o stanie wyników z elementami rozszerzonymi. W idealnej sytuacji powinno się pojawić więcej prawidłowych stron, a liczba błędów i ostrzeżeń nie powinna się zwiększyć. Jeśli zauważysz problemy w uporządkowanych danych:

  1. Popraw błędy.
  2. Sprawdź opublikowany adres URL, by zobaczyć, czy problem nadal występuje.
  3. Poproś o weryfikację, korzystając z raportu o stanie.

Po opublikowaniu nowych szablonów lub zaktualizowaniu kodu

Po wprowadzeniu istotnych zmian w witrynie monitoruj liczbę błędów i ostrzeżeń dotyczących uporządkowanych danych.
  • Możesz zauważyć większą liczbę błędów, jeśli wprowadzisz nowy szablon, który nie działa, lub jeśli Twoja witryna wykorzystuje istniejący szablon w nowy i nieprawidłowy sposób.
  • Jeśli okaże się, że jest mniej prawidłowych elementów (ale liczba błędów się nie zwiększyła), być może na swoich stronach nie umieszczasz już uporządkowanych danych. Użyj narzędzia do sprawdzania adresów URL, by dowiedzieć się, co jest przyczyną problemu.

Okresowe analizowanie ruchu

Analizuj ruch w wyszukiwarce Google za pomocą raportu skuteczności. Zawarte w nim dane pokazują, jak często Twoja strona wyświetla się w wyszukiwarce jako wynik z elementami rozszerzonymi, jak często użytkownicy ją klikają i jaka jest jej średnia pozycja w wynikach wyszukiwania. Możesz też pobrać te wyniki automatycznie za pomocą interfejsu Search Console API.

Rozwiązywanie problemów

Jeśli masz problem z zastosowaniem uporządkowanych danych, skorzystaj z tych rozwiązań: