Carousels

Anda dapat menggunakan data terstruktur untuk menjadikan hasil kaya Anda memenuhi syarat untuk ditampilkan dalam tampilan seperti daftar yang disebut carousel. Carousel biasanya hanya muncul di perangkat seluler, dan hanya untuk jenis konten tertentu, seperti yang dijelaskan di bawah ini. Jika Anda menggunakan markup carousel untuk jenis konten yang belum didukung dalam format carousel, hal itu tidak termasuk error; informasi tersebut masih bisa ditampilkan, tapi tidak dalam format carousel.

Dalam beberapa kasus, Google Penelusuran dapat menampilkan hasil kaya dalam carousel walaupun halaman itu tidak menyertakan data terstruktur untuk daftar: misalnya, suatu resep mungkin muncul di carousel resep yang mencantumkan hasil dari beberapa situs berbeda.

Contoh

Berikut ini daftar resep ayam dari satu situs yang ditampilkan dalam carousel:

Carousel hasil kaya resep

Panduan

Selain panduan data terstruktur standar, panduan berikut berlaku untuk semua markup daftar:

  • Semua item dalam daftar harus berjenis sama, misalnya: Article atau Recipe.
  • Teks yang terlihat oleh pengguna harus serupa dengan informasi yang dimuat dalam data terstruktur pada halaman.
  • Item yang ditampilkan dalam format daftar akan ditampilkan dalam urutan yang ditentukan oleh properti position.
  • Format daftar saat ini didukung untuk jenis konten berikut: Recipe, Course, Article, Restaurant, Movie.

Ada dua cara untuk menerapkan format daftar untuk data terstruktur Anda:

  • Halaman ringkasan + beberapa halaman detail lengkap
  • Daftar tunggal, all-in-one-page (semua dalam satu halaman)

Halaman ringkasan + beberapa halaman detail lengkap

Halaman ringkasan memiliki deskripsi singkat setiap item yang ada dalam daftar, dan setiap deskripsi mengarah ke halaman detail terpisah yang berfokus sepenuhnya pada satu item.

Halaman ringkasan Halaman detail
Menentukan ItemList, di mana masing-masing ListItem hanya memiliki tiga properti: @type (disetel ke "ListItem"), position (posisi dalam daftar), dan url (URL halaman dengan detail lengkap tentang item tersebut). Menentukan elemen data terstruktur yang sesuai untuk jenis daftar tersebut.
Kode-pseudo untuk best_dessert_recipes.html:

ItemList
  itemListElement: [
    {
      @type: ListItem
      position: 1
      url: http://example.com/coffee_cake.html
    },
    {
      @type: ListItem
      position:2
      url: http://example.com/apple_pie.html,
    },
    ... more recipes ...
  ]
Kode-pseudo untuk coffee_cake.html:

@type: Recipe
name: Party Coffee Cake
author: George Smith
.... more properties ...

Contoh kode:

Contoh kode:

Daftar tunggal, all-in-one-page (semua dalam satu halaman)

Daftar tunggal all-in-one-page menampung semua informasi daftar, termasuk teks lengkap untuk setiap item: misalnya, galeri resep untuk berbagai jenis muffin, yang semuanya dimuat dalam satu halaman.

Halaman tunggal
Menentukan ItemList, di mana setiap elemen adalah ListItem dengan properti item yang diisi dengan data terstruktur untuk jenis elemen schema.org tersebut (misalnya Movie atau Course). Halaman ini harus berisi teks yang terlihat oleh pengguna dan sebuah anchor untuk mencocokkan setiap elemen ListItem.

Kode-pseudo untuk best_dessert_recipes.html:


ItemList
  itemListElement: [
    {
      @type: ListItem
      position: 1
      item: {
        @type: Recipe
        url: http://example.com/big_list_of_recipes#recipe_1
        name: George's Cherry Pie
        author: George Smith
        ... all other required Recipe type properties ...}
    },
    {
      @type: ListItem
      position: 2
      item: {
        @type: Recipe
        url: http://example.com/big_list_of_recipes#recipe_2
        name: Party Coffee Cake
        author: Mary Stone
        ... all other required Recipe type properties ...}
    },
    ... more recipes ...
  ]
Contoh kode:

Definisi jenis data terstruktur

Untuk menentukan sebuah daftar, Anda harus menentukan sebuah ItemList yang berisi setidaknya dua ListItems. Anda harus menyertakan properti wajib agar konten Anda memenuhi syarat untuk ditampilkan sebagai hasil kaya. Anda juga dapat menyertakan properti yang direkomendasikan untuk menambahkan informasi lain tentang konten Anda, yang dapat memberikan pengalaman pengguna yang lebih baik.

ItemList

ItemList adalah item container yang menampung semua elemen dalam daftar. Jika digunakan pada halaman ringkasan, semua URL dalam daftar harus mengarah ke halaman berbeda pada domain yang sama. Jika digunakan dalam daftar all-in-one-page, semua URL harus mengarah ke halaman yang menjadi host data terstruktur daftar.

Definisi lengkap ItemList tersedia di schema.org/ItemList.

Properti wajib
itemListElement

ListItem

Daftar item. Semua item harus memiliki jenis yang sama. Lihat ListItem untuk mengetahui detailnya.

ListItem

ListItem berisi detail tentang masing-masing item dalam daftar.

  • Jika ini adalah halaman ringkasan, ListItem hanya boleh mencakup properti type, position, dan url.
  • Jika ini adalah daftar all-in-one-page, ListItem harus menyertakan semua properti schema.org tambahan untuk jenis data yang dideskripsikannya (misalnya objek Recipe atau Course).

Definisi lengkap ListItem tersedia di schema.org/ListItem.

Contoh item dalam daftar ringkasan sederhana (JSON-LD):

{
  "@type":"ListItem",
  "position":1,
  "url":"http://example.com/desserts/apple-pie"
}

Contoh item dalam daftar all-in-one (JSON-LD):

{
  "@type": "ListItem",
  "position": 1,
  "item": {
    "@type": "Recipe",
    "url": "http://example.com/desserts/pies/#apple-pie",
    "name": "Apple Pie",
    "image": "https://example.com/300px-Apple_pie.jpg",
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": "6",
      "reviewCount": "32"
    },
    "recipeYield": "8 servings",
    "recipeIngredient": [
      "Pastry crust for bottom and top",
      "1/2 cup unsalted butter",
      "3 tablespoons all-purpose flour",
      "1/4 cup water",
      "1/4 cup white sugar",
      "1/2 cup brown sugar",
      "10 cups peeled, chopped green apples"
    ], ... snip ...
  }
}
Properti wajib
item

Thing

Hanya digunakan untuk daftar all-in-one-page. Ini adalah properti wajib untuk daftar all-in-one-page. Jangan sertakan untuk halaman ringkasan. Isi objek ini dengan nilai berikut, ditambah semua anggota dari jenis data terstruktur tertentu yang dideskripsikan:

  • item.name
  • item.url
  • Semua properti lain yang wajib untuk jenis data ini, seperti yang dijelaskan dalam schema.org dan aturan yang dijelaskan dalam dokumen ini untuk jenis konten Anda (misalnya Article atau Book). Misalnya, Anda dapat memberikan properti bookFormat dan isbn untuk buku dalam daftar, serta memberikan properti prepTime dan image untuk resep.
item.name

Text

Nama string item yang ditampilkan di galeri yang dirender. Pemformatan HTML diabaikan. Ini adalah properti wajib untuk daftar all-in-one-page. Jangan sertakan untuk halaman ringkasan.

item.url

URL

URL yang sepenuhnya memenuhi syarat + anchor halaman ke item ini di halaman. Ini adalah properti wajib untuk daftar all-in-one-page. Jangan sertakan untuk halaman ringkasan. URL harus dari halaman saat ini, dan Anda harus menyertakan anchor HTML (tag <a> atau nilai name atau id) di halaman Anda di dekat teks yang terlihat oleh pengguna. Contoh: https://example.org/recipes/pies#apple_pie.

position

Integer

Posisi item dalam carousel. Ini adalah bilangan berbasis 1.

url

URL

Hanya digunakan untuk daftar halaman ringkasan. Ini adalah properti wajib untuk halaman ringkasan. Jangan sertakan untuk daftar all-in-one-page. URL kanonis dari halaman detail item. Semua URL dalam daftar harus unik, tetapi berada pada domain yang sama (domain yang sama atau sub/super-domain sebagai halaman saat ini).