Build 2016 - P505 - Windows Store Analytics APIs: New Ways to Get Your Hands on Your Data

#Build2016

Windows Store Analytics APIs: New ways to get your hands on your dataStuart HargreavesProgram Manager – Windows Dev Center

Windows Dev Center Analytics• Windows Store Analytics APIs• Dev Center content pack for Power BI• New Dev Center app

Dev Center Analytics Reports

Dev Center Download reports page

Windows Store Analytics APIs

Windows Store Analytics APIs• Programmatic access to key data

App AcquisitionsIAP AcquisitionsRatingsReviewsApp Health

• Rich set of parameters and filters• Customer hardware and demographic data• Retrieve data for arbitrary date ranges• Text search on reviews• Daily, weekly or monthly aggregation

Windows Store Analytics APIsRequestMethod Request URI

GEThttps://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR

Header DescriptionAuthorization Required. The Azure AD access token in the form of Bearer <token>.

Windows Store Analytics APIsResponse{ "Value": [ { "date": "2016-02-01", "applicationId": "9NBLGGGZ5QDR", "applicationName": "Contoso Demo", "deviceType": "Phone", "orderName": "", "storeClient": "Windows Phone Store (client)", "osVersion": "Windows Phone 8.1", "market": "IT", "gender": "m", "ageGroup": "0-17", “acquisitionType": "Free", "acquisitionQuantity": 1 } ], "@nextLink": "appacquisitions?applicationId=9NBLGGGZ5QDR&aggregationLevel=day&startDate=2015/01/01 &endDate=2016/02/01&top=10000&skip=20000&orderby=date", "TotalCount": 46766}

Windows Store Analytics APIsParameters and filtersCommon Parameters• startDate, endDate• orderBy• aggregationLevel• filter

Common Filters• market• osVersion• deviceType• ageGroup• gender

Common filter operators• and• or• eq• ne

Reviews API• contains• lt• gt• le• ge

Windows Store Analytics APIsApp AcquisitionsExample 1App acquisitions between 3/14/2015 and 3/21/2015 https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR&startDate=3/14/2015&endDate=3/21/2015

Example 2App acquisitions from customers on Windows 10 desktop, aggregated by week https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR&aggregationLevel=week&filter=osVersion eq 'Windows 10‘ and deviceType eq 'PC'

Windows Store Analytics APIsIn App AcquisitionsExample 1In-app acquisitions for a single in-app product by males between 25 and 44https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappacquisitions?inAppProductId=9NBLGGGZ5QDR&filter=gender eq 'm' and (ageGroup eq '25-34' or ageGroup eq '35-44')

Example 2In-app acquisitions for all in-app products for a single app, that are paid or promotional code acquisitions, within the U.S. and Canada, sorted by datehttps://manage.devcenter.microsoft.com/v1.0/my/analytics/inappacquisitions?applicationId=9NBLGGGZ5QDR&orderBy=date&filter=(market eq 'US' or market eq 'CA') and (acquisitionType eq 'paid' or acquisitionType eq 'promotional code')

Windows Store Analytics APIsRatingsExample 1Average rating since the beginning of 2015, aggregated by month ordered descending by datehttps://manage.devcenter.microsoft.com/v1.0/my/analytics/ratings?ApplicationId=9NBLGGGZ5QDR&startDate1/1/2015&aggregationLevel=month&orderBy=date desc

Example 2Average rating for a single dayhttps://manage.devcenter.microsoft.com/v1.0/my/analytics/ratings?applicationId=9NBLGGGZ5QDR&startDate=3/30/2016&endDate=3/30/2016

Windows Store Analytics APIsReviewsExample 1Reviews whose reviewTitle or reviewText contain “slow” from devices with less than 2048mb of RAM, whose rating is less than or equal to 3 starshttps://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?ApplicationId=9NBLGGGZ5QDR&filter=(contains(reviewTitle,'slow‘) or contains(reviewText,‘slow')) and deviceRAM lt 2048 and rating le 3

Example 2Revised reviews that contain ‘Thank you’ in the developer response https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?ApplicationId=9NBLGGGZ5QDR&filter=isRevised eq true and contains(responseText,'Thank you‘)

Windows Store Analytics APIsApp HealthExample 1All crashes on tablets, grouped by failureName and packageVersion and aggregated by weekhttps://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?ApplicationId=9NBLGGGZ5QDR&groupBy=failureName,packageVersion&aggregationLevel=week&filter=eventType eq 'crash' and deviceType eq 'Tablet'

Example 2All events for package version 2.1.1.2 grouped by eventType, eventName and packageName https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?ApplicationId=9NBLGGGZ5QDR&groupBy=eventType,eventName,packageName&filter=packageVersion eq '2.1.1.2'

Windows Store Analytics APIsAPI documentation http://aka.ms/AnalyticsAPIDocs

Windows Store Analytics APIsPrerequisites1. An Azure Active Directory2. Your Azure AD associated with your Dev Center account

See http://aka.ms/ManageAccountUsers for complete instructionsWatch the Multi-user Support in Dev Center video (http://aka.ms/MultiUserSupportVideo) for more information

Windows Store Analytics APIsAzure AD Application setup1. Associate an Azure AD application with your Dev Center

account2. Generate a key (client secret)3. Obtain your Azure access token, using….

• Client Id• Client secret• Azure AD tenant id

See http://aka.ms/AnalyticsAPIDocs for complete instructions and sample code for an Azure AD application

Dev Center content pack for Power BI• Rich, interactive visualization out of the box• Data is refreshed daily• Customizable dashboards, reports and visualizations• Slice data by segments• Share with other in your org• Free Microsoft service

Get started with the Dev Center content pack: http://aka.ms/DevCenterContentPackLearn more about Power BI: http://powerbi.com

Dev Center app• See app and in-app acquisitions, crashes, ratings and reviews• Upcoming features:

• Notifications about your Dev Center account• Respond to reviews• Payouts report• Ad performance report

Dev Center app: http://aka.ms/DevCenterApp

Windows Store analytics APIsSupport for 3rd party analytics partners

• APIs are available to 3rd party analytics solution providers• Microsoft welcomes inquires and discussions

Contact AMaziak@microsoft.com for more information

API documentation: http://aka.ms/AnalyticsAPIDocs

Manage Account Users: http://aka.ms/ManageAccountUsers

Dev Center content pack for Power BI: http://aka.ms/DevCenterContentPack

Dev Center app: http://aka.ms/DevCenterApp

Links to more information

Submit feedback in the Dev Center dashboard

© 2016 Microsoft Corporation. All rights reserved.