Cargar datos de Google Analytics 4 en BigQuery

Puede cargar datos de Google Analytics 4 en BigQuery mediante el conector BigQuery Data Transfer Service para Google Analytics 4. Con BigQuery Data Transfer Service, puede programar tareas de transferencia periódicas que añadan sus datos más recientes de Google Analytics 4 a BigQuery.

Informes admitidos

BigQuery Data Transfer Service para Google Analytics 4 admite las siguientes opciones de informes:

Opción de denuncia Asistencia
Frecuencia de repetición

Diariamente, a la hora en que se creó la transferencia de datos (opción predeterminada)

Puedes configurar la hora del día.
Actualizar ventana

Últimos 4 días (predeterminado)

Se puede configurar hasta 30 días
Duración máxima de relleno

Sin límite

Aunque el conector de Google Analytics no tiene una duración máxima de relleno, es posible que se produzcan errores al rellenar el historial de datos debido a los ajustes de conservación de datos de Google Analytics.

Para obtener información sobre cómo se transforman los informes de Google Analytics 4 en tablas y vistas de BigQuery, consulte el artículo Transformación de datos de Google Analytics 4.

En una transferencia de Google Analytics 4, BigQuery Data Transfer Service 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 en Google Analytics, consulte Informes predefinidos.

Ingestión de datos de transferencias de Google Analytics 4

Cuando transfiere datos de Google Analytics 4 a BigQuery, los datos se cargan en tablas de BigQuery que están 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 programa varias transferencias para la misma fecha, BigQuery Data Transfer Service sobrescribirá la partición de esa fecha con los datos más recientes. Si se realizan varias transferencias el mismo día o se ejecutan rellenados, no se duplicarán los datos y no se verán afectadas las particiones de otras fechas.

Actualizar ventanas

Una ventana de actualización es el número de días durante los que una transferencia de datos recupera datos cuando se produce una transferencia de datos. Por ejemplo, si la ventana de actualización es de tres días y se produce una transferencia diaria, BigQuery Data Transfer Service recupera todos los datos de la tabla de origen de los últimos tres días. En este ejemplo, cuando se produce una transferencia diaria, BigQuery Data Transfer Service crea una partición de tabla de destino de BigQuery con una copia de los datos de la tabla de origen del día actual y, a continuación, activa automáticamente ejecuciones de relleno para actualizar las particiones de tabla de destino de BigQuery con los datos de la tabla de origen de los dos días anteriores. Las ejecuciones de relleno automático sobrescribirán o actualizarán de forma incremental tu tabla de destino de BigQuery, en función de si el conector de BigQuery Data Transfer Service admite o no las actualizaciones incrementales.

Cuando ejecutas una transferencia de datos por primera vez, esta recupera todos los datos de origen disponibles en la ventana de actualización. Por ejemplo, si la ventana de actualización es de tres días y ejecutas la transferencia de datos por primera vez, BigQuery Data Transfer Service recuperará todos los datos de origen en un plazo de tres días.

Los periodos de actualización se asignan al campo de la API TransferConfig.data_refresh_window_days.

Para recuperar datos que no estén dentro del periodo de actualización (por ejemplo, datos históricos) o para recuperar datos de interrupciones o brechas en la transferencia, puedes iniciar o programar una reposición.

Antes de empezar

Consulte los siguientes requisitos y la información 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 lectura al ID de propiedad que se usa en la configuración de la transferencia.
  • Comprueba que has completado todas las acciones necesarias para habilitar BigQuery Data Transfer Service.
  • Crea un conjunto de datos de BigQuery para almacenar tus datos de Google Analytics 4.
  • Si quieres configurar notificaciones de ejecuciones de transferencias para Pub/Sub, asegúrate de que tienes el permiso de pubsub.topics.setIamPolicy Gestión de Identidades y Accesos (IAM). Si solo configuras notificaciones por correo electrónico, no se necesitan permisos de Pub/Sub. Para obtener más información, consulta el artículo sobre las notificaciones de ejecución de BigQuery Data Transfer Service.

Roles de BigQuery necesarios

Para obtener los permisos que necesitas para crear una transferencia, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de BigQuery (roles/bigquery.admin). Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para crear una transferencia. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

Para crear una transferencia, se necesitan los siguientes permisos:

  • 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 u otros roles predefinidos.

Configurar una transferencia de datos de Google Analytics 4

Selecciona una de las opciones siguientes:

Consola

  1. Ve a la página Transferencias de datos de la Google Cloud consola.

    Ir a Transferencias de datos

  2. Haz clic en Crear transferencia.

  3. En la página Crear transferencia, haz lo siguiente:

    • En la sección Tipo de fuente, en Fuente, elija Google Analytics 4.

  4. En la sección Detalles de la fuente de datos:

    • En el campo ID de propiedad, introduzca un ID de propiedad.
    • Opcional: En el campo Filtro de tabla, introduzca una lista de tablas separadas por comas que quiera incluir. Por ejemplo, Audiences, Events. Añade el carácter - al principio de esta lista para excluir determinadas tablas, como -Audiences, Events. Todas las tablas se incluyen de forma predeterminada.
    • Opcional: En el campo Ventana de actualización, introduce la duración de la ventana de actualización en días. La ventana de actualización tiene un valor predeterminado de cuatro días y puede tener un valor de hasta 30 días.

  5. En la sección Configuración de destino, en el menú Conjunto de datos de destino, selecciona el conjunto de datos que has creado para almacenar tus datos.

  6. En la sección Nombre de la configuración de transferencia, en Nombre visible, indica un nombre para la transferencia de datos. El nombre de la transferencia puede ser cualquier valor que te permita identificarla si necesitas modificarla más adelante.

  7. En la sección Opciones de programación:

    • Selecciona Empezar ahora o Empezar a una hora determinada y, a continuación, indica la fecha de inicio y la duración.
    • En Se repite, elige una opción para determinar la frecuencia con la que se realizará la transferencia de datos. Si seleccionas Días, indica una hora válida en UTC.

  8. Opcional: En el menú Cuenta de servicio, selecciona una cuenta de servicio de las que estén asociadas a tu proyecto. Google Cloud La cuenta de servicio seleccionada debe tener los roles necesarios para ejecutar esta transferencia de datos.

    Si has iniciado sesión con una identidad federada, se necesita una cuenta de servicio para crear una transferencia de datos. Si has iniciado sesión con una cuenta de Google, no es obligatorio usar una cuenta de servicio para la transferencia de datos. Para obtener más información sobre cómo usar cuentas de servicio con transferencias de datos, consulta el artículo Usar cuentas de servicio.

  9. Opcional: En la sección Opciones de notificación:

    • Haz clic en el interruptor para habilitar las notificaciones por correo electrónico. Si habilitas esta opción, el administrador de las transferencias recibirá una notificación por correo cuando falle una ejecución de transferencia.
    • Haz clic en el interruptor para habilitar las notificaciones de Pub/Sub. En Seleccionar un tema de Cloud Pub/Sub, elige el nombre del tema o haz clic en Crear un tema. Esta opción configura las notificaciones de ejecución de Pub/Sub para tu transferencia.

  10. Opcional: Si usas CMEKs, en la sección Opciones avanzadas, selecciona Clave gestionada por el cliente. Aparecerá una lista de las CMEKs disponibles para que elijas la que quieras. Para obtener información sobre cómo funcionan las CMEKs con BigQuery Data Transfer Service, consulta Especificar una clave de cifrado en las transferencias.

  11. Haz clic en Guardar.

bq

Introduce el comando bq mk y proporciona la marca de creación de transferencia — --transfer_config. Se necesitan las siguientes marcas:

  • --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: tu ID de proyecto. Si no se especifica --project_id, se usa el proyecto predeterminado.
  • DATASET: el conjunto de datos de destino de la configuración de transferencia de datos.
  • NAME: el nombre visible de la configuración de transferencia de datos. El nombre de la transferencia puede ser cualquier valor que te permita identificarla si necesitas modificarla más adelante.
  • PARAMETERS: los parámetros de la configuración de transferencia de datos creada en formato JSON. Por ejemplo, --params='{"param":"param_value"}'. En el caso de las transferencias a Google Analytics 4, es obligatorio el parámetro property_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

  • Los totales agregados de las métricas de usuarios únicos y de sesiones pueden no ser precisos y no coincidir con los valores de Google Analytics.

Especificar la clave de cifrado en las transferencias

Puedes especificar claves de cifrado gestionadas por el cliente (CMEKs) para cifrar los datos de una ejecución de transferencia. Puedes usar una CMEK para admitir transferencias desde Google Analytics 4.

Cuando especifica una CMEK con una transferencia, BigQuery Data Transfer Service aplica la CMEK a cualquier caché intermedio en disco de los datos ingeridos para que todo el flujo de trabajo de transferencia de datos cumpla los requisitos de la CMEK.

No puedes actualizar una transferencia para añadir una CMEK si no se creó originalmente con una CMEK. Por ejemplo, no puedes cambiar una tabla de destino que originalmente estaba cifrada de forma predeterminada para que ahora se cifre con CMEK. Del mismo modo, tampoco puedes cambiar el tipo de cifrado de una tabla de destino cifrada con CMEK.

Puedes actualizar una CMEK de una transferencia si la configuración de la transferencia se creó originalmente con un cifrado CMEK. Cuando actualizas una CMEK de una configuración de transferencia, BigQuery Data Transfer Service propaga la CMEK a las tablas de destino en la siguiente ejecución de la transferencia, donde BigQuery Data Transfer Service sustituye las CMEKs obsoletas por la nueva CMEK durante la ejecución de la transferencia. Para obtener más información, consulta Actualizar una transferencia.

También puedes usar las claves predeterminadas del proyecto. Cuando especifica una clave predeterminada de proyecto con una transferencia, BigQuery Data Transfer Service usa la clave predeterminada de proyecto como clave predeterminada para cualquier configuración de transferencia nueva.

Precios

No hay ningún coste por realizar una transferencia a Google Analytics 4.

Cuando se transfieren los datos a BigQuery, se aplica el precio estándar de este servicio para las consultas y el almacenamiento.

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, puede cambiar a Google Analytics 360.