Atelier animé par Julien Soulard et Mathieu Deschamps, consultants AT Internet lors du Digital Analytics Forum du jeudi 11 juin 2015 à Paris. Les consultants AT Internet vous délivrent leurs bonnes pratiques pour optimiser votre utilisation de l’API et la performance de vos appels. Découvrez par exemple comment obtenir de meilleurs temps de réponse selon vos filtres, périodes, etc. et ainsi mettre l’information en circulation de manière efficace et adaptée à son contexte d’utilisation.

1. L’API d’AT Internet

2. OBJECTIF
2
Optimiser l’utilisation de l’API et la performance des
appels via les bonnes pratiques
Sandrine LAFON – Julien SOULARD – Mathieu DESCHAMPS

3. 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.

4. 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

5. 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

6. 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

7. INTRODUCTION
7
PARAMÈTRES
Obligatoires :

8. INTRODUCTION
8
PARAMÈTRES
Facultatifs :

9. AGENDA
9
Règles de base
Tips Excel et dynamisation du fichier IQY

10. RÈGLES DE BASE
ENREGISTRER VOS TEMPLATES
 LES DONNÉES SONT MISES EN CACHE ET PRÉ CALCULÉES CHAQUE NUIT
10

11. 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.

12. 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

13. 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)

14. 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

15. IDENTIFIER LES REQUÊTES LOURDES VIA DES
OUTILS COMME FIDDLER
 FILTRER SUR APIREST
15
RÈGLES DE BASE

16. TIRER PROFIT DES DEMANDES DE PRÉ CALCUL
 LA SOLUTION POUR AVOIR DES DONNÉES SUR PLUS DE 45 JOURS
16
RÈGLES DE BASE

17. TIRER PROFIT DES DEMANDES DE PRÉ CALCUL
 LA SOLUTION POUR AVOIR DES DONNÉES SUR PLUS DE 45 JOURS
17
RÈGLES DE BASE

18. 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

19. 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

20. 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

21. TIPS
LIMITER 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.

22. 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

23. 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 vous
rapprocher de l’équipe de consultant AT Internet pour voir les solutions
envisageables
TIPS

24. 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

25. AGENDA
26
Règles de base
Tips Excel et dynamisation du fichier IQY

26. 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)

27. 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.

28. DYNAMISER LE FICHIER IQY
DÉMONSTRATION
29

29. DYNAMISER LE FICHIER IQY
AVANTAGES
30
- Gain de temps
- Facile à maintenir
- Permet la dynamisation du site
- Permet la dynamisation de segment / filtre

30. WWW.ATINTERNET.COM
LET’S TALK DATA!
Julien.soulard@atinternet.com – mathieu.deschamps@atinternet.com
Julien SOULARD – Mathieu DESCHAMPS