[DAF 2015] Atelier API AT internet

1 130 vues

Publié le

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.

Publié dans : Données & analyses
0 commentaire
1 j’aime
Statistiques
Remarques
  • Soyez le premier à commenter

Aucun téléchargement
Vues
Nombre de vues
1 130
Sur SlideShare
0
Issues des intégrations
0
Intégrations
417
Actions
Partages
0
Téléchargements
11
Commentaires
0
J’aime
1
Intégrations 0
Aucune incorporation

Aucune remarque pour cette diapositive

[DAF 2015] Atelier API AT internet

  1. 1. L’API d’AT Internet
  2. 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. 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. 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. 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. 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. 7. INTRODUCTION 7 PARAMÈTRES Obligatoires :
  8. 8. INTRODUCTION 8 PARAMÈTRES Facultatifs :
  9. 9. AGENDA 9 Règles de base Tips Excel et dynamisation du fichier IQY
  10. 10. RÈGLES DE BASE ENREGISTRER VOS TEMPLATES  LES DONNÉES SONT MISES EN CACHE ET PRÉ CALCULÉES CHAQUE NUIT 10
  11. 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. 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. 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. 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. 15. IDENTIFIER LES REQUÊTES LOURDES VIA DES OUTILS COMME FIDDLER  FILTRER SUR APIREST 15 RÈGLES DE BASE
  16. 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. 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. 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. 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. 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. 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. 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. 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. 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. 25. AGENDA 26 Règles de base Tips Excel et dynamisation du fichier IQY
  26. 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. 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. 28. DYNAMISER LE FICHIER IQY DÉMONSTRATION 29
  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. 30. WWW.ATINTERNET.COM LET’S TALK DATA! Julien.soulard@atinternet.com – mathieu.deschamps@atinternet.com Julien SOULARD – Mathieu DESCHAMPS

×