[daf 2015] atelier api at internet
TRANSCRIPT
![Page 1: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/1.jpg)
L’API d’AT Internet
![Page 2: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/2.jpg)
OBJECTIF
2
Optimiser l’utilisation de l’API et la performance des
appels via les bonnes pratiques
Sandrine LAFON – Julien SOULARD – Mathieu DESCHAMPS
![Page 3: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/3.jpg)
INTRODUCTION
3
DÉFINITION DE L’API
Les solutions AT Internet sont basées sur la collecte d’un grand
nombre de données.
Nos API vous permettent de récupérer une partie ou la totalité des
informations pour une intégration automatique dans un autre système
de stockage ou de traitement, qu’il soit directement dans votre
système ou chez un prestataire externe.
![Page 4: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/4.jpg)
INTRODUCTION
4
QUELQUES CHIFFRES
100 000 000 d’appels API sur les 6 derniers mois
6 600 utilisateurs Data Query
30 000 templates Data Query
20 000 segments
8 000 Custom Metrics
5 000 demandes de pré-calculs le 1er mois du lancement (avril)
Sur les 30 derniers jours, 80% des appels API répondent en moins de
500ms
![Page 5: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/5.jpg)
INTRODUCTION
5
LES FORMATS D’EXPORT
Format d’export direct :
https://apirest.atinternet-solutions.com/data/v2/getData?querystring
Querystring : paramètres pour définir les données à récupérer et le
périmètre
3 formats : xml, json et html
Format d’export IQY :
https://apirest.atinternet-solutions.com/iqy/v2/getData?querystring
Connecteur IQY : Possibilité de construire ses tableaux de bord dans
Excel
Export CSV
![Page 6: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/6.jpg)
INTRODUCTION
6
LIMITES
Nombre d’appels :
Appels à l’API Rest illimités : pas de limitation en quantité d’appels
Le nombre d’appels en simultané est bridé par utilisateur
Pour chaque utilisateur : 5 créneaux attribués
Périodes d’analyse :
Anciennement limité à 45 jours
Aujourd’hui : Limite étendue à 6 mois
![Page 7: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/7.jpg)
INTRODUCTION
7
PARAMÈTRES
Obligatoires :
![Page 8: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/8.jpg)
INTRODUCTION
8
PARAMÈTRES
Facultatifs :
![Page 9: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/9.jpg)
AGENDA
9
Règles de base
Tips Excel et dynamisation du fichier IQY
![Page 10: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/10.jpg)
RÈGLES DE BASE
ENREGISTRER VOS TEMPLATES LES DONNÉES SONT MISES EN CACHE ET PRÉ CALCULÉES CHAQUE NUIT
10
![Page 11: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/11.jpg)
RÈGLES DE BASE
LANCER LE MÊME APPEL AU MOINS QUATRE FOIS NOUS DÉTECTONS QUE CET APPEL À ÉTÉ FAIT RÉGULIÈREMENT, ET
ACTIVONS ALORS LA MISE EN CACHE.
11
La date appelée n’a pas d’importance.
![Page 12: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/12.jpg)
RÈGLES DE BASE
12
SI VOS APPELS API DOIVENT SE FAIRE SUR J-1 LANCER LES APPELS À PARTIR DE 8H POUR BÉNÉFICIER DU SYSTÈME DE
DONNÉES PRÉCALCULÉES
![Page 13: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/13.jpg)
13
MULTI APPELS LANCER TOUS VOS APPELS EN SERIE, PLUTÔT QU’EN PARALLELE (LIMITE DE
5 APPELS SIMULTANES)
RÈGLES DE BASE
Cette manipulation permet également l’utilisation de Tableau Croisés
Dynamiques dans Excel après des appels API (sinon le TCD se mettra à
jour avant que les requêtes ne soient chargées)
![Page 14: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/14.jpg)
FILTRES
FAVORISER LES FILTRES “EGAL A” OU “COMMENCE PAR” PAR RAPPORT A “CONTIENT”
NE PAS OUBLIER D’UTILISER “VIDE” OU “N’EST PAS VIDE”
14
RÈGLES DE BASE
![Page 15: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/15.jpg)
IDENTIFIER LES REQUÊTES LOURDES VIA DES
OUTILS COMME FIDDLER FILTRER SUR APIREST
15
RÈGLES DE BASE
![Page 16: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/16.jpg)
TIRER PROFIT DES DEMANDES DE PRÉ CALCUL LA SOLUTION POUR AVOIR DES DONNÉES SUR PLUS DE 45 JOURS
16
RÈGLES DE BASE
![Page 17: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/17.jpg)
TIRER PROFIT DES DEMANDES DE PRÉ CALCUL LA SOLUTION POUR AVOIR DES DONNÉES SUR PLUS DE 45 JOURS
17
RÈGLES DE BASE
![Page 18: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/18.jpg)
LIMITE DES 10 000 LIGNES : EST IL POSSIBLE D’EXPLOITER CES RÉSULTATS AU FORMAT
CSV ?
18
La limite passe à 100 000 lignes pour un export CSV.
RÈGLES DE BASE
![Page 19: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/19.jpg)
LIMITE DES 10 000 LIGNES : UTILISER GETROWCOUNT ET NUM-PAGE POUR FAIRE LE
BON NOMBRE D’APPELS
19
Get Row count: Cet appel permet de savoir combien de requêtes
API seront nécessaires si l’on souhaite afficher l’intégralité des
données
Le paramètre &page-num permet d’afficher les résultats par tranche
de 10 000. Par exemple, &page-num=3 affichera les résultats de 20
001 à 30 000.
On peut ainsi programmer autant d’appels que nécessaires
RÈGLES DE BASE
![Page 20: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/20.jpg)
20
FAIRE DES APPELS SUR DES GROUPES
DE SITE PLUTÔT QUE SUR CHAQUE SITE
Lorsque c’est possible, il est préférable d’utiliser une seule requête
regroupant plusieurs sites, plutôt que plusieurs requêtes. Les templates
multi-site peuvent vous y aider.
RÈGLES DE BASE
![Page 21: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/21.jpg)
TIPSLIMITER LE NOMBRE D’APPELS API EN
PASSANT PAR DES MÉTRIQUES
PERSONNALISÉES
21
EXEMPLE: Vous souhaitez suivre la performance d’un tunnel de conversion. Vous
avez crée quatre requêtes dans DataQuery:
DATE | PAGE (FILTRE 1_Page_Panier) + VISITES
DATE | PAGE (FILTRE 2_Page_Adresse_livraison) + VISITES
DATE | PAGE (FILTRE 3_Page_paiement) + VISITES
DATE | PAGE (FILTRE 4_Page_Confirmation) + VISITES
En créant quatre métriques personnalisées, on rassemble ces quatres étapes dans
un seul template Data Query :
DATE | CM(1_Page_Panier) | CM(2_Page_Adresse_livraison) |
CM(3_Page_paiement) | CM(4_Page_Confirmation)
On réalise un seul appel au lieu de quatre, ce qui permet d’améliorer le temps de
réponse.
![Page 22: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/22.jpg)
POUR LES APPELS EN TEMPS RÉEL : EST IL
NÉCESSAIRE D’APPELER LA JOURNÉE
ENTIÈRE ?
22
&period={R:{D:'0'}}
Cet appel donne les données depuis le début de la journée
&period=p1:{R:{H:0}}Cet appel donne les données de l’heure en cours (11:00 11:43)
&period=p1:{R:{H:-1}}
Cet appel donne les données de l’heure précédente(11:00 11:59)
Ces parametres ne sont accessible que en construisant vos requetes “à la main”Vous pouvez les retrouver dans le guide utilisateur DataQuery.
TIPS
![Page 23: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/23.jpg)
23
- Unique visitor ID (Unique visitors)- Visitor ID (Identified visitors)- Visitor ID (text) (Identified visitors)- Visits ID (Visits)- Page position (Pages)- Status (Orders)- Multi-channel campaigns (Traffic sources)- Minutes (start of visit) (Time)- Second (start of visit) (Time)- Minutes (event) (Time)- Second (event) (Time)
Attention : Certaines dimensions sont toujours limitées à 45
jours :
Si vous avez un besoin particulier sur ces dimensions, vous pouvez vousrapprocher de l’équipe de consultant AT Internet pour voir les solutions envisageables
TIPS
![Page 24: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/24.jpg)
SEGMENTS > PRÉFÉRER LA SÉLECTION
D’UN ÉLÉMENT PLUTÔT QU’UN CONTIENT.
24
Il est souvent possible d’optimiser le temps de réponse des
segments de cette façon.
TIPS
![Page 25: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/25.jpg)
AGENDA
26
Règles de base
Tips Excel et dynamisation du fichier IQY
![Page 26: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/26.jpg)
RENDRE LE TABLEAU PLUS USER
FRIENDLY
FORMAT DE LA DATE
27
Utiliser la fonction excel « Texte » pour reformater la date.
Data Query impose le format AAAA-MM-JJ.
Faire reference à la cellule avec la date au format JJ/MM/AAAA
=texte(Cellule; »AAAA-MM-JJ »)
Ceci permet egalement de faire des modifications sur la date plus
facilement (=B1-7 pour avoir la comparaison a 7 jours par exemple)
![Page 27: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/27.jpg)
UTILISER UNE MACRO POUR
SIMPLIFIER L’ACTUALISATION
28
La macro d’actualisation permet de rendre les tableaux de bords
accessible à absolument tout le monde, dès la première
utilisation.
![Page 28: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/28.jpg)
DYNAMISER LE FICHIER IQY
DÉMONSTRATION
29
![Page 29: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/29.jpg)
DYNAMISER LE FICHIER IQY
AVANTAGES
30
- Gain de temps
- Facile à maintenir
- Permet la dynamisation du site
- Permet la dynamisation de segment / filtre
![Page 30: [DAF 2015] Atelier API AT internet](https://reader033.vdocuments.site/reader033/viewer/2022052602/55b7e3cdbb61eb27198b4660/html5/thumbnails/30.jpg)
WWW.ATINTERNET.COM
LET’S TALK DATA!
[email protected] – [email protected]
Julien SOULARD – Mathieu DESCHAMPS