Respons GA4 Data API yang berhasil belum membuktikan ekspornya lengkap. Sebuah permintaan dapat mengembalikan sebagian baris, membawa pembatasan kualitas, atau memakai kombinasi metrik yang tidak menjawab pertanyaan bisnismu.
Sebelum membuat grafik trafik organik, tambahkan satu tahap penerimaan data. Hasilnya sederhana: ekspor dapat dipakai, dapat dipakai dengan batas yang dijelaskan, atau perlu diperbaiki. Dengan begitu, angka parsial tidak diam-diam menjadi dasar keputusan konten.
Simpan kontrak laporan bersama hasilnya
Catat property, tanggal awal dan akhir, dimensi, metrik, filter, urutan baris, waktu pengambilan, serta versi kode pengambil data. Simpan juga zona waktu yang dilaporkan. Nama file seperti traffic-final.csv tidak cukup menjelaskan semuanya.
Tuliskan pertanyaan dalam satu kalimat, misalnya “berapa sesi organic search menurut landing page pada bulan lalu?”. Setelah itu tentukan satuan setiap baris. Jika menambahkan perangkat, satu landing page dapat muncul beberapa kali; itulah perubahan bentuk data yang perlu disadari.
Gunakan checkCompatibility untuk memeriksa kombinasi dimensi dan metrik yang didukung API. Kombinasi yang diterima secara teknis tetap perlu dinilai dari makna bisnisnya. Dokumentasi pemeriksaan kompatibilitas.
Bedakan jumlah baris respons dan jumlah baris hasil
rowCount menunjukkan jumlah baris hasil query, terpisah dari banyaknya baris yang dikirim pada satu respons. Karena itu, menghitung panjang rows saja dapat membuat ekspor terpotong terlihat lengkap. Struktur RunReportResponse.
Bayangkan hasil sintetis memiliki 2.350 baris dan kamu meminta 1.000 baris per halaman. Pengambilan yang diharapkan adalah 1.000, 1.000, lalu 350 baris. Simpan catatan berikut saat proses berjalan:
| Permintaan | Offset | Baris diterima | Akumulasi |
|---|---|---|---|
| Pertama | 0 | 1.000 | 1.000 |
| Kedua | 1.000 | 1.000 | 2.000 |
| Ketiga | 2.000 | 350 | 2.350 |
Angka tersebut hanya ilustrasi pagination. Besar halaman ditentukan sesuai kebutuhan, batas API, dan beban pemrosesan yang tersedia.
offset menentukan titik mulai baris dan limit menentukan banyaknya baris yang diminta. Dokumentasi saat diperiksa menetapkan batas maksimum 250.000 baris per permintaan. Meminta limit besar tetap tidak menggantikan pemeriksaan kelengkapan. Parameter runReport.
Buat pengambilan ulang yang dapat didiagnosis
Pertahankan dimensi, filter, periode, serta urutan selama mengambil halaman berikutnya. Urutan yang stabil membantu mendeteksi baris berulang. Hindari memecah pengambilan untuk periode yang masih cepat berubah lalu menganggap seluruh hasil sebagai satu snapshot tetap.
Simpan setiap halaman dengan nomor, offset, jumlah baris, dan statusnya sebelum digabung. Jika permintaan ketiga gagal, status keseluruhan adalah parsial. Jangan menerbitkan file dua halaman pertama dengan label “selesai”.
Periksa kunci gabungan dari seluruh dimensi dan indeks rentang tanggal jika memakai beberapa rentang. Kunci berulang antarhalaman perlu diselidiki, bukan otomatis dihapus untuk membuat jumlah akhir cocok. Penyebabnya bisa salah offset, perubahan hasil, atau konfigurasi pengurutan.
Jika rowCount berubah selama proses, tandai ketidakkonsistenan. Pilih pengambilan ulang dengan cakupan yang stabil atau laporkan batasnya. Jangan menambah baris rekaan agar jumlah sesuai dengan respons pertama.
Simpan metadata kualitas dalam berkas pendamping
Beberapa informasi penting tidak berada dalam tabel utama. Pada metadata, dataLossFromOtherRow menandai penggabungan rincian ke (other), sedangkan samplingMetadatas menjelaskan sampling ketika tersedia. subjectToThresholding berarti hasil tunduk pada threshold, bukan kepastian bahwa ada baris yang hilang. emptyReason dapat menjelaskan hasil kosong. Definisi ResponseMetaData.
Simpan nilai mentahnya bersama ekspor, bukan hanya badge “aman”. Jika beberapa halaman memiliki metadata berbeda, laporkan perbedaannya. Jangan mengambil metadata dari halaman terakhir saja dan membuang peringatan sebelumnya.
Untuk memahami gejala pada laporan, gunakan panduan data GA4 yang kosong, dibatasi, atau digabung. Dalam proses API, tugas tambahannya adalah memastikan keterangan tersebut ikut sampai ke orang yang membaca dashboard.
Rekonsiliasi menggunakan metrik yang tepat
Jangan menjumlahkan pengguna per halaman lalu menyebut hasilnya pengguna unik situs. Satu orang dapat mengunjungi beberapa halaman. Rata-rata dan rasio juga memerlukan komponen serta pembobotan yang sesuai, bukan penjumlahan langsung.
Buat permintaan pembanding pada cakupan yang sama untuk metrik yang ingin diperiksa. Catat apakah pengurangan dimensi mengubah cara agregasi. Selisih tidak selalu berarti bug; periksa definisi, filter, pembatasan kualitas, dan waktu pengambilan sebelum memutuskan.
Contoh penerimaan: jumlah baris lengkap, tidak ada kunci berulang yang belum dijelaskan, tetapi rincian tertentu masuk (other). Data itu mungkin cukup untuk laporan kanal, namun belum cukup untuk menyusun peringkat seluruh artikel. Status kegunaan mengikuti pertanyaan, bukan sekadar berhasilnya koneksi.
Serahkan bukti yang bisa diulang
Paket ekspor sebaiknya berisi konfigurasi permintaan tanpa kredensial, data per halaman, tabel gabungan, metadata kualitas, dan catatan pemeriksaan. Tambahkan jumlah baris yang diharapkan dan diterima agar penerima tidak harus menebak.
Mulai dari satu laporan yang dipakai setiap bulan. Uji satu kegagalan halaman lanjutan dan pastikan dashboard menolak menganggapnya lengkap. Pemeriksaan kecil itu melindungi keputusan yang nilainya jauh lebih besar daripada waktu menambahkan grafik baru.
