Accéder aux rapports personnalisés Google Analytics à partir de BigQuery

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

  1. Installez le module complémentaire Google Analytics Sheets depuis Google Workspace Marketplace.

  2. Ouvrez la boîte de dialogue ExtensionsOutil de création de rapports GA4 pour Google AnalyticsCréer un rapport.

    Ouvrir le module complémentaire Google Analytics pour Sheets

  3. Configurez le rapport en spécifiant la propriété Analytics, la plage de dates et les champs du rapport.

  4. Utilisez les champs suivants pour le rapport "Acquisition d'utilisateurs" :

    Dimensions

    • firstUserDefaultChannelGroup

    Métriques

    • eventCount
    • keyEvents
    • totalRevenue
    • newUsers
    • engagedSessions
    • engagementRate
  5. Laissez les champs Filtres de dimensions et Filtres de métriques vides.

    Voici une image des paramètres de rapport corrects:

    Configuration des rapports du module complémentaire Google Analytics Sheets (partie 1)

    Configuration des rapports du module complémentaire Google Analytics Sheets (partie 2)

    Configuration des rapports du module complémentaire Google Analytics Sheets (partie 3)

  6. Cliquez sur Créer un rapport pour créer la configuration du rapport dans le document Sheets actuel:

    Feuille de configuration des rapports du module complémentaire Google Analytics Sheets

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

    Données des rapports du module complémentaire Google Analytics pour Sheets

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

    Calendrier du module complémentaire Sheets pour Google Analytics

É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

  1. Dans Google Cloud Console, ouvrez la page "BigQuery".

    Accéder à BigQuery

  2. Dans le panneau Explorateur, développez votre projet et sélectionnez un ensemble de données.

  3. Développez l'option Actions puis cliquez sur Ouvrir.

  4. Dans le panneau de détails, cliquez sur Créer une table.

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

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

  7. 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 que User acquisition report!A:G. Notez comment la feuille correspondant au nom du rapport personnalisé est mentionnée dans la plage.

  8. Dans la section Schéma, activez Détection automatique.

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

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

  11. Cliquez sur CRÉER LA TABLE.

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

Configuration des tables externes BigQuery, partie 1

Configuration de table externe BigQuery (2e partie)

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

  1. Ouvrez la table user_acquisition_report pour inspecter son schéma:

    Schéma de la table externe BigQuery

  2. Cliquez sur Requête. Dans la requête suggérée, remplacez SELECT FROM par SELECT * 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:

Requête de table externe BigQuery