Cara Pasang JSON-LD Person Schema: Panduan Lengkap Tanpa Jargon Teknis
· 4 min read
Kamu tidak perlu mengerti cara kerja JSON-LD untuk mengimplementasikannya dengan benar. Kamu perlu mengerti apa yang ia katakan ke sistem AI tentangmu, dan kenapa mendapatkannya dengan benar lebih penting dari kebanyakan hal yang mungkin sedang kamu lakukan untuk visibilitas.
Ini adalah panduan yang aku harapkan ada ketika aku mulai membangun entity infrastructure untuk perusahaan-perusahaanku. Tidak ada jargon. Tidak ada asumsi pengetahuan. Kode aktual yang bisa kamu copy, edit, dan gunakan hari ini.
Apa yang sebenarnya dilakukan JSON-LD Person schema
Ketika AI agent mengunjungi websitemu, ia membaca dua hal: konten yang dibaca manusia, dan structured data yang dibaca mesin. JSON-LD adalah structured data-nya.
Blok Person schema memberitahu sistem AI: website ini milik orang tertentu, ini nama dan deskripsinya, ini peran yang ia pegang, ini organisasi yang ia hubungkan, ini tempat kamu bisa memverifikasi klaim-klaim ini di sumber independen.
Tanpa itu, AI agent harus menyimpulkan identitasmu dari teks yang tidak terstruktur. Mungkin kesimpulannya benar. Mungkin tidak. Deklarasi terstruktur tidak tunduk pada interpretasi.
Field yang diperlukan
Ini adalah field yang penting. Semua yang lain adalah peningkatan opsional.
| Field | Fungsinya | Contoh nilai |
|---|---|---|
@context |
Memberitahu sistem bahwa ini adalah vocab Schema.org | "https://schema.org" |
@type |
Mendeklarasikan ini adalah entitas Person | "Person" |
name |
Nama lengkapmu, persis seperti yang muncul di tempat lain | "Ibrahim Anwar" |
url |
URL homepage kanonikmu | "https://hibranwar.com" |
description |
Satu kalimat jelas tentang siapa kamu dan apa yang kamu lakukan | Lihat contoh di bawah |
jobTitle |
Peran atau jabatan utamamu | "Practitioner & Director" |
sameAs |
Array profil eksternal yang terverifikasi | LinkedIn, ORCID, dll. |
Field sameAs adalah yang paling jarang digunakan dan paling penting. Ia menciptakan tautan cross-reference yang memungkinkan sistem AI memverifikasi identitasmu di sumber independen. Tanpanya, schema-mu adalah deklarasi tanpa rantai verifikasi.
Kode aktualnya
Ini adalah Person schema yang aku jalankan di hibranwar.com. Copy, edit nilai-nilainya agar sesuai dengan informasi aktualmu, dan paste di dalam tag <script> di bagian <head> dari homepage-mu.
{
"@context": "https://schema.org",
"@type": "Person",
"name": "Ibrahim Anwar",
"alternateName": "Hibranwar",
"url": "https://hibranwar.com",
"image": "https://hibranwar.com/img/ibrahim-anwar.jpg",
"description": "Practitioner and Director membangun entity infrastructure untuk klien industri dan enterprise. Pendiri Witanabe, Arsindo, dan Hibrkraft.",
"jobTitle": "Practitioner & Director",
"worksFor": [
{
"@type": "Organization",
"name": "Witanabe",
"url": "https://witanabe.com"
},
{
"@type": "Organization",
"name": "PT Arsindo Cipta Perkasa",
"url": "https://ptarsindo.com"
},
{
"@type": "Organization",
"name": "Hibrkraft",
"url": "https://hibrkraft.com"
}
],
"knowsAbout": [
"Entity Infrastructure",
"AI Search Visibility",
"Industrial Engineering",
"System Design",
"Publishing"
],
"nationality": {
"@type": "Country",
"name": "Indonesia"
},
"sameAs": [
"https://www.linkedin.com/in/hibranwar/",
"https://orcid.org/0009-0005-2721-6021",
"https://osf.io/YOUR_OSF_ID",
"https://zenodo.org/search?q=hibranwar",
"https://www.instagram.com/hibranwar/"
]
}
Array sameAs adalah tempat kamu mendaftarkan setiap profil eksternal yang terverifikasi. LinkedIn, ORCID, Google Scholar, GitHub, direktori yang relevan. Setiap entri menambahkan tautan verifikasi. Semakin banyak tautan, semakin kuat rantai verifikasi identitas.
Kesalahan umum yang merusak schema
Menggunakan variasi nama yang berbeda. Kalau schema-mu bilang "Ibrahim Anwar" tapi LinkedIn-mu bilang "Bram Anwar" dan Google Business Profile-mu bilang "H. Ibrahim Anwar, ST.", cross-reference gagal. Pilih satu bentuk kanonik dan gunakan di mana-mana.
Format URL yang salah. Field url harus cocok persis dengan URL kanonik aktualmu, termasuk apakah ada trailing slash atau tidak. Kalau websitemu redirect hibranwar.com ke www.hibranwar.com, gunakan URL tujuannya.
Deskripsi yang kosong atau samar. "Pengusaha dan profesional" tidak memberitahu sistem AI apapun yang berguna. Spesifik tentang apa yang sebenarnya kamu lakukan.
Entry sameAs yang hilang. Ini adalah kelalaian paling umum. Person schema tanpa sameAs adalah deklarasi tanpa verifikasi. Minimum: LinkedIn dan satu identifier akademis atau pemerintah (ORCID gratis dan butuh 10 menit untuk didaftarkan).
Menempatkannya di tempat yang salah. Blok JSON-LD masuk ke dalam tag <script type="application/ld+json"> di bagian <head>. Bukan di body. Bukan sebagai file terpisah. Inline di head.
Cara memverifikasi bahwa itu berfungsi
Setelah menambahkan schema, cek di validator.schema.org. Paste URL-mu atau paste kode langsung. Ia akan memberitahumu kalau ada error, warning, atau field rekomendasi yang hilang.
Validasi yang bersih tidak menjamin kutipan AI segera. Itu menjamin deklarasimu machine-readable dan diformat dengan benar. Kutipannya mengikuti dari itu, dikombinasikan dengan sisa entity infrastructure.
Satu hal yang tidak diperbaiki oleh ini sendirian
Schema adalah lapisan deklarasi yang machine-readable. Ia paling efektif ketika mengkonfirmasi klaim yang sudah bisa diverifikasi melalui kontenmu.
Kalau schema-mu bilang kamu punya 558 judul yang diterbitkan tapi tidak ada dokumentasi publik tentang judul-judul tersebut di domain-mu, schema-mu mendeklarasikan sesuatu yang tidak bisa diverifikasi AI agent. Schema dan evidence harus bekerja bersama.
Bangun keduanya. Schema memberitahu mesin apa yang harus dicari. Konten memberi mereka sesuatu untuk ditemukan.
Aku praktisi. Silakan tanya.