Google Analytics 4 (idxal)

1. Nə daxil olur və nə olmur

Hər iki yol bu hesabdan oxuyur: sizin Google hesabınızdan və ayrıca aktivləşdirilir. Fərqli suallara cavab verir və hər ikisinə ehtiyacınız yoxdur.

Yol	Nə gətirir	Nə üçün
Data API	Gündəlik yekunlar: seanslar, istifadəçilər, səhifə baxışları, iştiraklı seanslar	Əhatə sualı. GA4 3,000 seans sayır, MousePlayer 40 qeydə alıb — istinad rəqəmi olmadan fərqi hətta görmək olmaz.
BigQuery idxalı	Hadisələri ilə ayrı-ayrı GA4 seansları	MousePlayer-in qeydə ala bilmədiyi ziyarətdə nə baş verdiyi.

İdxal edilmiş seans təkrar oynadıla bilməz. GA4 nə səhifənin anlıq görüntüsünü, nə də siçan hərəkətini saxlayır, buna görə təkrar oynatma qurmaq üçün əsas yoxdur. Aldığınız qeydlərinizin yanındakı rəqəmlər və hadisələrdir — bundan artıq deyil və biz onu artıq kimi təqdim etmirik.

İdxal öz cədvəllərində saxlanılır və qeydlərinizə heç vaxt qarışdırılmır. Əks halda hər törəmə göstəricinin mənası səssizcə dəyişərdi — davranış profilləri, ziyarətçi qiymətləndirməsi, maneə təhlili — və sonradan hansı sətrin ölçüldüyünü, hansının gətirildiyini heç kim deyə bilməzdi.

2. Yol 1: Data API

İki şey lazımdır: resurs ID-si və xidmət hesabı açarı.

Resurs ID-si ölçmə ID-si deyil

Ən çox uğursuzluğa səbəb olan məqam budur və Google-un öz xəta mesajı bunu demir. Ölçmə ID-si belə görünür: G-ABC123XYZ, izləmə kodunuzda yerləşir və hər yerdə görünür. Resurs ID-si isə yalnız rəqəmlərdən ibarətdir və yalnız admin sahəsində, Admin, Resurs parametrləri altında görünür. İkinci tələb olunur; birincini sizi 400 xətasına aparmaq əvəzinə qeydlə rədd edirik.

Xidmət hesabının yaradılması və icazələndirilməsi

Google Cloud Console-da xidmət hesabı yaradın və JSON açarı yaradın.
Eyni layihədə bu API-ni aktivləşdirin: Google Analytics Data API.
GA4-də Admin, Resursa girişin idarə edilməsi altında xidmət hesabının e-poçt ünvanını bu rolla əlavə edin: Baxışçı. Xidmət hesabı ayrıca istifadəçidir; bu addım olmadan Google səbəbini demədən 403 cavabı verir.

JSON faylının məzmununu sahəyə yapışdırın. Şifrələnmiş saxlanılır və sonra yalnız qısaldılmış formada göstərilir.

3. Yol 2: BigQuery idxalı

Bu yol GA4-ün xam ixracını oxuyur. Bunu GA4-də bir dəfə qurmalısınız: Admin, BigQuery keçidləri. Cədvəllər yalnız növbəti gündən görünür — bundan əvvəl idxal heç nə tapmır və bu, xəta deyil.

Nə daxil edirsiniz

İxracın yerləşdiyi GCP layihə ID-si . Bu, MousePlayer məlumatlarını ixrac etdiyiniz layihə ilə eyni olmaq məcburiyyətində deyil.
Bu məlumatın məlumat dəsti ID-si. GA4 ona bu adı verir: analytics_<propertyId>.
Məlumat dəstində bu rolu olan xidmət hesabı açarı: BigQuery Data Viewer və layihədə bu rolu olan: BigQuery Job User . Oxuma girişi kifayətdir; daha artıq icazə verməyin.

Nəyə başa gəlir və kim ödəyir

BigQuery bu ölçüyə görə ödəniş hesablayır: oxunmuş baytlarvə bu ödəniş sizə aiddir. Buna görə idxal hər icrada yalnız bir neçə günü oxuyur və həmişə tək sorğu işlədir — ikinci sorğu eyni cədvəlləri yenidən oxuyardı. Bundan əlavə sərt hədd sorğunu bahalaşmazdan əvvəl dayandırır; bu baş verdikdə çatdırılma jurnalındakı mesaj zaman aralığının çox böyük olduğunu bildirir.

İcra tezliyi

Standart olaraq hər altı saatdan bir və hər icra son üç günü yenidən gətirir. Bu təsadüfi deyil: GA4 48 saatadək geriyə məlumat tamamlayır və gündəlik ixrac yalnız ertəsi gün görünür. Daha tez-tez soruşmaq daha təzə rəqəmlər deyil, eyni rəqəmləri verir.

4. Hər iki tərəfi bağlayan açar

Həmçinin bu körpünü: analitika körpüsü GA4-ə təyin etsəniz, MousePlayer hər seansla birlikdə bu kukidən müştəri ID-sini qeydə alır: _ga . BigQuery ixracında bu sahədə olan dəyər məhz budur: user_pseudo_id.

Bununla GA4 seansı qeydlərinizdən biri ilə uyğunlaşdırıla bilər — əks istiqamətdə isə eyni ziyarətdə GA4-ün nə saydığını görə bilərsiniz. Körpü olmadan hər iki tərəf sadəcə əlaqəsiz yan-yana qalır.

Bu üsuldan istifadə edirsinizsə, eyni sahədə öz müştəri identifikatorunuz da saxlanılır: setUserId(). Hər ikisi ola bilməz: orada ya Google müştəri ID-si, ya da öz nömrəniz yerləşir.

5. Razılıq, saxlanma, silinmə

Daxil olan məlumatda kuki olub

Yalnız bu identifikatoru daşıyan sətirlər: user_pseudo_id idxal edilir. Ziyarətçi rədd etdikdə GA4 Consent Mode ilə kukisiz müraciətlər göndərir və onlarda bu yoxdur — buna görə əlavə təminata ehtiyac olmadan kənarda qalır. Modelləşdirilmiş, yəni təxmin edilmiş sətirlər də eyni səbəbdən kənarda qalır: təxmini seans kimi saxlamaq heç baş verməmiş ziyarətləri saxlamaq demək olardı.

Nə qədər saxlanılır

Standart olaraq 180 gün, idxal anından deyil, sətrin təsvir etdiyi gündən hesablanır. Əks halda müddət heç bitməzdi, çünki hər icra eyni günləri yenidən gətirir.

Silinmə

Ziyarətçi məlumatlarının silinməsini istəyərsə, yuxarıdakı identifikatorla əlaqələndirmək mümkün olduğu qədər idxal edilmiş GA4 seansları da silinir. Layihəni silsəniz, qeydlərinizdən heç birinə aid olmayan sətirlər də daxil olmaqla hər halda silinirlər. Gündəlik saxlanma icrası onlara qəsdən toxunmur: GA4 məlumatlarının öz müddəti var, qeydləriniz isə daha tez bitir.

6. Heç nə gəlməyəndə

Hər icra nəticəsini, uğursuzluqlar daxil olmaqla, inteqrasiyalar səhifəsindəki çatdırılma jurnalına aydın sözlərlə yazır. Adətən nəyin çatışmadığı artıq orada deyilir.

Mesaj	Nə etməli
Resurs ID-si yalnız rəqəmlərdən ibarət olmalıdır	Ölçmə ID-sini daxil etmisiniz. Doğru nömrə GA4-də Resurs parametrləri altındadır.
Data API-dən HTTP 403	Xidmət hesabı GA4 resursunda Baxışçı deyil və ya GCP layihəsində Data API aktiv deyil.
Məlumat dəsti və ya ixrac cədvəlləri tapılmadı	BigQuery əlaqəsi yoxdur, məlumat dəsti fərqli adlanır və ya hələ bir gün keçməyib.
Giriş rədd edilib (BigQuery)	Xidmət hesabında məlumat dəsti üzrə BigQuery Data Viewer və ya layihə üzrə BigQuery Job User yoxdur.
Sorğu həddindən çox məlumat oxuyacaqdı	Xərc həddi hər hansı ödəniş hesablanmazdan əvvəl onu dayandırıb. Daha kiçik zaman aralığı seçin.
aralıqda seans yoxdur	Xəta deyil. Gətirilmiş günlərdə razılıqlı seans olmayıb.

Necə kömək edə bilərik?