Studi kasus: melengkapi TechArticle di halaman lesson mahir.dev
Membandingkan JSON-LD TechArticle mahir.dev saat audit dan sekarang, menemukan penyebab properti yang masih kosong, dan menyusun rencana perbaikan.
13m bacaanKuis WajibMicro Badge Lesson
Studi kasus: melengkapi TechArticle di halaman lesson mahir.dev
Audit SEO mahir.dev mencatat bahwa JSON-LD TechArticle di halaman lesson belum lengkap: tanpa author, publisher, datePublished, dan image. Lesson ini membandingkan kondisi saat audit dengan kode saat ini, lalu menyusun langkah untuk menutup kekurangannya.
Kondisi kode saat ini
Builder techArticleJsonLd() di src/lib/seo.ts sekarang menghasilkan:
Tidak ada tanggal terbit, tanggal perubahan, atau gambar. Builder tidak bisa mengisi properti dari data yang tidak diterimanya. Ini pola yang sering terjadi saat audit: perbaikan SEO di frontend ternyata butuh perubahan di API.
Rencana perbaikan
1. Cek dan tambahkan data di API
Model di backend Go memakai GORM, yang biasanya menyimpan created_at dan updated_at untuk setiap baris. Langkah pertama adalah memastikan respons API lesson mengirim kedua nilai itu, lalu menambahkannya ke tipe di frontend.
Ada satu hal yang perlu diputuskan: updated_at di database berubah setiap kali baris itu diubah, termasuk perubahan yang bukan isi materi (misalnya mengganti urutan lesson). Kalau dipakai langsung sebagai dateModified, tanggalnya bisa berubah tanpa ada perubahan konten. Pilihan yang lebih jujur adalah menyimpan tanggal perubahan isi secara terpisah, atau setidaknya hanya memperbaruinya saat content_body berubah.
Pola ...(kondisi ? { ... } : {}) yang sudah dipakai di builder mahir.dev menjaga properti tetap kosong kalau datanya tidak ada, bukan diisi nilai palsu.
3. Gambar
Lesson berbasis teks tidak punya gambar utama. Ada dua pilihan:
pakai gambar course sebagai image lesson. Isinya relevan, karena lesson adalah bagian dari course itu.
buat gambar per lesson dengan opengraph-image.tsx (lesson 24), lalu pakai URL yang sama untuk image di JSON-LD
Pilihan kedua sekaligus memperbaiki kartu preview saat link lesson dibagikan.
4. Pertimbangkan author sebagai Person
Saat ini author adalah organisasi. Kalau setiap course punya instruktur yang ditampilkan di halaman (data instructor sudah ada di courseJsonLd()), instruktur itu bisa menjadi author lesson dengan url ke halaman profilnya. Ini memperkuat sinyal tentang siapa yang menulis materi. Lakukan hanya kalau instruktur itu benar-benar penulis materinya.
5. Uji
Uji satu URL lesson di Rich Results Test sebelum dan sesudah perubahan. Simpan screenshot keduanya untuk laporan audit.
Yang dipelajari dari kasus ini
audit perlu diulang. Separuh temuan di audit ini sudah diperbaiki sejak audit ditulis.
perbaikan structured data sering berhenti di data yang tidak tersedia, bukan di kode JSON-LD-nya
lebih baik properti kosong daripada diisi tanggal atau penulis yang tidak akurat
Penutup modul
Kamu sekarang bisa memasang structured data dengan aman, memilih jenis yang tepat per template, dan menilai mana yang masih menghasilkan rich result di Google. Modul terakhir menyatukan semua yang sudah kamu pelajari ke dalam satu proyek audit.
Checkpoint KuisTarget: 70%
Kuis: Studi kasus TechArticle
Kuis ini wajib untuk sertifikat. Kamu tetap bisa lanjut ke pelajaran berikutnya dan mengerjakannya nanti.