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
- Dans Google Analytics 4, le compte utilisateur ou le compte de service doit disposer d'un accès en lecture à l'ID de propriété utilisé dans la configuration du transfert.
- Vérifiez que vous avez effectué toutes les actions requises pour activer le service de transfert de données BigQuery.
- Créez un ensemble de données BigQuery pour stocker vos données Google Analytics 4.
- Si vous avez l'intention de configurer des notifications d'exécution de transfert pour Pub/Sub, assurez-vous de disposer de l'autorisation Identity and Access Management (IAM)
pubsub.topics.setIamPolicy
. Si vous ne configurez que des notifications par e-mail, les autorisations Pub/Sub ne sont pas nécessaires. Pour plus d'informations, consultez la page Notifications d'exécution du service de transfert de données BigQuery.
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
Accédez à la page Transferts de données dans la console Google Cloud .
Cliquez sur
Créer un transfert.Sur la page Créer un transfert, procédez comme suit :
- Dans la section Type de source, choisissez Google Analytics 4 comme Source.
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.
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.
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.
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.
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.
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.
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.
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ètreproperty_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.