Kebanyakan pasukan sebenarnya sudah punya laporan kedudukan Google. Isinya tab Prestasi dalam Search Console, disusun ikut klik lalu ditangkap skrin ke dalam slaid. Ia menunjukkan kedudukan. Ia tidak menunjukkan apa yang berubah, kenapa ia berubah, atau apa yang sesiapa patut buat dengannya.
Aliran kerja ini menyelesaikannya dalam satu sesi. Anda tetapkan satu set pertanyaan, serahkan kontrak laporan bertulis kepada Codex, dan biarkan ia menghasilkan bentuk yang sama setiap minggu. Pembinaan pertama mengambil masa sekitar 90 minit. Setiap larian berikutnya bawah sepuluh minit.
Keseluruhan aliran: eksport mentah masuk, satu laporan berbentuk tetap keluar, dan satu keputusan manusia di hujungnya.
Apa yang anda akan ada di akhir nanti
Untuk siapa ini: untuk sesiapa yang bertanggungjawab atas pelaporan sesebuah laman dan sudah punya akses ke Search Console. Anda tidak perlu jadi pembangun, tetapi perlu tempat menyimpan fail yang Codex boleh baca.
Apa yang anda akan ada setelah selesai: templat laporan yang tersimpan, fail arahan bertulis yang dipatuhi Codex pada setiap larian, dan satu laporan lengkap untuk satu minggu sebenar.
Prasyarat: properti Search Console yang sudah disahkan, senarai 20 hingga 50 pertanyaan yang anda benar-benar ambil berat, Codex dengan akses ke folder projek, dan kebenaran baca ke repositori laman anda sendiri jika mahu versi lanjutan.
Definisi selesai: anda boleh serahkan laporan itu kepada seseorang yang tidak mengerjakan SEO, dan orang itu boleh menyebut tiga pertanyaan mana yang perlu dilihat dan kenapa.
Masa: sekitar 90 minit untuk pembinaan pertama, bawah 10 minit setiap larian selepasnya.
Kenapa laporan Prestasi bukan laporan kedudukan
Search Console memberi anda empat lajur: klik, tayangan, CTR dan kedudukan purata. Itu jadual pengukuran. Laporan kedudukan perlu menjawab set soalan yang berbeza, dan isyarat tahun 2026 telah melebarkan jurang itu berbanding sebelum ini.
Tinjauan pakar Zyppy yang diterbitkan 9 September 2026 mengumpulkan 13,665 titik data daripada 131 pengamal. Isyarat klik dan tingkah laku berada pada 29.4%, isyarat jenama pada 27.0%, dan kesihatan SEO teknikal pada 17.5%. Dua daripada tiga isyarat yang mengalahkan kesihatan teknikal tidak kelihatan dalam lajur kedudukan. Perbincangan kami tentang apa yang diubah oleh angka-angka itu ada dalam panduan praktikal, tetapi versi ringkas untuk pelaporan ialah ini: kalau laporan anda hanya memaparkan kedudukan, anda melaporkan isyarat yang paling sedikit bergerak.
Jurang itulah yang ditutup oleh Codex. Ia tidak akan memberitahu kenapa Google mengubah sesuatu. Ia akan menghimpunkan bukti perubahan itu cukup konsisten sehingga anda boleh menjelaskannya sendiri.
Sebelum mula: empat keputusan
Buat keputusan ini sebelum menulis apa-apa, kerana mengubahnya kemudian bermakna membina semula laporan.
- Set pertanyaan. 20 hingga 50 pertanyaan, dikelompokkan kepada dua atau tiga bakul yang sepadan dengan cara perniagaan berfikir. "Produk", "perbandingan", "sokongan" berfungsi lebih baik daripada "volum tinggi / sederhana / rendah".
- Tetingkap perbandingan. Bandingkan 28 hari terakhir dengan 28 hari sebelumnya. Tetingkap lebih pendek bising; lebih panjang menyembunyikan perubahan yang anda cari.
- Ambang. Tentukan apa yang layak dilaporkan. Pertanyaan yang bergerak lebih lima kedudukan, atau tayangan bergerak lebih 30% sementara klik mendatar, ialah nilai lalai yang munasabah.
- Tempat simpan. Satu folder, satu peraturan penamaan.
reports/ranking/YYYY-MM-DD.mdbeserta subfolderdata/untuk eksport mentah. Codex perlukan tempat menulis yang konsisten.
Langkah 1: eksport data mentah
Buka Search Console, pilih properti anda, kemudian pergi ke Prestasi. Tetapkan julat tarikh kepada 56 hari supaya perbandingan 28 lawan 28 boleh dibuat daripada satu eksport, kemudian guna butang Eksport untuk memuat turun CSV tab Pertanyaan.
Buat perkara sama untuk Halaman, dan untuk Peranti kalau anda bercadang melaporkan pemisahan mudah alih lawan desktop.
Hasil yang dijangkakan: tiga fail CSV dalam data/, dinamakan dengan tarikh eksport.
Semakan kualiti: buka CSV Pertanyaan dan pastikan baris data pertama bukan pertanyaan yang mengandungi perkataan "anonymous". Search Console menyembunyikan pertanyaan jarang, dan baris-baris itu akan masuk ke laporan anda sebagai pergerakan tanpa nama.
Kalau gagal: kalau eksport terpotong, julat tarikh anda terlalu lebar untuk had baris. Eksport tetingkap 28 hari secara berasingan dan biarkan Codex menyambungnya.
Langkah 2: tulis kontrak laporan
Inilah langkah yang menentukan sama ada aliran ini bertahan melepasi minggu ketiga. Letakkan kontrak dalam fail yang Codex baca pada setiap larian: AGENTS.md di akar projek, atau fail arahan khusus dalam folder laporan.
Kontrak perlukan lima perkara dan tidak perlukan yang lain:
Blok kontrak | Apa yang ditulis | Kenapa ia penting |
|---|---|---|
Input | Laluan fail yang tepat dan peraturan julat tarikh | Menghalang ejen daripada mengarang tetingkap sendiri |
Ambang | Jalur anda, dalam angka | Menukar jadual menjadi keputusan |
Bentuk output | Tiga bahagian, mengikut urutan ini | Mengekalkan minggu ke-30 boleh dibandingkan dengan minggu ke-1 |
Peraturan keyakinan | Apa yang ditulis apabila data tidak menjelaskan perubahan | Menghalang karut yang penuh keyakinan |
Sempadan | Apa yang ejen tidak boleh lakukan | Baca sahaja sehingga anda percaya |
Versi yang berfungsi kelihatan seperti ini:
## Kontrak laporan kedudukan
Input: data/queries-*.csv, data/pages-*.csv
Tetingkap: 28 hari terakhir lawan 28 hari sebelumnya. Sebut kedua-dua tarikh di kepala laporan.
Laporkan hanya tiga perkara:
1. Pertanyaan yang bergerak: mana-mana pertanyaan yang beralih lebih 5 kedudukan, atau
tayangan naik lebih 30% sementara klik mendatar, atau mana-mana pertanyaan
yang keluar dari sepuluh teratas.
2. Penjelasan yang mungkin: guna hanya data dalam fail. Kalau fail tidak menjelaskan
pergerakan itu, tulis "tidak dijelaskan oleh data ini".
3. Periksa minggu depan: satu baris bagi setiap pertanyaan yang ditanda, dengan
nama tepat halaman atau pertanyaan yang perlu diperiksa.
Jangan pernah menyatakan sebab yang tidak boleh ditunjuk dalam data. Jangan pernah
mencadangkan perubahan laman. Jangan pernah menyunting fail di luar reports/ranking/.Hasil yang dijangkakan: satu fail arahan, di-commit atau disimpan bersebelahan data.
Semakan kualiti: baca kontrak itu dengan kuat. Kalau mana-mana baris boleh terpakai untuk laman lain tanpa suntingan, baris itu terlalu kabur untuk mengehadkan apa-apa.
Kalau gagal: kalau Codex terus menambah bahagian, bentuk outputnya tidak cukup spesifik. Sebut ketiga-tiga tajuk itu tepat seperti yang anda mahu.
Anatomi laporan. Kaki yang menyenaraikan fail tepat yang digunakan ialah bahagian yang paling dipercayai oleh penyemak, dan bahagian yang paling kerap ditinggalkan oleh templat.
Langkah 3: jana laporan pertama
Halakan Codex ke folder itu dan minta satu laporan mengikut kontrak. Minta failnya, bukan jawapan dalam sembang, supaya hasilnya boleh disemak dan dibandingkan.
Larian pertama ialah tempat anda menemui rupa sebenar data anda. Peruntukkan dua atau tiga pusingan pembetulan. Itu biasa, dan itu bahagian paling murah dalam keseluruhan aliran ini.
Hasil yang dijangkakan: reports/ranking/YYYY-MM-DD.md dengan kepala, tiga bahagian dan kaki yang menyenaraikan fail tepat yang digunakan.
Semakan kualiti: ambil dua pertanyaan yang ditanda dan sahkan angkanya dengan tangan dalam Search Console. Kalau sepadan, saluran itu sihat. Kalau tidak, berhenti dan betulkan langkah data. Jangan nyahpepijat analisis di atas input yang rosak.
Kalau gagal: kegagalan paling kerap ialah ketidakpadanan tarikh antara eksport dan kontrak. Pakukan kedua-dua tarikh di kepala laporan pada setiap larian, supaya selisih dua hari tidak senyap-senyap menukar bulan yang mendatar menjadi keruntuhan.
Versi pertama yang saya bina melaporkan sebelas pertanyaan bergerak pada minggu yang hampir tiada apa bergerak. Kontraknya elok; eksportnya tidak. Fail 30 hari yang dibandingkan dengan tetingkap 28 hari membuatkan dua hari yang hilang kelihatan seperti keruntuhan seluruh laman. Sekarang kontrak itu enggan berjalan kalau dua julat itu tidak sepadan, dan kegagalan itu belum kembali.
Langkah 4: tambah baris yang ejen tidak boleh tulis
Setiap laporan mendapat satu perenggan manusia: apa yang kami keluarkan, ubah atau rosakkan minggu lepas.
Ini bukan hiasan. Ini cara terpantas menangkap ejen yang mengaitkan keluaran anda sendiri dengan kemas kini algoritma. Apabila laporan berkata sekumpulan halaman produk menurun dan nota anda berkata templatnya berubah pada Selasa, ruang penjelasannya mengecil serta-merta.
Hasil yang dijangkakan: dua atau tiga ayat di atas laporan, ditulis oleh manusia.
Semakan kualiti: kalau nota dan bahagian pergerakan saling bercanggah, percanggahan itu ialah baris paling berharga dalam laporan. Biarkan ia kelihatan daripada dilicinkan.
Langkah 5: sahkan sebelum menghantar
Jalankan tiga semakan ini sebelum laporan meninggalkan meja anda.
- Tarikh. Kedua-dua tetingkap dinyatakan di kepala laporan, sepadan dengan eksport.
- Dua ujian petik. Dua pertanyaan yang ditanda disahkan dengan tangan.
- Satu semakan percanggahan. Adakah mana-mana penjelasan yang didakwa merujuk data yang tiada dalam senarai fail di bawah?
Kalau ketiga-tiganya lulus, laporan itu selamat dikongsi. Ia draf penilaian anda, bukan penggantinya.
Laluan lanjutan, apabila anda bersedia
Jalankan aliran ini dengan tangan selama empat minggu. Automasikan hanya selepas anda membetulkan kelas ralat yang sama dua kali.
Selepas itu penambahbaikan bersifat berperingkat:
- Jadualkan larian. Larian berjadual mingguan akan menulis laporan sebelum anda membuka komputer riba. Kekalkan perenggan manusia sebagai medan wajib, supaya laporan tidak boleh keluar tanpanya.
- Simpan snapshot dalam kawalan versi. Setiap larian menjadi satu commit. Beza antara dua minggu lebih cepat dibaca daripada kedua-dua laporannya.
- Tambah properti kedua. Pertanyaan pesaing atau jenama duduk dalam laporan berasingan dengan kontrak yang sama, bukan dicampur ke dalam laporan utama.
- Tambah satu isyarat luaran. Semakan carian berjenama atau bahagian jawapan menjadikan isyarat jenama daripada tinjauan 2026 boleh diukur dan bukan sekadar teori.
Apa yang tidak patut diautomasikan: langkah saranan. Sebaik sahaja ejen mula mencadangkan perubahan laman, anda sudah berpindah daripada pelaporan ke penerbitan, dan beban semakan naik lebih cepat daripada masa yang dijimatkan.
Penyelesaian masalah
Gejala | Punca mungkin | Pembetulan |
|---|---|---|
Setiap pertanyaan kelihatan menurun | Julat tarikh beralih antara eksport | Pakukan kedua-dua tetingkap dalam kontrak dan kepala laporan |
Laporan kosong | Ambang terlalu ketat untuk tahap trafik anda | Turunkan ambang tayangan sebelum menurunkan ambang kedudukan |
Lima pertanyaan sama setiap minggu | Set pertanyaannya terlalu sempit | Tambah pertanyaan ekor panjang dan pertanyaan perbandingan ke dalam bakul |
Pergerakan tanpa penjelasan | Biasa bagi pertanyaan volum rendah | Kekalkan hasil "tidak dijelaskan oleh data ini" dan teruskan |
Angka berbeza daripada Search Console | Properti atau penapis tidak sepadan dalam eksport | Sentiasa eksport daripada properti dan set penapis yang sama |
Pelihara aliran ini
Tiga tabiat penyelenggaraan mengekalkannya berguna melepasi suku pertama.
Semak semula set pertanyaan setiap suku. Laporan yang mengejar keutamaan tahun lepas ialah pelajaran sejarah, bukan laporan kedudukan.
Baca semula kontrak apabila Search Console berubah. Google mengemas kini antara muka laporan Prestasi dan medan eksport secara berkala. Kalau satu medan hilang, kontrak itu perlu disunting pada hari yang sama.
Simpan laporan lama. Membandingkan laporan suku ini dengan suku yang sama tahun lepas ialah satu-satunya cara murah untuk memisahkan penurunan sebenar daripada faktor bermusim.
Soalan lazim (FAQ)
Perlukah guna Codex? Tidak. Aliran ini berfungsi dengan mana-mana ejen yang boleh membaca fail, berjalan mengikut jadual dan menulis output yang boleh disemak. Codex sesuai apabila laman anda memang sudah hidup dalam repositori, kerana laporannya menjadi commit yang boleh anda bandingkan.
Boleh guna alat percuma sahaja? Boleh. Keseluruhan aliran berjalan atas data Search Console yang percuma serta ejennya. Anda hanya perlukan penjejak kedudukan berbayar apabila mahukan kedudukan pesaing atau kedudukan yang tidak kelihatan dalam properti anda sendiri.
Apa bezanya dengan laporan Prestasi dalam Search Console? Laporan Prestasi menunjukkan jadual. Aliran ini menghasilkan keputusan: pertanyaan mana yang melepasi ambang, apa yang dijelaskan dan tidak dijelaskan oleh data, dan apa yang perlu diperiksa minggu depan. Ia juga menyimpan rekod, yang tidak dilakukan oleh antara muka itu.
Kalau laman saya sangat sedikit trafik? Turunkan ambang tayangan dan bandingkan 28 hari dengan 28 hari yang sama tahun lepas, bukan dengan 28 hari sebelumnya. Laman volum rendah mendapat lebih banyak isyarat daripada perbandingan tahun ke tahun berbanding minggu ke minggu.
Patutkah laporan memuatkan AI Overview atau petikan AI? Kalau mahu, tambah bahagian berasingan dengan kontraknya sendiri. Jauhkan ia daripada laporan kedudukan, kerana sumber dan pengukurannya berbeza, dan mencampurkannya menjadikan kedua-duanya lebih sukar dibaca.
Penulis: Leo Harrington, penterjemah analitik SEO untuk lebih 500 laporan eksekutif di Auspia. Leo menulis tentang menukar data carian menjadi laporan yang boleh ditindaklanjuti oleh bukan pakar.
