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.

Skema terbaik pertama Article, WebPage, dan BreadcrumbList untuk sebagian besar halaman panduan.
Alur kerja terbaik Buat skema dari metadata halaman yang sama yang mengatur judul, deskripsi, kanonis, dan Open Graph.
Pemeriksaan realitas terbaik Markup FAQPage dan WebSite masih bisa mendeskripsikan konten, tapi jangan buat strategi berdasarkan tampilan Google yang sudah usang.

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.

Penting: Data terstruktur harus mendukung halaman, bukan menggantikan konten berguna. Jika halaman terlihat tipis, membingungkan, usang, atau menyesatkan, markup skema tidak akan membuatnya hasil pencarian yang kuat.

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.

01

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.

02

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.

03

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.

04

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.

05

Jaga tanggal tetap jujur

Ubah dateModified hanya saat konten halaman berubah signifikan. Jangan perbarui tanggal otomatis hanya agar terlihat lebih baru di hasil pencarian.

06

Buat gambar dapat dirayapi

Gunakan URL gambar absolut, dimensi yang sesuai, dan file yang tidak diblokir oleh robot, otentikasi, atau rendering hanya lazy-loading.

07

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.

08

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.

HTMLContoh JSON-LD Artikel
<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>
C#Pola pembantu C#
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>");
}
Aturan praktis: Gunakan URL stabil untuk url dan @id. Gunakan URL kanonis yang sama di mana-mana. Jika halaman yang sama muncul di beberapa URL bahasa, buat metadata spesifik bahasa dan jaga konsistensi pengaturan hreflang/kanonis.

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 Kaya

Kosakata

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 Skema

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

Kesalahan 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

Panduan di atas berdasarkan dokumentasi resmi Google Search Central dan schema.org, lalu diubah menjadi daftar periksa JSON-LD praktis.

01 Pengenalan data terstruktur Google developers.google.com 02 Kebijakan data terstruktur Google developers.google.com 03 Data terstruktur Artikel Google developers.google.com 04 Data terstruktur Breadcrumb Google developers.google.com 05 Data terstruktur FAQ Google developers.google.com 06 Pembaruan kotak pencarian sitelinks Google developers.google.com 07 Memulai dengan Schema.org schema.org 08 Tes Hasil Kaya Google search.google.com 09 Validator Schema Markup validator.schema.org

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.