Ekspor otomatis dapat terlihat lengkap karena prosesnya selesai tanpa error. Padahal, data Search Analytics API memiliki batas dan perilaku agregasi yang perlu dibaca bersama hasilnya. Banyak baris tidak otomatis berarti seluruh aktivitas pencarian sudah tercakup.
Saya membedakan dua kebutuhan: angka ringkas untuk memantau perubahan dan baris rinci untuk menemukan pola. Keduanya dapat memakai permintaan berbeda. Dashboard menjadi lebih jujur ketika asal angka dan keterbatasannya disimpan sejak pengambilan data.
Tulis kontrak permintaan sebelum membuat skrip
Kontrak minimal mencatat properti, tanggal awal dan akhir, tipe pencarian, dimensi, filter, jenis agregasi, serta keadaan data yang diminta. Simpan pula waktu pengambilan dan versi proses ekspor.
Contoh ilustratif: kamu ingin meneliti halaman tutorial pada pencarian web selama tujuh hari. Ekspor harian dengan dimensi page dan query menghasilkan rincian untuk pertanyaan itu. Ia bukan pengganti otomatis bagi total semua jenis pencarian pada seluruh properti.
Dokumentasi API menjelaskan bahwa kombinasi dimensi membentuk kelompok baris dan urutan dimensi menentukan urutan nilai pada keys. API juga tidak menjamin pengembalian semua baris, melainkan baris teratas sesuai batas internalnya. Referensi Search Analytics query.
Gunakan identitas baris yang lengkap
Misalkan urutan dimensi yang diminta adalah page, lalu query. Baris contoh mempunyai keys berisi URL tutorial dan kata pencarian. Jika skrip membacanya sebagai query lalu halaman, data masih dapat disimpan tetapi maknanya tertukar.
Untuk menghindarinya, simpan skema dimensi bersama respons. Bentuk identitas baris dari properti, tanggal, tipe pencarian, dan seluruh kombinasi dimensi yang relevan. Jangan memakai query saja sebagai kunci unik jika query yang sama dapat muncul untuk beberapa halaman.
Saat menggabungkan hasil beberapa hari, pertahankan tanggal tiap baris. Duplikat akibat pengambilan ulang harus dibedakan dari baris sah pada hari berbeda. Proses yang dijalankan kembali seharusnya memperbarui bagian yang sama secara terkontrol, bukan menggandakan totalnya.
Pagination menyelesaikan permintaan, bukan seluruh cakupan
rowLimit pada API dapat diatur sampai 25.000, dengan startRow untuk melanjutkan pengambilan. Panduan Google menyarankan pengambilan per hari dan pagination, sekaligus menjelaskan batas hingga 50.000 baris per hari per tipe pencarian. Pengelompokan menurut halaman atau query dapat menghilangkan sebagian data. Panduan pengambilan data Search Analytics.
Contoh ilustratif: batch pertama berisi 25.000 baris dan batch kedua 7.000. Kamu dapat mencatat 32.000 baris yang dikembalikan oleh permintaan tersebut. Jangan memberi label “seluruh pencarian website” hanya karena batch selanjutnya kosong.
Simpan catatan jumlah baris per batch, offset, keberhasilan respons, dan alasan berhenti. Jika satu batch gagal, tandai ekspor parsial. Nilai kosong akibat kegagalan tidak boleh diubah menjadi nol klik.
Pisahkan tabel ringkasan dan tabel diagnosis
Untuk memantau total, gunakan permintaan dengan dimensi yang sesuai kebutuhan ringkasan. Untuk diagnosis, gunakan rincian halaman atau query dengan batas cakupan yang dinyatakan. Google secara khusus menyarankan menghindari dimensi page dan query ketika membutuhkan data yang lebih lengkap. Panduan ekspor resmi.
Perbedaan antara jumlah rincian dan ringkasan menjadi informasi kualitas data. Jangan otomatis menambahkan baris “query lainnya” dengan posisi rata-rata yang dibuat-buat. Jika selisih dapat dihitung secara sah, jelaskan definisinya dan metrik mana yang belum diketahui.
Contoh kartu kualitas ekspor:
| Pemeriksaan | Catatan yang diperlukan |
|---|---|
| Definisi | Properti, periode, search type, filter, dimensi |
| Kelengkapan proses | Batch berhasil, gagal, dan alasan berhenti |
| Identitas | Tidak ada penggandaan kombinasi kunci yang sama |
| Konsistensi | Ringkasan dibandingkan dengan permintaan setara |
| Batas data | Batas baris dan rincian yang mungkin tidak tersedia |
| Pemakaian | Cocok untuk total, segmentasi, atau investigasi sampel |
Hitung ulang metrik sesuai maknanya
Untuk kelompok baris yang memang dapat dijumlahkan, CTR dihitung dari total klik dibagi total impresi. Jangan merata-ratakan persentase CTR setiap baris tanpa bobot.
Contoh ilustratif: satu baris memiliki 10 klik dari 100 impresi, baris lain 20 klik dari 1.000 impresi. CTR gabungan adalah 30 dibagi 1.100, sekitar 2,73%, bukan rata-rata sederhana 6%. Pastikan keduanya benar-benar kelompok terpisah dalam definisi pengambilan yang sama.
Perhatikan pula satuan penyimpanan. API mengembalikan CTR sebagai rasio; tampilan persentase memerlukan pemformatan yang sesuai. Jangan mengalikan dua kali ketika connector sudah mengubahnya. Definisi respons Search Analytics.
Uji sebelum mempercayai dashboard
Ambil periode kecil, periksa beberapa baris mentah, dan telusuri transformasinya sampai tampilan akhir. Uji pengambilan ulang, respons kosong yang sah, serta satu batch gagal. Pastikan ketiganya menghasilkan status berbeda.
Jika angka berbeda dari antarmuka Search Console, cocokkan periode, zona waktu, filter, tipe pencarian, dan tingkat agregasi sebelum menuduh salah satu sumber salah. Simpan respons asli agar proses dapat diaudit.
Ekspor yang baik membuat pembaca dashboard tahu apa yang sedang dihitung. Ketika cakupan terbatas, batas itu ikut tampil bersama angka, sehingga keputusan berikutnya tidak bertumpu pada kelengkapan yang hanya diasumsikan.
