Importación de Google Analytics 4

1. Que entra e que non

Ambas as vías len da súa conta Google e actívanse por separado. Responden preguntas distintas e non necesita ambas.

Vía	Que obtén	Para que
Data API	Totais diarios: sesións, usuarios, vistas de páxina e sesións con interacción	A cuestión da cobertura. GA4 conta 3.000 sesións e MousePlayer gravou 40; sen a cifra de referencia nin sequera se podería detectar a diferenza.
Importación BigQuery	Sesións GA4 individuais cos seus eventos	O que ocorreu nunha visita que MousePlayer non puido gravar.

Unha sesión importada non se pode reproducir. GA4 non conserva capturas da páxina nin movementos do rato, polo que non hai nada co que construír unha reprodución. Recibe cifras e eventos xunto ás gravacións, nada máis, e non o presentamos como algo máis.

A importación vive nas súas propias táboas e nunca se mestura coas gravacións. Doutro xeito cambiaría en silencio o significado de cada cifra derivada: perfís de comportamento, valoración dos visitantes e análise da fricción; despois ninguén podería dicir que fila se mediu e cal se obtivo doutra fonte.

2. Vía 1: Data API

Necesita dúas cousas: o ID da propiedade e unha clave de conta de servizo.

O ID da propiedade non é o ID de medición

Este é o intento fallido máis habitual e a propia mensaxe de Google non o explica. O ID de medición ten o aspecto G-ABC123XYZ, está no fragmento de seguimento e é visible en todas partes. O ID da propiedade é só numérico e aparece unicamente na administración, en Admin, Property settings. Necesítase o segundo; rexeitamos o primeiro cunha nota para non facelo acabar nun 400.

Crear e autorizar a conta de servizo

Na Google Cloud Console cree unha conta de servizo e xere unha clave JSON.
No mesmo proxecto active a Google Analytics Data API.
En GA4, en Admin, Property access management, engada o correo electrónico da conta de servizo como Viewer. Unha conta de servizo é un usuario propio; sen este paso Google responde 403 sen explicar por que.

Pegue o contido do ficheiro JSON no campo. Gárdase cifrado e despois só se mostra abreviado.

3. Vía 2: importación BigQuery

Esta vía le a exportación en bruto GA4. Ten que configurala unha vez en GA4: Admin, BigQuery links. As táboas só aparecen a partir do día seguinte e antes diso a importación non atopa nada, o que non é un fallo.

Que introduce

O ID do proxecto GCP no que está a exportación. Non é necesariamente o mesmo proxecto ao que exporta os datos MousePlayer.
O ID do conxunto de datos. GA4 chámao analytics_<propertyId>.
Unha clave de conta de servizo con BigQuery Data Viewer no conxunto de datos e BigQuery Job User no proxecto. Abonda con acceso de lectura; non conceda máis.

Canto custa e quen paga

BigQuery factura polos bytes lidos, e esa factura é súa. Por iso a importación só le uns días por execución e só executa unha consulta; outra lería de novo as mesmas táboas. Ademais, un límite estrito aborta a consulta antes de que resulte cara; cando ocorre, a mensaxe do rexistro de entregas indica que a xanela temporal é demasiado grande.

A frecuencia

Cada seis horas de xeito predeterminado e cada execución volve obter os últimos tres días. Non é arbitrario: GA4 completa datos ata 48 horas despois e a exportación diaria só aparece ao día seguinte. Consultar máis a miúdo non dá cifras máis recentes, só as mesmas.

4. A clave que une ambos os lados

Se tamén configura a ponte de analítica para GA4, MousePlayer grava o ID de cliente da cookie _ga con cada sesión. É exactamente o valor que a exportación BigQuery leva como user_pseudo_id.

Con el pódese vincular unha sesión GA4 cunha das súas gravacións e, á inversa, ver o que GA4 contou durante a mesma visita. Sen a ponte, ambos os lados quedan xuntos pero sen conexión.

O mesmo campo tamén leva o seu identificador de cliente propio se usa setUserId(). Non pode ter ambos: ou o ID de cliente Google ou o seu propio número.

5. Consentimento, conservación e eliminación

O que entra tiña unha cookie

Só se importan filas que teñen un user_pseudo_id no rexistro. Se o visitante rexeita, GA4 envía eventos sen cookies mediante Consent Mode e estes non o teñen, polo que se exclúen sen necesidade de garantías adicionais. As filas modeladas, é dicir, estimadas, quedan fóra polo mesmo motivo: gardar unha estimación como sesión sería gardar visitas que nunca ocorreron.

Canto tempo se conserva

180 días de xeito predeterminado, contados desde o día que describe a fila, non desde a importación. Doutro xeito o período nunca caducaría porque cada execución volve obter os mesmos días.

Eliminación

Se un visitante solicita borrar os seus datos, as sesións GA4 importadas elimínanse tamén na medida en que se poidan atribuír mediante o identificador anterior. Se elimina o proxecto, elimínanse en todo caso, incluídas as filas que nunca pertenceron a ningunha das súas gravacións. A rutina diaria de conservación déixaas á parte deliberadamente: os datos GA4 teñen o seu propio reloxo e as gravacións caducan antes.

6. Cando non chega nada

Cada execución escribe o resultado no rexistro de entregas da páxina de integracións, incluídos os fallos e con palabras claras. Normalmente xa indica o que falta.

Mensaxe	Que facer
O ID da propiedade debe ser só numérico	Introduciu o ID de medición. O número correcto está en GA4, en Property settings.
HTTP 403 da Data API	A conta de servizo non é Viewer na propiedade GA4 ou a Data API non está activada no proxecto GCP.
Non se atoparon o conxunto de datos ou as táboas de exportación	Falta a ligazón BigQuery, o conxunto de datos ten outro nome ou aínda non pasou un día.
Acceso denegado (BigQuery)	A conta de servizo non ten BigQuery Data Viewer no conxunto de datos ou BigQuery Job User no proxecto.
A consulta lería demasiados datos	O límite de custo abortouna antes de facturar nada. Escolla unha xanela temporal menor.
sen sesións na xanela	Non é un fallo. Non houbo sesións con consentimento nos días obtidos.

Como podemos axudar?