Migrer vos données depuis une solution non-supportée nativement

Migrer vos données depuis une solution non-supportée nativement

Cette page explique comment réimporter dans Eulerian un historique de données agrégées provenant d'une solution qui ne dispose pas de connecteur natif.
Ce mode d'import s'appuie sur le connecteur RealTime Analytics - Import. Il utilise des formats génériques et n'est donc pas lié à une plateforme source spécifique. Les données peuvent provenir de n'importe quelle solution, à condition d'être préparées au format attendu.

Principe général

Le réimport permet de récupérer un historique agrégé pour certaines typologies de rapports.
Il repose sur deux éléments :
  • un fichier CSV contenant les données à importer ;
  • un fichier JSON décrivant le format des données, le type d'import et les correspondances entre les colonnes du CSV et les dimensions ou métriques Eulerian.
Nom du connecteur : RealTime Analytics - Import

Fonctionnement du réimport

Les données importées sont agrégées selon le profil défini dans le fichier JSON.
Si une seule valeur est envoyée sur une période de plus d'un jour, elle est répartie de façon égale sur l'ensemble des jours de la période. Le reste éventuel est ajouté à la première journée.
Lorsque des données sont envoyées sur une période donnée, le traitement appliqué est le suivant :
  • si la ligne concernée n'existe pas encore, la valeur fournie dans le fichier est injectée ;
  • si la ligne concernée existe déjà, la nouvelle valeur annule et remplace l'existant.
Exemple : si une ligne contient déjà 15 pages vues et qu'un nouvel import envoie 17 pages vues, la valeur affichée dans l'interface sera 17.

Pré-requis

Pour mettre en place le réimport, vous devez disposer de :
  • vos données au format CSV ;
  • un fichier JSON définissant le format des données et le type d'import.
Les caractères accentués sont automatiquement supprimés lors du réimport afin de garantir une meilleure compatibilité entre les solutions.
Une fois le connecteur créé, des endpoints API permettent d'indiquer la typologie de données à importer.

Typologies de données importables

Les sections suivantes décrivent les différentes typologies de données prises en charge.
Pour chaque typologie, vous trouverez :
  • les métriques disponibles ;
  • un exemple de format JSON ;
  • un exemple de fichier CSV ;
  • l'URL d'appel API à utiliser.

Données au niveau du site

Les métriques suivantes :
  • temps passée : duration - il doit être fourni en secondes
  • visites : visit
  • visiteurs uniques journaliers : dvisitor
  • ventes : scartvalid
  • CA ventes : scartvalidamount
  • devis : estimatevalid
  • CA devis : estimatevalidamount
  • paniers commencés : scart
Exemple de format d'import :
{
  "skipHeader" : true,
  "kind" : "website",
  "dimensions" : [{
     "idx" : 0,
     "target": "website_name"
  }],
  "metrics" : [{
     "idx" : 1,
     "target" : "visit"
   }, {
     "idx" : 4,
     "target" : "duration"
   }, {
     "idx" : 7,
     "target" : "dvisitor"
   }],
   "period" : {
     "from" : "01/03/2023",
     "to" : "31/03/2023",
     "scale" : "D"
   }
}
Fichier CSV contenant la donnée à importer :
Nom
Visites
Actions
Nombre maximum d'actions en une visite
Temps total passé par les visiteurs (en secondes)
Rebonds
Visites avec conversions
Visiteurs uniques (résumé quotidien)
Utilisateurs (résumé quotidien)
MonSite
439216
818178
300
39214621
317335
0
403838
0
URL d'appel pour importer ces données :
curl -F "meta-data=@website.json" -F "file-name=@website.csv" https://$URL_API/ea/v2/$TOKEN_API_EPC/epc/$SITE/analyticsimport/website.json

Données au niveau pages

Les métriques suivantes :
  • pages vues : hit
  • temps passée : duration - il doit être fourni en secondes
  • visites : visit
  • visites entrantes : visitin
  • visites sortants : visitout
  • visites a une page : visitone
Exemple de format d'import :
  "skipHeader" : true,
  "kind" : "pagetree",
  "dimensions" : [{
     "idx" : 0,
     "target": "pageinfo_name"
  }],
  "metrics" : [{
     "idx" : 2,
     "target" : "hit"
   }, {
     "idx" : 3,
     "target" : "duration"
   }, {
     "idx" : 22,
     "target" : "visitin"
   }, {
     "idx" : 25,
     "target" : "visitone"
   }, {
     "idx" : 26,
     "target" : "visitout"
   }],
   "period" : {
     "from" : "01/03/2023",
     "to" : "31/03/2023",
     "scale" : "D"
   }
}
Fichier CSV contenant la donnée à importer :
Nom
Vues de page uniques
Vues de page
Temps total passé par les visiteurs (en secondes)
nb_hits_with_time_network
min_time_network
max_time_network
nb_hits_with_time_server
min_time_server
max_time_server
nb_hits_with_time_transfer
min_time_transfer
max_time_transfer
nb_hits_with_time_dom_processing
min_time_dom_processing
max_time_dom_processing
nb_hits_with_time_dom_completion
min_time_dom_completion
max_time_dom_completion
nb_hits_with_time_on_load
min_time_on_load
max_time_on_load
Entrées
Actions après être entré ici
Temps total passé par les visiteurs (en secondes) après être entré ici
Rebonds
Sorties
Visiteurs uniques (résumé quotidien)
Entrées uniques (résumé quotidien)
Sorties uniques (résumé quotidien)
Temps moyen de connexion
Moy. heure du serveur
Moy. temps de transfert
Temps moyen de traitement du DOM
Temps moyen de génération du DOM
Moy. au temps de chargement
Temps de chargement moyen
Temps moyen sur la page
Taux de rebond
Taux de sortie
Méta-données: segment
Cliqué dans les résultats de recherche
Homepage
100651
119493
4343012
116206
0
1289.613
116217
0
1460.591
116220
0
604.561
116143
0.757
9743.714
388
1.014
54.823
353
0.085
1.236
76674
123083
4355771
57586
79539
87678
67301
69116
0.135
0.21
0.064
1.093
0.263
0.012
1.777
36
75 %
79 %
pageTitle==tata
Bienvenu-sur-notre-sitre
78120
101083
3898685
100632
0
5608.867
100622
0
882.9
100642
0
481.358
100517
0.184
11014.492
3367
0.175
694.053
3227
0.036
3.626
68162
167686
7805427
36363
50701
72280
61857
47658
0.221
0.206
0.078
1.233
0.538
0.013
2.289
39
53 %
65 %
pageTitle==test
URL d'appel pour importer ces données :
curl -F "meta-data=@pagetree.json" -F "file-name=@pagetree.csv" https://$URL_API/ea/v2/$TOKEN_API_EPC/epc/$SITE/analyticsimport/pagetree.json
L'URL de la page peut aussi être fournie dans une autre dimension dénommée pageinfo_url.
Exemple :
{
  "skipHeader" : true,
  "kind" : "pagetree",
  "dimensions" : [{
     "idx" : 0,
     "target": "pageinfo_name"
  }, {
     "idx" : 1,
     "target" : "pageinfo_url"
  }],
  "metrics" : [{
     "idx" : 2,
     "target" : "hit"
   }, {
     "idx" : 3,
     "target" : "duration"
   }, {
     "idx" : 22,
     "target" : "visitin"
   }, {
     "idx" : 25,
     "target" : "visitone"
   }, {
     "idx" : 26,
     "target" : "visitout"
   }],
   "period" : {
     "from" : "01/03/2023",
     "to" : "31/03/2023",
     "scale" : "D"
   }
}

Données au niveau des moteurs de recherche

Les métriques suivantes :
  • temps passée : duration - il doit être fourni en secondes
  • visites : visit
  • visiteurs uniques journaliers : dvisitor
  • ventes : scartvalid
  • CA ventes : scartvalidamount
  • devis : estimatevalid
  • CA devis : estimatevalidamount
  • paniers commencés : scart
Exemple de format d'import :
{
  "skipHeader" : true,
  "kind" : "searchengine",
  "dimensions" : [{
     "idx" : 0,
     "target": "searchengine_name"
  }],
  "metrics" : [{
     "idx" : 1,
     "target" : "visit"
   }, {
     "idx" : 4,
     "target" : "duration"
   }, {
     "idx" : 7,
     "target" : "dvisitor"
   }],
   "period" : {
     "from" : "01/03/2023",
     "to" : "31/03/2023",
     "scale" : "D"
   }
}
Fichier CSV contenant la donnée à importer :
Nom
Visites
Actions
Nombre maximum d'actions en une visite
Temps total passé par les visiteurs (en secondes)
Rebonds
Visites avec conversions
Visiteurs uniques (résumé quotidien)
Utilisateurs (résumé quotidien)
Méta-données: segment
Méta-données: url
Méta-données: logo
Google
385590
684329
300
33213892
287085
0
358242
0
referrerType==search;referrerName==Google
 http://google.com 
plugins/Morpheus/icons/dist/searchEngines/google.com.png
Bing
12835
31047
128
1671124
8290
0
12060
0
referrerType==search;referrerName==Bing
 http://bing.com 
plugins/Morpheus/icons/dist/searchEngines/bing.com.png
URL d'appel pour importer ces données :
curl -F "meta-data=@searchengine.json" -F "file-name=@searchengine.csv" https://$URL_API/ea/v2/$TOKEN_API_EPC/epc/$SITE/analyticsimport/searchengine.json

Données au niveau des sites affluents (référants)

Les métriques suivantes :
  • temps passée : duration - il doit être fourni en secondes
  • visites : visit
  • visiteurs uniques journaliers : dvisitor
  • ventes : scartvalid
  • CA ventes : scartvalidamount
  • devis : estimatevalid
  • CA devis : estimatevalidamount
  • paniers commencés : scart
Exemple de format d'import
{
  "skipHeader" : true,
  "kind" : "refererdomain",
  "dimensions" : [{
     "idx" : 0,
     "target": "refererdomain_name"
  }],
  "metrics" : [{
     "idx" : 1,
     "target" : "visit"
   }, {
     "idx" : 4,
     "target" : "duration"
   }, {
     "idx" : 7,
     "target" : "dvisitor"
   }],
   "period" : {
     "from" : "01/03/2023",
     "to" : "31/03/2023",
     "scale" : "D"
   }
}
Fichier CSV contenant la donnée à importer :
Nom
Visites
Actions
Nombre maximum d'actions en une visite
Temps total passé par les visiteurs (en secondes)
Rebonds
Visites avec conversions
Visiteurs uniques (résumé quotidien)
Utilisateurs (résumé quotidien)
Méta-données: segment
 www.francetvinfo.fr 
394
1765
71
38473
276
0
382
0
referrerName== www.francetvinfo.fr 
 www.oneplanetsummit.fr 
376
758
13
61846
203
0
353
0
referrerName== www.oneplanetsummit.fr 
 fr.wikipedia.org 
371
1397
53
69163
213
0
365
0
 referrerName==fr.wikipedia.org 
URL d'appel pour importer ces données :
curl -F "meta-data=@refererdomain.json" -F "file-name=@refererdomain.csv" https://$URL_API/ea/v2/$TOKEN_API_EPC/epc/$SITE/analyticsimport/refererdomain.json

Données au niveau des sources d'acquisition payantes

Les métriques suivantes :
  • temps passée : duration - il doit être fourni en secondes
  • visites : visit
  • visiteurs uniques journaliers : dvisitor
  • ventes : scartvalid
  • CA ventes : scartvalidamount
  • devis : estimatevalid
  • CA devis : estimatevalidamount
  • paniers commencés : scart
Valeures autorisées pour media_key :
  • MAILING : emailing
  • ADVERTISING : display
  • AFFILIATION : affiliation
  • SPONSOREDLINK : SEA
  • PARTNER : partenariat
  • TRUSTEDFEED : comparateurs de prix
  • OFFLINE : offline / broadcast / TV
  • GENERIC : générique
Exemple de format d'import :
{
  "skipHeader" : true,
  "kind" : "opedata",
  "dimensions" : [{
     "idx" : 0,
     "target": "media_key"
  }, {
     "idx" : 1,
     "target" : "publisher_name"
  }, {
     "idx" : 2,
     "target" : "ope_name"
  }],
  "metrics" : [{
     "idx" : 3,
     "target" : "visit"
   }, {
     "idx" : 4,
     "target" : "duration"
   }, {
     "idx" : 5,
     "target" : "dvisitor"
   }],
   "period" : {
     "from" : "01/03/2023",
     "to" : "31/03/2023",
     "scale" : "D"
   }
}
Fichier CSV contenant la donnée à importer :
Levier
Support
Campagne
Visites
Temps passé (en secondes)
Visiteurs uniques (résumé quotidien)
ADVERTISING
Google
Google-Display
9654
665332
58
AFFILIATION
AWin
awin
548
98
6
URL d'appel pour importer ces données :
curl -F "meta-data=@media.json" -F "file-name=@media.csv" https://$URL_API/ea/v2/$TOKEN_API_EPC/epc/$SITE/analyticsimport/opedata.json

Données au niveau des pays

Les métriques suivantes :
  • temps passée : duration - il doit être fourni en secondes
  • visites : visit
  • visiteurs uniques journaliers : dvisitor
  • ventes : scartvalid
  • CA ventes : scartvalidamount
  • devis : estimatevalid
  • CA devis : estimatevalidamount
  • paniers commencés : scart
Exemple de format d'import :
{
  "skipHeader" : true,
  "kind" : "geoloccountry",
  "dimensions" : [{
     "idx" : 9,
     "target": "geoloccountry_isocode"
  }],
  "metrics" : [{
     "idx" : 1,
     "target" : "visit"
   }, {
     "idx" : 4,
     "target" : "duration"
   }, {
     "idx" : 7,
     "target" : "dvisitor"
   }],
   "period" : {
     "from" : "01/03/2023",
     "to" : "31/03/2023",
     "scale" : "D"
   }
}
Fichier CSV contenant la donnée à importer :
Nom
Visites
Actions
Nombre maximum d'actions en une visite
Temps total passé par les visiteurs (en secondes)
Rebonds
Visites avec conversions
Visiteurs uniques (résumé quotidien)
Utilisateurs (résumé quotidien)
Méta-données: code
Méta-données: logo
Méta-données: segment
Méta-données: logoHeight
France
439216
818178
300
39214621
317335
0
403838
0
fr
plugins/Morpheus/icons/dist/flags/fr.png
countryCode==fr
16
États-Unis
22276
35735
115
3022018
17095
0
21092
0
us
plugins/Morpheus/icons/dist/flags/us.png
countryCode==us
16
URL d'appel pour importer ces données :
curl -F "meta-data=@geoloccountry.json" -F "file-name=@geoloccountry.csv" https://$URL_API/ea/v2/$TOKEN_API_EPC/epc/$SITE/analyticsimport/geoloccountry.json

Checklist avant import

Avant de lancer un réimport, vérifiez que :
  • le fichier CSV contient les colonnes attendues ;
  • le fichier JSON référence les bons index de colonnes ;
  • la période d'import est correctement définie ;
  • le type d'import correspond à la typologie de données envoyée ;
  • les valeurs déjà importées peuvent être remplacées si un nouvel import est lancé sur les mêmes lignes.