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.

Descripción general del conector

El Servicio de transferencia de datos de BigQuery para el conector de Google Analytics admite las siguientes opciones para la transferencia de datos.

Opciones de transferencia de datos Asistencia
Informes compatibles El conector de Google Analytics admite la transferencia de datos de informes desde la API de Google Analytics Data v1.

Para obtener información sobre cómo los informes de Google Analytics se transforman en tablas y vistas de BigQuery, consulta Transformación de informes de Google Analytics.
Frecuencia de repetición El conector de Google Analytics admite transferencias de datos diarias.

De forma predeterminada, las transferencias de datos se programan en el momento en que se crean. Puedes configurar la hora de la transferencia de datos cuando configuras la transferencia de datos.
Período de actualización Puedes programar tus transferencias de datos para recuperar datos de Google Analytics de hasta 30 días en el momento en que se ejecute la transferencia de datos. Puedes configurar la duración de la ventana de actualización cuando configures la transferencia de datos.

De forma predeterminada, el conector de Google Analytics tiene un período de actualización de 4 días.

Para obtener más información, consulta Cómo actualizar ventanas.
Disponibilidad de datos de reabastecimiento Ejecuta un reabastecimiento de datos para recuperar datos fuera de la transferencia de datos programada. Puedes recuperar datos hasta el límite que permita la política de retención de datos de tu fuente de datos.

Para obtener información sobre la política de retención de datos de Google Analytics, consulta la Política de retención de datos de Google Analytics.

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.

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

Roles de BigQuery requeridos

Para obtener los permisos que necesitas para crear una transferencia de datos de Servicio de transferencia de datos de BigQuery, pídele a tu administrador que te otorgue el rol de IAM de administrador de BigQuery (roles/bigquery.admin) en tu proyecto. 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 de datos del Servicio de transferencia de datos de BigQuery. 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 de datos del Servicio de transferencia de datos de BigQuery:

  • Permisos del Servicio de transferencia de datos de BigQuery:
    • bigquery.transfers.update
    • bigquery.transfers.get
  • Permisos de BigQuery:
    • bigquery.datasets.get
    • bigquery.datasets.getIamPolicy
    • bigquery.datasets.update
    • bigquery.datasets.setIamPolicy
    • bigquery.jobs.create

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información, consulta Cómo otorgar acceso a bigquery.admin.

Informes personalizados

El conector del Servicio de transferencia de datos de BigQuery para Google Analytics admite el uso de informes personalizados especificando dimensiones y métricas en la configuración de transferencia de Google Analytics. Estos informes personalizados incorporan datos de la versión de la API de Google Analytics Data compatible con el Servicio de transferencia de datos de BigQuery.

Puedes especificar un informe personalizado cuando creas una transferencia de Google Analytics.

Limitaciones de los informes personalizados

  • Solo se admite un informe personalizado por configuración de transferencia.
  • Se admite un máximo de 9 dimensiones y 10 métricas por informe personalizado.
  • No todas las dimensiones y métricas son compatibles entre sí. Utiliza la herramienta Explorador de dimensiones y métricas de GA4 para validar las dimensiones y métricas de tu informe personalizado antes de crear la transferencia.

Configura una transferencia de datos de Google Analytics 4

Selecciona una de las siguientes opciones:

Console

  1. Ve a la página Transferencia de datos en 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, elige Google Analytics 4.

  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: Para transferir informes personalizados en lugar de los informes estándar, haz lo siguiente:
      • En el campo Nombre de la tabla del informe personalizado, ingresa el nombre de la tabla de salida para el informe personalizado. Para obtener más información sobre los nombres de tablas válidos, consulta Nombres de las tablas.
      • En el campo Dimensiones del informe personalizado, ingresa las dimensiones del informe personalizado. Para obtener más información, consulta Informes personalizados.
      • En el campo Métricas del informe personalizado, ingresa las métricas del informe personalizado. Para obtener más información, consulta Informes personalizados.
    • 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.

  5. 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.

  6. 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.

  7. 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.

  8. 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.

  9. Opcional: En la sección Opciones de notificación, haz lo siguiente:

    • 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.

  10. 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.

  11. 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: 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á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

  • Es posible que los totales agregados de las métricas de usuarios distintos 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.