Migrer vos données depuis Piano Analytics


Ce connecteur va vous permettre de ré-importer votre historique de données agrégées pour certaines typologies de rapports.


Afin d'être le plus complet possible les données requêtées et synchronisées via le connecteur sont en mode ECO: OFF, si vous souhaitez faire des comparaisons il est impératif de se mettre dans le même mode ECO: OFF sinon vous verrez des écarts plus importants.


Comment mettre en place le ré-import de données ?

Afin de pouvoir mettre en place le ré-import de données vous devez :
  • avoir l'API activée sur votre compte Piano Analytics
  • créer  un accès API  dans votre interface Piano
  • récupérer les deux valeurs : ACCESS KEY (clé d'accès) et SECRET KEY (clé secrète)
  • récupérer le siteId que vous souhaitez synchroniser, cette valeur correspond a l'id du site contenant les données a synchroniser.
Une fois que l'accès API est activée, connectez vous sur l'interface Eulerian et activez le connecteur de ré-import de données Piano Analytics Import.

Au moment de la création du connecteur de ré-import de données une vérification de l'accès API pour le siteId cible est effectuée en requêtant le nombre total de visite sur la période allant du 1 janvier 2021 a la date de création du connecteur (mais pas plus loin que le 16 mars 2023), ceci afin d'éviter de créer des connecteurs qui :
  • ne peuvent pas accèder à l'API pour un problème d'identifiants API
  • ne peuvent pas synchorniser un site vide


Ecart de données avec Data Query

Nous avons constaté que des écarts peuvent exister entre les volumes de visites et de visiteurs unique sur certaines périodes, la donnée visible suite au ré-import est issue de l'
API AT Internet. Dans certains cas celle-ci peut être différente de ce qui est visualisé dans l'interface Data Query. Nous ne pouvons malheureusement pas faire de correctifs a ce niveau-là.


Données globales au niveau site

Les métriques suivantes :
  • visites
  • pages vues
  • visiteurs uniques
  • temps passé
  • taux de rebond
  • visites à une page
La donnée est segmentable par type d'appareil.


Données au niveau pages

Les métriques suivantes :
  • pages vues
  • taux de rebond
  • temps passée
  • visites
  • visites a une page
  • visites entrantes
Les dimensions additionelles suivantes sont automatiquement importées et associées à la page importée :
  • Page - 1er niveau (page_chapter1) devient Page Label 1
  • Page - 2eme niveau (page_chapter2) devient Page Label 2
  • Page - 3eme niveau (page_chapter3) devient Page Label 3
  • l'URL de la page si disponible est aussi récupérée et associée a la page concernée
La donnée est segmentable par type d'appareil.



Données globales par source de trafic gratuit

Cela concerne les sources suivantes :
  • accès direct
  • sites affluents dont Portails & Webmails
  • réseaux sociaux gratuits
  • référencement naturel / moteur de recherche
Les métriques suivantes :
  • visites
  • pages vues
  • visiteurs uniques
  • temps passé
  • taux de rebond
  • visites à une page
La donnée est segmentable par type d'appareil.
Un traitement particulier est opéré sur les sources suivantes :
  • Portails : un référant 'Portails' est créé regroupant les sites Portails (Portal sites) disponibles en tant que source, l'URL du site référant se trouvera en sous-élément du référant principal 'Portails'
  • Webmails : un référant 'Webmails' est créé regroupant les Webmails disponibles en tant que source, l'URL du site référant se trouvera en sous-élément du référant principal 'Webmails'
Les données au niveau mot-clé pour la source Référencement naturel n'est pas disponible.


Données globales par source de trafic payantes

Cela concerne les sources suivantes :
  • liens sponsorisés
  • push notifications → classifié en Levier Générique
  • advertisement → classifié en Levier Display
  • unclassified campaigns → classifié en Levier Display
Les métriques suivantes :
  • visites
  • pages vues
  • visiteurs uniques
  • temps passé
  • taux de rebond
  • visites à une page
La donnée est segmentable par type d'appareil.Nous créons une campagne par support, donc un même nom de campagne peut se trouver dupliqué par support, il suffit alors de créer un regroupement supérieur pour retrouver ses aggrégats.

Si vous avez des leviers spécifiques a ré-importer et qui ne sont pas listés ci-dessus, merci de nous contacter.


Données globales au niveau géographique

Nous récupérons les données au niveau :
  • pays
  • région
  • ville

Un référentiel basé sur des codes ISO n'est pas disponible, le ré-import se base donc sur des approximations liés au nommage des pays, région & villes. Il est donc possible qu'on ne puisse pas retrouver strictement le même niveau de détail malgré nos meilleurs efforts.Les métriques suivantes :
  • visites
  • pages vues
  • visiteurs uniques
La donnée est segmentable par type d'appareil.


Données globales au niveau évènements


La taxonomie des évènements de type click n'étant pas normalisée, nous ne pouvons offrir qu'une synchronisation limitées. Les données sont transitées dans la notion suivi de conversion.Le nom des évènements est nettoyé :
  • suppression de https:/ en début de nom
  • suppression de / en début de nom
Les métriques suivantes :
  • clics
La donnée est segmentable par type d'appareil.


Erreurs



Création du connecteur

A la création du connecteur si vous obtenez ce message
Cela veut dire que les informations de connexion fournies ne sont pas correctes. Au moment de la création du connecteur nous testons l'accès a l'API Piano afin de valider que celui-ci est fonctionnel, si vous obtenez cette erreur c'est que les informations fournies pour se connecter ne sont pas bonnes.Solution : merci de contacter le support Piano afin qu'ils puissent tester de leur côté.Le test que nous faisons pour requêter l'API et les droits associés est le suivant :
curl -v -H 'Content-Type: application/json' -X POST -H 'x-api-key: accesskey_secretkey' --data '{"columns":["m_visits"],"max-results":1,"period":{"p1":[{"end":"2023-02-28","start":"2021-01-01","type":"D"}]},"space":{"s":[siteId]},"page-num":1,"sort":["-m_visits"]}' https://api.atinternet.io/v3/data/getData
Donc si vous avez les paramètres suivants :
  • accessKey : 321656894d
  • secretKey : 65465sdfds8sdf32268sdf454g
  • siteId : 5623
Vous aurez l'appel :
curl -v -H 'Content-Type: application/json' -X POST -H 'x-api-key: 321656894d_65465sdfds8sdf32268sdf454g' --data '{"columns":["m_visits"],"max-results":1,"period":{"p1":[{"end":"2023-02-28","start":"2021-01-01","type":"D"}]},"space":{"s":[5623]},"page-num":1,"sort":["-m_visits"]}' https://api.atinternet.io/v3/data/getData