1. WEBINAR
INNOVATIONS 2014 / API V2 - DATA QUERY 2
Juillet 2014
Mélanie CLAISSE – Chef de produit
Clémence NOIZAT-TALLON – Chef de produit

2. SOMMAIRE
I. Introduction
II. Nouveautés
III. Transition vers la nouvelle version
IV. Questions et réponses

3. I. INTRODUCTION
CONTEXTE
- Enorme volume de données :
“databesity”
- Difficulté pour trouver la bonne
information au bon endroit.
- Construire facilement des reportings ;
les automatiser et les personnaliser.
- Partager les données et les
communiquer

4. I. INTRODUCTION
LE SUCCES DE L’API V1
- 80 000 000 appels en un an
(en moyenne)
- 2 600 utilisateurs Data Query
- 15 000 templates Data Query
- ... et tellement d’autres !

5. I. INTRODUCTION
POURQUOI UNE NOUVELLE API?
- Plus rapide et plus puissante
- Flexibilité
- Simplicité d’utilisation
- Evolution : 20 nouveautés
- Une nouvelle interface Data Query

6. I. INTRODUCTION
DATA QUERY 2
Explorer les nouvelles fonctionnalités de l’API
Garantir une expérience utilisateur optimale
Un nouvel espace de travail

7. 1) NOUVEAU CALENDRIER
II. NOUVEAUTÉS
- Un nouveau calendrier, entièrement refondu d’un point de vue
ergonomique.
- Périodes relatives
Périodes relatives prédéfinies et personnalisées, incluant le temps réel
Simplification des appels sur des périodes régulières
Gain de temps : automatisation des exports facilitée
Exemple
- Périodes multiples

8. 1) NOUVEAU CALENDRIER
Périodes multiples
Exemple : identifier les performances commerciales entre deux périodes
1e semaine de juin vs 1e semaine de juillet
Samedi 14, 21 et 28 juin
Du 1er au 15 juin vs du 1er au 15 juillet
II. NOUVEAUTÉS

9. 1) NOUVEAU CALENDRIER
Produits Commandes
(25 mai – 25 juin)
Visites Commandes
(25 mai – 25 juin)
Visites
TV 123 2 398 32 090 4 535 45 312
Tablette YX 1 873 24 350 2 435 25 644
Smartphone Z 2 109 18 724 4 356 24 320
Accessoire ER 874 5 643 988 4 532
II. NOUVEAUTÉS
Périodes multiples
Exemple : identifier les performances commerciales entre deux périodes

10. 1) NOUVEAU CALENDRIER
Produits Commandes
(25 mai – 25 juin)
Visites Commandes
(25 mai – 25 juin)
Visites
TV 123 2 398 32 090 4 535 45 312
Tablet YX 1 873 24 350 2 435 25 644
Smartphone Z 2 109 18 724 4 356 24 320
Accessory ER 874 5 643 988 4 532
Avec l’API 1: 1 appel par période + besoin de consolider les produits
II. NOUVEAUTÉS
Périodes multiples
Exemple : identifier les performances commerciales entre deux périodes

11. Produits Commandes
(25 mai – 25 juin)
Visites Commandes
(25 mai – 25 juin)
Visites
TV 123 2 398 32 090 4 535 45 312
Tablet YX 1 873 24 350 2 435 25 644
Smartphone Z 2 109 18 724 4 356 24 320
Accessory ER 874 5 643 988 4 532
1) NOUVEAU CALENDRIER
Avec l’API 2: un appel pour l’ensemble de la table de données,
et la consolidation est déjà faite.
II. NOUVEAUTÉS
Périodes multiples
Exemple : identifier les performances commerciales entre deux périodes

12. 1) NOUVEAU CALENDRIER
- Jusqu’à 3 périodes
- P1 sert de référence aux deux autres périodes -> P1 est obligatoire
- Les filtres et les tris s’effectuent sur P1
- 1 dimension seulement par requête (en progrès)
- 100 lignes par jeu de résultat
- 1 période ne peut contenir qu’une seule fois le même métrique
Périodes multiples
Champ d’application fonctionnel du paramètre multi périodes dans l’API :
II. NOUVEAUTÉS

13. Exemple : suivre l’évolution des ventes sur le dernier mois
Evolution des visites jour après jour sur la période
Evolution heure par heure des visites du jour, etc.
2) EVOLUTION
II. NOUVEAUTÉS

14. Champ d’application fonctionnel du mode EVO dans l’API :
- 1 dimension autorisée par appel
- Le mode EVO ne s’applique pas aux périodes multiples
- Nombre maximum de métriques dans le jeu de données = 30
2) EVOLUTION
II. NOUVEAUTÉS

15. Comparaison entre métriques sur des périodes différentes
(variation en %, différence en valeur)
Exemple : comparer les ventes par produit entre deux périodes.
3) VARIATION ET DIFFERENCE
II. NOUVEAUTÉS

16. - Sélectionner au moins 2 métriques
- Le mode Evolution doit être désactivé
Champ d’application fonctionnel du mode VAR / DIF dans l’API :
3) VARIATION ET DIFFERENCE
II. NOUVEAUTÉS

17. Total “Displayed” : total des métriques du jeu de résultats en retour (page
de résultats uniquement).
Total “Référence” : total des métriques du site de référence (bientôt
disponible).
Exemple : obtenir la part des 20 meilleures produits vendus.
4) LIGNE TOTAL
II. NOUVEAUTÉS

18. Champ d’application fonctionnel du paramètre Ratio dans l’API :
- Activer l’affichage du total
5) RATIO
II. NOUVEAUTÉS

19. 6) META DATA
Le paramètre Context transfère les informations des méta data dans le
champ de d’application de l’appel.
Context pour Space: label, currency, time zone, etc.
Context pour Periods: period labels, list of dates
Context pour Ranges: information linked to the result pagination (ex: Next URL)
Context pour Profile: language, first day of week
II. NOUVEAUTÉS

20. 7) FILTRES ET TRIS
De nombreux nouveaux filtres :
“Ne contient pas”
“Ne commence pas par”
“Ne se termine pas par”
“Egal à la valeur 1 ou à la valeur 2”
“Est différent de la valeur 1 ou de la valeur 2”
“Contient la valeur 1 ou la valeur 2”
“Ne contient pas les valeurs 1 ou 2”
“Contient le mot 1 ou le mot 2”
+ ajout du multi filtre
Exemple : isoler les produits dont l’intitulé contient les mots “Sony” OU
“Samsung” et qui ont généré un chiffre d’affaires >6 000€
II. NOUVEAUTÉS

21. 8) RÉSULTAT MAXIMUM
Avec le paramètre Résultat maximum, possibilité de définir le nombre de
lignes nécessaires dans le jeu de résultat.
Par défaut le Résultat maximum est 20.
Possibilité de modifier le paramètre Résultat maximum.
Valeur comprise entre 1 et 10 000.
Si plus de 10 000 lignes sont nécessaires, il faut faire une pagination
-> utiliser les Méta Data
II. NOUVEAUTÉS

22. 9) FORMAT DE SORTIE
Le format de sortie n’est plus à indiquer dans l’URL. Il sera intégré
directement dans l’entête de l’appel API.
Accept: application/json
Accept: application/xml
Accept: application/html
Format par défaut : json
II. NOUVEAUTÉS

23. 10) FOCUS SUR LES QUOTAS
Objectif : protéger nos infrastructures et fournir une qualité de service
unifiée pour tous nos utilisateurs.
- Pas de limitation du nombre d’appels API.
- Mais une limitation du nombre d’appels simultanés.
- 5 slots par utilisateur.
- Possibilité d’obtenir un compte Premium.
II. NOUVEAUTÉS

24. III. TRANSITION VERS LA NOUVELLE VERSION
UNE NOUVELLE API, UN NOUVEL ENVIRONNEMENT DE TRAVAIL
https://apirest.atinternet-solutions.com/data/v2/getData?querystring

25. LA TRANSITION
2 “écosystèmes” Data Query :
La v1 est toujours accessible depuis le DWS 2
La v2 est accessible depuis le nouvel environnement de travail
Les métriques personnalisés et les segments sont les mêmes sur les deux
applications.
Les templates de DQ v1 peuvent être importés dans DQ v2
Attention : une fois les templates importés dans DQv2, ils ne sont plus
accessibles dans DQv1.
La première version de l’API v1 fonctionne toujours.
III. TRANSITION VERS LA NOUVELLE VERSION

26. IV. QUESTIONS & RÉPONSES

27. atcontact@atinternet.com
www.atinternet.com