Microsoft Cognitive Services provides various APIs including the Recommendations API. The document discusses getting started with the Recommendations API by enabling Cognitive Services on an Azure account, understanding the API's capabilities for different recommendation types, and how to build a recommendations model by uploading catalog and usage files to define items and user interactions. It also provides examples of integrating the API with SSIS and displaying recommendations in Power BI.

1. Microsoft Cognitive Services – Recommendations API:
Your First Recommendations Model
XXIV EVENTO PORTO.DATA – OUTUBRO 2016
Bruno Paulino
Business Intelligence Consultant

2. Bruno Paulino
Business Intelligence Consultant
IBM | Microsoft Certified Professional
3+ years’ experience in BI
Brazilian | Italian | Almost Portuguese 
Email: bpaulino@bi4all.pt
LinkedIn:
http://pt.linkedin.com/in/brunopaulino
Academic Experience
Business Intelligence Short Master
Portucalense Universtity, Portugal, 2011
Master’s degree in Information Management
Faculty of Engineering - University of Porto (FEUP), Portugal, 2008
Bachelor’s degree in Information Science
Londrina State University (UEL), Brazil, 2003
Relevant Experience
BI4ALL Consultores de Gestão | 2013 – To date
Past Projects:
Metlife Iberia
Johnson & Johnson
ECS Capital
Salvador Caetano
Current Project:
Mapfre
Sapec
Servier
MCoutinho
OCP Portugal

3. Getting Started
 What’s Cognitive Services API
 How to enable Cognitive Services on Azure account
 Discovering the Recommendations API
 Using Recommendations API with SSIS
 Showing recommendations results in PowerBI

4. Intelligent solutions able to see, hear, speak,
understand and interpret our needs using
natural methods of communication.
https://www.microsoft.com/cognitive-services

5. Vison LanguageSpeech Knowledge Search
Microsoft Cognitive Services APIs
Computer Vision
Emotion
Face
Video
Custom Recognition
Intelligent Service
Bing Speech
Speaker Recognition
Bing Spell Check
Language
Understanding
Intelligent Service
Linguistic Analysis
Text Analytics
Web Language Model
Academic Knowledge
Entity Linking
Intelligence Service
Knowledge
Exploration Service
Recommendations
Bing Autosuggest
Bing Image Search
Bing News Search
Bing Video Search
Bing Web Search

6. Microsoft Cognitive Services APIs Applications
Online store boosts conversion rate with
quick-deploy recommendations technology
Uber is using driver selfies to enhance security
Cognitive video indexing platform that
processes videos that you upload and creates
an index of the content within the video
Wearable technology helping people who are visually impaired “see” the world

7. https://portal.azure.com
Microsoft Azure
https://azure.microsoft.com/
Create a free Azure account
Sign in to your account

8. Microsoft Azure Enable Cognitive Services APIs on Azure account
 New
 Intelligence + analytics
 Cognitive Services APIs (pré-visualização)
 API Type: Recommendations API
 Pricing tier: F0 Free
Note: copy and save the Key 1, it will be used in all API processes.

9. Frequently Bought Together
recommendations (FBT)
Item to item
recommendations (I2I)
Personalized user
recommendations (U2I)
Introducing

10. Steps to Create a Model
Create/Trigger a
Recommendations
Build
Upload
Usage File
Upload
Catalog File
Create a Project:
Define the Model Name

11. Catalog File Format
<Item Id>,<Item Name>,<Item Category>,[<Description>],<Features list>
Example without features
AAA04294,Office Language Pack Online DwnLd,Office
AAA04303,Minecraft Download Game,Games
C9F00168,Kiruna Flip Cover,Accessories
Example with features
AAA04294,Office Language Pack Online DwnLd,Office,, softwaretype=productivity, compatibility=Windows
BAB04303,Minecraft DwnLd,Games,, softwaretype=gaming, compatibility=iOS, agegroup=all
C9F00168,Kiruna Flip Cover,Accessories,, compatibility=lumia, hardwaretype=mobile

12. Usage File Format
<User Id>,<Item Id>,<Time>,[<Event type>]
Example
168064,6485200,2013/06/20T10:00:00, Purchase
263325,6485200,2013/06/20T10:00:00, Purchase
190485,6485200,2013/06/20T10:00:00, Click
225087,6485936,2013/06/20T10:00:00, Purchase
Event type
 Click
 RecommendationClick
 AddShopCart
 RemoveShopCart
 Purchase

13. Let’s Create a Model
https://www.microsoft.com/cognitive-services/en-us/recommendations-api

14. API SDK and SQL Server Integration Service (SSIS)
When using C# classes from the API SDK in a SSIS Script Component, you have to add the
following references:
 Newtonsoft.Json
 System.Net.Http
 System.Runtime.Serialization
 System.Net.Http.Formating
Note: you need to install the Newtonsoft.Jason reference
into the Global Assembly Cache (GAC) using gacutil.exe.
https://msdn.microsoft.com/en-us/library/dkkx7f79(v=vs.110).aspx

15. Showing Recommendations Results in PowerBI

16. Obrigado!
Bruno Paulino
bpaulino@bi4all.pt