Import daripada Google Analytics 4

1. Perkara yang masuk, dan yang tidak

Kedua-dua laluan membaca daripada akaun Google anda dan diaktifkan secara berasingan. Ia menjawab soalan berbeza, dan anda tidak memerlukan kedua-duanya.

Laluan	Perkara yang diambil	Tujuan
Data API	Jumlah harian: sesi, pengguna, paparan halaman, sesi terlibat	Soalan liputan. GA4 mengira 3,000 sesi, MousePlayer merakam 40 - tanpa angka rujukan, perbezaan itu pun tidak dapat disedari.
Import BigQuery	Sesi GA4 individu bersama peristiwanya	Perkara yang berlaku semasa lawatan yang tidak dapat dirakam MousePlayer.

Import disimpan dalam jadual tersendiri dan tidak pernah dicampurkan ke dalam rakaman anda. Jika tidak, makna setiap angka terbitan akan berubah secara senyap - profil tingkah laku, penilaian pelawat, analisis geseran - dan selepas itu tiada siapa dapat menyatakan baris mana diukur dan baris mana diambil.

2. Laluan 1: Data API

Anda memerlukan dua perkara: ID aset web dan kunci akaun perkhidmatan.

ID aset web bukan ID pengukuran

Inilah percubaan gagal paling biasa, dan mesej ralat Google sendiri tidak menyebutnya. ID pengukuran kelihatan seperti G-ABC123XYZ, berada dalam cebisan kod penjejakan anda dan kelihatan di mana-mana. ID aset web ialah angka sahaja dan hanya muncul dalam kawasan pentadbir, di Admin, Property settings. Yang kedua itulah diperlukan; kami menolak yang pertama dengan nota, bukan membiarkan anda mengalami ralat 400.

Mencipta dan memberikan kebenaran kepada akaun perkhidmatan

• Dalam Google Cloud Console, cipta akaun perkhidmatan dan jana kunci JSON.
• Dalam projek yang sama, aktifkan Google Analytics Data API.
• Dalam GA4 di Admin, Property access management, tambahkan alamat e-mel akaun perkhidmatan sebagai Viewer. Akaun perkhidmatan ialah pengguna tersendiri; tanpa langkah ini, Google membalas 403 tanpa menyatakan sebabnya.

Tampal kandungan fail JSON ke dalam medan. Ia disimpan tersulit dan hanya ditunjukkan dalam bentuk dipendekkan selepas itu.

3. Laluan 2: import BigQuery

Laluan ini membaca eksport mentah GA4. Anda perlu menyediakannya sekali dalam GA4: Admin, BigQuery links. Jadual hanya muncul mulai hari berikutnya - sebelum itu import tidak menemui apa-apa, dan itu bukan ralat.

Perkara yang anda masukkan

• ID projek GCP tempat eksport berada. Itu tidak semestinya projek yang sama tempat anda mengeksport data MousePlayer.
• ID set data. GA4 menamakannya analytics_<propertyId>.
• Kunci akaun perkhidmatan dengan BigQuery Data Viewer pada set data dan BigQuery Job User dalam projek. Akses baca mencukupi; sila jangan berikan lebih.

Kosnya, dan siapa membayar

BigQuery mengenakan caj mengikut bait dibaca, dan bil itu tanggungan anda. Sebab itulah import membaca hanya beberapa hari setiap larian dan hanya menjalankan satu pertanyaan - pertanyaan kedua akan membaca jadual yang sama semula. Di samping itu, had tegas membatalkan pertanyaan sebelum menjadi mahal; apabila itu berlaku, mesej dalam log penghantaran menyatakan jendela masa terlalu besar.

Kekerapan

Setiap enam jam secara lalai, dan setiap larian mengambil semula tiga hari terakhir. Itu bukan sewenang-wenangnya: GA4 mengisi semula data sehingga 48 jam, dan eksport harian hanya muncul pada hari berikutnya. Bertanya lebih kerap tidak memberikan angka lebih baharu, hanya angka yang sama.

4. Kunci yang memautkan kedua-dua belah

Jika anda turut menetapkan penghubung analitik kepada GA4, MousePlayer merekodkan ID klien daripada kuki _ga bersama setiap sesi. Itulah nilai tepat yang dibawa eksport BigQuery sebagai user_pseudo_id.

Dengannya, sesi GA4 boleh dipadankan dengan salah satu rakaman anda - dan sebaliknya, anda boleh melihat apa yang dikira GA4 semasa lawatan yang sama. Tanpa penghubung, kedua-dua belah hanya berada bersebelahan tanpa sambungan.

5. Persetujuan, pengekalan, pemadaman

Data yang masuk mempunyai kuki

Hanya baris yang membawa user_pseudo_id diimport. Apabila pelawat menolak, GA4 menghantar hit tanpa kuki di bawah Consent Mode, dan hit itu tidak membawanya - jadi dikecualikan tanpa sesiapa perlu memberikan jaminan. Baris dimodelkan, iaitu dianggarkan, juga dikecualikan atas sebab sama: menyimpan anggaran sebagai sesi bermakna menyimpan lawatan yang tidak pernah berlaku.

Tempoh penyimpanan

180 hari secara lalai, dikira dari hari yang dihuraikan baris - bukan masa import. Jika tidak, tempoh itu tidak akan tamat kerana setiap larian mengambil hari yang sama semula.

Memadam

Jika pelawat meminta data mereka dipadamkan, sesi GA4 diimport turut dipadamkan - setakat yang boleh diatributkan melalui pengecam di atas. Jika anda memadam projek, semuanya dipadamkan juga, termasuk baris yang tidak pernah tergolong pada rakaman anda. Larian pengekalan harian sengaja tidak menyentuhnya: data GA4 menggunakan kiraan masa tersendiri, dan rakaman anda luput lebih awal.

6. Apabila tiada data diterima

Setiap larian menulis hasilnya ke log penghantaran pada halaman integrasi - termasuk kegagalan, dengan bahasa jelas. Biasanya itu sudah menyatakan perkara yang kurang.

Mesej	Tindakan
ID aset web mestilah angka sahaja	Anda memasukkan ID pengukuran. Nombor yang betul berada dalam GA4 di Property settings.
HTTP 403 daripada Data API	Akaun perkhidmatan bukan Viewer pada aset web GA4, atau Data API tidak diaktifkan dalam projek GCP.
Set data atau jadual eksport tidak ditemui	Pautan BigQuery tiada, nama set data berbeza atau satu hari belum berlalu.
Akses ditolak (BigQuery)	Akaun perkhidmatan tiada BigQuery Data Viewer pada set data atau BigQuery Job User dalam projek.
Pertanyaan akan membaca terlalu banyak	Had kos membatalkannya sebelum apa-apa dibilkan. Pilih jendela masa lebih kecil.
tiada sesi dalam jendela	Bukan ralat. Tiada sesi dengan persetujuan dalam hari yang diambil.