Importació de Google Analytics 4

1. Què s’importa i què no

Totes dues vies llegeixen les dades del seu compte de Google i s’activen per separat. Responen a preguntes diferents i no cal utilitzar-les totes dues.

Via	Què obté	Per a què serveix
Data API	Totals diaris: sessions, usuaris, visualitzacions de pàgina, sessions amb implicació	La qüestió de la cobertura. GA4 compta 3.000 sessions i MousePlayer n’ha gravat 40; sense la xifra de referència, ni tan sols es pot detectar la diferència.
Importació de BigQuery	Sessions individuals de GA4 amb els seus esdeveniments	Què ha passat durant una visita que MousePlayer no ha pogut gravar.

La importació es desa en taules pròpies i no es barreja mai amb les seves gravacions. Si no fos així, el significat de totes les xifres derivades canviaria sense avís —els perfils de comportament, la valoració dels visitants, l’anàlisi de fricció— i després ningú no podria dir quina fila s’ha mesurat i quina s’ha importat.

2. Via 1: Data API

Necessita dues coses: l’identificador de la propietat i una clau de compte de servei.

L’identificador de la propietat no és l’identificador de mesurament

Aquest és l’intent fallit més habitual, i el missatge d’error de Google no n’explica el motiu. El camp identificador de mesurament té un format com G-ABC123XYZ, és al fragment de seguiment i es veu pertot arreu. En canvi, el camp identificador de la propietat és exclusivament numèric i només apareix a l’àrea d’administració, a Administració, Configuració de la propietat. Cal el segon; rebutgem el primer amb un avís en lloc de deixar que es trobi amb un error 400.

Crear i autoritzar el compte de servei

• A la consola de Google Cloud, creï un compte de servei i generi una clau JSON.
• Al mateix projecte, activi l’API Google Analytics Data API.
• A GA4, a Administració, Gestió d’accés a la propietat, afegeixi l’adreça electrònica del compte de servei amb el rol Lector. Un compte de servei és un usuari independent; sense aquest pas, Google respon 403 sense explicar per què.

Enganxi el contingut del fitxer JSON al camp. Es desa xifrat i després només es mostra abreujat.

3. Via 2: Importació de BigQuery

Aquesta via llegeix l’exportació de dades en brut de GA4. Cal configurar-la una vegada a GA4: Administració, Enllaços de BigQuery. Les taules no apareixen fins a l’endemà i abans la importació no troba res; això no és cap error.

Què cal introduir

• El identificador del projecte de GCP que conté l’exportació. No és necessàriament el mateix projecte al qual exporta les dades de MousePlayer.
• El identificador del conjunt de dades. GA4 li dona el nom analytics_<propertyId>.
• Una clau de compte de servei amb el rol BigQuery Data Viewer al conjunt de dades i BigQuery Job User al projecte. N’hi ha prou amb accés de lectura; no concedeixi més permisos.

Què costa i qui ho paga

BigQuery factura segons els bytes llegits, i la factura va a càrrec seu. Per això la importació només llegeix uns quants dies per execució i sempre executa una sola consulta; una segona tornaria a llegir les mateixes taules. A més, un límit estricte interromp la consulta abans que resulti cara; quan passa, el missatge del registre de lliuraments indica que l’interval de temps és massa gran.

Periodicitat

Per defecte, cada sis hores, i cada execució torna a obtenir els últims tres dies. No és arbitrari: GA4 completa dades amb fins a 48 hores de retard, i l’exportació diària no apareix fins a l’endemà. Consultar més sovint no proporciona xifres més recents, sinó les mateixes.

4. La clau que vincula totes dues bandes

Si també configura el pont d’analítica amb GA4, MousePlayer grava l’identificador de client de la galeta _ga amb cada sessió. És exactament el valor que l’exportació de BigQuery conté al camp user_pseudo_id.

Amb aquest valor, una sessió de GA4 es pot relacionar amb una de les seves gravacions; a l’inrevés, pot veure què ha comptat GA4 durant la mateixa visita. Sense el pont, totes dues bandes simplement conviuen sense connexió.

5. Consentiment, conservació i supressió

Les dades que s’importen tenien una galeta

Només s’importen les files que contenen un valor user_pseudo_id vàlid. Quan un visitant rebutja el consentiment, GA4 envia senyals sense galetes en Consent Mode, i aquests no en contenen cap; per tant, queden exclosos sense que ningú hagi de donar garanties. Les files modelades, és a dir, estimades, també en queden excloses pel mateix motiu: desar una estimació com a sessió significaria desar visites que no han passat mai.

Quant de temps es conserva

Per defecte, 180 dies, comptats des del dia que descriu la fila, no des del moment de la importació. Si no, el termini no s’acabaria mai, perquè cada execució torna a obtenir els mateixos dies.

Supressió

Si un visitant demana que se suprimeixin les seves dades, també se suprimeixen les seves sessions de GA4 importades, en la mesura que es puguin atribuir mitjançant l’identificador anterior. Si suprimeix el projecte, se suprimeixen en qualsevol cas, incloses les files que no han pertangut mai a cap gravació seva. L’execució diària de conservació les deixa expressament intactes: les dades de GA4 tenen un calendari propi, i les seves gravacions caduquen abans.

6. Quan no arriba res

Cada execució escriu el resultat al registre de lliuraments de la pàgina d’integracions, també els errors, amb paraules entenedores. Normalment això ja indica què falta.

Missatge	Què cal fer
L’identificador de la propietat ha de ser exclusivament numèric	Ha introduït l’identificador de mesurament. El número correcte és a GA4, a Configuració de la propietat.
HTTP 403 de Data API	El compte de servei no té el rol de Lector a la propietat de GA4, o Data API no està activada al projecte de GCP.
No s’han trobat el conjunt de dades o les taules d’exportació	Falta l’enllaç de BigQuery, el conjunt de dades té un altre nom o encara no ha passat un dia.
Accés denegat (BigQuery)	Al compte de servei li falta BigQuery Data Viewer al conjunt de dades o BigQuery Job User al projecte.
La consulta hauria llegit massa dades	El límit de cost l’ha interrompuda abans que es facturés res. Triï un interval de temps més petit.
cap sessió dins de l’interval	No és cap error. No hi havia cap sessió amb consentiment als dies consultats.