Microsoft Launches Windows Store analytics API

2:15 PM

Dev Center has released Windows Store analytics API, which would provide users with analytics information for their Windows Store apps without logging into Dev Center. By using REST API you will be able to regain same information which you will see in Dev Center for app and in-app purchase acquisitions, ratings and reviews and also app health.

The company states,
“This new API provides quick access to reports without the time required to log into Dev Center, chose specific reports, and then download them. This can be especially useful if you would like to provide quick app information to marketing or finance, or run advanced analysis of data using your own tools (Excel, Power BI, etc.).”

Most data can easily be pulled at daily, weekly or monthly levels, allowing you to configure the API so that you will be able to recover data range and information, as per your interest.

Microsoft states,
“The Windows Store analytics API requires an Azure Active Directory (Azure AD) account that is associated with your Dev Center account.  If you do not currently have an Azure AD connected to your Dev Center account, please refer to the Using Multi-user and roles blog or MSDN documentation on how to set one up.  You will set up the app or service from which you want to call the Windows Store analytics API as an Azure AD application.  After you obtain an access token from Azure AD, you can then call the Windows Store analytics API from your app or service.”

As per the
official blog to obtain an Azure AD access token, you need to follow the instructions given below:

  1. Associate an Azure AD application with your Dev Center account.
  • Under Manage users in Account settings in Dev Center, click Add Azure AD applications. If the application already exists in your Azure AD, select it. If not, click New Azure AD application and enter the required field values.
  • Reply URL: Enter the Reply URL for the new Azure AD application. This is the URL where users can sign in and use your Azure AD application (sometimes also known as the App URL or Sign-On URL). To find the application’s reply URL, in the Azure Management Portal, click Active Directory, click the directory, and then click the application, and then click Configure. The Reply URL field is in the Single Sign-on section of the Configure page.
  • App ID URI: enter a URL in this format:
    • YOURTENANTNAME should be your organization’s tenant name in Azure AD
    • YOURAPPNAME should be the name of the app you would like to pull data for with the API
    • In the Roles section, select Manager, then save.
    • Return to the Manage users page, select the Azure AD application you just created, and click Add new key.
    • Copy the Client ID and Key provided, as you will not be able to access this information again. You will need both of these in order to obtain the Azure AD token to use when calling the analytics API.
    2. Obtain an Azure AD access token by sending a service-to-service access token request to the following Azure AD endpoint:<tenant id>/oauth2/token. 
    • To find the tenant ID, log in to the Azure Management Portal, navigate to Active Directory, and select the directory linked to your Dev Center account. The tenant ID is embedded in the URL for this page, as shown by the your_tenant_ID string example:<your_tenant_name>#workspaces/ActiveDirectoryExtension/Directory/<your_tenant_ID>/direcotryQuickStart
    • The client_id and client_secret parameters are the Client ID and Key values that you copied in step 1.d.
    • The resource parameter is:
    3.Call the Windows Store analytics API. 
    • Set your call code parameters and pass the access token to the Authorization header.
    • Required parameters for each request include the app or IAP ID.
    • You can specify the date range and the number of rows you would like returned, as well as choose additional filters based on the data you would like to see.
    • Data is returned in JSON format.
    Once your API set up is complete and you have gained access token, use the REST call to obtain specific data which you will require from your apps. Read documentation for each of the data sources for additional information on how to set the parameters as well as to view examples of data that is returned by each call:
    App Acquisitions: Aggregate acquisition data for an app by day, week, or month including type, age group, gender, market, OS version, and Store client.

    • IAP Acquisitions: Aggregate acquisition data for all IAPs in an app or a specific IAP by day, week, or month including type, age group, gender, market, OS version, and Store client.
    • Ratings: Ratings data for an app by day, week, or month including market, OS version, device type, and if the rating is new or revised.
    • Reviews: Review data for an app including market, OS version, package version, device details, if the review is new or revised, the review title, text, and author, helpful/not helpful votes, and the date and text of any responses.
    • App Health: App failure data for an app by day including name, hash, symbol, market, OS version, event type, device type, package name and version, hit count and machine count.

    Please share this

    Related Posts

    Next Post »