Charger des données Google Analytics 4 dans BigQuery

Vous pouvez charger des données Google Analytics 4 dans BigQuery à l'aide du connecteur Service de transfert de données BigQuery pour Google Analytics 4. Le service de transfert de données BigQuery vous permet de planifier des tâches de transfert récurrentes qui ajoutent vos dernières données Google Analytics 4 à BigQuery.

Rapports acceptés

Le service de transfert de données BigQuery pour Google Analytics 4 accepte les options de création de rapports suivantes :

Option de création de rapports Compatibilité
Fréquence de répétition

Tous les jours, à l'heure où le transfert a été créé (par défaut)

Vous pouvez configurer une heure spécifique.

Intervalle d'actualisation

4 derniers jours (par défaut)

Configurable jusqu'à 30 jours

Durée maximale du remplissage

Aucune limite

Bien que le connecteur Google Analytics n'ait pas de durée maximale pour le remplissage des données historiques, vous pouvez rencontrer des erreurs lors du remplissage des données historiques en raison de vos paramètres de conservation des données Google Analytics.

Pour en savoir plus sur la transformation des rapports Google Analytics 4 en tables et vues BigQuery, consultez Transformation des données Google Analytics 4.

Lors d'un transfert Google Analytics 4, le service de transfert de données BigQuery transfère les rapports suivants vers BigQuery :

  • Audiences
  • Demographic details
  • Ecommerce purchases
  • Events
  • Landing page
  • Pages and screens
  • Promotions
  • Tech details
  • Traffic Acquisition
  • User Acquisition

Pour en savoir plus sur les rapports prédéfinis disponibles pour Google Analytics, consultez Rapports prédéfinis.

Ingestion de données à partir de transferts Google Analytics 4

Lorsque vous transférez des données Google Analytics 4 vers BigQuery, elles sont chargées dans des tables BigQuery partitionnées par date. La partition de la table dans laquelle les données sont chargées correspond à la date de la source de données. Si vous planifiez plusieurs transferts pour la même date, le service de transfert de données BigQuery remplace la partition de cette date spécifique par les données les plus récentes. Plusieurs transferts le même jour ou l'exécution de remplissages n'entraînent pas de données en double, et les partitions des autres dates ne sont pas affectées.

Actualiser les fenêtres

Un intervalle d'actualisation correspond au nombre de jours pendant lesquels un transfert de données récupère des données lors d'un transfert de données. Par exemple, si la fenêtre d'actualisation est de trois jours et qu'un transfert quotidien a lieu, le service de transfert de données BigQuery récupère toutes les données de votre table source des trois derniers jours. Dans cet exemple, lorsqu'un transfert quotidien a lieu, le service de transfert de données BigQuery crée une partition de table de destination BigQuery avec une copie des données de votre table source du jour, puis déclenche automatiquement des exécutions de remplissage pour mettre à jour les partitions de table de destination BigQuery avec les données de votre table source des deux jours précédents. Les opérations de remplissage déclenchées automatiquement écrasent ou mettent à jour de manière incrémentielle votre table de destination BigQuery, selon que les mises à jour incrémentielles sont ou non compatibles avec le connecteur du service de transfert de données BigQuery.

Lorsque vous exécutez un transfert de données pour la première fois, celui-ci récupère toutes les données sources disponibles pendant l'intervalle d'actualisation. Par exemple, si la fenêtre d'actualisation est de trois jours et que vous exécutez le transfert de données pour la première fois, le service de transfert de données BigQuery récupère toutes les données sources dans un délai de trois jours.

Les fenêtres d'actualisation sont mappées sur le champ d'API TransferConfig.data_refresh_window_days.

Pour récupérer des données en dehors de la période d'actualisation, telles que des données historiques, ou pour récupérer des données en cas d'indisponibilité ou d'écarts de transfert, vous pouvez lancer ou planifier une exécution de remplissage.

Avant de commencer

Avant de créer un transfert de données Google Analytics 4, consultez les conditions préalables et les informations suivantes.

Prérequis

Rôles BigQuery requis

Pour obtenir les autorisations nécessaires pour créer un transfert, demandez à votre administrateur de vous accorder le rôle IAM Administrateur BigQuery (roles/bigquery.admin). Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour créer un transfert. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour créer un transfert :

  • bigquery.transfers.update sur l'utilisateur
  • bigquery.datasets.update sur l'ensemble de données cible

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Configurer un transfert de données Google Analytics 4

Sélectionnez l'une des options suivantes :

Console

  1. Accédez à la page Transferts de données dans la console Google Cloud .

    Accéder à la page Transferts de données

  2. Cliquez sur Créer un transfert.

  3. Sur la page Créer un transfert, procédez comme suit :

    • Dans la section Type de source, choisissez Google Analytics 4 comme Source.
  4. Dans la section Data source details (Détails de la source de données) :

    • Dans le champ ID de propriété, saisissez un ID de propriété.
    • Facultatif : dans le champ Filtre de table, saisissez une liste des tables à inclure (séparées par une virgule), par exemple Audiences, Events. Ajoutez le préfixe - à cette liste pour exclure certaines tables, par exemple -Audiences, Events. Toutes les tables sont incluses par défaut.
    • Facultatif : dans le champ Intervalle d'actualisation, saisissez la durée de votre intervalle d'actualisation en jours. La fenêtre d'actualisation est définie par défaut sur quatre jours, mais peut durer jusqu'à 30 jours.
  5. Dans le menu Ensemble de données de destination de la section Paramètres de destination, sélectionnez l'ensemble de données que vous avez créé pour stocker vos données.

  6. Dans la section Nom de la configuration de transfert, sous Nom à afficher, saisissez le nom du transfert de données. Ce nom peut correspondre à n'importe quelle valeur permettant d'identifier le transfert si vous devez le modifier ultérieurement.

  7. Dans la section Schedule options (Options de programmation) :

    • Sélectionnez Commencer ou Commencer à l'heure définie, puis indiquez une date de début et une heure d'exécution.
    • Dans le champ Périodicité, choisissez une option pour la fréquence d'exécution du transfert de données. Si vous sélectionnez Jours, indiquez une heure valide au format UTC.
  8. Facultatif : Dans le menu Compte de service, sélectionnez un compte de service parmi ceux associés à votre projet Google Cloud . Le compte de service sélectionné doit disposer des rôles requis pour exécuter ce transfert de données.

    Si vous vous êtes connecté avec une identité fédérée, vous devez disposer d'un compte de service pour créer un transfert de données. Si vous vous êtes connecté avec un compte Google, un compte de service pour le transfert de données est facultatif. Pour en savoir plus sur l'utilisation des comptes de service avec des transferts de données, consultez Utiliser des comptes de service.

  9. Facultatif : dans la section Notification options (Options de notification) :

    • Cliquez sur le bouton pour activer les notifications par e-mail. Lorsque vous activez cette option, l'administrateur de transfert reçoit une notification par e-mail si l'exécution du transfert échoue.
    • Cliquez sur le bouton pour activer les notifications Pub/Sub. Sous Sélectionner un sujet Cloud Pub/Sub, choisissez le nom de votre sujet ou cliquez sur Créer un sujet. Cette option permet de configurer les notifications d'exécution Pub/Sub pour votre transfert.
  10. Facultatif : Si vous utilisez des CMEK, dans la section Options avancées, sélectionnez Clé gérée par le client. La liste des CMEK disponibles s'affiche. Pour en savoir plus sur le fonctionnement des CMEK avec le Service de transfert de données BigQuery, consultez Spécifier une clé de chiffrement avec les transferts.

  11. Cliquez sur Enregistrer.

bq

Saisissez la commande bq mk, puis spécifiez l'indicateur de création de transfert --transfer_config. Les options suivantes sont obligatoires :

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

Où :

  • PROJECT_ID : ID de votre projet. Si --project_id n'est pas spécifié, le projet par défaut est utilisé.
  • DATASET : ensemble de données cible de la configuration de transfert de données.
  • NAME : nom à afficher de la configuration de transfert de données. Ce nom peut correspondre à toute valeur permettant d'identifier le transfert si vous devez le modifier ultérieurement.
  • PARAMETERS : paramètres de la configuration de transfert de données créée au format JSON (par exemple, --params='{"param":"param_value"}'). Pour les transferts Google Analytics 4, le paramètre property_id est obligatoire.
  • DATA_SOURCE. La source de données – ga4.

Par exemple, la commande suivante crée un transfert de données Google Analytics 4 nommé My Transfer utilisant l'ID de propriété 468039345, avec l'ensemble de données cible mydataset.

Le transfert de données est créé dans le projet par défaut :

  bq mk --transfer_config
  --project_id=your_project
  --target_dataset=mydataset
  --display_name=My Transfer
  --params='{"property_id":"468039345"}'
  --data_source=ga4

API

Utilisez la méthode projects.locations.transferConfigs.create et fournissez une instance de la ressource TransferConfig.

Limites

  • Les totaux agrégés pour les métriques sur les utilisateurs uniques et les sessions peuvent ne pas être exacts et ne pas correspondre aux valeurs dans Google Analytics.

Spécifier une clé de chiffrement avec les transferts

Vous pouvez spécifier des clés de chiffrement gérées par le client (CMEK) pour chiffrer les données d'une exécution de transfert. Vous pouvez utiliser une clé CMEK pour accepter les transferts provenant de Google Analytics 4.

Lorsque vous spécifiez une clé CMEK avec un transfert, le service de transfert de données BigQuery l'applique à tous les caches sur disque intermédiaires des données ingérées afin que l'intégralité du workflow de transfert de données soit compatible avec CMEK.

Vous ne pouvez pas mettre à jour un transfert existant pour ajouter une clé CMEK si le transfert n'a pas été initialement créé avec une clé CMEK. Par exemple, vous ne pouvez pas modifier une table de destination initialement chiffrée par défaut pour être chiffrée avec des clés CMEK. À l'inverse, vous ne pouvez pas modifier une table de destination chiffrée par CMEK pour obtenir un type de chiffrement différent.

Vous pouvez mettre à jour une clé CMEK pour un transfert si la configuration de celui-ci a été initialement créée avec un chiffrement CMEK. Lorsque vous mettez à jour une clé CMEK pour une configuration de transfert, le service de transfert de données BigQuery propage cette clé aux tables de destination à la prochaine exécution du transfert, où le service de transfert de données BigQuery remplace toutes les clés CMEK obsolètes par la nouvelle clé lors de l'exécution du transfert. Pour en savoir plus, consultez Mettre à jour un transfert.

Vous pouvez également utiliser les clés par défaut d'un projet. Lorsque vous spécifiez une clé de projet par défaut avec un transfert, le service de transfert de données BigQuery utilise cette clé pour toutes les nouvelles configurations de transfert.

Tarifs

Le transfert vers Google Analytics 4 est gratuit.

Une fois les données transférées vers BigQuery, les tarifs standards pour le stockage et les requêtes BigQuery s'appliquent.

Quota

Les transferts Google Analytics 4 sont soumis aux quotas de propriétés Analytics appliqués par Google Analytics 4. Pour augmenter le quota par propriété, vous pouvez passer à Google Analytics 360.