Carga datos de Google Analytics 4 en BigQuery
Puedes cargar datos de Google Analytics 4 en BigQuery con el conector del Servicio de transferencia de datos de BigQuery para Google Analytics 4. Con el Servicio de transferencia de datos de BigQuery, puedes programar trabajos de transferencia recurrentes que agreguen tus datos más recientes de Google Analytics 4 a BigQuery.
Informes compatibles
Actualmente, el Servicio de transferencia de datos de BigQuery para Google Analytics 4 admite las siguientes opciones de informes:
Opción de informe | Asistencia |
---|---|
Frecuencia de repetición | Diariamente, en el momento en que se crea por primera vez la transferencia de datos (predeterminado) Puedes configurar la hora del día. |
Período de actualización | Últimos 4 días (configuración predeterminada) Configurable hasta por 30 días |
Duración máxima del reabastecimiento | Sin límite Si bien el conector de Google Analytics no tiene una duración máxima de reabastecimiento, es posible que se produzcan errores al reabastecer datos históricos debido a la configuración de retención de datos de Google Analytics. |
Para obtener información sobre cómo los informes de Google Analytics 4 se transforman en tablas y vistas de BigQuery, consulta Transformación de datos de Google Analytics 4.
En una transferencia de Google Analytics 4, el Servicio de transferencia de datos de BigQuery transfiere los siguientes informes a BigQuery:
Audiences
Demographic details
Ecommerce purchases
Events
Landing page
Pages and screens
Promotions
Tech details
Traffic Acquisition
User Acquisition
Para obtener más información sobre los informes predefinidos disponibles para Google Analytics, consulta Informes predefinidos.
Transferencia de datos desde transferencias de Google Analytics 4
Cuando transfieres datos de Google Analytics 4 a BigQuery, estos se cargan en tablas de BigQuery particionadas por fecha. La partición de la tabla en la que se cargan los datos corresponde a la fecha de la fuente de datos. Si programas varias transferencias para la misma fecha, el Servicio de transferencia de datos de BigQuery reemplaza la partición para esa fecha específica con los datos más recientes. Las transferencias múltiples en el mismo día o los reabastecimientos en ejecución no generan datos duplicados y las particiones para otras fechas no se ven afectadas.Períodos de actualización
El período de actualización se refiere a la cantidad de días durante los cuales una transferencia de datos recupera datos cuando se produce la transferencia. Por ejemplo, si el período de actualización es de tres días y se produce una transferencia diaria, el Servicio de transferencia de datos de BigQuery recuperará todos los datos de tu tabla de origen de los últimos tres días. En este ejemplo, cuando se produce una transferencia diaria, el Servicio de transferencia de datos de BigQuery crea una nueva partición de tabla de destino de BigQuery con una copia de los datos de la tabla de origen del día actual y, luego, activa automáticamente las ejecuciones de reabastecimiento para actualizar las particiones de la tabla de destino de BigQuery con los datos de la tabla de origen de los últimos dos días. Las ejecuciones de reabastecimiento activadas automáticamente reemplazarán o actualizarán de forma incremental tu tabla de destino de BigQuery, en base a si las actualizaciones incrementales son compatibles o no con el conector del Servicio de transferencia de datos de BigQuery.
Cuando ejecutas una transferencia de datos por primera vez, la transferencia de datos recupera todos los datos de origen disponibles dentro del período de actualización. Por ejemplo, si el período de actualización es de tres días y ejecutas la transferencia de datos por primera vez, el Servicio de transferencia de datos de BigQuery recupera todos los datos de origen en un plazo de tres días.
Las ventanas de actualización se asignan al campo de API TransferConfig.data_refresh_window_days
.
Para recuperar datos fuera del período de actualización, como datos históricos, o para recuperar datos de interrupciones o brechas de transferencia, puedes iniciar o programar una ejecución de reabastecimiento.
Antes de comenzar
Revisa la siguiente información y los requisitos previos antes de crear una transferencia de datos de Google Analytics 4.
Requisitos previos
- En Google Analytics 4, la cuenta de usuario o la cuenta de servicio deben tener acceso de visualizador al ID de propiedad que se usa en la configuración de la transferencia.
- Verifica si completaste todas las acciones necesarias para habilitar el Servicio de transferencia de datos de BigQuery.
- Crea un conjunto de datos de BigQuery para almacenar tus datos de Google Analytics 4.
- Si quieres configurar las notificaciones de ejecución de transferencias para Pub/Sub, asegúrate de tener el permiso
pubsub.topics.setIamPolicy
de Identity and Access Management (IAM). Si solo configuras las notificaciones por correo electrónico, no se necesitan los permisos de Pub/Sub. Para obtener más información, consulta la sección sobre notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.
Roles de BigQuery requeridos
Para obtener los permisos que necesitas para crear una transferencia,
pídele a tu administrador que te otorgue el rol de IAM de
administrador de BigQuery (roles/bigquery.admin
).
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene los permisos necesarios para crear una transferencia. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para crear una transferencia:
-
bigquery.transfers.update
en el usuario -
bigquery.datasets.update
en el conjunto de datos de destino
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Configura una transferencia de datos de Google Analytics 4
Selecciona una de las siguientes opciones:
Console
Ve a la página Transferencia de datos en la Google Cloud consola.
Haz clic en
Crear transferencia.En la página Crear transferencia, haz lo siguiente:
- En la sección Tipo de fuente, en Fuente, elige Google Analytics 4.
En la sección Detalles de fuente de datos (Data source details):
- En el campo ID de propiedad, ingresa un ID de propiedad.
- Opcional: En el campo Filtro de tabla, ingresa una lista de tablas separada por comas para incluir, por ejemplo,
Audiences, Events
. Agrega el prefijo-
a esta lista para excluir ciertas tablas, por ejemplo,-Audiences, Events
. Todas las tablas se incluyen de forma predeterminada. - Opcional: En el campo Período de actualización, ingresa una duración para tu período de actualización en días. El período de actualización tiene un valor predeterminado de cuatro días y puede tener un valor de hasta 30 días.
En la sección Configuración de destino, en el menú Conjunto de datos de destino, selecciona el conjunto de datos que creaste para almacenar tus datos.
En la sección Nombre de configuración de la transferencia (Transfer config name), en Nombre visible (Display name), ingresa el nombre de la transferencia de datos. El nombre de la transferencia puede ser cualquier valor que te permita identificarla si necesitas modificarla más adelante.
En la sección Opciones de programación, haz lo siguiente:
- Selecciona Comenzar ahora o Comenzar a la hora definida y detalla una fecha de inicio y una hora de ejecución.
- En Repeticiones, selecciona la frecuencia con la que se ejecutará la transferencia. Si seleccionas Días, proporciona una hora válida en UTC.
Opcional: En el menú Cuenta de servicio, selecciona una cuenta de servicio de las cuentas de servicio asociadas con tu proyecto de Google Cloud . La cuenta de servicio seleccionada debe tener los roles necesarios para ejecutar esta transferencia de datos.
Si accediste con una identidad federada, se requiere una cuenta de servicio para crear una transferencia de datos. Si accediste con una Cuenta de Google, la cuenta de servicio para la transferencia de datos es opcional. Para obtener más información sobre el uso de cuentas de servicio con transferencias de datos, consulta Usa cuentas de servicio.
Opcional: En la sección Opciones de notificación:
- Haz clic en el botón de activación para habilitar las notificaciones por correo electrónico. Cuando habilitas esta opción, el administrador de transferencias recibe una notificación por correo electrónico cuando falla una ejecución de transferencia.
- Haz clic en el botón de activación para habilitar las notificaciones de Pub/Sub. En Selecciona un tema de Cloud Pub/Sub, elige el nombre de tu tema o haz clic en Crear un tema. Con esta opción, se configuran las notificaciones de ejecución de Pub/Sub para tu transferencia.
Opcional: Si usas CMEK, en la sección Opciones avanzadas, selecciona Clave administrada por el cliente. Aparecerá una lista de las CMEK disponibles para que elijas. Para obtener información sobre cómo funcionan las CMEK con el Servicio de transferencia de datos de BigQuery, consulta Especifica la clave de encriptación con transferencias.
Haz clic en Guardar.
bq
Ingresa el comando bq mk
y suministra la marca de creación de transferencias --transfer_config
. Las siguientes marcas son obligatorias:
--data_source
--target_dataset
--display_name
--params
bq mk --transfer_config \ --project_id=PROJECT_ID \ --target_dataset=DATASET \ --display_name=NAME \ --params='PARAMETERS' \ --data_source=DATA_SOURCE
Donde:
- PROJECT_ID: el ID de tu proyecto Si no se especifica
--project_id
, se usa el proyecto predeterminado. - DATASET: el conjunto de datos de destino para la configuración de transferencia.
- NAME: Es el nombre visible de la configuración de transferencia de datos. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si es necesario hacerle modificaciones más tarde.
- PARAMETERS: Son los parámetros de la configuración de transferencia de datos creada en formato JSON, por ejemplo,
--params='{"param":"param_value"}'
. Para las transferencias de Google Analytics 4, se requiere el parámetroproperty_id
. - DATA_SOURCE: La fuente de datos:
ga4
.
Por ejemplo, el siguiente comando crea una transferencia de datos de Google Analytics 4 llamada My Transfer
con el ID de propiedad 468039345
y el conjunto de datos de destino mydataset
.
La transferencia de datos se crea en el proyecto predeterminado:
bq mk --transfer_config --project_id=your_project --target_dataset=mydataset --display_name=My Transfer --params='{"property_id":"468039345"}' --data_source=ga4
API
Usa el método projects.locations.transferConfigs.create
y proporciona una instancia del recurso TransferConfig
.
Limitaciones
- Es posible que los totales agregados de las métricas de usuarios únicos y de sesiones no sean precisos y no coincidan con los valores de Google Analytics.
Especifica la clave de encriptación con transferencias
Puedes especificar claves de encriptación administradas por el cliente (CMEKs) para encriptar los datos de una ejecución de transferencia. Puedes usar una CMEK para admitir transferencias de Google Analytics 4.Cuando especificas una CMEK con una transferencia, el Servicio de transferencia de datos de BigQuery aplica la CMEK a cualquier memoria caché del disco intermedia de datos transferidos para que todo el flujo de trabajo de transferencia de datos cumpla con la CMEK.
No puedes actualizar una transferencia existente para agregar una CMEK si la transferencia no se creó en un principio con una CMEK. Por ejemplo, no puedes cambiar una tabla de destino que se encriptó de forma predeterminada para que ahora se encripte con CMEK. Por el contrario, tampoco puedes cambiar una tabla de destino encriptada con CMEK para que tenga un tipo de encriptación diferente.
Puedes actualizar una CMEK para una transferencia si la configuración de la transferencia se creó en un principio con una encriptación de CMEK. Cuando actualizas una CMEK para una configuración de transferencia, el Servicio de transferencia de datos de BigQuery propaga la CMEK a las tablas de destino en la siguiente ejecución de la transferencia, en la que el Servicio de transferencia de datos de BigQuery reemplaza cualquier CMEK desactualizada por la CMEK nueva durante la ejecución de la transferencia. Para obtener más información, consulta Actualiza una transferencia.
También puedes usar las claves predeterminadas del proyecto. Cuando especificas una clave predeterminada de proyecto con una transferencia, el Servicio de transferencia de datos de BigQuery usa la clave predeterminada del proyecto como la clave predeterminada para cualquier configuración de transferencia nueva.
Precios
No hay ningún costo por ejecutar una transferencia de Google Analytics 4.
Una vez que se transfirieron los datos a BigQuery, se aplican los precios estándar de almacenamiento y consulta de BigQuery.
Cuota
Las transferencias de Google Analytics 4 están sujetas a las cuotas de propiedades de Analytics que aplica Google Analytics 4. Para permitir más cuota por propiedad, puedes actualizar a Google Analytics 360.