Ukungenisa kusuka ku-Google Analytics 4
Izindlela ezimbili zokuletha izibalo zakho ze-GA4 lapha: izamba zansuku zonke zokubuza ukuthi i-MousePlayer ibona okungakanani — namaseshini e-GA4 ngamanye avela ekuthekeliseni kwe-BigQuery okuvakasha esingakwazanga ukukurekhoda.
1. Okungenayo nokungangeniyo
Zombili izindlela zifunda ku-akhawunti ye-Google yakho futhi zivulwa ngokwehlukana. Ziphendula imibuzo ehlukene, futhi awuzidingi zombili.
| Indlela | Okulandwayo | Inhloso |
|---|---|---|
| Data API | Izamba zansuku zonke: amaseshini, abasebenzisi, ukubukwa kwamakhasi, amaseshini azibandakanyayo | Umbuzo wokumbozwa. I-GA4 ibala amaseshini angu-3,000, i-MousePlayer irekhode angu-40 — ngaphandle kwesibalo sokuqhathanisa umehluko awunakubonwa nokubonwa. |
| Ukungenisa kwe-BigQuery | Amaseshini e-GA4 ngamanye nezehlakalo zawo | Okwenzekile ekuvakasheni i-MousePlayer engakwazanga ukukurekhoda. |
Iseshini engenisiwe ayikwazi ukudlalwa kabusha. I-GA4 ayigcini isithombe sekhasi noma ukunyakaza kwegundane, ngakho akukho okungakhiwa ngakho ukudlala kabusha. Okutholayo yizibalo nezehlakalo eceleni kokurekhodiwe kwakho — akukho okungaphezu kwalokho, futhi asikuvezi njengokungaphezu kwalokho.
Ukungenisa kugcinwa kumathebula aso ahlukile futhi akuhlanganiswa neze nokurekhodiwe kwakho. Kungenjalo incazelo yazo zonke izibalo ezitholwe ngokubala ibizoshintsha buthule — amaphrofayela okuziphatha, ukunikeza izivakashi inani, ukuhlaziywa kwezithiyo — bese kungabi namuntu ongasho ukuthi yimuphi umugqa olinganisiwe nokuthi yimuphi olandiwe.
2. Indlela 1: Data API
Udinga izinto ezimbili: i-ID yesayithi nokhiye we-akhawunti yesevisi.
I-ID yesayithi ayiyona i-ID yokulinganisa
Lona umzamo ovame ukuhluleka kakhulu, futhi umlayezo wephutha we-Google uqobo awuyisho imbangela. I- ID yokulinganisa ibukeka kanje: G-ABC123XYZ, itholakala ocezwini lwekhodi yakho lokulandelela futhi ibonakala yonke indawo. I- ID yesayithi iyizinombolo kuphela futhi ivela endaweni yokuphatha kuphela, ngaphansi kokuthi Umphathi, Izilungiselelo Zesayithi. Kudingeka eyesibili; eyokuqala siyayenqaba ngenothi kunokuba sikuvumele uhlangabezane no-400.
Ukudala nokugunyaza i-akhawunti yesevisi
- Ku-Google Cloud Console, dala i-akhawunti yesevisi bese ukhiqiza ukhiye we-JSON.
- Kuphrojekthi efanayo, vula i- Google Analytics Data API.
- Ku-GA4 ngaphansi kokuthi Umphathi, Ukuphathwa Kokufinyelela Isayithi, faka ikheli le-imeyili le-akhawunti yesevisi libe Umbukeli. I-akhawunti yesevisi iwumsebenzisi ozimele; ngaphandle kwalesi sinyathelo i-Google iphendula ngo-403, ingasho nokuthi kungani.
Namathisela okuqukethwe kwefayela le-JSON enkambini. Kugcinwa kubethelwe futhi kamuva kuboniswa kufinyeziwe kuphela.
3. Indlela 2: ukungenisa kwe-BigQuery
Le ndlela ifunda ukuthekelisa okuluhlaza kwe-GA4. Kufanele ukusetha kanye ku-GA4: Umphathi, Izixhumanisi Ze-BigQuery. Amathebula avela kuphela kusukela ngosuku olulandelayo — ngaphambi kwalokho ukungenisa akutholi lutho, futhi lokho akulona iphutha.
Okufakayo
- I- ID yephrojekthi ye-GCP lapho kugcinwe khona ukuthekelisa. Akudingeki kube yiphrojekthi efanayo othekelisa kuyo idatha ye-MousePlayer.
- I- ID yesethi yedatha. I-GA4 iyibiza ngokuthi
analytics_<propertyId>. - Ukhiye we-akhawunti yesevisi onendima ye- BigQuery Data Viewer kusethi yedatha ne- BigQuery Job User kuphrojekthi. Ukufinyelela kokufunda kwanele; unganikezi okwengeziwe.
Izindleko nokuthi zikhokhwa ngubani
I-BigQuery ikhokhisa ngokwe- bhayithi elifundiwe, futhi leyo nkokhelo ingeyakho. Yingakho ukungenisa kufunda izinsuku ezimbalwa kuphela ekuqaliseni ngakunye futhi kuhlale kusebenzisa umbuzo owodwa kuphela — owesibili ubuzofunda amathebula afanayo futhi. Ngaphezu kwalokho umkhawulo oqinile umisa umbuzo ngaphambi kokuba ubize kakhulu; uma lokho kwenzeka, umlayezo kulogi yokuthunyelwa uthi iwindi lesikhathi likhulu kakhulu.
Imvamisa
Njalo ngemva kwamahora ayisithupha ngokuzenzakalela, futhi ukuqalisa ngakunye kulanda futhi izinsuku ezintathu ezedlule. Lokhu akukhethiwe nje: i-GA4 igcwalisa emuva amahora afinyelela kwangu-48, futhi ukuthekelisa kwansuku zonke kuvela ngosuku olulandelayo kuphela. Ukubuza kaningi akukuniki izinombolo ezintsha, kukunika ezifanayo nje.
4. Ukhiye oxhumanisa izinhlangothi zombili
Uma futhi usetha ibhuloho lokuhlaziya ku-GA4, i-MousePlayer irekhoda i-ID yeklayenti evela kukhukhi elithi _ga ngeseshini ngayinye. Yilo kanye inani elithwalwa ukuthekelisa kwe-BigQuery ngaphansi kokuthi user_pseudo_id.
Ngalo, iseshini ye-GA4 ingafaniswe nokukodwa okurekhodiwe kwakho — futhi ngakolunye uhlangothi ungabona lokho i-GA4 ekubalile ngesikhathi sokuvakasha okufanayo. Ngaphandle kwebhuloho izinhlangothi zombili zimane zihlale eceleni, zingaxhunyiwe.
Inkambu efanayo iqukethe nesihlonzi sakho sekhasimende uma usebenzisa setUserId(). Ngeke ube nakho kokubili: kungaba i-ID yeklayenti le-Google noma inombolo yakho ekhona lapho.
5. Imvume, ukugcinwa, ukususa
Okungenayo bekunekhukhi
Kungena imigqa enesihlonzi esithi user_pseudo_id kuphela. Lapho isivakashi senqaba, i-GA4 ithumela izehlakalo ezingenamakhukhi ngaphansi kwe-Consent Mode, futhi lezo azinaso — ngakho azifakwa ngaphandle kokuba umuntu enze isiqinisekiso. Imigqa eyenziwe imodeli, okusho ukuqagelwa, ayifakwa ngesizathu esifanayo: ukugcina ukuqagelwa njengeseshini bekuzosho ukugcina ukuvakasha okungazange kwenzeke.
Ihlala isikhathi esingakanani
Izinsuku ezingu-180 ngokuzenzakalela, zibalwa kusukela osukwini oluchazwa umugqa — hhayi kusukela ngesikhathi sokungenisa. Kungenjalo isikhathi besingeke siphele, ngoba ukuqalisa ngakunye kulanda izinsuku ezifanayo futhi.
Ukususa
Uma isivakashi sicela ukususwa kwedatha yaso, amaseshini aso e-GA4 angenisiwe nawo ayasuswa — ngokwezinga angabelwa ngalo ngesihlonzi esingenhla. Uma ususa iphrojekthi, ayasuswa noma kunjalo, kuhlanganise nemigqa engakaze ibe yingxenye yokurekhodiwe kwakho. Ukuqalisa kwansuku zonke kokugcinwa kukhetha ukungayithinti: idatha ye-GA4 inesikhathi sayo, futhi okurekhodiwe kwakho kuphelelwa isikhathi ngaphambili.
6. Uma kungafiki lutho
Ukuqalisa ngakunye kubhala umphumela wakho kulogi yokuthunyelwa ekhasini lokuhlanganisa — kuhlanganise nokwehluleka, ngamagama acacile. Lokho kuvame ukusho vele ukuthi yini engekho.
| Umlayezo | Okufanele ukwenze |
|---|---|
| I-ID yesayithi kufanele ibe izinombolo kuphela | Ufake i-ID yokulinganisa. Inombolo efanele iku-GA4 ngaphansi kokuthi Izilungiselelo Zesayithi. |
| HTTP 403 evela ku-Data API | I-akhawunti yesevisi ayiyena umbukeli kusayithi le-GA4, noma i-Data API ayivuliwe kuphrojekthi ye-GCP. |
| Isethi yedatha noma amathebula okuthekelisa akutholakalanga | Isixhumanisi se-BigQuery asikho, isethi yedatha inegama elihlukile noma usuku alukadluli okwamanje. |
| Ukufinyelela kunqatshiwe (BigQuery) | I-akhawunti yesevisi ayinayo i-BigQuery Data Viewer kusethi yedatha noma i-BigQuery Job User kuphrojekthi. |
| Umbuzo ubuzofunda okuningi kakhulu | Umkhawulo wezindleko uwumise ngaphambi kokuba kukhokhiswe lutho. Khetha iwindi lesikhathi elincane. |
| awekho amaseshini ewindini lesikhathi | Akulona iphutha. Belingekho iseshini enemvume ezinsukwini ezilandiwe. |