Intégration Google Analytics


À propos de cette intégration
SAS_IntegrationNotRESTIntroduction

Il existe plusieurs moyens d’intégrer des systèmes tiers avec Product name - ev sas.png. Cela, en fonction des besoins métiers, des contraintes d’architecture et de sécurité en vigueur ainsi que des spécificités de chaque application ou service tiers. Notamment, vous pouvez utiliser les datasources REST, CSV, Online CSV ainsi que le widget Html Script.

Cette page présente un processus d’intégration type déjà mis en œuvre dans un contexte client.

Pour plus de détails sur cette intégration, veuillez contacter les départements "Consulting & Professional Services" et Support d'Logo - EasyVista.png ou vos fournisseurs de services et intégrateurs habituels.

Synthèse de l'intégration

Cette intégration permet de récupérer toutes les informations disponibles sur l’analyse de trafic de vos sites web ainsi que de vos applications créées avec Product name - ev sas.png via l’API REST de Google Analytics et le module Google Analytics Spreadsheet Add-on de Google Sheets.

        Example documentation icon FR.png  Créez rapidement une application Product name - ev sas.png avec des tableaux de bord (contenant des graphiques, diagrammes et indicateurs) pour voir d’un seul coup d’œil toutes les métriques les plus pertinentes de suivi de vos sites et applications

Flux d’intégration des données (sens) Type d'authentification Options du connecteur d'intégration

Product name - ev sas - big.png

Up arrow.png

Logo - Google Analytics.png

N/A

Datasource CSV   Apps - Datasource - CSV icon.png

Datasource Online CSV   Apps - Datasource - CSV Online icon.png

Version SaaS du produit tiers

Version On-premise du produit tiers

Check icon.png

Not check icon.png

Description détaillée de l'API

Item Commentaires
À propos du logiciel et de la société

Logo - Google Analytics.png

Google Analytics est un service gratuit d'analyse d'audience de sites web et d'applications, utilisé par plus de 10 millions de sites, soit plus de 80 % du marché mondial.

Informations sur l'API REST

Date à laquelle les informations ont été récupérées du site de la société : Avril 2016

Nom/version/date des API REST connues les plus récentes :

Principaux liens utiles pour l’intégration Création d'un compte Google :Google Analytics :
  • Conditions générales
    Note : L’usage que vous faîtes de Google Analytics est soumis à acceptation des conditions générales Google Analytics. Les frais éventuels d’usage de Google Analytics sont à votre charge.
Google Sheets :Module Google Analytics Spreadsheet Add-On et API à utiliser pour créer des rapports d’activités de sites web :
Atouts de l'API N/A
Recommandations sur l'API (limites, conseils, tips) N/A
Commentaires N/A

Processus d'intégration pas à pas

Note : Dans les versions Product name - ev sas.png 2016.3.x et antérieures, il n’y a pas de datasource REST intégré permettant l'intégration directe des données fournies par Google Analytics via une architecture REST et une authentification OAuth 2.0, comme c’est le cas pour d’autres services de Google tel que Google Gmail, Google Contacts, Google Calendar, etc.
Toutefois, vous pouvez utiliser les datasources CSV et Online CSV en intégrant des fichiers .csv créés à partir des fonctions d’export ou de publication en ligne de Google Sheets, ainsi qu'à partir du module d’extension Google Analytics Spreadsheet Add-on disponible pour Google Sheets.

Google Analytics peut être intégré avec Product name - ev sas.png en 4 étapes simples :

   Open url.png  voir :


Étape 1: Vérifier la liste des prérequis


Étape 2 : Créer un fichier Google Sheets (spreadsheet) contenant les rapports Google Analytics

    Open url.png  voir Procédure détaillée :

1. Créez un fichier Google Sheets (classeur ou spreadsheet).

2. Créez les rapports Google Analytics souhaités dans la feuille Report Configuration : cliquez sur Modules complémentaires > Google Analytics > Create New Report.

        Open url.png  voir Procédure détaillée : Guide d’installation et d’utilisation du module Google Analytics Spreadsheet Add-on (EN) : Créer un rapport

   Notes

  • La feuille Report Configuration est créée automatiquement à la création du premier rapport.
  • Chaque colonne de cette feuille définit un rapport différent.
  • Pour créer rapidement un nouveau rapport, copiez-collez une colonne d'un rapport existant puis modifiez les valeurs des paramètres.

3. Configurez les paramètres des rapports :

4. Lancez les rapports du classeur : cliquez sur Modules complémentaires > Google Analytics > Run reports.

        Open url.png  voir Procédure détaillée : Guide d’installation et d’utilisation du module Google Analytics Spreadsheet Add-on (EN) : Lancer les rapports

   Notes

  • Le module crée autant de feuilles qu'il y a de rapports (colonnes) configurés dans la feuille Report Configuration.
  • Toutes les feuilles créées ont la même structure -  voir Example documentation icon FR.png ci-dessous :
    • les 15 premières lignes contiennent les informations de paramétrage du rapport ;
    • les lignes suivantes contiennent les données du rapport.

5. Créez une nouvelle feuille (ou plusieurs selon vos besoins) pour organiser et consolider (via des formules basiques) les données des rapports générés par le module Google Analytics Spreadsheet Add-on.

Note : Ces feuilles de consolidation vont être les sources de données utilisée par les datasources CSV / Online CSV liés à votre application Product name - ev sas.png.
En effet, les 15 premières lignes de chaque feuille contiennent les informations de paramétrage du rapport, lignes qui ne peuvent pas être interprétées par les datasources CSV et Online CSV puisqu'ils lisent les fichiers .csv à partir de la première ligne.
Il vous faut dont récupérer les informations utiles des autres feuilles à partir de la ligne 16 de chacune d'entre elles. Pour cela, utilisez la formule Feuille<n>!B16 dans laquelle Feuille<n> est le nom de la feuille de votre fichier Google Sheets dans laquelle vous souhaitez récupérer des données.
    Open url.png  voir Cas d'utilisation

             Example documentation icon FR.png  

Dans votre fichier Google Sheets, créez une nouvelle feuille Stats Consolidées et placez-la en première position, juste avant la feuille Report Configuration.
Pour récupérer les informations de la feuille 4 à partir de la ligne 16, utilisez la formule Feuille4!B16.
Open url.png voir écran

Example Google Analytics - One sheet.png

(1) : 15 premières lignes générées pour le rapport "Sessions Last Week", non utilisables par les datasources dans Product name - ev sas.png

(2) : Données du rapport "Sessions Last Week", pouvant être récupérées dans la feuille de consolidation

 

6. Générez les fichiers .csv que vous allez intégrer dans votre application Product name - ev sas.png via un datasource :

  • Si vous utilisez un datasource statique CSV, générez manuellement les rapports sur la périodicité souhaitée :
    • cliquez sur Fichier > Télécharger au format > Valeurs séparées par des virgules (.csv, feuille active) ;
    • sauvegardez le fichier .csv dans le dossier de votre choix.
       


Étape 3 : Dans Product name - ev sas.png, créer les datasources liés aux données Google Analytics

Suivant vos besoins d'analyse :

  • Vous pouvez utiliser 2 types de datasources : CSV et Online CSV.
    • Utilisez le datasource CSV (statique) lorsque vos données de Google Analytics ne sont pas amenées à changer dans le temps (statistiques uniquement des semaines, mois et années passés) et vous ne souhaitez pas avoir de statistiques pour une période ultérieure à la date à laquelle vous allez importer le fichier source (fichier .csv) ou vous prévoyez de vérifier les données du fichier source avant de l’importer manuellement dans votre application.
    • Utilisez le datasource Online CSV (dynamique) lorsque vos données de Google Analytics sont amenées à changer dans le temps : ceci vous permet de mettre en place un processus de reporting entièrement automatisé.
               Example documentation icon FR.png Reporting quotidien, hebdomadaire ou annuel
  • Vous pouvez créer un ou plusieurs datasources se basant sur la même source de données ou sur des sources de données différentes.
    • Les datasources peuvent utiliser des colonnes différentes via le Data Transformer.
    • Open url.png  voir Description détaillée des datasources :
               CSV
               Online CSV
       


Étape 4 : Créer les widgets affichant les données Google Analytics

Pour cette intégration, utilisez principalement les widgets de la catégorie Dashboards afin d'afficher graphiquement les données de Google Analytics dans votre application Product name - ev sas.png.
         Open url.png  voir Bibliothèque des widgets

        Note: Sur chaque widget, ne cochez pas la case de la propriété First Row Contains Dimension.

Best Practice big icon.pngBonnes pratiques

  • Si vous prévoyez de réaliser des tableaux de bord sur des statistiques fournies par des outils d’analyse de sites web tels que Google Analytics Reports, c’est généralement pour utiliser des graphiques de types diagramme à secteurs, graphique linéaire, diagramme à barres, etc. Aussi, il est essentiel de définir à l’avance ce que vous souhaitez montrer sur ces graphiques, et donc de définir quelles métriques et dimensions de l’API Google Analytics choisie seront utilisées sur l’axe des abscisses, sur l’axes des ordonnées ou dans les secteurs.
  • Google Analytics fournit de nombreuses métriques sur l’analyse d’un site web. Selon vos besoins, créez un fichier Google Sheets par thématique.
        Open url.png  voir Références de l’API Google Analytics Core Reporting V4 (Dimensions & Metrics Explorer) (EN)

Example documentation icon FR.png  Créez les fichiers Google Sheets suivants:

  • My Website_GoogleAnalytics_Page Tracking.gsheet ==> Catégorie métrique : Page Tracking
  • My Website_GoogleAnalytics_Sessions.gsheet ==> Catégorie métrique : Session
  • My Website_GoogleAnalytics_Site Performance.gsheet ==> Catégorie métrique : Site Speed
  • My Website_GoogleAnalytics_Users.gsheet ==> Catégorie métrique : User
  • My Website_GoogleAnalytics_Platform or device.gsheet ==> Catégorie métrique : Platform or Device
  • Vous pouvez mixer les paramètres Dimensions de différentes catégories dans un même fichier Google Sheets.
  • Dans la feuille Report Configuration, définissez un ordre logique des colonnes à des fins d’organisation et de réutilisation, et donnez des noms explicites, courts et sans équivoque à vos rapports (entêtes des colonnes).
  • À partir des statistiques fournies par les rapports de Google Analytics, créez des feuilles de consolidation des données dans votre fichier Google Sheets : ces données directement exploitables vont vous permettre de construire rapidement les tableaux de bord et graphiques (de type diagrammes à secteurs, graphiques linéaires, diagrammes à barres, etc.) de votre application Product name - ev sas.png -  Open url.png  voir étape 2.5 et Cas d'utilisation
    • Donnez également des noms explicites, courts et sans équivoque aux colonnes de ces feuilles. Cela va vous permettre d'identifier rapidement les colonnes des datasources à afficher dans vos graphiques via le Data Transformer des widgets de la catégorie Dashboard.
    • Si vous avez de nombreux rapports dans ces feuilles, ajoutez des colonnes vides pour séparer des groupes de rapports similaires -  Open url.png  voir Cas d'utilisation > étape 5
    • Faîtes attention à l'ordre (de gauche à droite) des colonnes : c'est dans cet ordre que les noms des colonnes sont affichés dans le Data Transformer -  Open url.png  voir Cas d'utilisation > étape 7

Exemples de fichiers Google Sheets avec des rapports Google Analytics

Les fichiers Google Sheets ci-dessous (convertis au format Microsoft Excel .xlsx) contiennent des exemples de rapports Google Analytics avec des statistiques d’analyse d’audience du site web du wiki d’EasyVista (basé sur Xwiki). Vous pouvez les utiliser à titre d'exemple pour comprendre comment créer des rapports Google Analytics, réutiliser des formules et fonctions de Google Sheets, des métriques et dimensions utiles de Google Analytics, etc. 

Les rapports utilisés vous permettent de construire des tableaux de bord avec des statistiques et des métriques :

  • Annuelles consolidées par mois sur 3 années (année en cours, année N-1 et année N-2)
  • Mensuelles consolidées par semaine sur 2 mois glissants (mois en cours et mois N-1)
  • Hebdomadaires consolidées par jour (du Lundi au Dimanche) sur 2 semaines glissantes (semaine en cours et semaine N-1)

    Download Zip icon.png  

Notes

  • Pour utiliser les fichiers Exemples avec Google Sheets, convertissez-les au format .gsheet :
    • à partir de votre compte Google Drive (par exemple), cliquez droit sur un fichier .xlsx ;
    • sélectionnez l'option Ouvrir avec puis Google Sheets : un nouveau fichier au format .gsheet est créé dans le même dossier.
      Voir écran
      Convert gsheet files.png
  • Le View (Profile) ID dans les rapports de la feuille Report Configuration a été anonymisé.
    • Ce numéro est attribué automatiquement par le module Google Analytics Spreadsheet Add-on à la création d’un rapport. 
    • La valeur de ce numéro est liée au compte Google Analytics et à la propriété sélectionnée au moment de la création du rapport.
  • Pour réutiliser tout ou partie des rapports inclus dans les feuilles des fichiers Exemples (à convertir en fichiers .gsheet), vous pouvez :
    • générer un nouveau rapport Google Analytics avec le module Google Analytics Spreadsheet Add-on, en sélectionnant le compte Analytics de votre choix et la propriété que vous souhaitez analyser ;
    • copier le View (Profile) ID de ce nouveau rapport et le coller dans les rapports existants pour remplacer la valeur ga:XXXXXXXX ;
    • supprimer la colonne de ce nouveau rapport ;
    • supprimer les feuilles existantes correspondant à des rapports configurés dans la feuille Report Configuration initiale et supprimés par la suite ;
    • modifier les feuilles de consolidation (ex. : Consolidated Stats By Year) en fonction des changements effectués sur la feuille Report Configuration. Ces modifications sont répercutées sur les feuilles de rapports créées dans le classeur Google sheets : ce sont ces feuilles de consolidation qui contiennent les formules publiées sur le web ou sauvegardées au format .csv pour être réutilisées par des datasources CSV ou Online CSV.

Cas d'utilisation

Comment créer un tableau de bord permettant de comparer le nombre de sessions utilisateurs par mois sur 3 années (l’année en cours, l’année précédente et l’année N-2) afin de voir les tendances ?

1. Créez un fichier Google Sheets My Website_GoogleAnalytics_Sessions.gsheet.

2. Dans la feuille Report Configuration, ajoutez les différents rapports utiles à la réalisation de votre tableau de bord : chaque colonne identifie l'un de ces rapports : Sessions Last Week, Sessions This Week, ...
         Example Google Analytics - Report configuration sheet.png

3.  Configurez les paramètres des rapports -  Open url.png  voir Processus d'intégration pas à pas > étape 2.3

4. Lancez les rapports via le module Google Analytics Spreadsheet Add-on : une feuille est créée pour chaque rapport -  Open url.png  voir Structure de chaque feuille : Processus d'intégration pas à pas > étape 2.4

5. Créez une nouvelle feuille Stats Consolidées pour la consolidation des données et placez-la en première position, juste avant la feuille Report Configuration.

6. Dans cette feuille de consolidation, définissez les données directement exploitables par les datasources de votre application Product name - ev sas.png : 

  • Ajoutez manuellement les données ne provenant pas des rapports : colonnes Semaine (A), Mois (D), Année (G).
  • Utilisez la formule Feuille<n>!B16 pour récupérer les informations souhaitées dans les autres feuilles (à partir de la ligne 16 ; remplacez Feuille<n> par le nom de la feuille si vous avez modifié son nom par défaut comme dans l’exemple fourni).
  • Ajoutez des colonnes vides pour améliorer la lisibilité de la feuille.
Example Google Analytics - Consolidated stats sheet.png
  • colonne (A) Week : jours de la semaine (du lundi au dimanche)

  • colonne (D) Month : numéros de semaine composant un mois (il n’y a jamais plus de 5 semaines)

  • colonne (G) Year : mois composant une année civile (de janvier à décembre)

  • colonne (K) vide : séparation des groupes de rapports similaires

7. Générez les fichiers .csv que vous allez utiliser via un datasource dans votre application Product name - ev sas.png -  Open url.png  voir Processus d'intégration pas à pas > étape 2.6 :

  • génération manuelle pour un datasource CSV 
  • planification pour un datasource Online CSV

8. Allez sur votre application Product name - ev sas.png et configurez le graphique à afficher sur votre tableau de bord via un widget Bar Chart :

  • Ajoutez un datasource lisant les données de votre feuille consolidée Stats Consolidées.
  • Ajoutez un widget Bar Chart :
    • Sélectionnez le datasource et décochez la case First Row Contains Dimension Elements.
    • Via le Data Transformer, sélectionnez, dans l'ordre d'affichage souhaité sur le graphique, les colonnes à utiliser.
Example Google Analytics - Data Transformer Total.png

Data Transformer affichant toutes les colonnes de la feuille Stats Consolidées

Example Google Analytics - Data Transformer Partial.png

Sélection des 4 colonnes utilisées pour afficher le graphique Bar Chart :

  • la colonne Year est utilisée pour l'axe des abscisses ;
  • les 3 autres colonnes sont utilisés pour l'axe des ordonnées, ce qui permet d'afficher les tendances dans l'ordre chronologique.

    Example Google Analytics - Bar Chart.png

Cas des applications Product name - ev sas - big.png à analyser avec Google Analytics

Considération 1

Les applications Product name - ev sas.png sont des applications de type web monopage (Single Page Application – SPA), accessibles via une page web unique. Leur but est d’éviter le chargement d’une nouvelle page à chaque action demandée et de fluidifier ainsi l’expérience utilisateur. Certaines applications de ce type peuvent émuler une navigation en changeant l'URL affichée dans la barre de navigation du navigateur, mais il n’y a jamais de chargement d’une nouvelle page complète.

Le JavaScript tracking snippet inséré dans vos pages web pour utiliser la librairie analytics.js et obtenir des statistiques d’analyse d’audience fonctionne bien avec les sites et applications web traditionnels car le code est exécuté à chaque fois qu’un utilisateur charge une page. Aussi, avec la librairie officielle analytics.js de Google Analytics, il vous sera difficile d’avoir des statistiques détaillées pour chacune des pages de votre application. Donc, par exemple, vous pourrez obtenir le nombre total de visiteurs ou de sessions par pays pour l’ensemble de l'application, mais vous ne pourrez pas avoir le nombre total de visiteurs ou de sessions des utilisateurs sur une page en particulier. 

Considération 2

Les applications monopages Product name - ev sas.png ont des URL de type https://yourcompanyname-apps.easyvista.com/index.php?timestamp=1463741371186&name=com.yourcompanyname.573eeb6962823|571e2218d3f5f&showapp=0.
Google Analytics ne vous permet pas de créer de nouvelles propriétés lorsque l'URL du site web comporte des arguments, comme c’est le cas par défaut. Sinon, le message d’erreur ci-dessous s’affiche.
         Consideration2 - Error message.png

Pour éviter cela :

  • Créez une propriété pour chaque application pour laquelle vous souhaitez obtenir des statistiques d’analyse d’audience, afin d’avoir un code de suivi différent pour chacune d'entre elles.
  • Pour chacune de ces propriétés, saisissez un nom de site web différent (ex. My Company Service Store) et saisissez la même URL racine correspondant à votre plateforme Product name - ev sas.png (ex. : yourcompanyname-apps.easyvista.com) :
             Consideration2 - Property name.png
  • Sur chaque page de l'application, insérez un JavaScript tracking snippet (code de suivi) avec l'ID de suivi obtenu en créant la propriété (ex. : My Company Service Store, My University).
    Note : Google autorise l’ajout de 50 propriétés par compte Analytics. Si vous avez plus de 50 applications sur votre plateforme Product name - ev sas.png pour lesquelles vous souhaitez des statistiques d’analyse d’audience, contactez votre responsable de compte ou utilisez un autre compte Google Analytics.
     

Comment ajouter un JavaScript tracking snippet dans une page d’une application Product name - ev sas.png basée sur l'application modèle IT Portal

  • Obtenez un ID de suivi en ajoutant une propriété à votre compte Google Analytics.
             Open url.png  voir Configurer une propriété pour obtenir un ID de suivi (ex. : UA-XXXXXXXX-X)
  • Copiez le code de suivi associé à l'ID de suivi.
             Open url.png  voir Localiser votre code de suivi, l'identifiant de suivi et le numéro de propriété
  • Collez le code de suivi dans un widget Html Script :
    • ajoutez le widget en bas de la page de l'application ;
    • collez le code de suivi dans le champ Html Code ;
    • dans la catégorie Theme > champ Widget Height, affectez la valeur 15 (hauteur minimale d’un widget) ;
    • dans la sous-catégorie Border > champ Style, sélectionnez la valeur none : en mode Exécution, cela permet de supprimer le cadre autour du widget si un thème est utilisé dans l'application ; le widget contenant le code de suivi Google Analytics est ainsi invisible pour les utilisateurs.
Tags:
Modifié par Utilisateur inconnu le 2017/09/08 11:36
Créé par Administrator XWiki le 2016/09/29 09:05

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help

Glossaire

Powered by XWiki ©, EasyVista 2020