Cet article détaille plusieurs comportements propres au connecteur, et met en avant certaines nouveautés. Vous trouverez également des explications quant aux écarts de données entre les deux outils Looker Studio et Piano Analytics.
Plusieurs éléments peuvent expliquer des écarts de données entre Piano Analytics et Looker Studio, le connecteur étant limité par l'outil et ses règles de processing internes propres à Google.
Comportement API
Les métriques comme "Visites" ou "Visiteurs" ne sont pas des métriques sommables. La ligne de résultat "TOTAL" affichée par nos outils affiche le résultat dédupliqué, afin de ne pas compter plusieurs fois la même visite ou le même visiteur sur une période donnée, comme l'explique en détail cet article.
Or, Looker Studio n'est pas en mesure de dédupliquer ces informations puisque l'outil ne connaît pas le calcul que nous effectuons pour procéder. Il va donc simplement sommer les lignes. Il est alors probable que l'outil vous affiche des valeurs plus importantes que sur nos outils.
Limites API
Looker Studio ne permet pas à notre connecteur de requêter librement la donnée. Ainsi, une requête créée sur Looker Studio ne pourra excéder 10 000 lignes de résultats.
Il est possible de vérifier sur nos outils, depuis Data Query, le nombre de lignes de résultats retournées en cliquant sur le bouton prévu à cet effet en bas à droite de l'interface :
Si votre requête dépasse cette limite, il faudra la modifier ou exporter les données depuis nos outils pour les importer dans Looker Studio.
Le connecteur est également soumis aux limites propres de notre API v3 détaillées ici.
Un utilisateur d'un board Looker ne pourra pas effectuer plus de 5 appels concurrents à notre API (1 appel=1 boite du rapport) et cette limite s'élève à 20 appels concurrents à l'échelle de l'organisation du client. Cependant le connecteur possède un système de refresh faisant en sorte que vos données soient récupérées rapidement.
Il est possible que vous obteniez des erreurs de ce type :
Sachez que ces erreurs sont propres à Google, et non relatives à notre API. Nous vous recommandons de contacter le support Google, ou éventuellement de reconnecter votre source de données.
Filtres (Nouveauté dernière version)
Bien que la limite des 10 000 lignes soit bloquante pour certains cas de figure, il apparait en réalité un besoin plus fréquent d'analyser les résultats de requêtes possédant un ou des filtres.
Avec la nouvelle version du connecteur (source de données "Piano Analytics), une amélioration significative a été apportée à la gestion des filtres. Auparavant, les filtres appliqués dans Looker Studio n’étaient pris en compte que sur les 10 000 premières lignes de résultats renvoyées par la requête de données Piano Analytics, ce qui pouvait entraîner des divergences entre les résultats affichés dans Looker Studio et ceux observés directement dans Piano Analytics.
Désormais, avec cette mise à jour, les filtres sont appliqués directement au niveau de l'appel API, garantissant ainsi que l'ensemble des données soit filtré correctement dès l'extraction. Cela permet d’obtenir des résultats cohérents entre les deux plateformes et d'améliorer la précision des rapports créés dans Looker Studio.
Toutes vos requêtes de plus de 10 000 lignes de résultats seront donc correctement filtrées.
Segments (Nouveauté dernière version)
Plus besoin de passer par la création de métriques personnalisées pour espérer retrouver vos analyses segmentées ! Avec la nouvelle version du connecteur Looker Studio, importez vos segments Piano Analytics directement dans les boites de vos rapports. La nouvelle version possède un sélecteur de segment global, disponible au moment du paramétrage de la source de données "Piano Analytics", ainsi qu'un sélecteur de segment personnalisé disponible depuis le menu de configuration de vos boites.
Segment global : applique le segment à l'ensemble de votre board.
Segment personnalisé : applique le segment uniquement à la boite sélectionnée.
Tri
Le tri appliqué par Looker Studio peut différer selon votre requête. Il n'est pas possible de choisir le tri à appliquer au moment où Looker effectue l'appel API comme c'est le cas sur nos outils. Nous n'avons pas la main pour intervenir sur ce comportement.
Si vous chargez une requête qui excède les 10 000 lignes de résultats, les 10 000 premières lignes retournées peuvent alors être différentes de celles affichées par nos outils.
Mode éco
Comme pour les comparaisons de données entre nos différents outils, ou notre API et nos outils, il faudra vous assurer que le mode éco soit désactivé. Ce mode peut mener à avoir jusqu'à un maximum de 2% d'écart dans vos résultats afin de diminuer l'impact environnemental de vos requêtes.
Par défaut, il n'est pas actif dans un appel API, et n'a donc aucun impact sur les résultats restitués par Looker Studio.
Format Date et Boolean
Les propriétés de types booléennes ne sont pas compatibles avec le connecteur AT Internet présent sur Looker Studio.
Si vous souhaitez remonter cette information sur Looker Studio, nous vous invitons à contacter un administrateur pour que celui-ci crée une propriété personnalisée comme ci-dessous convertissant votre propriété search_same_day en chaine de caractères (String).
Ces modifications ne seront cependant pas rétroactives.
Les propriétés de dates et heures issues de Piano Analytics sont également retraitées avec une fonction propre à Looker Studio dans un format parfois différent.
Pour cette raison, nous pouvons vous proposer un exemple permettant de faire fonctionner la propriété 'Date'. Les étapes sont reproductibles pour n'importe quelle information horodatée présente dans nos évènements, il faudra seulement modifier la règle pour prendre la bonne partie de l'information en fonction de ce que vous souhaitez reproduire.
Le principe est de créer une nouvelle propriété customisée qui récolte le paramètre de date des hits pour récupérer uniquement le mois sous un format string ou chaine de caractères. De cette façon, la propriété ne sera pas retraitée une fois dans Looker.
Tout d'abord, créez votre propriété customisée string (nous prenons comme exemple Looker_mois) et validez votre draft.
Allez ensuite dans le menu de configuration de cette propriété, puis Processing et enfin Snippets puis créez ce snippet :
Et enfin créez cette règle :
Avant l'étape 3, la propriété contient les numéros des mois (01, 02...) et vous pouvez y ajouter une table de correspondance pour avoir les noms réels des mois comme ceci :
Il vous suffira ensuite d'utiliser cette propriété dans Looker Studio pour avoir des informations relatives qui soient correctes.
Notez toutefois que ces propriétés au format string ne seront pas utilisables dans les graphiques temporels de Looker, car ces derniers utilisent obligatoirement un format date. Toutefois, il peut arriver que nos propriétés natives dans ce format fonctionnent pour ce type de graphique.