Apa itu structured data, apa yang didapat darinya, aturan dasar Google, cara memasang JSON-LD dengan aman di Next.js, dan alat untuk mengujinya.
14m bacaanKuis WajibMicro Badge Lesson
JSON-LD: cara kerja dan cara mengujinya
Dari teks halaman, Google bisa menebak bahwa sebuah halaman membahas "Belajar Next.js Full Stack". Tapi apakah itu artikel, course, produk, atau event? Siapa penyelenggaranya? Structured data menjawab pertanyaan itu secara eksplisit, dalam format yang bisa dibaca mesin.
Kosakata schema.org, format JSON-LD
Structured data memakai kosakata dari schema.org: daftar jenis (Course, Article, Organization, Product) beserta propertinya (name, description, provider). Kosakata itu bisa ditulis dalam beberapa format. Google merekomendasikan JSON-LD, karena ditulis terpisah dari HTML yang tampil:
html
<script type="application/ld+json">{ "@context": "https://schema.org", "@type": "Course", "name": "Belajar Next.js Full Stack", "description": "Bangun aplikasi web lengkap dengan Next.js.", "provider": { "@type": "Organization", "name": "Mahir.dev Academy", "url": "https://mahir.dev" }}</script>
@context menyatakan kosakata yang dipakai.
@type adalah jenis entitas.
properti lain mengisi detailnya, dan nilainya bisa berupa entitas lain (seperti provider di atas).
Apa yang didapat dari structured data
Structured data bukan sinyal ranking langsung. Manfaatnya ada dua:
Rich result. Untuk jenis tertentu, Google bisa menampilkan hasil pencarian yang lebih kaya: breadcrumb di bawah judul, rating bintang, harga produk, atau carousel. Jenis yang didukung tercantum di galeri structured data Google Search Central.
Pemahaman entitas. Mesin pencari dan sistem lain (termasuk yang membaca halaman untuk menjawab pertanyaan) bisa memahami hubungan antar entitas: course ini diselenggarakan organisasi itu, lesson ini bagian dari course itu.
Daftar rich result yang didukung Google berubah dari waktu ke waktu. Sejak 2025 Google menghentikan beberapa jenis, termasuk rich result Course info. Rich result FAQ berhenti tampil di Google Search sejak Mei 2026. Sebelum memasang structured data demi rich result tertentu, cek dulu apakah jenis itu masih ada di galeri.
Aturan dasar dari Google
Sesuai dengan konten yang terlihat. Structured data harus menggambarkan isi halaman yang bisa dilihat pengunjung. Rating yang tidak ditampilkan, harga yang berbeda, atau FAQ yang tidak ada di halaman melanggar pedoman Google.
Lengkap dan akurat. Properti wajib (required) harus ada supaya halaman eligible untuk rich result. Properti yang disarankan (recommended) menambah peluang. Nilai yang ditebak atau dikarang lebih buruk daripada properti yang dikosongkan.
Eligible bukan berarti pasti tampil. Markup yang valid membuat halaman memenuhi syarat. Google tetap memutuskan kapan rich result ditampilkan.
JSON-LD di Next.js
Dokumentasi Next.js merekomendasikan tag <script> biasa di page.tsx atau layout.tsx, bukan next/script. JSON-LD adalah data, bukan kode yang perlu dijalankan.
Ada satu hal penting: kalau data berasal dari database atau input pengguna, JSON.stringify saja tidak cukup. Judul course yang berisi </script><script>... bisa menutup tag dan menyisipkan script berbahaya (XSS). Karena itu karakter < perlu diganti dengan <.
Mahir.dev membungkusnya dalam satu komponen di src/components/JsonLd.tsx:
Karakter > dan & juga di-escape untuk lapisan tambahan. Dengan komponen ini, setiap halaman cukup menulis <JsonLd data={courseJsonLd(course)} />, dan escape tidak bisa terlupa.
Untuk tipe data TypeScript yang sesuai schema.org, ada paket komunitas schema-dts.
Menguji structured data
Rich Results Test (search.google.com/test/rich-results): mengecek apakah halaman eligible untuk rich result Google dan menampilkan error serta peringatan per properti. Bisa menguji URL publik atau potongan kode.
Schema Markup Validator (validator.schema.org): memvalidasi terhadap kosakata schema.org secara umum, termasuk jenis yang tidak punya rich result di Google.
Search Console: untuk jenis yang didukung, ada laporan di bagian Enhancements yang menunjukkan jumlah halaman valid dan yang bermasalah di seluruh web.
Urutan kerjanya: uji potongan kode di Rich Results Test saat pengembangan, uji URL setelah deploy, lalu pantau laporan Search Console untuk masalah yang muncul di skala seluruh web.
Rich Results Test untuk mahir.dev/belajar/belajar-nextjs-full-stack (17 Nov 2026). Klik setiap baris untuk melihat properti yang terbaca beserta error atau peringatannya. Perhatikan bahwa "valid" artinya markup memenuhi syarat teknis, belum berarti rich result pasti tampil. Course list item di sini valid, tapi Google hanya menampilkan rich result Course list untuk konten berbahasa Inggris (lesson 27). Tombol VIEW TESTED PAGE menampilkan HTML hasil render yang dilihat Google.
Latihan
Buka satu halaman web yang kamu kelola di Rich Results Test. Catat jenis structured data yang terdeteksi.
Buka view-source: halaman yang sama dan cari application/ld+json.
Cek apakah komponen JSON-LD di proyekmu meng-escape karakter < untuk data yang berasal dari database.
Checkpoint KuisTarget: 70%
Kuis: JSON-LD dasar
Kuis ini wajib untuk sertifikat. Kamu tetap bisa lanjut ke pelajaran berikutnya dan mengerjakannya nanti.