Data terstruktur resep (Recipe, HowTo, ItemList)

Bantu pengguna menemukan konten resep Anda dengan memberi tahu Google terkait resep Anda menggunakan data terstruktur. Jika Anda menyediakan informasi seperti rating pengulas, waktu memasak dan persiapan, serta informasi nutrisi, Google dapat lebih memahami resep Anda dan menyajikannya kepada pengguna dengan cara yang menarik. Resep dapat muncul di hasil Google Penelusuran dan Google Gambar.

Ilustrasi tampilan hasil kaya resep di Google Penelusuran. Ilustrasi ini berisi 4 hasil kaya dari situs yang berbeda, dengan detail waktu yang diperlukan untuk memasak resep, gambar, dan informasi ulasan. Ilustrasi tampilan resep di Google Gambar. Ada 6 hasil gambar yang menunjukkan item makanan yang berbeda, dengan 3 hasil berisi badge resep yang memberi tahu pengguna bahwa itu adalah resep

Berdasarkan cara Anda me-markup konten, resep Anda dapat memenuhi syarat untuk peningkatan penelusuran berikut:

Peningkatan penelusuran resep
Resep Terpandu: Memungkinkan Asisten Google memandu pengguna mengakses resep Anda di Google Home dan layar smart dengan menambahkan data terstruktur Recipe. Ada beberapa properti tambahan yang diperlukan untuk Resep Terpandu, tetapi hanya direkomendasikan untuk Google Penelusuran. Pastikan Anda menambahkan recipeIngredient dan recipeInstructions. Jika Anda menambahkan properti video, properti contentUrl juga harus ditambahkan.

Untuk informasi selengkapnya terkait resep di Asisten Google, pelajari cara membuat Action dari konten web.

Ilustrasi tampilan resep terpandu di Google Home melalui Asisten Google. Ilustrasi ini menunjukkan Asisten Google yang merespons permintaan pengguna dengan daftar kemungkinan resep untuk dimasak
Carousel host resep: Memungkinkan pengguna menjelajahi halaman galeri resep Anda dengan menambahkan data terstruktur ItemList. Ilustrasi tampilan carousel host resep di Google Penelusuran. Ilustrasi ini menunjukkan 3 resep yang berbeda dari situs yang sama dalam format carousel di mana pengguna dapat menjelajahi dan memilih resep tertentu

Cara menambahkan data terstruktur

Data terstruktur adalah format terstandarisasi untuk memberikan informasi tentang suatu halaman dan mengelompokkan konten halaman tersebut. Jika Anda baru mengenal data terstruktur, Anda dapat mempelajari lebih lanjut cara kerja data terstruktur.

Berikut adalah ringkasan tentang cara membuat, menguji, dan merilis data terstruktur. Untuk panduan langkah demi langkah tentang cara menambahkan data terstruktur ke halaman web, lihat codelab data terstruktur.

  1. Tambahkan properti wajib. Berdasarkan format yang Anda gunakan, pelajari tempat menyisipkan data terstruktur di halaman.
  2. Ikuti pedoman.
  3. Validasi kode Anda menggunakan Pengujian Hasil Kaya dan perbaiki setiap error kritis. Pertimbangkan juga untuk memperbaiki masalah non-kritis yang mungkin ditandai di alat tersebut, karena tindakan ini dapat membantu meningkatkan kualitas data terstruktur Anda (tetapi hal ini tidak diperlukan agar memenuhi syarat untuk hasil kaya).
  4. Deploy beberapa halaman yang menyertakan data terstruktur dan gunakan Alat Inspeksi URL untuk menguji cara Google melihat halaman tersebut. Pastikan halaman Anda dapat diakses oleh Google dan tidak diblokir oleh file robots.txt, tag noindex, atau persyaratan login. Jika halaman tidak bermasalah, Anda dapat meminta Google meng-crawl ulang URL tersebut.
  5. Agar Google tetap mengetahui setiap perubahan pada masa mendatang, sebaiknya kirimkan peta situs. Anda dapat mengotomatiskan proses ini dengan Search Console Sitemap API.

Contoh

Berikut beberapa contoh resep yang menggunakan kode JSON-LD.

Resep Terpandu

Berikut contoh halaman yang memenuhi syarat untuk ditampilkan di Google Penelusuran dan sebagai Resep Terpandu di Asisten.

<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": "https://www.example.com/video123.mp4",
        "embedUrl": "https://www.example.com/videoplayer?video=123",
        "uploadDate": "2018-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2019-02-05T08:00:00+08:00"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Resep di Penelusuran

Berikut contoh halaman yang memenuhi syarat untuk ditampilkan di Penelusuran.

<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": "https://www.example.com/video123.mp4",
        "embedUrl": "https://www.example.com/videoplayer?video=123",
        "uploadDate": "2018-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2019-02-05T08:00:00+08:00"
       }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Berikut contoh halaman ringkasan resep (halaman yang berisi daftar resep) dengan data terstruktur itemList. Konten ini mungkin memenuhi syarat untuk ditampilkan dalam petak pada hasil Penelusuran.

<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>

Panduan

Anda harus mengikuti panduan umum data terstruktur agar resep Anda memenuhi syarat untuk ditampilkan pada hasil Penelusuran. Jika ingin resep Anda ditampilkan sebagai Resep Terpandu di Asisten, pastikan konten Anda mematuhi kebijakan pembatasan konten untuk Asisten.

Panduan berikut berlaku untuk data terstruktur Recipe.

  • Gunakan data terstruktur Recipe untuk konten tentang menyiapkan hidangan tertentu. Misalnya, "scrub wajah" atau "ide pesta" bukanlah nama yang valid untuk hidangan.
  • Agar resep Anda muncul dalam carousel atau petak, Anda harus mengikuti panduan ini:
    • Sediakan data terstruktur ItemList guna meringkas resep untuk daftar Anda. Anda dapat menyediakan data terstruktur ItemList secara terpisah atau bersama dengan data terstruktur resep.
    • Situs Anda harus memiliki halaman ringkasan yang mencantumkan semua resep dalam koleksi. Misalnya, saat pengguna mengklik link ringkasan dari hasil Penelusuran, mereka akan diarahkan secara tepat ke halaman di situs Anda yang mencantumkan resep yang terkait dengan penelusuran mereka.

Definisi jenis data terstruktur

Anda harus menyertakan properti wajib agar konten Anda memenuhi syarat untuk ditampilkan sebagai hasil kaya di Google Penelusuran. Anda juga dapat menyertakan properti yang direkomendasikan untuk menambahkan informasi lain tentang konten, yang akan meningkatkan kualitas pengalaman pengguna.

Recipe

Markup konten resep Anda dengan properti jenis Recipe schema.org berikut. Definisi lengkap Recipe tersedia di schema.org/Recipe. Properti yang didukung Google adalah sebagai berikut:

Properti wajib
image

URL atau ImageObject

Gambar hidangan yang sudah jadi.

Pedoman gambar tambahan:

  • Setiap halaman harus memuat setidaknya satu gambar (baik Anda menyertakan markup ataupun tidak). Google akan memilih gambar terbaik untuk ditampilkan dalam hasil Penelusuran berdasarkan rasio lebar tinggi dan resolusi.
  • URL gambar harus dapat di-crawl dan diindeks. Untuk memeriksa apakah Google dapat mengakses URL Anda, gunakan Alat Inspeksi URL.
  • Gambar harus mewakili konten yang di-markup.
  • Gambar harus dalam format file yang didukung oleh Google Gambar.
  • Untuk hasil terbaik, sebaiknya sediakan beberapa gambar beresolusi tinggi (minimal 50 ribu piksel saat mengalikan lebar dan tinggi) dengan rasio aspek berikut: 16x9, 4x3, dan 1x1.

Contoh:

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

Text

Nama hidangan.

Properti yang direkomendasikan
aggregateRating

AggregateRating

Anotasi untuk skor ulasan rata-rata yang ditetapkan ke item. Ikuti Panduan cuplikan ulasan dan daftar properti AggregateRating yang wajib dan direkomendasikan.

Jika data terstruktur Recipe berisi satu ulasan, nama pengulas harus berupa orang atau organisasi yang valid. Misalnya, "Diskon 50% untuk bahan" bukanlah nama yang valid untuk pengulas.

author

Person atau Organization

Nama orang atau organisasi yang menulis resep. Untuk membantu Google memahami penulis secara optimal di berbagai fitur, sebaiknya ikuti praktik terbaik markup penulis.

cookTime

Duration

Waktu yang diperlukan untuk memasak hidangan dalam format ISO 8601.

Selalu gunakan bersama dengan prepTime.

datePublished

Date

Tanggal publikasi resep, dalam format ISO 8601.

description

Text

Ringkasan singkat yang mendeskripsikan hidangan.

keywords

Text

Istilah lain untuk resep Anda seperti musim (“musim panas”), hari raya (“Lebaran“), atau deskriptor lainnya (“cepat”, “mudah”, “autentik”).

Panduan tambahan

  • Gunakan koma untuk memisahkan beberapa entri dalam daftar kata kunci.
  • Jangan gunakan tag yang sebenarnya merupakan recipeCategory atau recipeCuisine.

    Tidak direkomendasikan:

    
    "keywords": "dessert, American"
    

    Direkomendasikan:

    
    "keywords": "winter apple pie, nutmeg crust"
    
nutrition.calories

Energy

Jumlah kalori dalam setiap porsi yang dihasilkan dengan resep ini. Jika nutrition.calories ditentukan, recipeYield harus ditentukan dengan jumlah porsi.

prepTime

Duration

Durasi waktu yang diperlukan untuk menyiapkan dan memasak hidangan, dalam format ISO 8601.

Selalu gunakan bersama dengan cookTime.

recipeCategory

Text

Jenis makanan atau hidangan atau waktu hidang dari resep Anda. Misalnya: "makan malam", "hidangan utama", atau "hidangan penutup, camilan".

recipeCuisine

Text

Wilayah yang terkait dengan resep Anda. Misalnya, "Prancis", "Mediterania", atau "Amerika".

recipeIngredient

Text

Bahan yang digunakan dalam resep.

Contoh:


"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"
]

Panduan tambahan:

  • Sertakan hanya teks bahan yang diperlukan untuk membuat resep.
  • Jangan sertakan informasi yang tidak perlu, seperti definisi bahan.
recipeInstructions

HowToStep, HowToSection, atau Text

Langkah-langkah untuk membuat hidangan.

Ada beberapa opsi untuk menetapkan nilai recipeInstructions. Sebaiknya gunakan HowToStep. HowToSection juga dapat digunakan untuk mengelompokkan HowToSteps jika resep memiliki beberapa bagian.

  • HowToStep: Tentukan langkah-langkah resep ini dengan HowToStep.
    
    "recipeInstructions": [
      {
        "@type": "HowToStep",
        "name": "Preheat",
        "text": "Heat oven to 425°F.",
        "url": "https://example.com/recipe#step1",
        "image": "https://example.com/photos/recipe/step1.jpg"
      }, {
        "@type": "HowToStep",
        "name": "Prepare crust",
        "text": "Place 1 pie crust in ungreased 9-inch glass pie plate, pressing firmly against side and bottom.",
        "url": "https://example.com/recipe#step2",
        "image": "https://example.com/photos/recipe/step2.jpg"
      }, {
        "@type": "HowToStep",
        "name": "Make filling",
        "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate.",
        "url": "https://example.com/recipe#step3",
        "image": "https://example.com/photos/recipe/step3.jpg"
      }, {
        "@type": "HowToStep",
        "name": "Cover",
        "text": "Top with second crust. Cut slits or shapes in several places in top crust.",
        "url": "https://example.com/recipe#step4",
        "image": "https://example.com/photos/recipe/step4.jpg"
      }, {
        "@type": "HowToStep",
        "name": "Bake",
        "text": "Bake 40 to 45 minutes. The pie is ready when the apples are tender and the crust is golden brown.",
        "url": "https://example.com/recipe#step5",
        "image": "https://example.com/photos/recipe/step5.jpg"
      }, {
        "@type": "HowToStep",
        "name": "Cool",
        "text": "Cool on cooling rack at least 2 hours before serving.",
        "url": "https://example.com/recipe#step6",
        "image": "https://example.com/photos/recipe/step6.jpg"
      }
    ]
    
  • HowToSection (hanya gunakan jika resep terdiri dari beberapa bagian): Gunakan untuk mengelompokkan langkah menjadi beberapa bagian. Lihat HowToSection sebagai contoh.
  • Properti teks tunggal atau berulang: Blok teks yang mencakup satu atau beberapa langkah. Google memperlakukan semua langkah sebagai bagian tunggal. Nilai properti berulang dirangkai menjadi satu blok teks tunggal. Selanjutnya, Google mencoba untuk otomatis memecah blok teks tunggal ini menjadi beberapa langkah terpisah. Google mencoba mencari dan menghapus nama bagian, nomor langkah, kata kunci, dan apa saja yang dapat keliru muncul dalam teks langkah resep. Untuk hasil terbaik, sebaiknya tentukan langkah-langkah secara jelas dengan HowToStep.
    
    "recipeInstructions": [
      "In large bowl, gently mix filling ingredients; spoon into crust-lined pie
    plate. Top with second crust. Cut slits or shapes in several places in top
    crust. Bake 40 to 45 minutes. The pie is ready when the or until apples are
    tender and the crust is golden brown. Cool on cooling rack at least 2 hours
    before serving."
    ]
    

Panduan tambahan

  • Jangan sertakan metadata yang sudah dicakup di tempat lain. Secara khusus, gunakan properti author untuk menentukan penulis, recipeCuisine untuk masakan, recipeCategory untuk kategori, dan keywords untuk kata kunci lainnya.
  • Hanya sertakan teks tentang cara membuat hidangan; jangan sertakan teks lain seperti "Arahan", "Tonton video", "Langkah 1". Cantumkan frasa tersebut di luar data terstruktur.

    Tidak direkomendasikan:

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

    Direkomendasikan:

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

Text atau Integer

Jumlah yang dihasilkan oleh resep. Tentukan jumlah porsi yang dihasilkan dari resep ini hanya dengan angka. Jika Anda ingin menggunakan unit lain (misalnya jumlah item), Anda dapat menyertakan hasil tambahan. Ini diperlukan jika Anda menentukan informasi gizi per porsi (seperti nutrition.calories).

Contoh


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

Duration

Total waktu yang diperlukan untuk menyiapkan dan memasak hidangan, dalam format ISO 8601.

Gunakan totalTime atau kombinasi cookTime dan prepTime.

video VideoObject

Video yang menunjukkan langkah-langkah untuk membuat hidangan. Ikuti daftar Properti video yang wajib dan direkomendasikan.

  • Video without clips
    
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "video": [
        {
          "@type": "VideoObject",
          "name": "Delicious PieParty Coffee Cake",
          "description": "How to make a delicious pie - quickly and easily!How to make 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": "https://www.example.com/videos/123_600x400.mp4",
          "embedUrl": "https://www.example.com/videoplayer?id=123",
          "uploadDate": "2018-02-05T08:00:00+08:00"
        }
      ]
    }
    ]
    
  • Video with clips: Video dengan klip yang sesuai dengan segmen video. Bagian lain dari resep tersebut (seperti langkah-langkah) dapat merujuk ke klip ini, yang ditentukan dalam video.hasPart.
    
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "video": {
        "@type": "VideoObject",
        "name": "Make a pie",
        "description": "How to make a delicious pie - quickly and easily!",
        "thumbnailUrl": "https://example.com/photos/photo.jpg",
        "contentUrl": "https://www.example.com/videos/123_600x400.mp4",
        "embedUrl": "https://www.example.com/videoplayer?id=123",
        "uploadDate": "2018-02-05T08:00:00+08:00",
        "duration": "P1MT10S",
        "hasPart": [{
          "@type": "Clip",
          "@id": "Clip1",
          "name": "Preheat oven",
          "startOffset": 20,
          "endOffset": 29
          "url": "https://www.example.com/example?t=20"
         },
         {
           "@type": "Clip",
           "@id": "Clip2",
           "name": "Arrange pie crust",
           "startOffset": 29,
           "endOffset": 36
           "url": "https://www.example.com/example?t=29"
         },
         {
           "@type": "Clip",
           "@id": "Clip3",
           "name": "Make filling",
           "startOffset": 36,
           "endOffset": 45
           "url": "https://www.example.com/example?t=36"
         },
         {
           "@type": "Clip",
           "@id": "Clip4",
           "name": "Add filling",
           "startOffset": 45,
           "endOffset": 65
           "url": "https://www.example.com/example?t=45"
         },
         {
           "@type": "Clip",
           "@id": "Clip5",
           "name": "Bake",
           "startOffset": 65,
           "endOffset": 80
           "url": "https://www.example.com/example?t=65"
         },
         {
           "@type": "Clip",
           "@id": "Clip6",
           "name": "Let cool",
           "startOffset": 80,
           "endOffset": 90
           "url": "https://www.example.com/example?t=80"
        }]
      }
    }
    
video.contentUrl

URL

URL yang mengarah ke file media video yang sebenarnya, dalam salah satu format encoding yang didukung. Jangan menautkan ke halaman tempat video ditayangkan, ini harus berupa URL file media video itu sendiri.


"contentUrl": "https://www.example.com/video/123/file.mp4"

Pastikan untuk mengikuti Praktik terbaik video kami.

video.hasPart

Clip

Klip video yang menjadi bagian dari keseluruhan video.

video.hasPart.endOffset

Number

Waktu berakhir klip yang dinyatakan dalam jumlah detik dari awal video.

video.hasPart.name

Text

Nama klip. Misalnya, "Menyusun kulit pai" adalah nama klip yang menunjukkan cara menata dan menekan kulit pai di piring pai.

video.hasPart.startOffset

Number

Waktu mulai klip yang dinyatakan dalam jumlah detik dari awal video.

video.hasPart.url

URL

Link ke awal klip. Bagian awal klip harus cocok dengan nilai yang ditetapkan pada video.hasPart.startOffset. Contoh:


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

HowToSection

Gunakan HowToSection untuk mengelompokkan urutan langkah (atau sub-bagian) yang merupakan bagian dari petunjuk untuk resep. Tentukan HowToSection langsung dalam definisi properti recipeInstructions, atau sebagai itemListElement dari HowToSection lain.

Jenis HowToSection menentukan bagian dari satu resep dan berisi satu atau beberapa langkah. Jangan gunakan HowToSection untuk menentukan resep yang berbeda pada hidangan yang sama; sebagai gantinya, gunakan HowToSection sebagai bagian dari satu resep. Untuk mencantumkan beberapa resep hidangan, gunakan beberapa objek Recipe. Misalnya, untuk beberapa cara membuat pai apel, cantumkan sebagai beberapa objek Recipe, bukan objek HowToSection.

Definisi lengkap HowToSection tersedia di schema.org/HowToSection.

Properti wajib
itemListElement HowToStep

Daftar langkah-langkah detail untuk bagian, dan/atau sub-bagian. Misalnya, resep piza dapat memiliki satu bagian yang berisi langkah-langkah membuat kulit, satu bagian tentang menyiapkan taburan, dan satu bagian tentang mencampur serta memanggang. Jika suatu resep memiliki bagian, tetapi tidak ditentukan dengan HowToSections, Asisten mungkin salah menyajikan nama bagian sebagai langkah saja (misalnya, langkah "Membuat kulit" diikuti dengan langkah "Mencampur tepung dan ragi").

Contoh:


{
  "@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

Nama bagian.

HowToStep

Gunakan HowToStep untuk mengelompokkan satu atau beberapa kalimat yang menjelaskan cara melakukan bagian dari resep. Tentukan properti text dengan kalimat atau, tentukan itemListElement dengan HowToDirection atau HowToTip untuk setiap kalimat.

Markup langkah resep Anda dengan properti berikut dari jenis HowToStep. Tentukan HowToStep langsung dalam definisi properti recipeInstructions, atau sebagai itemListElement dari HowToSection.

Definisi lengkap HowToStep tersedia di schema.org/HowToStep.

Properti wajib
itemListElement HowToDirection atau HowToTip

Daftar sub-langkah detail, termasuk arahan atau tips.

Opsional jika text digunakan.

text Text

Teks petunjuk lengkap dari langkah ini.

Opsional jika itemListElement digunakan. Panduan tambahan:

  • Hanya sertakan teks petunjuk dan jangan sertakan teks lain seperti "Arahan", "Tonton video", "Langkah 1". Tentukan frasa tersebut di luar properti yang di-markup.

    Tidak direkomendasikan:

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

    Direkomendasikan:

    
    {
      "@type": "HowToStep",
      "text": "Heat oven to 425°F."
    }
    
Properti yang direkomendasikan
image ImageObject atau URL

Gambar untuk langkah. Panduan tambahan terkait gambar:

  • URL gambar harus dapat di-crawl dan diindeks.
  • Gambar harus mewakili konten yang di-markup.
  • Gambar harus dalam format .jpg, .png, atau .gif.
name Text

Kata atau frasa singkat yang meringkas langkah (misalnya, "Menyusun kulit pai"). Jangan menggunakan teks non-deskriptif (misalnya "Langkah 1: [teks]") atau bentuk langkah lainnya yang mencantumkan nomor (misalnya "1. [teks]").

url URL

URL yang langsung menautkan ke langkah (jika tersedia). Misalnya, fragmen link anchor.

video VideoObject atau Clip

Video untuk langkah ini atau klip video.

Untuk VideoObject, Ikuti daftar properti Video atau Klip yang wajib dan direkomendasikan.

HowToDirection dan HowToTip

Gunakan HowToDirection dan HowToTip untuk mendeskripsikan arahan atau tips. Keduanya memiliki properti wajib dan direkomendasikan yang sama.

Definisi lengkap HowToDirection dan HowToTip tersedia di schema.org/HowToDirection dan schema.org/HowToTip.

Properti wajib
text Text

Teks arahan atau tips.

ItemList

Selain properti Recipe, tambahkan properti berikut untuk daftar khusus host. Meskipun ItemList tidak diwajibkan, Anda harus menambahkan properti berikut jika ingin resep Anda memenuhi syarat untuk carousel host. Untuk informasi lebih lanjut tentang carousel host, lihat Carousel.

Definisi lengkap ItemList tersedia di schema.org/ItemList.

Properti wajib
itemListElement

ListItem

Anotasi untuk satu halaman item.

ListItem.position

Integer

Posisi ordinal halaman item dalam daftar. Contoh:


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

URL

URL kanonis halaman item. Setiap item harus memiliki URL unik.

Memantau hasil kaya dengan Search Console

Search Console adalah alat yang dapat membantu Anda memantau performa halaman Anda di Google Penelusuran. Anda tidak perlu mendaftar ke Search Console agar halaman Anda dapat disertakan dalam hasil Google Penelusuran. Tetapi dengan mendaftar, Anda dapat memahami dan meningkatkan cara Google melihat situs Anda dengan mudah. Sebaiknya Anda memeriksa Search Console dalam kasus berikut:

  1. Setelah men-deploy data terstruktur untuk pertama kalinya
  2. Setelah merilis template baru atau memperbarui kode
  3. Menganalisis traffic secara berkala

Setelah men-deploy data terstruktur untuk pertama kalinya

Setelah Google mengindeks halaman Anda, temukan masalah menggunakan laporan status Hasil kaya yang relevan. Idealnya, akan ada peningkatan jumlah item yang valid, sedangkan jumlah item yang tidak valid tidak berubah. Jika Anda menemukan masalah pada data terstruktur Anda:

  1. Perbaiki item yang tidak valid.
  2. Periksa URL aktif untuk memeriksa apakah masalah terus berlanjut.
  3. Minta validasi menggunakan laporan status.

Setelah merilis template baru atau memperbarui kode Anda

Saat Anda membuat perubahan yang signifikan pada situs, pantau peningkatan jumlah item yang tidak valid pada data terstruktur.
  • Jika terjadi peningkatan jumlah item yang tidak valid, mungkin Anda meluncurkan template baru yang tidak berfungsi, atau situs Anda berinteraksi dengan template yang ada dengan cara baru yang salah.
  • Jika terjadi penurunan jumlah item yang valid (tidak cocok dengan peningkatan jumlah item yang tidak valid), mungkin Anda tidak lagi menyematkan data terstruktur di halaman Anda. Gunakan Alat Inspeksi URL untuk mempelajari penyebab masalah tersebut.

Menganalisis traffic secara berkala

Analisis traffic Google Penelusuran Anda menggunakan Laporan Performa. Data akan menunjukkan seberapa sering halaman Anda muncul sebagai hasil kaya di Penelusuran, seberapa sering pengguna mengkliknya, dan posisi rata-rata halaman Anda saat muncul di hasil penelusuran. Anda juga dapat otomatis menarik hasil ini dengan Search Console API.

Pemecahan masalah

Jika Anda mengalami masalah saat menerapkan atau mendebug data terstruktur, berikut beberapa referensi yang dapat membantu Anda.

  • Jika Anda menggunakan sistem pengelolaan konten (CMS) atau ada orang lain yang menangani situs Anda, minta mereka untuk membantu Anda. Pastikan untuk meneruskan pesan Search Console yang menjelaskan masalah tersebut kepada mereka.
  • Google tidak menjamin bahwa fitur yang menggunakan data terstruktur akan muncul dalam hasil penelusuran. Untuk mengetahui daftar alasan umum mengapa Google tidak dapat menampilkan konten Anda dalam hasil kaya, lihat Panduan Umum terkait Data Terstruktur.
  • Mungkin ada error dalam data terstruktur Anda. Periksa daftar error data terstruktur.
  • Jika halaman Anda dikenai tindakan manual data terstruktur, data terstruktur pada halaman itu akan diabaikan (meskipun halaman masih bisa muncul di hasil Google Penelusuran). Untuk memperbaiki masalah data terstruktur, gunakan laporan Tindakan Manual.
  • Tinjau panduan lagi untuk mengidentifikasi apakah konten Anda tidak mematuhi panduan. Masalah itu mungkin disebabkan oleh konten yang berisi spam atau penggunaan markup yang berisi spam. Namun, masalahnya mungkin bukan pada sintaksis, sehingga Pengujian Hasil Kaya tidak akan dapat mengidentifikasi masalah tersebut.
  • Pecahkan masalah hasil kaya tidak ada/penurunan jumlah hasil kaya.
  • Tunggu hingga crawling dan pengindeksan ulang selesai. Perlu diingat bahwa Google mungkin memerlukan waktu beberapa hari untuk mencari dan meng-crawl halaman setelah Anda memublikasikannya. Untuk pertanyaan umum terkait crawling dan pengindeksan, lihat FAQ crawling dan pengindeksan Google Penelusuran.
  • Posting pertanyaan di forum Pusat Google Penelusuran.