Lompat ke konten
Aback Tools Logo

Cara Memeriksa Data Terstruktur di Situs Web: Panduan Validasi JSON-LD

Cara memeriksa data terstruktur di situs web: temukan blok JSON-LD, validasi sintaksis dan properti wajib, perbaiki error skema umum, uji kelayakan hasil kaya, dan otomatiskan validasi di CI/CD.

DH
Tutorials & How-Tos12 menit baca2,700 kata

Data terstruktur memberi tahu mesin pencari apa makna konten Anda — bukan sekadar apa yang dikatakan kata-katanya, tetapi apakah sebuah halaman adalah produk, artikel, resep, atau FAQ. Melakukannya dengan benar membuat Google menampilkan konten Anda sebagai hasil kaya: penilaian bintang, akordeon FAQ, jejak breadcrumb, dan karosel langkah. Melakukannya salah membuat markup diabaikan secara diam-diam. Panduan ini mencakup semua metode memeriksa data terstruktur di situs web mana pun, dari inspeksi kode sumber hingga validasi CI otomatis.

40+Tipe skemadidukung hasil kaya Google
100%Pemeriksaan lokal perambantanpa URL atau login
<1sKecepatan validasiumpan balik JSON-LD instan

Apa itu data terstruktur?

Data terstruktur adalah metadata yang dapat dibaca mesin, tertanam di halaman web, yang membantu mesin pencari memahami konten melampaui teks yang terlihat. Format dominannya adalah JSON-LD — tag script notasi objek JavaScript yang ditempatkan di `<head>` halaman, memakai kosakata dari schema.org untuk mendeskripsikan entitas seperti artikel, produk, acara, resep, dan organisasi.

Saat mesin pencari merayapi halaman, ia mengekstrak blok-blok skema ini dan memakainya untuk menghasilkan hasil kaya: listingan pencarian yang disempurnakan yang menampilkan penilaian bintang, rentang harga, tanggal acara, akordeon FAQ, dan navigasi breadcrumb langsung di SERP. Hasil kaya secara konsisten mencapai tingkat klik lebih tinggi daripada listingan standar tautan biru karena menyampaikan lebih banyak informasi dalam sekali pandang.

Tiga format data terstruktur

  • JSON-LD: tag `<script type="application/ld+json">` mandiri yang memuat objek JSON. Google merekomendasikan format ini — paling mudah ditambahkan, divalidasi, dan dipelihara tanpa menyentuh HTML halaman.
  • Microdata: atribut skema (`itemscope`, `itemtype`, `itemprop`) yang ditambahkan langsung ke elemen HTML. Terikat erat pada struktur halaman — lebih sulit divalidasi dan diperbarui.
  • RDFa: atribut data tertaut (`typeof`, `property`) yang ditambahkan ke elemen HTML. Banyak dipakai di beberapa platform CMS tetapi kurang umum dibanding JSON-LD untuk implementasi baru.

Note

Google mendukung ketiga format, tetapi merekomendasikan JSON-LD untuk sebagian besar kasus. Panduan ini berfokus pada JSON-LD karena itulah format dominan dalam implementasi modern dan yang menjadi acuan sebagian besar perkakas.

Cara memeriksa data terstruktur

Ada empat metode praktis memeriksa data terstruktur di sebuah halaman, masing-masing cocok untuk situasi berbeda. Metode tercepat tidak butuh alat sama sekali; yang paling menyeluruh memerlukan validator dan lingkungan pengujian milik Google.

Metode 1: lihat kode sumber halaman

Klik kanan halaman mana pun di peramban dan pilih Lihat Kode Sumber Halaman (Ctrl+U / Cmd+U). Tekan Ctrl+F untuk membuka pencarian dan cari `application/ld+json`. Setiap hasil adalah blok data terstruktur. Ini langsung memberi tahu apakah data terstruktur ada di halaman dan memungkinkan Anda menyalin JSON untuk validasi. Untuk halaman yang merender konten via JavaScript, tampilan kode sumber hanya menampilkan HTML awal — gunakan DevTools untuk keluaran yang dirender.

Metode 2: panel Elements DevTools

Buka DevTools Chrome (F12), masuk ke tab Elements, dan cari `ld+json` di pohon elemen. Ini menampilkan data terstruktur seperti yang saat ini dirender peramban — termasuk blok yang disuntikkan JavaScript setelah halaman termuat. Ini pendekatan yang benar untuk React, Next.js, atau framework apa pun yang menambahkan data terstruktur sisi klien atau lewat rendering sisi server.

Metode 3: Validator Data Terstruktur (tercepat untuk pengembangan)

Salin blok JSON-LD dan tempel ke validator data terstruktur. Ia memvalidasi sintaksis JSON, memeriksa deklarasi `@context` dan `@type`, serta menandai properti wajib yang hilang untuk tipe skema yang dideklarasikan — semuanya di peramban Anda tanpa mengirimkan URL atau menunggu perayapan. Inilah siklus tercepat saat pengembangan karena Anda bisa memperbaiki dan memvalidasi ulang dalam hitungan detik.

Metode 4: Uji Hasil Kaya milik Google

Kirimkan URL halaman live Anda ke Uji Hasil Kaya Google di `search.google.com/test/rich-results`. Google mengambil halaman, mengekstrak semua data terstruktur, dan melaporkan tipe hasil kaya apa saja yang memenuhi syarat bagi halaman tersebut. Ini pengujian otoritatif untuk kelayakan hasil kaya — tetapi butuh URL live dan memakan 5-30 detik per pengujian. Gunakan setelah validasi lokal bersih.

Validator Data Terstruktur

Validasi blok data terstruktur JSON-LD apa pun untuk sintaksis, properti wajib, dan kepatuhan schema.org — lokal di peramban, tanpa URL.

Open tool

Memvalidasi markup JSON-LD

Validasi JSON-LD punya dua lapisan berbeda: validasi sintaksis (apakah JSON valid secara struktural?) dan validasi skema (apakah konten memenuhi properti wajib dan yang direkomendasikan tipe schema.org?). Kedua lapisan harus lulus sebelum blok data terstruktur bermanfaat.

1

Periksa halaman untuk blok JSON-LD

Klik kanan halaman dan pilih Lihat Kode Sumber Halaman. Cari `application/ld+json`. Salin seluruh objek JSON dari dalam tag script — dari kurung kurawal pembuka hingga penutup. Jika ada beberapa blok, salin masing-masing secara terpisah untuk validasi.

2

Validasi sintaksis dengan validator JSON-LD

Tempel blok yang disalin ke validator JSON-LD. Ia memeriksa bahwa JSON terbentuk baik, bahwa `@context` diatur ke `https://schema.org`, dan bahwa `@type` merujuk tipe schema.org yang dikenali. Error sintaksis dilaporkan dengan nomor baris; peringatan tipe tak dikenal mengidentifikasi tipe skema yang kecil kemungkinannya menghasilkan hasil kaya.

3

Periksa properti wajib untuk tipe yang dideklarasikan

Setiap tipe skema punya properti wajib dan yang direkomendasikan. Skema `Product` mensyaratkan `name` dan `offers` atau `review` untuk kelayakan hasil kaya. `Article` mensyaratkan `headline`, `author`, dan `datePublished`. Validator data terstruktur memeriksa `@type` yang dideklarasikan dan menandai setiap properti wajib yang hilang atau salah format.

4

Uji kelayakan hasil kaya dengan alat Google

Setelah validasi lokal bersih, kirimkan URL halaman ke Uji Hasil Kaya Google. Tinjau daftar tipe skema yang terdeteksi dan pastikan masing-masing tampil sebagai memenuhi syarat, bukan ditandai error. Tangani peringatan "Direkomendasikan" untuk properti yang meningkatkan kualitas hasil kaya meski tidak membloknya.

contoh-skema-artikel.json
json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to Check Structured Data on a Website",
  "author": {
    "@type": "Person",
    "name": "Devvrat Hans",
    "url": "https://abacktools.com"
  },
  "datePublished": "2026-06-11",
  "dateModified": "2026-06-11",
  "publisher": {
    "@type": "Organization",
    "name": "Aback Tools",
    "url": "https://abacktools.com"
  }
}

Tip

Selalu tetapkan `datePublished` dan `dateModified` sebagai string tanggal ISO 8601 (`YYYY-MM-DD` atau `YYYY-MM-DDTHH:MM:SSZ`). Kesalahan umum adalah memakai format yang mudah dibaca manusia seperti "11 Juni 2026" — ini gagal validasi skema dan dapat mencegah artikel muncul di Google Discover dan Top Stories.

Error umum data terstruktur

Sebagian besar error data terstruktur jatuh ke kategori yang dapat diprediksi. Mengetahui makna tiap jenis error — dan mengapa itu penting — memungkinkan Anda memperbaiki dalam urutan yang benar: sintaksis dulu, properti wajib kedua, penyempurnaan yang direkomendasikan terakhir.

Properti wajib yang hilang

Google mendefinisikan properti wajib untuk setiap tipe skema yang mendukung hasil kaya. Jika properti wajib mana pun absen, seluruh skema tidak memenuhi syarat untuk fitur hasil kayanya. Contoh umum: `Product` tanpa `name` atau `offers`, `Recipe` tanpa `name` atau `recipeIngredient`, `Event` tanpa `name`, `startDate`, atau `location`. Pemeriksa kelengkapan skema Product secara khusus mengaudit skema Product terhadap semua bidang Google yang wajib dan direkomendasikan.

Tipe nilai yang salah

Properti schema.org mengharapkan tipe nilai spesifik. Properti `url` harus URL absolut yang dimulai dengan `https://`; `ratingValue` harus angka (bukan string seperti `"4.5"`); `datePublished` harus string tanggal ISO 8601 yang valid. Meneruskan string ketika angka diharapkan, atau jalur relatif ketika URL absolut disyaratkan, memicu error ketidakcocokan tipe yang memblokir skema terbaca dengan benar.

Tipe skema dan konten halaman tidak cocok

Google mensyaratkan data terstruktur mencerminkan konten halaman yang terlihat secara akurat. Menempatkan markup `FAQPage` di halaman yang tidak menampilkan pertanyaan dan jawaban FAQ secara kasat mata, atau menambahkan markup `Product` ke halaman kategori tanpa detail produk spesifik, melanggar pedoman data terstruktur Google dan bisa berujung pada tindakan manual terhadap kelayakan hasil kaya.

Jenis errorContohDampakCara memperbaiki
Properti wajib hilangProduct tanpa nameMemblokir hasil kayaTambahkan properti
Tipe nilai salahratingValue: "4.5" (string)Skema diabaikanGunakan angka: 4.5
URL relatif di bidang urlimage: /foto.jpgError validasiGunakan URL HTTPS absolut
Format tanggal tak validdatePublished: "Juni 2026"Tanggal tak teruraiGunakan format YYYY-MM-DD
@type tak dikenal@type: "BlogPosting2"Skema tak dikenaliGunakan tipe schema.org persis
@context hilangTanpa deklarasi @contextSkema tak terekstrakTambahkan konteks schema.org
Konten tak cocokFAQPage di halaman non-FAQRisiko tindakan manualSamakan skema dengan konten

Warning

Kebijakan Data Terstruktur Google melarang memakai data terstruktur untuk menandai konten yang tidak terlihat oleh pengguna. Data terstruktur tersembunyi — deskripsi lebih kaya dari konten yang terlihat, ulasan palsu, atau data entitas yang direkayasa untuk SEO — diperlakukan sebagai spam. Selalu pastikan JSON-LD Anda mencerminkan apa yang benar-benar dilihat pengguna di halaman.

Pemeriksaan berdasarkan tipe skema

Tipe skema berbeda punya properti wajib berbeda, presentasi hasil kaya berbeda, dan alat validasi yang paling cocok untuk masing-masing. Begini cara menangani tipe yang paling sering dipakai.

FAQPage dan HowTo

FAQPage adalah salah satu tipe skema paling berdampak untuk CTR organik — skema FAQPage yang valid dirender sebagai akordeon yang bisa dibuka langsung di hasil Google Penelusuran, menampilkan pertanyaan dan jawaban tanpa perlu klik. Gunakan generator skema FAQ untuk menghasilkan markup FAQPage yang bersih dari pasangan tanya-jawab polos, lalu validasi keluarannya dengan validator JSON-LD. Untuk konten instruksional langkah demi langkah, generator skema HowTo membangun markup HowTo valid dengan blok `HowToStep` yang terstruktur benar.

Markup BreadcrumbList menghasilkan jejak breadcrumb yang tampil di bawah judul halaman di hasil Google Penelusuran — menggantikan URL mentah dengan hierarki yang terbaca. Setiap `ListItem` mensyaratkan `name` dan URL `item`. Gunakan generator skema Breadcrumb untuk menghasilkan JSON-LD BreadcrumbList dari jalur URL atau entri manual, siap langsung dimasukkan ke templat halaman Anda.

Organization dan Article

Skema Organization menetapkan identitas situs Anda untuk graf pengetahuan Google — nama, logo, informasi kontak, dan profil sosial. Validator skema Organization memeriksa semua bidang yang direkomendasikan hadir dan terformat benar. Untuk konten editorial, skema Article dengan `author`, `datePublished`, dan `publisher` meningkatkan kelayakan untuk Google News, Top Stories, dan Discover, yang bisa mendatangkan lalu lintas signifikan ke halaman berita dan blog.

Ulasan dan penilaian agregat

Penilaian bintang di hasil pencarian berasal dari `AggregateRating` yang disarangkan di dalam skema `Product`, `LocalBusiness`, atau `Recipe`. `ratingValue` harus berupa angka, `reviewCount` harus bilangan bulat positif, dan `bestRating` serta `worstRating` keduanya harus ditentukan untuk menghindari ambiguitas. Pemeriksa kelayakan cuplikan ulasan memvalidasi markup penilaian terhadap persyaratan spesifik Google untuk hasil kaya ulasan.


Tipe skemaHasil kayaBidang wajib utamaPemeriksa Aback Tools
FAQPageAkordeon FAQ di SERPmainEntity dengan tanya-jawabGenerator Skema FAQ
HowToKarosel langkah di SERPname, step, textGenerator Skema HowTo
BreadcrumbListJejak breadcrumb di SERPitemListElement, name, itemGenerator Skema Breadcrumb
ProductPanel produk dengan harga/penilaianname, offers atau reviewPemeriksa Kelengkapan Skema Product
ArticleTop Stories, Discoverheadline, author, datePublishedValidator JSON-LD
OrganizationPanel pengetahuanname, url, logoValidator Skema Organization
LocalBusinessPaket lokal, petaname, address, telephoneValidator Data Terstruktur

Data terstruktur di CI/CD

Pemeriksaan data terstruktur manual bekerja untuk halaman individual, tetapi situs besar dengan templat yang menghasilkan data terstruktur secara programatik membutuhkan validasi otomatis. Menambahkan pemeriksaan data terstruktur ke pipeline CI/CD Anda menangkap regresi sebelum sampai ke produksi dan memblokir kelayakan hasil kaya.

Ekstraksi dan validasi di pipeline build

Pendekatan paling andal adalah mengekstrak JSON-LD dari keluaran HTML hasil build dan memvalidasinya secara programatik. Setelah build, urai berkas HTML yang dihasilkan, ekstrak setiap blok `<script type="application/ld+json">`, dan jalankan masing-masing lewat pustaka validasi schema.org seperti `schema-dts` (TypeScript), `jsonld` (Node.js), atau Structured Data Linter milik Google. Buat build gagal jika properti wajib mana pun hilang atau JSON-nya cacat.

terminal
bash
# Extract all JSON-LD blocks from built HTML using grep
grep -rl 'application/ld+json' ./out/ | while read file; do
  # Parse and validate each block
  node scripts/validate-schema.js "$file"
done

# Or use a dedicated CLI tool
npx schema-validator ./out/**/*.html --strict

Pemantauan fitur SERP

Setelah deployment, pantau performa hasil kaya di Google Search Console pada bagian "Enhancements". Setiap tipe skema yang Anda implementasikan mendapat laporannya sendiri yang menampilkan item valid, peringatan, dan error saat Googlebot merayapi halaman Anda. Lonjakan error yang tiba-tiba biasanya menandakan perubahan templat yang merusak skema untuk satu kategori halaman penuh. Pemeriksa fitur SERP menyediakan pandangan pelengkap — fitur SERP apa saja yang saat ini dipicu oleh URL tertentu.

Tip

Setelah memperbaiki error data terstruktur, minta pengindeksan ulang untuk URL yang terdampak di Google Search Console menggunakan alat Inspeksi URL. Klik "Minta Pengindeksan" untuk meminta Googlebot merayapi ulang dan mengekstrak ulang data terstruktur lebih cepat daripada siklus perayapan normal, yang bisa berlangsung berhari-hari hingga berminggu-minggu untuk halaman prioritas rendah.

Praktik terbaik

Mengikuti praktik-praktik ini memastikan data terstruktur Anda benar, mudah dipelihara, dan selaras dengan pedoman Google — memaksimalkan kelayakan hasil kaya tanpa berisiko tindakan manual atau kegagalan skema yang senyap.

Jaga data terstruktur selaras dengan konten yang terlihat

Sumber paling umum tindakan manual Google terhadap data terstruktur adalah ketidakcocokan antara skema dan apa yang dilihat pengguna. Jika skema `Product` Anda menampilkan harga $29 tetapi halaman menampilkan $49, Google memperlakukannya sebagai markup yang menyesatkan. Gunakan CMS atau sistem templat Anda untuk menghasilkan data terstruktur dari sumber data yang sama yang mengisi konten halaman yang terlihat — jangan pernah mengodekan nilai secara manual di skema yang ditampilkan secara dinamis di tempat lain.

Gunakan tipe spesifik, bukan generik

Schema.org punya hierarki tipe yang dalam. Halaman tentang produk perangkat lunak sebaiknya memakai `SoftwareApplication`, bukan `Product` generik. Restoran lokal sebaiknya memakai `Restaurant` (subtipe dari `FoodEstablishment`), bukan `LocalBusiness` generik. Tipe yang lebih spesifik memberi mesin pencari lebih banyak sinyal tentang konten dan dapat membuka format presentasi yang lebih kaya di hasil pencarian.

Data terstruktur tidak boleh digunakan untuk menyesatkan pengguna atau memberikan informasi yang menyesatkan. Data terstruktur pada sebuah halaman harus merepresentasikan konten halaman secara akurat.

- Dokumentasi Google Search Central
  • Validasi sebelum deploy: jalankan validator data terstruktur pada setiap blok skema sebelum tayang — tangkap error sebelum Googlebot melakukannya.
  • Satu entitas per blok: sarangkan entitas terkait (mis. `author` di dalam `Article`) daripada membuat blok tingkat atas terpisah untuk setiap sub-entitas.
  • Gunakan URL absolut di mana-mana: bidang `url`, `image`, `logo`, dan `sameAs` semuanya mensyaratkan URL `https://` penuh — jalur relatif tidak valid dalam data terstruktur.
  • Sertakan sameAs untuk organisasi: tautkan skema Organization Anda ke Wikipedia, Wikidata, LinkedIn, dan sumber otoritatif lain untuk memperkuat asosiasi graf pengetahuan.
  • Pantau Google Search Console: periksa laporan Enhancements setiap minggu — mereka menampilkan halaman mana yang punya data terstruktur valid, berperingatan, atau bermasalah saat Googlebot merayapinya.

Note

Data terstruktur dibaca oleh lebih dari sekadar Google. Microsoft Bing, Rich Pins Pinterest, dan pratinjau tautan Slack semuanya memakai data terstruktur schema.org untuk tampilan kaya mereka masing-masing. Strategi skema yang terimplementasi baik menguntungkan setiap platform yang mengonsumsi halaman Anda, bukan hanya Google Penelusuran.

Key takeaways

  • Periksa data terstruktur dengan mencari `application/ld+json` di kode sumber halaman — setiap tag script dengan tipe itu adalah blok data terstruktur.
  • Gunakan validator data terstruktur selama pengembangan untuk validasi JSON-LD instan dan lokal di peramban tanpa perlu mengirimkan URL.
  • Uji Hasil Kaya Google adalah alat otoritatif untuk kelayakan hasil kaya — jalankan setelah validasi lokal bersih, bukan menggantikannya.
  • Error paling umum adalah properti wajib yang hilang, tipe nilai yang salah (string ketika angka diharapkan), dan URL relatif ketika URL HTTPS absolut disyaratkan.
  • Hasilkan markup skema yang benar untuk tipe FAQPage, HowTo, BreadcrumbList, dan Product memakai generator dan validator khusus dari Aback Tools.
  • Data terstruktur harus cocok dengan konten halaman yang terlihat — ketidakcocokan antara nilai skema dan nilai yang ditampilkan berisiko tindakan manual Google terhadap kelayakan hasil kaya.
  • Pantau bagian Enhancements di Google Search Console setelah deployment untuk melacak item valid, peringatan, dan error saat Googlebot merayapi halaman Anda.

Pertanyaan yang sering diajukan

The fastest way is to right-click the page, select View Page Source, and search for "application/ld+json". Each script tag with that type contains a structured data block. Alternatively, open Chrome DevTools, go to the Network tab, reload the page, find the HTML document response, and search for "schema.org" in the response body. For a visual summary, use a browser extension like Schema Markup Validator or submit the URL to Google's Rich Results Test.

Google's Rich Results Test (search.google.com/test/rich-results) is the authoritative tool for checking rich result eligibility - it shows exactly which features your markup qualifies for. For faster, privacy-first validation without submitting a URL, the Aback Tools Structured Data Validator checks your JSON-LD block entirely in the browser with line-level error reporting. Use both: the Aback Tools validator during development and Google's tool before deployment.

JSON-LD (JavaScript Object Notation for Linked Data) is the W3C standard format for embedding structured data in web pages. You place a `<script type="application/ld+json">` tag in the `<head>` of your HTML document containing a JSON object that describes the page content using schema.org vocabulary. Google, Bing, and other search engines read this script tag to understand the page and generate rich results - star ratings, FAQ accordions, recipe cards, and breadcrumb trails in search results.

The most frequent errors are missing required properties (a `Product` schema without `name` or `offers`, an `Article` without `headline`), incorrect value types (a number where a URL is expected), invalid enum values (a `priceValidUntil` date in the wrong format), missing `@context` or `@type` declarations, and mismatched types (using `FAQPage` markup on a page that is not an FAQ page). Google also flags "soft errors" - missing recommended properties that do not block rich results but reduce their quality.

Structured data does not directly improve rankings - Google has stated it is not a ranking signal. Its value is in rich result eligibility: pages with correct structured data can appear as FAQ accordions, product panels with ratings and price, event listings, recipe cards, and How-to carousels in Google Search. These rich features increase click-through rate significantly, which has an indirect positive effect on organic performance. Structured data is also used by Google's AI Overviews for sourcing cited information.

Copy the JSON-LD block from your template or build output and paste it into the Aback Tools Structured Data Validator - it validates the schema without needing a live URL. For full rich-result eligibility testing, Google's Rich Results Test accepts either a URL or raw HTML - paste the entire `<head>` section of your page into the code input and it will extract and validate the structured data without the page being publicly accessible.

Yes. A page can have multiple `<script type="application/ld+json">` tags, each containing a separate schema type. A blog post page might include an Article schema, a BreadcrumbList schema, and an FAQPage schema simultaneously. Google reads all of them independently and applies whichever rich result features each schema qualifies for. The schemas must not contradict each other - the page name, URL, and author should be consistent across all blocks on the same page.

All three are formats for embedding structured data in HTML, but they differ in approach. JSON-LD places the schema in a standalone script tag, separate from the visible HTML - making it easy to add, maintain, and validate without touching the page content. Microdata and RDFa annotate existing HTML elements with schema attributes, tightly coupling the markup to the page structure. Google supports all three formats, but officially recommends JSON-LD for most use cases because it is the easiest to implement and maintain.

ShareXLinkedIn