Conoce el API de Innovachallenge

InnovaChallenge Data API

Innova Challenge API What is it?

The InnovaChallenge Data API offers aggregated statistics of spending by geographical area, temporal period and commercial category, accesible through a REST services API.

Innova Challenge API

Which are the data sources? (1/2)

The statistics exposed through the InnovaChallenge Data API come from a dataset that contains transactions performed with BBVA cards, properly anonymized and aggregated. Scope: •  Madrid and Barcelona provinces •  Timespan: 2012-11 – 2013-04 •  Classified into commercial sectors of activity Some metrics about the data: •  More than 30 million transactions •  More than 2 million cards •  More than 200,000 stores Overall, BBVA has a 15-20% market share in card payments.


Which are the data sources? (2/2)

Each transaction has several parameters associated that describe the context of the purchase made: •  Transaction amount •  Time & date of the purchase (timestamp) •  Store location (lat/lon coordinates). •  Commercial category of the store. •  Demographic segment of the cardholder. •  Zip code of residence of the cardholder. This data, processed and aggregated, provide the basis for the API services. These allow to gain relevant insights on the commercial activity in a given geographical area, for a specific activity sector, for a specific timeframe and a customer segment.

The API offers data about geographical areas in two different partitions for the Madrid and Barcelona provinces: - Zip codes - Zoom 2 cells (450x550m) •  These cells have a size determined by half of a hundredth of a decimal lat/

lon coordinate. The cells are centered in coordinates with the third decimal place set to 0 or 5. Some examples:

(40.415, -3.705), (40.420, -3.705), (40.415, -3.710), (40.420, -3.710)

•  To ask for a cell it’s enough to call the services with a point contained in such cell.

Statistics: spatial detail


- Timeframe: 2012-11 – 2013-04 - Data is aggregated by weeks and months. •  Week number 1 in a given year is

considered to be the week that has more than 4 days within the given year.

•  To ask for statistics of a given week or

month, just specify a day that belongs to the period of interest in the API call.

Statistics: temporal detail


41

40

42

43

44

There are 16 different store categories / types of activity:

•  Travel •  Groceries •  Hypermarkets •  Hotels •  Real estate •  Automotion •  Bars and restaurants •  Personal care

Statistics: store categories

•  Sports & toys •  Technology •  Home •  Contents •  Fashion •  Leisure •  Health •  Transportation

There are also aggregates for all categories at once.


Available statistics services

Commercial categories


The statistics in the services are always referred to an area, a commercial category and a temporal aggregation.

1st service: customer segments Given an area, a commercial category and a temporal aggregation, the service returns: - Average spending - Number of transactions - Number of unique cards that have performed the transactions for each one of 14 demographic segments and one segment belonging to corporate cards. It provides insights on how each customer segment spends their money. Restriction: no results are given if based on less than 3 cards per segment or less than 5 stores per category.





2nd service: purchase patterns Given an area, a commercial category and a month, the service returns: - For the transaction amounts: average, minimum, maximum, standard deviation and mode. - Number of transactions - Number of unique cards that have performed the transactions for each hour of the day and each day of the week (aggregated patterns computed over the course of a month) Provides insights on typical purchase patterns Restriction: no results are given if based on less than 3 cards or less than 5 stores per category.



3rd service: zip codes of residence of the customers. Given an area, a commercial category and a temporal aggregation, the service returns the list of the top 100 zip codes of procedence of customers making purchases in that given area, ordered by the following criteria: - Total spending - Number of transactions - Number of unique cards that have performed the transactions The service returns also the values for these criteria. Provides insights on the area of influence of the stores that are located in a given area. Restriction: no results are given if based on less than 3 cards per zip code or less than 5 stores per category.


Additional services

Commercial categories This service returns the commercial categories tree that can be used to call the other API services. It returns the category id and the description string in English and Spanish.


Access to the API

The data is accesible through a REST API that provides the three data services and the additional commercial categories service. It is necessary to register first at the BBVA Developer Center:

http://developer.bbva.com The registration process currently requires the user to specify an application. Once it is registered, the Developer Center provides a pair of app_key and app_secret that will allow you to authenticate yourself and consume the services.

Thanks!

Conoce el API de Innovachallenge

Technology

Transcript of Conoce el API de Innovachallenge