Piano Analytics : import de données historique

Piano Analytics : import de données historique

Cette page explique comment réimporter dans Eulerian un historique de données agrégées depuis Piano Analytics.
Le connecteur Piano Analytics Import permet de récupérer certaines typologies de rapports. Les données synchronisées dépendent des dimensions et métriques disponibles dans Piano Analytics et des traitements appliqués par le connecteur.
Afin d'être le plus complet possible, les données requêtées et synchronisées via le connecteur sont en mode ECO: OFF. Pour effectuer des comparaisons, il est impératif d'utiliser le même mode ECO: OFF ; sinon, des écarts plus importants peuvent apparaître.
Une fois l'import d'historique réalisé, vous pouvez utiliser le  connecteur de tracking automatique des UTMs  pour continuer d'utiliser votre taxonomie actuelle avant de migrer vers la  mesure publicitaire native  d'Eulerian.

Mise en place du réimport

Pour mettre en place le réimport de données Piano Analytics, suivez les étapes ci-dessous.

Étape 1 — Activer l'API Piano Analytics

L'API doit être activée sur votre compte Piano Analytics.

Étape 2 — Créer un accès API

Créez un accès API depuis votre interface Piano Analytics :  API Keys .

Étape 3 — Récupérer les clés API

Récupérez les deux valeurs suivantes :
  • ACCESS KEY ;
  • SECRET KEY.

Étape 4 — Récupérer le site à synchroniser

Récupérez le siteId que vous souhaitez synchroniser.
Cette valeur correspond à l'identifiant du site contenant les données à synchroniser.

Étape 5 — Activer le connecteur dans Eulerian

Une fois l'accès API activé, connectez-vous à l'interface Eulerian et activez le connecteur de réimport de données Piano Analytics Import.

Vérification à la création du connecteur

Lors de la création du connecteur de réimport, une vérification de l'accès API est effectuée pour le siteId cible.
Cette vérification requête le nombre total de visites sur la période allant du 1er janvier 2021 à la date de création du connecteur, sans aller au-delà du 16 mars 2023.
Cette vérification permet d'éviter la création de connecteurs qui :
  • ne peuvent pas accéder à l'API à cause d'un problème d'identifiants API ;
  • ne peuvent pas synchroniser un site vide.

Écart de données avec Data Query

Des écarts peuvent exister entre les volumes de visites et de visiteurs uniques sur certaines périodes.
La donnée visible après réimport est issue de l'API AT Internet. Dans certains cas, elle peut être différente de ce qui est visualisé dans l'interface Data Query.
Nous ne pouvons pas faire de correctifs à ce niveau-là.

Données synchronisées

Données globales au niveau site

Les métriques suivantes sont synchronisées :
  • 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 sont synchronisées :
  • pages vues ;
  • taux de rebond ;
  • temps passé ;
  • visites ;
  • visites à une page ;
  • visites entrantes.
Les dimensions additionnelles suivantes sont automatiquement importées et associées à la page importée :
  • page_chapter1 devient Page Label 1 ;
  • page_chapter2 devient Page Label 2 ;
  • page_chapter3 devient Page Label 3 ;
  • l'URL de la page, si disponible, est récupérée et associée à la page concernée.
La donnée est segmentable par type d'appareil.

Données globales par source de trafic gratuit

Les sources suivantes sont concernées :
  • accès direct ;
  • sites affluents, dont Portails & Webmails ;
  • réseaux sociaux gratuits ;
  • référencement naturel / moteur de recherche.
Les métriques suivantes sont synchronisées :
  • 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 appliqué aux sources suivantes :
  • Portails : un référant Portails est créé pour regrouper les sites Portails disponibles en tant que source. L'URL du site référant se trouve en sous-élément du référant principal Portails.
  • Webmails : un référant Webmails est créé pour regrouper les Webmails disponibles en tant que source. L'URL du site référant se trouve en sous-élément du référant principal Webmails.
Les données au niveau mot-clé pour la source Référencement naturel ne sont pas disponibles.

Données globales par source de trafic payantes

Les sources suivantes sont concernées :
  • 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 sont synchronisées :
  • 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. Un même nom de campagne peut donc être dupliqué par support. Il suffit alors de créer un regroupement supérieur pour retrouver ses agrégats.
Si vous avez des leviers spécifiques à réimporter et qui ne sont pas listés ci-dessus, merci de nous contacter.

Données globales au niveau géographique

Les données sont récupérées aux niveaux suivants :
  • 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ées au nommage des pays, régions et villes.
Il est possible de ne pas retrouver strictement le même niveau de détail, malgré nos meilleurs efforts.
Les métriques suivantes sont synchronisées :
  • 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, seule une synchronisation limitée est possible.
Les données sont transitées dans la notion suivi de conversion.
Le nom des évènements est nettoyé avec les traitements suivants :
  • suppression de https:/ en début de nom ;
  • suppression de / en début de nom.
Les métriques suivantes sont synchronisées :
  • clics.
La donnée est segmentable par type d'appareil.

Erreurs

Création du connecteur

À la création du connecteur, si vous obtenez ce message :
Cela signifie que les informations de connexion fournies ne sont pas correctes.
Au moment de la création du connecteur, nous testons l'accès à l'API Piano afin de valider qu'il est fonctionnel. Si vous obtenez cette erreur, les informations fournies pour se connecter ne sont pas bonnes.
Solution : merci de contacter le support Piano afin qu'il puisse tester l'accès de son côté.
Le test effectué 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
Avec les paramètres suivants :
  • accessKey : 321656894d ;
  • secretKey : 65465sdfds8sdf32268sdf454g ;
  • siteId : 5623.
L'appel correspondant est :
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