Impor dari Google Analytics 4

1. Yang Diimpor, dan yang Tidak

Kedua jalur membaca dari akun Google Anda dan diaktifkan secara terpisah. Keduanya menjawab pertanyaan berbeda, dan Anda tidak memerlukan keduanya.

Jalur	Yang diambil	Tujuan
Data API	Total harian: sesi, pengguna, tampilan halaman, sesi dengan interaksi	Pertanyaan cakupan. GA4 menghitung 3.000 sesi, MousePlayer merekam 40 — tanpa angka acuan, perbedaannya bahkan tidak dapat diketahui.
Impor BigQuery	Sesi GA4 individual beserta peristiwanya	Apa yang terjadi selama kunjungan yang tidak dapat direkam MousePlayer.

Impor disimpan dalam tabelnya sendiri dan tidak pernah dicampurkan ke rekaman Anda. Jika dicampurkan, makna setiap angka turunan akan berubah diam-diam — profil perilaku, penilaian pengunjung, analisis hambatan — dan sesudahnya tidak ada yang dapat menentukan baris mana yang diukur dan mana yang diambil.

2. Jalur 1: Data API

Anda memerlukan dua hal: ID properti dan kunci akun layanan.

ID Properti Bukan ID Pengukuran

Inilah kesalahan yang paling sering terjadi, dan pesan kesalahan Google sendiri tidak menyebutkannya. ID pengukuran berbentuk seperti G-ABC123XYZ, ada di cuplikan kode pelacakan, dan terlihat di mana-mana. ID properti hanya berupa angka dan hanya muncul di area admin, pada Admin, Pengaturan properti. Yang diperlukan adalah yang kedua; kami menolak yang pertama dengan keterangan agar Anda tidak menemui kesalahan 400.

Membuat dan Memberi Akses Akun Layanan

• Di Google Cloud Console, buat akun layanan dan hasilkan kunci JSON.
• Di proyek yang sama, aktifkan Google Analytics Data API.
• Di GA4, pada Admin, Pengelolaan akses properti, tambahkan alamat email akun layanan sebagai Pelihat. Akun layanan adalah pengguna tersendiri; tanpa langkah ini, Google menjawab 403 tanpa menjelaskan alasannya.

Tempelkan isi file JSON ke kolom. Disimpan secara terenkripsi dan setelahnya hanya ditampilkan dalam bentuk singkat.

3. Jalur 2: Impor BigQuery

Jalur ini membaca ekspor mentah GA4. Anda harus menyiapkannya sekali di GA4: Admin, Tautan BigQuery. Tabel Baru Muncul Mulai Hari Berikutnya — sebelum itu, impor tidak menemukan apa pun, dan itu bukan kesalahan.

Yang Anda Masukkan

• ID proyek GCP tempat ekspor disimpan. Belum tentu proyek yang sama dengan tujuan ekspor data MousePlayer Anda.
• ID dataset. GA4 menamainya analytics_<propertyId>.
• Kunci akun layanan dengan peran BigQuery Data Viewer pada dataset dan BigQuery Job User di proyek. Akses baca sudah cukup; jangan berikan lebih.

Biaya dan Siapa yang Membayar

BigQuery menagih berdasarkan byte yang dibaca, dan tagihannya menjadi tanggungan Anda. Karena itu, impor hanya membaca beberapa hari per proses dan hanya menjalankan satu kueri — kueri kedua akan membaca tabel yang sama lagi. Selain itu, batas tegas membatalkan kueri sebelum biayanya tinggi; jika terjadi, pesan di log pengiriman menyatakan bahwa rentang waktu terlalu besar.

Frekuensi

Secara bawaan setiap enam jam, dan setiap proses mengambil ulang tiga hari terakhir. Ini bukan tanpa alasan: GA4 melengkapi data hingga 48 jam ke belakang, dan ekspor harian baru muncul keesokan harinya. Meminta lebih sering tidak memberikan angka lebih baru, hanya angka yang sama.

4. Kunci yang Menghubungkan Kedua Sisi

Jika Anda juga mengatur jembatan analitik ke GA4, MousePlayer merekam ID klien dari cookie _ga pada setiap sesi. Itulah nilai yang dibawa ekspor BigQuery sebagai user_pseudo_id.

Dengan nilai itu, sesi GA4 dapat dicocokkan dengan salah satu rekaman Anda — dan sebaliknya, Anda dapat melihat apa yang dihitung GA4 selama kunjungan yang sama. Tanpa jembatan, kedua sisi hanya berdampingan tanpa terhubung.

5. Persetujuan, Retensi, Penghapusan

Data yang Diimpor Memiliki Cookie

Hanya baris yang memiliki user_pseudo_id yang diimpor. Jika pengunjung menolak, GA4 mengirim hit tanpa cookie dalam Consent Mode, dan hit tersebut tidak memiliki pengenal itu — sehingga dikecualikan tanpa perlu jaminan siapa pun. Baris hasil pemodelan, yaitu estimasi, juga dikecualikan dengan alasan yang sama: menyimpan estimasi sebagai sesi berarti menyimpan kunjungan yang tidak pernah terjadi.

Lama Penyimpanan

Secara bawaan 180 hari, dihitung dari hari yang dijelaskan baris tersebut — bukan saat impor. Jika tidak, periode tidak akan pernah berakhir karena setiap proses mengambil ulang hari yang sama.

Penghapusan

Jika pengunjung meminta datanya dihapus, sesi GA4 impornya juga dihapus — sejauh dapat dikaitkan melalui pengenal di atas. Jika Anda menghapus proyek, semuanya tetap dihapus, termasuk baris yang tidak pernah menjadi bagian dari rekaman Anda. Proses retensi harian sengaja tidak menyentuhnya: data GA4 mengikuti jadwalnya sendiri, dan rekaman Anda kedaluwarsa lebih dahulu.

6. Saat Tidak Ada Data yang Masuk

Setiap proses menulis hasilnya ke log pengiriman di halaman integrasi — termasuk kegagalan, dalam bahasa yang jelas. Biasanya itu sudah menjelaskan apa yang kurang.

Pesan	Yang perlu dilakukan
ID properti harus hanya berupa angka	Anda memasukkan ID pengukuran. Nomor yang benar ada di GA4 pada Pengaturan properti.
HTTP 403 dari Data API	Akun layanan bukan Pelihat pada properti GA4, atau Data API belum diaktifkan di proyek GCP.
Dataset atau tabel ekspor tidak ditemukan	Tautan BigQuery belum ada, nama dataset berbeda, atau belum lewat satu hari.
Akses ditolak (BigQuery)	Akun layanan tidak memiliki BigQuery Data Viewer pada dataset atau BigQuery Job User di proyek.
Kueri akan membaca terlalu banyak data	Batas biaya membatalkannya sebelum ada tagihan. Pilih rentang waktu yang lebih kecil.
tidak ada sesi dalam rentang waktu	Bukan kesalahan. Tidak ada sesi dengan persetujuan pada hari yang diambil.