Panduan data terstruktur praktis
Panduan Markup Skema JSON-LD untuk SEO Praktis
JSON-LD membantu mesin pencari memahami apa isi halaman, siapa penerbitnya, bagaimana kaitannya dengan situs Anda, dan fakta mana yang layak digunakan dalam fitur pencarian yang didukung.
Tujuan berguna bukan menambahkan semua tipe skema yang bisa ditemukan. Tujuannya adalah data terstruktur akurat yang sesuai halaman terlihat, tervalidasi dengan baik, dan tetap sinkron saat konten berubah.
Versi singkat yang berguna
Gunakan JSON-LD saat Anda dapat mendeskripsikan halaman dengan fakta jujur dan terlihat: judul, deskripsi, penulis, tanggal terbit, breadcrumb, detail produk, data video, atau konten tanya jawab yang jelas. Jangan tambahkan skema untuk menjanjikan fitur yang tidak lagi ditampilkan Google atau menandai konten yang tidak dapat dilihat pengguna.
Daftar Isi
Apa yang sebenarnya dilakukan JSON-LD
JSON-LD adalah blok data terstruktur yang dapat dibaca mesin. Biasanya berada di tag skrip di head atau body halaman dan mendeskripsikan entitas dengan kosakata schema.org. Mesin pencari menggunakannya sebagai lapisan kejelasan di atas konten yang terlihat.
Kejelasan parser
Makna
Ini mengubah fakta halaman menjadi entitas dan properti bernama, seperti Article, author, datePublished, BreadcrumbList, atau SoftwareApplication.
Fitur pencarian
Kelayakan
Ini bisa membuat halaman memenuhi syarat untuk hasil kaya yang didukung, tapi Google tetap menentukan apa yang ditampilkan berdasarkan kualitas, kebijakan, kueri, dan ketersediaan fitur.
Grafik situs
Konsistensi
Ini memberi CMS atau aplikasi Blazor Anda satu tempat terstruktur untuk menggunakan ulang URL kanonis, bahasa, judul, tanggal, gambar, dan data penerbit yang sama.
Bukan jalan pintas
Batas
Ini tidak memperbaiki konten lemah, ulasan palsu, jawaban FAQ tersembunyi, tanggal usang, atau halaman yang tidak sesuai data terstruktur.
Pilih skema sesuai fungsi halaman
Cara termudah menghindari data terstruktur spam atau duplikat adalah dengan menanyakan apa tujuan halaman. Tambahkan set skema terkecil yang menggambarkan tugas itu dengan tepat.
Konten
Article / BlogPosting
- Gunakan untuk
- Panduan, tutorial, ulasan, posting berita, dan penjelasan panjang.
- Tambahkan saat
- Halaman memiliki judul jelas, penulis atau penerbit, tanggal terbit, tanggal modifikasi, URL kanonis, dan gambar.
- Hindari saat
- Halaman ini kebanyakan berupa UI alat, daftar produk, halaman kategori, atau halaman landing yang tipis.
Navigasi
BreadcrumbList
- Gunakan untuk
- Hampir semua halaman di bawah beranda.
- Tambahkan saat
- Pengguna dapat memahami posisi halaman dalam hierarki situs.
- Hindari saat
- Jalur breadcrumb tidak sesuai dengan tautan internal, URL kanonis, atau navigasi yang terlihat.
Identitas situs
WebPage / WebSite / Organization
- Gunakan untuk
- Beranda, hub, halaman tentang, dan halaman di mana identitas penerbit penting.
- Tambahkan saat
- Anda menginginkan grafik entitas stabil yang menghubungkan halaman, situs, penerbit, dan bahasa.
- Hindari saat
- Anda menambahkan markup WebSite hanya untuk mengejar tampilan kotak pencarian sitelinks lama.
Produk atau aplikasi
Product / SoftwareApplication
- Gunakan untuk
- Alat, aplikasi, halaman SaaS, ekstensi, perangkat lunak yang dapat diunduh, atau halaman produk nyata.
- Tambahkan saat
- Konten halaman yang terlihat mencakup nama, deskripsi, OS atau kategori, harga, penawaran, dan rating saat Anda memberi markup.
- Hindari saat
- Rating, harga, ketersediaan, atau ulasan tidak terlihat oleh pengguna di halaman.
Pertanyaan
FAQPage
- Gunakan untuk
- Bagian tanya jawab yang terlihat yang benar-benar membantu pengguna memahami topik.
- Tambahkan saat
- Konten tanya jawab berguna di halaman meskipun Google tidak menampilkan hasil kaya FAQ.
- Hindari saat
- Anda menambahkan tanya jawab generik hanya untuk mengisi ruang pencarian atau mengulang jawaban yang sama di banyak halaman.
Media
VideoObject / ImageObject
- Gunakan untuk
- Halaman dengan video tersemat penting, video tutorial, atau aset gambar yang dapat dirayapi.
- Tambahkan saat
- Media adalah pusat halaman dan memiliki judul, deskripsi, thumbnail, tanggal unggah, dan URL stabil.
- Hindari saat
- Media bersifat dekoratif, tersembunyi, diblokir, atau tidak relevan dengan tujuan utama halaman.
Daftar periksa implementasi yang mencegah sebagian besar kesalahan
JSON-LD yang baik itu membosankan dengan cara terbaik: konsisten, dibuat dari bidang terpercaya, mudah divalidasi, dan sulit terlupakan saat halaman berubah.
Pilih satu entitas utama halaman
Tentukan apakah halaman terutama artikel, produk, aplikasi, video, FAQ, koleksi, atau halaman web umum. Skema sekunder harus mendukung entitas utama tersebut.
Cocokkan dengan konten yang terlihat
Setiap klaim yang diberi markup harus terlihat atau dapat disimpulkan jelas di halaman: judul, penulis, tanggal, harga, rating, tanya jawab, breadcrumb, dan gambar.
Gunakan nilai @id yang stabil
Berikan entitas penting ID stabil seperti URL kanonis ditambah #article, #webpage, #organization, atau #faq. Ini membantu parser menghubungkan bagian grafik.
Hasilkan dari metadata bersama
Gunakan ulang bidang sumber yang sama untuk membuat tag judul, meta deskripsi, URL kanonis, gambar Open Graph, tag bahasa, dan tanggal terakhir diubah.
Jaga tanggal tetap jujur
Ubah dateModified hanya saat konten halaman berubah signifikan. Jangan perbarui tanggal otomatis hanya agar terlihat lebih baru di hasil pencarian.
Buat gambar dapat dirayapi
Gunakan URL gambar absolut, dimensi yang sesuai, dan file yang tidak diblokir oleh robot, otentikasi, atau rendering hanya lazy-loading.
Render lebih awal
Di Blazor dan aplikasi JavaScript lain, lebih baik gunakan JSON-LD yang diprerender atau dirender server agar crawler melihatnya di respons HTML awal.
Validasi dan pantau
Jalankan Tes Hasil Kaya sebelum publikasi, periksa Validator Markup Skema untuk sintaks, dan pantau Search Console setelah pengindeksan.
Pola JSON-LD yang bersih untuk halaman Blazor
Untuk Blazor, pola paling aman adalah membangun skema dari metadata halaman saat inisialisasi atau prerendering, serialisasi sekali, dan render skrip application/ld+json di tempat crawler bisa melihatnya di HTML awal.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"@id": "https://example.com/en/json-ld-schema-guide/#article",
"headline": "JSON-LD Schema Markup Guide for Practical SEO",
"description": "A practical guide to choosing, generating, and validating structured data.",
"image": "https://example.com/images/json-ld-guide.png",
"datePublished": "2026-03-28T10:00:00+00:00",
"dateModified": "2026-05-31T10:00:00+00:00",
"author": {
"@type": "Organization",
"name": "Example Publisher"
},
"publisher": {
"@type": "Organization",
"name": "Example Publisher",
"logo": {
"@type": "ImageObject",
"url": "https://example.com/logo.png"
}
},
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://example.com/en/json-ld-schema-guide/"
}
}
</script>private MarkupString BuildJsonLd(PageMetaData meta)
{
var pageUrl = BuildPageUrl(meta);
var schema = new Dictionary<string, object?>
{
["@context"] = "https://schema.org",
["@type"] = "Article",
["@id"] = $"{pageUrl}#article",
["headline"] = meta.Title,
["description"] = meta.Description,
["url"] = pageUrl,
["datePublished"] = meta.Published?.ToString("O"),
["dateModified"] = meta.Modified?.ToString("O"),
["inLanguage"] = CS.Culture
};
var json = JsonSerializer.Serialize(schema, new JsonSerializerOptions
{
DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull
});
return new MarkupString($"<script type=\"application/ld+json\">{json}</script>");
}Validasi JSON-LD sebelum mengandalkannya
Validasi memiliki dua tugas berbeda. Validator Markup Skema memeriksa apakah kosakata dan sintaks JSON-LD dapat dipahami. Tes Hasil Kaya Google memeriksa apakah Google mengenali halaman sebagai memenuhi syarat untuk jenis hasil kaya yang didukung.
Kelayakan Google
Tes Hasil Kaya
Memeriksa apakah Google dapat membaca halaman dan apakah data terstruktur yang terdeteksi memenuhi syarat untuk jenis hasil kaya yang didukung.
Buka Tes Hasil KayaKosakata
Validator Schema Markup
Memeriksa struktur schema.org umum dan sintaks JSON-LD, termasuk tipe, properti, entitas bersarang, dan JSON yang salah format.
Buka Validator Markup SkemaSetelah dipublikasikan
Search Console
Gunakan laporan Inspeksi URL dan Peningkatan untuk menemukan masalah perayapan, pengindeksan, dan data terstruktur setelah Google memproses halaman.
Baca dokumen data terstruktur GoogleKesalahan JSON-LD umum yang merusak kepercayaan
Sebagian besar masalah skema bukan bug teknis kompleks. Mereka adalah ketidaksesuaian antara apa yang dikatakan markup dan apa yang dapat diverifikasi pengguna atau crawler di halaman.
Markup konten tersembunyi atau hilang
Jika pengguna tidak dapat melihat jawaban, ulasan, penawaran, gambar, atau klaim penulis, jangan masukkan ke data terstruktur. Ini cara tercepat kehilangan kepercayaan.
Menambahkan FAQPage ke semua hal
Skema FAQ masih bisa mendeskripsikan tanya jawab yang terlihat, tapi jangan dijadikan blok salin-tempel di setiap artikel. Gunakan hanya jika tanya jawab memperbaiki halaman.
Skrip duplikat yang bertentangan
Beberapa blok Artikel dengan judul, tanggal, atau URL berbeda membuat halaman sulit diinterpretasi. Satu grafik jelas lebih baik daripada tiga yang parsial.
Kanonis atau @id salah
URL skema harus sesuai dengan halaman kanonis, URL budaya, dan pengaturan hreflang. URL campuran bahasa menyebabkan duplikat konten dan kebingungan entitas.
Kesegaran palsu
Jangan ubah dateModified untuk edit template, perubahan pelacakan, atau pembaruan hanya skema. Gunakan tanggal untuk perubahan konten nyata.
Rendering terlambat hanya klien
Jika JSON-LD muncul hanya setelah rendering klien tertunda, crawler mungkin melewatkannya. Lebih baik gunakan rendering server atau prerendering untuk halaman penting.
Resep skema praktis berdasarkan tipe halaman
Anda jarang membutuhkan grafik besar. Kombinasi ini mencakup halaman yang biasanya diterbitkan oleh sebagian besar situs kecil, blog, alat, dan proyek ulasan.
Artikel panduan
Article + BreadcrumbList + WebPage
- Gunakan Article untuk judul, penulis, penerbit, gambar, tanggal, dan nama bagian.
- Gunakan BreadcrumbList untuk jalur situs yang terlihat.
- Gunakan referensi WebPage atau @id untuk menghubungkan halaman dan entitas artikel.
Halaman alat
SoftwareApplication + WebPage + BreadcrumbList
- Gunakan SoftwareApplication hanya jika halaman tentang aplikasi atau alat nyata.
- Sertakan sistem operasi, kategori, harga, atau detail penawaran hanya jika terlihat.
- Hindari markup ulasan atau rating kecuali halaman menampilkan data ulasan asli.
Halaman ulasan
Ulasan / Produk hanya jika halaman mendukungnya
- Markup item yang diulas, penulis, tanggal, dan rating hanya jika halaman menampilkannya dengan jelas.
- Jaga tautan afiliasi dan konteks komersial tetap transparan.
- Gunakan skor yang sama di skema dan konten yang terlihat.
Halaman pertanyaan
FAQPage hanya untuk tanya jawab yang berguna dan terlihat
- Buat setiap jawaban berguna sendiri, bukan hanya variasi kata kunci.
- Jangan sembunyikan jawaban di balik UI yang diblokir sehingga crawler tidak dapat mengaksesnya.
- Jangan harap hasil kaya FAQ sebagai manfaat utama SEO.
Sumber diperiksa
Sumber riset untuk panduan ini
Panduan di atas berdasarkan dokumentasi resmi Google Search Central dan schema.org, lalu diubah menjadi daftar periksa JSON-LD praktis.
FAQ markup skema JSON-LD
Apakah markup skema JSON-LD memengaruhi peringkat?
JSON-LD bukan tombol ajaib untuk peringkat. Ini membantu mesin pencari memahami konten yang memenuhi syarat dan mendukung kelayakan hasil kaya, tapi peringkat tetap bergantung pada kualitas konten, relevansi, kemampuan perayapan, tautan, dan banyak sinyal lain.
Di mana JSON-LD harus ditempatkan di halaman?
Tag skrip di bagian head biasanya paling mudah dikelola, tapi Google juga bisa membaca JSON-LD di body. Yang penting markup ada di halaman yang dirender dan sesuai dengan konten yang terlihat.
Haruskah saya masih menggunakan skema FAQPage?
Gunakan FAQPage hanya jika halaman memiliki pertanyaan dan jawaban yang benar-benar berguna dan terlihat. Jangan mengandalkannya untuk ruang hasil Google tambahan, karena tampilan hasil kaya FAQ telah sangat dikurangi dan dihentikan untuk sebagian besar situs biasa.
Bisakah satu halaman memiliki beberapa blok JSON-LD?
Ya. Halaman artikel biasa dapat memiliki data Article, BreadcrumbList, dan WebPage. Jaga blok tetap konsisten, hindari entitas duplikat yang bertentangan, dan gunakan nilai @id stabil untuk menghubungkan bagian terkait.
Apakah JSON-LD lebih baik daripada Microdata?
Untuk sebagian besar situs modern, ya. Google mendukung JSON-LD, Microdata, dan RDFa, tapi JSON-LD biasanya lebih mudah dipelihara karena tidak memerlukan atribut skema di dalam template HTML visual.
Seberapa sering saya harus memvalidasi data terstruktur?
Validasi setiap kali Anda mengubah template, bidang metadata, pembantu skema, URL, routing bahasa, pembuatan gambar, data ulasan, atau bagian FAQ. Juga periksa Search Console setelah halaman penting diindeks.