Ce guide explique comment accéder aux rapports Google Analytics personnalisés depuis BigQuery à l'aide du complément Google Analytics Sheets et du connecteur BigQuery Google Drive.
Ce guide explique comment générer un rapport personnalisé à l'aide du module complémentaire Google Analytics Sheets, exposer la feuille de résultats du rapport en tant que table externe BigQuery, puis interroger les données du rapport à partir de BigQuery.
Ce guide prend comme exemple le rapport "Acquisition d'utilisateurs", mais vous pouvez appliquer ces étapes à n'importe quel type de rapport.
Étape 1: Configurez un rapport personnalisé dans Google Sheets
Installez le module complémentaire Google Analytics Sheets depuis Google Workspace Marketplace.
Ouvrez la boîte de dialogue Extensions → Outil de création de rapports GA4 pour Google Analytics → Créer un rapport.
Configurez le rapport en spécifiant la propriété Analytics, la plage de dates et les champs du rapport.
Utilisez les champs suivants pour le rapport "Acquisition d'utilisateurs" :
Dimensions
firstUserDefaultChannelGroup
Métriques
eventCount
keyEvents
totalRevenue
newUsers
engagedSessions
engagementRate
Laissez les champs Filtres de dimensions et Filtres de métriques vides.
Voici une image des paramètres de rapport corrects:
Cliquez sur Créer un rapport pour créer la configuration du rapport dans le document Sheets actuel:
Sélectionnez Extensions → Outil de création de rapports GA4 pour Google Analytics → Exécuter des rapports pour générer le rapport. Un nouvel onglet portant le nom de votre rapport sera créé une fois le rapport terminé.
Ouvrez la boîte de dialogue Extensions → Outil de création de rapports GA4 pour Google Analytics → Planifier des rapports pour configurer l'interrogation périodique des dernières données de rapport. Indiquez l'emploi du temps, puis cliquez sur Enregistrer.
Étape 2: Connecter un document de rapport Google Sheets en tant que table externe BigQuery
Avec BigQuery, vous pouvez créer une table permanente associée à votre source de données externe dans Google Sheets. Utilisez cette fonctionnalité pour connecter la feuille de calcul de rapport Google Analytics créée à l'étape précédente en tant que table externe BigQuery.
Pour cette étape, suivez le guide de création de tables externes Google Drive de la documentation BigQuery.
console Google Cloud
Dans Google Cloud Console, ouvrez la page "BigQuery".
Dans le panneau Explorateur, développez votre projet et sélectionnez un ensemble de données.
Développez l'option
Actions puis cliquez sur Ouvrir.Dans le panneau de détails, cliquez sur Créer une table
.Dans la section Source de la page Create table (Créer une table) :
Dans Créer une table à partir de, sélectionnez Drive.
Dans le champ Sélectionner l'URI Drive, saisissez l'URI Drive du document Google Sheets contenant le rapport, au format
https://docs.google.com/spreadsheets/d/[file_id]
.Dans le champ Format de fichier, sélectionnez Feuille de calcul Google Sheets.
Dans la section Destination de la page Créer une table :
Pour Dataset name (Nom de l'ensemble de données), sélectionnez l'ensemble de données approprié, puis dans le champ Table name (Nom de la table), saisissez le nom de la table que vous créez dans BigQuery.
Vérifiez que le paramètre Type de table est défini sur Table externe.
Dans la zone Plage de la feuille, spécifiez le nom de la feuille et la plage de cellules à interroger. Il doit s'agir de la feuille contenant les données de votre rapport :
sheet_name!top_left_cell_id:bottom_right_cell_id
pour une plage de cellules. Pour notre exemple de rapport, la plage peut être spécifiée en tant queUser acquisition report!A:G
. Notez comment la feuille correspondant au nom du rapport personnalisé est mentionnée dans la plage.Dans la section Schéma, activez Détection automatique.
Développez la section Advanced options (Options avancées). Dans la zone Header rows to skip (Lignes d'en-tête à ignorer), spécifiez le nombre de lignes à omettre. Dans notre exemple, les données du rapport commencent par la ligne 15, qui est la valeur à définir dans la zone de saisie.
Dans la section Destination de la page Créer une table :
Pour Dataset (Ensemble de données), sélectionnez l'ensemble de données approprié, puis dans le champ Table (Table), saisissez le nom de la table que vous créez dans BigQuery.
Vérifiez que le paramètre Type de table est défini sur Table externe.
Cliquez sur CRÉER LA TABLE.
Si nécessaire, sélectionnez votre compte, puis cliquez sur Autoriser pour permettre aux outils clients BigQuery d'accéder à Google Drive.
Voici un exemple d'écran de configuration d'une table BigQuery externe:
Étape 3: Interroger une table de rapport Google Sheets à partir de BigQuery
Vous pouvez désormais exécuter une requête sur le tableau du rapport Google Sheets comme s'il s'agissait d'une table BigQuery standard, en respectant les limites applicables aux sources de données externes.
Ouvrez la table
user_acquisition_report
pour inspecter son schéma:Cliquez sur Requête. Dans la requête suggérée, remplacez
SELECT FROM
parSELECT * FROM
pour obtenir tous les champs du rapport, puis cliquez sur Run query (Exécuter la requête) pour exécuter une requête sur la table externe.
La requête de l'exemple suivant génère un extrait de données dans la table pour toutes les colonnes: