WEBINAR INNOVATIONS 2014 / API V2 - DATA QUERY 2 July 2014 Mélanie CLAISSE - Product Manager Clémence NOIZAT-TALLON - Product Manager
Jan 14, 2015
WEBINARINNOVATIONS 2014 / API V2 - DATA QUERY 2
July 2014
Mélanie CLAISSE - Product Manager
Clémence NOIZAT-TALLON - Product Manager
TABLE OF CONTENTS
I. Introduction
II. New features
III. Transition to the new version
IV. Q&A
I. INTRODUCTIONCONTEXT
- Databesity: a huge volume of data
- Difficulty to find the right information
at the right time
- To build easily, to automatize and
to custom reportings
- To share and to communicate data
I. INTRODUCTIONTHE API 1 SUCCESS
- 80 000 000 calls in one year
(average)
- 2 600 users Data Query
- 15 000 templates Data Query
- ... and counting!
I. INTRODUCTIONWHY A NEW API?
- Faster and more powerful
- Flexibily
- Simplicity
- Evolution: 20 new features
- A new interface Data Query
I. INTRODUCTIONDATA QUERY 2
Exploring all the API new functionalities
Insuring an optimal user experience
A new environment, a new workspace
1) NEW CALENDAR
II. NEW FEATURES
- A new calendar, entirely remade from the ergonomic point of view
- Relative periods
Pre-defined & custom periods, including real time
Simplification of calls on regular periods
Saving time: exports automation is easier
Example
- Multi-periods
1) NEW CALENDAR
II. NEW FEATURES
Multi periods
Example: to identify the sales performances of 2 different periods
1st week of June & 1st week of July
Saturday June 14th, 21st and 28th
From the 1st to the 15th of June and July…
1) NEW CALENDAR
II. NEW FEATURES
Product Orders(May 25 - June 25)
Visits Orders(June 25 – July 25)
Visits
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
Multi periods
Example: to identify the sales performances of 2 different periods
1) NEW CALENDAR
II. NEW FEATURES
Product Orders(May 25 - June 25)
Visits Orders(June 25 – July 25)
Visits
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
With the API 1: 1 call per period and necessity to consolidate the products
Multi periods
Example: to identify the sales performances of 2 different periods
1) NEW CALENDAR
II. NEW FEATURES
Product Orders(May 25 - June 25)
Visits Orders(June 25 – July 25)
Visits
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
With the API 2: 1 call for all the table, product consolidation is already done
Multi periods
Example: to identify the sales performances of 2 different periods
1) NEW CALENDAR
- Up to 3 periods
- P1 is the reference to the other ones
- Filters and sorts on P1
- 1 dimension per call (in progress)
- 100 lines per dataset
- 1 period can only contain once the same metric
II. NEW FEATURES
Multi periods
Functional scope of the multiple periods parameters in the API:
Example: to follow the evolution of sales per products during the running month
II. NEW FEATURES
Evolution of visits day by day on the period
Evolution hour by hour of the visits of the day, etc.
2) EVOLUTION
Functional scope of the EVO mode in the API:
- 1 dimension per call
- The EVO mode can’t be applied to multiple periods
- Maximum number of metrics in the dataset = 30
II. NEW FEATURES2) EVOLUTION
Comparison between metrics over different dates
(variation in %, difference in value)
Example: to compare the sales per products between two periods.
II. NEW FEATURES3) VARIATION AND DIFFERENCE
- You must select at least 2 metrics
- Evolution mode must be disactivated
Functional scope of the VAR / DIF mode in the API:
II. NEW FEATURES3) VARIATION AND DIFFERENCE
Total “Displayed”: total of the metrics displayed in the dataset.
Total “Reference”: total of the reference site’s metrics (soon available).
Example: to get the weight of the 20 best sold products.
II. NEW FEATURES4) TOTAL
Functional scope of the RATIO mode in the API:
- Need to activate the display of the Total
II. NEW FEATURES5) RATIO
6) META DATA
The Context parameter will transfer meta data information on the global call
scope.
Context for Space: label, currency, time zone, etc.
Context for Periods: period labels, list of dates
Context for Ranges: information linked to the result pagination (ex: Next URL)
Context for Profile: language, first day of week
II. NEW FEATURES
7) FILTERS AND SORTS
II. NEW FEATURES
There are 9 new filters:
“Does not contain”
“Does not start with”
“Does not end by”
“Equals to value 1 or value 2”
“Is different from value 1 or value 2”
“Contains value 1 or value 2”
“Does not contain value 1 or value 2”
“Contains the word value 1 or value 2”
“Does not contain value 1 or value 2”
+ add of multi filter
Example: to isolate products whom title contains the words “Sony” OR “Samsung”
and which have generated a turnover >6,000.00€
8) MAX RESULT
II. NEW FEATURES
With the Max result parameter, possibility to define the number of rows
required in the dataset.
By defaut Max result is 20.
Possibility to change the Max result parameter.
Value between 1 and 10 000.
If more than 10 000 is needed, necessity to make a pagination. Meta Data
are also made for this.
II. NEW FEATURES9) OUTPUT FORMATTING
The output format has no longer to be written in the URL, it has to be
integrated in the header of API call.
Accept: application/json
Accept: application/xml
Accept: application/html
The default format is json
10) FOCUS ON QUOTAS
Goal: to protect our infrastructures and provide an unified quality of service to all users
- No limitation in number of API calls
- But a limitation of simultaneous calls
- 5 slots per user
- Possibility to have Premium accounts
II. NEW FEATURES
III. TRANSITION TO THE NEW VERSIONA NEW WORKSPACE, A NEW API
https://apirest.atinternet-solutions.com/data/v2/getData?querystring
III. TRANSITION TO THE NEW VERSIONTHE TRANSITION
2 Data Query “ecosystems”:
V1 is still accessible from the DWS 2
V2 is accessible from the new workspace
Custom metrics and segments are the same on both apps
DQ v1 templates can be imported into DQ v2
Warning: once a template is imported in DQ v2, it will be closed in DQ v1.
The API v1 still continue to work
IV. QUESTIONS & ANSWERS
www.atinternet.com