Importar desde Google Analytics 4
Dos formas de traer aquí sus cifras de GA4: totales diarios para saber qué proporción de la actividad ve MousePlayer, y sesiones GA4 individuales de la exportación de BigQuery para las visitas que no pudimos grabar.
1. Qué se importa y qué no
Ambas vías leen datos de su cuenta de Google y se activan por separado. Responden a preguntas distintas; no necesita ambas.
| Vía | Qué obtiene | Para qué |
|---|---|---|
| Data API | Totales diarios: sesiones, usuarios, vistas de página y sesiones con interacción | Medir la cobertura. GA4 cuenta 3.000 sesiones y MousePlayer grabó 40: sin la cifra de referencia ni siquiera se puede detectar la diferencia. |
| Importación de BigQuery | Sesiones GA4 individuales con sus eventos | Saber qué ocurrió en una visita que MousePlayer no pudo grabar. |
Una sesión importada no se puede reproducir. GA4 no conserva capturas de la página ni movimientos de ratón, por lo que no hay datos para construir una reproducción. Obtiene cifras y eventos junto a sus grabaciones, nada más, y no lo presentamos como algo distinto.
La importación tiene sus propias tablas y nunca se mezcla con sus grabaciones. De lo contrario, cambiaría silenciosamente el significado de cada cifra derivada —perfiles de comportamiento, valoración de visitantes, análisis de fricción— y nadie podría distinguir después las filas medidas de las importadas.
2. Vía 1: Data API
Necesita dos cosas: el ID de propiedad y una clave de cuenta de servicio.
El ID de propiedad no es el ID de medición
Es el error más frecuente, y el propio mensaje de Google no lo menciona. El ID de medición tiene el formato G-ABC123XYZ, aparece en el fragmento de código de seguimiento y se ve en todas partes. El ID de propiedad es exclusivamente numérico y solo aparece en la administración, en Administrar, Configuración de la propiedad. Se necesita el segundo; rechazamos el primero con una explicación para evitarle un error 400.
Crear y autorizar la cuenta de servicio
- En Google Cloud Console, cree una cuenta de servicio y genere una clave JSON.
- En el mismo proyecto, active la Google Analytics Data API.
- En GA4, en Administrar, Gestión de accesos a la propiedad, añada el correo de la cuenta de servicio con el rol de Lector. Una cuenta de servicio es un usuario independiente; sin este paso, Google responde 403 sin explicar el motivo.
Pegue el contenido del archivo JSON en el campo. Se almacena cifrado y después solo se muestra abreviado.
3. Vía 2: importación de BigQuery
Esta vía lee la exportación sin procesar de GA4. Debe configurarla una vez en GA4: Administrar, Vinculaciones con BigQuery. Las tablas solo aparecen a partir del día siguiente - antes, la importación no encuentra nada y no es un fallo.
Qué debe introducir
- El ID del proyecto GCP que contiene la exportación. No es necesariamente el mismo proyecto al que exporta los datos de MousePlayer.
- El ID del conjunto de datos. GA4 le da el nombre
analytics_<propertyId>. - Una clave de cuenta de servicio con el rol Lector de datos de BigQuery en el conjunto de datos y Usuario de trabajos de BigQuery en el proyecto. El acceso de lectura es suficiente; no conceda más permisos.
Cuánto cuesta y quién paga
BigQuery factura por bytes leídos, y esa factura le corresponde a usted. Por eso la importación solo lee unos días por ejecución y lanza una sola consulta: una segunda volvería a leer las mismas tablas. Además, un límite estricto detiene la consulta antes de que resulte costosa; en ese caso, el registro de entregas indica que el intervalo es demasiado amplio.
La frecuencia
Cada seis horas de forma predeterminada; cada ejecución recupera de nuevo los últimos tres días. No es arbitrario: GA4 completa datos durante un máximo de 48 horas, y la exportación diaria aparece al día siguiente. Consultar más a menudo no proporciona cifras más recientes, solo las mismas.
4. La clave que conecta ambos lados
Si también configura el puente de análisis hacia GA4, MousePlayer guarda en cada sesión el ID de cliente de la cookie _ga . Es exactamente el valor que la exportación de BigQuery contiene como user_pseudo_id.
Con él puede vincular una sesión GA4 a una grabación y, a la inversa, ver qué contó GA4 durante la misma visita. Sin el puente, ambas fuentes quedan una junto a otra, sin conexión.
El mismo campo también contiene su propio identificador de cliente si utiliza setUserId(). No puede contener ambos: incluye el ID de cliente de Google o su propio número.
5. Consentimiento, conservación y eliminación
Los datos importados tenían una cookie
Solo se importan las filas que contienen un user_pseudo_id . Cuando un visitante rechaza el consentimiento, GA4 envía señales sin cookies mediante Consent Mode y estas no llevan ese identificador: quedan excluidas sin depender de una promesa. Las filas modelizadas, es decir, estimadas, se excluyen por el mismo motivo: almacenar una estimación como sesión equivaldría a guardar visitas que nunca ocurrieron.
Cuánto tiempo se conservan
180 días de forma predeterminada, contados desde el día descrito por la fila, no desde la importación. De lo contrario, el plazo nunca vencería, ya que cada ejecución vuelve a obtener los mismos días.
Eliminación
Si un visitante solicita borrar sus datos, también se eliminan sus sesiones GA4 importadas, en la medida en que puedan atribuírsele mediante el identificador anterior. Si elimina el proyecto, se borran todas, incluidas las filas que nunca pertenecieron a una de sus grabaciones. El proceso diario de conservación las deja intactas deliberadamente: los datos GA4 siguen su propio calendario y sus grabaciones caducan antes.
6. Cuando no llega nada
Cada ejecución escribe su resultado en el registro de entregas de la página de integraciones, incluidos los fallos, con palabras claras. Normalmente eso ya explica qué falta.
| Mensaje | Qué hacer |
|---|---|
| El ID de propiedad debe ser exclusivamente numérico | Ha introducido el ID de medición. El número correcto está en GA4, en Configuración de la propiedad. |
| HTTP 403 de la Data API | La cuenta de servicio no tiene el rol Lector en la propiedad GA4 o la Data API no está activada en el proyecto GCP. |
| No se encuentra el conjunto de datos o las tablas de exportación | Falta la vinculación con BigQuery, el conjunto de datos tiene otro nombre o aún no ha transcurrido un día. |
| Acceso denegado (BigQuery) | La cuenta de servicio no tiene el rol Lector de datos de BigQuery en el conjunto de datos o Usuario de trabajos de BigQuery en el proyecto. |
| La consulta habría leído demasiados datos | El límite de coste la detuvo antes de facturar nada. Elija un intervalo menor. |
| no hay sesiones en el intervalo | No es un fallo. No hubo sesiones con consentimiento en los días consultados. |