Pendahuluan
Ambil dan perbarui peta situs proyek Anda untuk membantu mesin pencari menemukan dan mengindeks halaman.
Informasi lebih lanjut tentang antarmuka pengguna modul ini https://doc.oneentry.cloud/docs/category/sitemap
🎯 Apa yang dilakukan modul ini?
Modul Sitemap memungkinkan Anda mengambil dan (meng)hasilkan kembali peta situs proyek OneEntry Anda - daftar terstruktur dari semua halaman yang digunakan oleh mesin pencari untuk mengindeks konten Anda dengan efisien.
Peta situs memberi tahu mesin pencari halaman mana yang ada, membantu Google, Bing, dan crawler lainnya menemukan dan mengindeks konten Anda lebih cepat. Generasi dipicu secara eksplisit melalui updateSitemap(body); getSitemap() mengembalikan daftar URL peta situs yang dihasilkan.
🚀 Memulai dengan Cepat
Inisialisasi modul dari defineOneEntry:
const { Sitemap } = defineOneEntry( "your-project-url", { "token": "your-app-token" });
Ambil daftar URL peta situs yang dihasilkan:
// Returns an array of sitemap URL strings (string[]).
const sitemaps = await Sitemap.getSitemap();
sitemaps.forEach((url) => {
console.log(url);
});
✨ Konsep Kunci
Apa itu Peta Situs?
Peta situs adalah file XML yang mencantumkan halaman-halaman situs web Anda sehingga mesin pencari dapat menemukannya dan merayapinya dengan efisien. Setiap entri dapat membawa URL, tanggal terakhir diubah, frekuensi perubahan, dan prioritas.
Membaca vs. Memperbarui Peta Situs
getSitemap() mengembalikan array string URL peta situs (string[]), misalnya:
[
'https://your-project.oneentry-cloud.com/sitemap.xml',
'https://your-project.oneentry-cloud.com/sitemap-en.xml'
]
Bidang per-entri url, lastmod, changefreq, priority adalah properti input dari ISitemapQuery (dikirim ke updateSitemap()), bukan bagian dari respons getSitemap().
Nilai Frekuensi Perubahan
Nilai-nilai ini adalah bagian dari input updateSitemap() (changefreq):
| Nilai | Arti |
|---|---|
| selalu | Halaman berubah setiap kali diakses |
| setiap jam | Halaman berubah setiap jam |
| setiap hari | Halaman berubah setiap hari |
| setiap minggu | Halaman berubah setiap minggu |
| setiap bulan | Halaman berubah setiap bulan |
| setiap tahun | Halaman berubah sekali setahun |
| tidak pernah | Halaman diarsipkan, tidak akan berubah |
📋 Apa yang Perlu Anda Ketahui
Menghasilkan peta situs
Peta situs dihasilkan ketika Anda memanggil updateSitemap(body), di mana body (sebuah ISitemapQuery) menyediakan baseUrls per bahasa yang digunakan untuk membangun URL. Ini tidak diproduksi secara otomatis - Anda memicu generasi secara eksplisit.
Mengambil peta situs
Gunakan getSitemap() untuk mengambil daftar URL peta situs yang dihasilkan (string[]).
Mengirim ke mesin pencari
Modul ini tidak mengirim langsung ke mesin pencari. Setelah mengambil URL peta situs, kirimkan melalui alat webmaster mesin pencari Anda (Google Search Console, Bing Webmaster Tools, dll.) dan jaga agar peta situs tetap diperbarui setelah perubahan konten besar.
📊 Tabel Referensi Cepat
| Metode | Deskripsi |
|---|---|
| getSitemap() | Dapatkan URL peta situs saat ini |
| updateSitemap() | Hasilkan/perbarui peta situs |
❓ Pertanyaan Umum (FAQ)
Bagaimana cara mengirim peta situs saya ke Google?
Hasilkan peta situs dengan updateSitemap(body) (mengirimkan baseUrls Anda), ambil URL peta situs yang dihasilkan dengan getSitemap(), lalu kirimkan URL peta situs di Google Search Console di bawah Peta Situs.
Seberapa sering saya harus memperbarui peta situs saya?
Perbarui peta situs Anda setiap kali Anda menambahkan halaman baru, memperbarui konten yang ada secara signifikan, atau mengubah struktur situs Anda. Untuk situs dengan lalu lintas tinggi, pertimbangkan pembaruan otomatis yang dipicu oleh perubahan konten.
Apa arti bidang prioritas?
Prioritas (0.0 hingga 1.0) adalah petunjuk bagi mesin pencari tentang pentingnya relatif halaman di situs Anda. Halaman utama biasanya 1.0, halaman kategori 0.8, dan halaman konten individu 0.6–0.7. Ini adalah bagian dari input updateSitemap() dan tidak mempengaruhi peringkat secara langsung.
🎓 Praktik Terbaik
- Hasilkan kembali setelah perubahan konten - Panggil
updateSitemap()setelah menambahkan atau mengubah halaman secara signifikan. - Tetapkan frekuensi perubahan yang akurat - Jangan klaim halaman berubah lebih sering daripada yang sebenarnya.
- Gunakan prioritas yang bermakna - Halaman utama > Kategori > Produk > Postingan blog.
- Sertakan semua halaman penting - Jangan kecualikan halaman yang ingin Anda indeks.
- Kirim setelah pembaruan besar - Beri tahu mesin pencari secara proaktif melalui alat webmaster.
🔗 Dokumentasi Terkait
- Modul Halaman - Kelola halaman yang termasuk dalam peta situs
- Modul Sistem - Utilitas API tingkat sistem