Code source wiki de Connecteur Google Analytics

Modifié par jhurst le 2021/04/21 10:01
Afficher les derniers auteurs
1 {{ddtoc/}}
2
3 Annexe
4
5 {{ddchildren/}}
6
7 ----
8
9 Ce document décrit l'utilisation du connecteur de source de données Google Analytics. Pour la configuration du connecteur, voir : [[Connecteur Google Analytics - Configuration>>doc:Digdash.deployment.Connectivity_Database.google_analytics_connector.google_analytics_connector_config.WebHome]].
10
11 = Prérequis =
12
13 * Un compte Google Analytics avec les identifiants de connexion pour DigDash (voir point suivant)
14 * Suivre les instructions du tutoriel [[Connecteur Google Analytics - Configuration>>doc:Digdash.deployment.Connectivity_Database.google_analytics_connector.google_analytics_connector_config.WebHome]] pour la récupération des données de connexion (compte de service + fichier P12 + identifiants du compte Google Analytics).
15
16 = Sélection de la source de données Google Analytics =
17
18 Vous pouvez récupérer des informations provenant de votre compte Google Analytics.
19
20 Sélectionnez le type de rapport souhaité dans la barre d'outils en bas de la page.
21
22
23 [[image:1599032753356-872.png||height="294" width="662"]]
24 __//Capture : Sélection de la source de données Google Analytics via la barre d’outils//__
25
26 **OU** sélectionnez la source de données souhaitée dans l'onglet **Source de données** figurant en haut de la page puis cliquez sur **Nouvelle source** dans le gestionnaire de source de données et choisissez **Rapport Google Analytics**.
27
28 [[image:1599032933155-101.png]]
29
30
31 [[image:1599032977125-650.png||height="401" width="700"]]
32 __//Capture : Sélection de la source de données Google Analytics via l’onglet **Source de données**//__
33
34 = Authentification =
35
36 Suivez le tutoriel nommé [[Connecteur Google Analytics - Configuration>>doc:Digdash.deployment.Connectivity_Database.google_analytics_connector.google_analytics_connector_config.WebHome]] et récupérez les informations fournies.
37
38 Entrez les informations dans les champs du connecteur prévus à cet effet.
39
40 [[image:1599033052634-105.png||height="619" width="956"]]
41
42 __//Capture : Interface pour l’authentification et le chargement des données Google Analytics//__
43
44 **Compte du service** : il s’agit de l’identifiant sous forme d’adresse email récupéré lors de la création du compte dans la console Google Analytics.
45
46 **Fichier P12** : Il s’agit de la clé secrète sous forme de fichier .p12 généré et que vous aurez téléchargée lors de la création du compte dans la console Google Analytics.
47
48 **Identifiant du compte** : il s’agit de l’identifiant récupéré dans Google Analytics.
49
50 **Identifiant de la vue** (post- authentification) : Un compte Google Analytics peut posséder plus qu’une seule vue. Vous pourrez choisir la vue sur laquelle vous souhaitez travailler.
51
52 **Période de temps** (post- authentification) : Vous pouvez récupérer vos données Google Analytics pour une période donnée.
53
54 **Représentation des données** (post-authentification) : c’est dans cette vue que vous pourrez visualiser les mesures et dimensions propres à Google Analytics.
55
56 Après authentification, cliquez sur le bouton « Charger les objets » pour pouvoir charger les informations de votre compte Google Analytics.
57
58 [[image:1599033232619-146.png]]
59
60 __//Capture : Remplissage des champs pour l’authentification Google Analytics//__
61
62 Après authentification, vous obtiendrez les éléments suivants dans la fenêtre de dialogue :
63
64 [[image:google_analytics_connector_fr_html_a02dce6cbc0dbbfb.png||queryString="width=638&height=535" height="535" width="638"]]
65 __//Capture : Chargement des objets Google Analytics après authentification//__
66
67 = Période de temps =
68
69 Vous pouvez spécifier une période de temps fixe pour la récupération de données en indiquant deux dates.
70
71 [[image:google_analytics_connector_fr_html_3ad5c82cc6c62444.png||queryString="width=554&height=180" height="180" width="554"]]
72 //__Capture : Sélection de dates pour la définition d’une période de temps fixe__//
73
74 (% class="box infomessage" %)
75 (((
76 **Note** : La date de fin d’une période est toujours exclue. La date de fin maximum ne peut être que la date du lendemain du jour courant. Exemple : si vous voulez récupérer les données pour la période du 1^^er^^ janvier 2016 (inclus) au 31 janvier 2016 (inclus), vous devez sélectionner le 01/01/2016 comme date de début et 01/02/2016 comme date de fin.
77 )))
78
79 = Dimensions et mesures =
80
81 [[image:1591971553506-248.png]]
82
83 //__Capture : Description de l’interface de sélection de mesures/dimensions__
84 1 : Zone de sélection des mesures disponibles 2 : Zone des mesures sélectionnées
85 3 : Zone de sélection des dimensions non disponibles 4 : Zone des dimensions sélectionnées//
86 La partie du haut concerne les mesures dans Google Analytics.
87
88 Dans la partie gauche, les mesures sont regroupées en catégories.
89
90 * [[image:1591971642827-593.png]] Vous pouvez filtrer sur les noms des mesures (et non des catégories) pour pouvoir rechercher plus rapidement une mesure dans la barre de filtre.
91 * [[image:google_analytics_connector_fr_html_41f958b711b0487d.gif]] Vous pouvez glisser depuis la partie gauche les mesures dans la partie droite pour les sélectionner.
92
93 La partie du bas concerne les dimensions dans Google Analytics.
94
95 Dans la partie gauche, les dimensions sont regroupées en catégories.
96
97 * [[image:1591971656676-234.png]] Vous pouvez filtrer sur les noms des dimensions (et non des catégories) pour pouvoir rechercher plus rapidement une dimension dans la barre de filtre.
98 * [[image:1591971670474-798.png]] Vous pouvez glisser depuis la partie gauche les dimensions dans la partie droite pour les sélectionner.
99
100 [[image:google_analytics_connector_fr_html_3c9cbdc4510d9d8f.png||queryString="width=223&height=370" height="370" width="223"]]
101 __//Capture : Les mesures et dimensions sont regroupées en catégories//__
102
103 == Possibilités de combinaison ==
104
105 Il est possible de combiner :
106
107 * mesures et dimensions
108 * seulement les mesures
109
110 Il n’est en revanche pas possible de n’avoir que des dimensions.
111
112 == Combinaisons valides ==
113
114 Toutes les combinaisons mesures-dimensions ou mesures-mesures ne sont pas valides.
115
116 DigDash se propose d’indiquer juste à titre d’information les combinaisons non valides.
117
118 Vous pouvez consulter la page de documentation suivante pour vérifier si les combinaisons des dimensions/mesures que vous avez sélectionnées sont valides.
119
120 __[[https:~~/~~/developers.google.com/analytics/devguides/reporting/core/dimsmets>>url:https://developers.google.com/analytics/devguides/reporting/core/dimsmets]]__
121
122 A la sélection d’une mesure ou dimension dans la partie droite, vous pourrez voir dans la partie gauche les dimensions et mesures non compatibles avec la dimension ou mesure sélectionnée.
123
124 Nous distinguons trois représentations pour les mesures :
125
126 [[image:google_analytics_connector_fr_html_c33b15cb62f719e9.png]] Mesure sélectionnée
127
128 [[image:google_analytics_connector_fr_html_698dbe549441612d.png]] Mesure non sélectionnée/disponible
129 (% style="color:#ffffff" %)[[image:1591971708209-455.png]](%%) Mesure non compatible avec une (ou des) mesure(s)/dimension(s) sélectionnée(s)
130
131 Nous distinguons trois représentations  pour les dimensions :
132 [[image:google_analytics_connector_fr_html_eb775712396c1bbc.png]] Dimension sélectionnée
133 [[image:google_analytics_connector_fr_html_3199d5cb5b6efc55.png]] Dimension non sélectionnée/disponible
134 [[image:1591971731783-625.png]] Dimension non compatible avec une (ou des) mesure(s)/dimension(s) sélectionnée(s)
135
136 [[image:google_analytics_connector_fr_html_bcb0d49f58bd4f13.png||queryString="width=618&height=517" height="517" width="618"]]
137 //__Capture : Nous pouvons observer qu’à la sélection de la mesure **1 Day Active Users**__
138 Entre autres, les mesures **7 Day Active Users** et **14 Day Active Users** sont incompatibles avec la mesure sélectionnée
139 Entre autres, les dimensions **User Type** et **Count of Sessions** sont incompatibles avec la mesure sélectionnée//
140
141 Vous avez la possibilité de sélectionner dans tous les cas les colonnes de votre choix, même invalides, une icône est toutefois présente pour vous indiquer que votre requête risque de ne pas être valide.
142
143 [[image:google_analytics_connector_fr_html_e545bf6e51b9a162.png||queryString="width=605&height=507" height="507" width="605"]]
144
145 __//Capture : Activation de l’icône encadrée lorsque qu'une incompatibilité est détectée entre les mesures/dimensions sélectionnées.//__
146
147 = Options avancées =
148
149 Vous pouvez configurer votre source de données Google Analytics de manière plus poussée en activant des options avancées.
150
151 [[image:google_analytics_connector_fr_html_40e5982a11441d4c.png||queryString="width=602&height=505" height="505" width="602"]]
152 __//Capture : Lien **Options avancées…** pour une configuration poussée de la source Google Analytics//__
153
154 Cliquer sur « Options avancées… ».
155
156 La boite de dialogue des options avancées s’affiche :
157
158 [[image:google_analytics_connector_fr_html_af17a2f23f02443a.png]]
159
160 __//Capture : Dialogue des options avancées//__
161
162 == Période de temps dynamique ==
163
164 Vous avez la possibilité de rendre vos périodes dynamiques en définissant un laps de temps à partir de la date courante.
165
166 Pour activer cette option, cocher la case à cocher « Période dynamique ».
167
168 [[image:google_analytics_connector_fr_html_50edaa8c0b204dc2.png]]
169
170 __//Capture : Description de la définition d’une période dynamique//__
171
172 Vous pouvez alors définir votre période dynamique par rapport à la date courante. Les dates entre parenthèses sont à titre informatif et changeront bien évidemment chaque jour.
173
174 Définition de la période dynamique :
175
176 * définition de la **date initiale** : il s’agit de la date courante à laquelle vous allez **SOUSTRAIRE** X pas dans le temps
177 * définition de la **date de fin** : il s’agit de la date initiale définie précédemment à laquelle vous allez **AJOUTER** Y pas dans le temps.
178
179 Avec :
180
181 * X et Y deux entiers positifs ou nuls
182 * les pas dans le temps qui peuvent correspondre à des jours, mois ou années.
183
184 == Echantillonnage ==
185
186 Quand il s’agit de comptes Google Analytics non payants (qui ne sont pas Google Analytics 360, non Premium), Google applique un échantillonnage dans les données récupérées pour pouvoir rendre une réponse plus ou moins rapide. Cet échantillonnage a un rôle dans la précision des données.
187
188 Trois options vous sont proposées si vous disposez d’un compte Google Analytics non Premium :
189
190 [[image:google_analytics_connector_fr_html_aae38095b2f26c79.png]]
191
192 __//Capture : Description de la définition des différents niveaux de niveaux d’échantillonnage//__
193
194 * **Défaut** : retourne une réponse avec une taille d'échantillon qui compense la vitesse et la précision.
195 * **Rapide** : retourne une réponse rapide avec une petite taille d'échantillon.
196 * **Haute précision** : retourne une réponse plus précise en utilisant une grande taille d'échantillon, mais cela peut induire une réponse plus lente.