L’API d’AT Internet

OBJECTIF

2

Optimiser l’utilisation de l’API et la performance des

appels via les bonnes pratiques

Sandrine LAFON – Julien SOULARD – Mathieu DESCHAMPS

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.

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

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

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

INTRODUCTION

7

PARAMÈTRES

Obligatoires :

INTRODUCTION

8

PARAMÈTRES

Facultatifs :

AGENDA

9

Règles de base

Tips Excel et dynamisation du fichier IQY

RÈGLES DE BASE

ENREGISTRER VOS TEMPLATES LES DONNÉES SONT MISES EN CACHE ET PRÉ CALCULÉES CHAQUE NUIT

10

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.

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

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)

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

IDENTIFIER LES REQUÊTES LOURDES VIA DES

OUTILS COMME FIDDLER FILTRER SUR APIREST

15

RÈGLES DE BASE

TIRER PROFIT DES DEMANDES DE PRÉ CALCUL LA SOLUTION POUR AVOIR DES DONNÉES SUR PLUS DE 45 JOURS

16

RÈGLES DE BASE

TIRER PROFIT DES DEMANDES DE PRÉ CALCUL LA SOLUTION POUR AVOIR DES DONNÉES SUR PLUS DE 45 JOURS

17

RÈGLES DE BASE

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

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

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

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.

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

- 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

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

AGENDA

26

Règles de base

Tips Excel et dynamisation du fichier IQY

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)

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.

DYNAMISER LE FICHIER IQY

DÉMONSTRATION

29

DYNAMISER LE FICHIER IQY

AVANTAGES

30

- Gain de temps

- Facile à maintenir

- Permet la dynamisation du site

- Permet la dynamisation de segment / filtre

WWW.ATINTERNET.COM

LET’S TALK DATA!

Julien.soulard@atinternet.com – mathieu.deschamps@atinternet.com

Julien SOULARD – Mathieu DESCHAMPS