Merge branch 'master' into portals-2057280

Author: tapanm-MSFT

powerapps-docs/developer/common-data-service/TOC.yml

@@ -343,6 +343,8 @@
       href: isv-app-management-appsource-checker.md
     - name: Connector Certification 
       href: isv-app-management-certification.md
+    - name: App usage analytics
+      href: isv-app-usage-analytics.md
 - name: Create client applications
   href: connect-cds.md
   items:

powerapps-docs/developer/common-data-service/isv-app-usage-analytics.md

@@ -0,0 +1,86 @@
+---
+title: Introduction to the Power Platform ISV Studio app usage analytics| Microsoft Docs
+description: Measure app's performance and get insights.
+services: ''
+suite: powerapps
+documentationcenter: na
+author: "nkrb" # GitHub ID
+manager: kvivek
+editor: ''
+tags: ''
+ms.service: powerapps
+ms.devlang: na
+ms.topic: article
+ms.reviewer: nabuthuk
+ms.workload: na
+ms.date: 10/02/2020
+ms.author: nabuthuk
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+
+# ISV app usage analytics
+
+[!INCLUDE [cc-beta-prerelease-disclaimer](../../includes/cc-beta-prerelease-disclaimer.md)]
+
+ISVs need data like active users, number of times the solution installed or other means of data to measure the success of their application. App usage analytics feature allows ISVs to monitor the usage of their apps by giving them the visibility into monthly, daily, and weekly usage data of their apps. 
+
+> [!NOTE]
+> A tenant or customer needs to update their apps for an ISV to start seeing the usage data.
+
+App usage feature allows ISVs to filter the usage data by **Component Type**, **Data Date**, **Package Name**, and **Solution Name**. An app can have multiple packages and an individual package can have multiple solutions. Each solution can have multiple components. App usage is measured based on how many times the components of the application are used in a month, week, or day. 
+
+> [!NOTE]
+> An app must be deployed via [AppSource](https://appsource.microsoft.com) in order to see this data.   
+
+> [!div class="mx-imgBorder"]
+> ![Usage dashboard](media/isv-app-usage-analytics-report.png "Usage dashboard")
+
+
+Some of the components of a solution can have shared ownership by multiple ISVs. For shared components, only the publisher who created the component gets the usage credit. For example, ISV1 created a form and ISV2 extends the form by adding a widget to it. Every time the form is used, ISV1 gets the usage credit and ISV2 gets the usage credit whenever the widget is used. If a user visited the form only to access the widget, ISV1 also gets the usage credit.
+
+For components that are not shared, only the publisher who created gets the usage credit. 
+
+## View the app usage dashboard
+
+To view the app usage data:
+
+1. Sign in to [ISV studio](https://aka.ms/ISVStudio/).
+1. On the **Home** page, you can see a list of published applications. Select the desired application for which you want to see the usage details. 
+1. Scroll-down to the page to view all the apps. Select the app and select the **Usage** tab.
+
+   > [!div class="mx-imgBorder"]
+   > ![List of top apps](media/isv-top-apps.png "List of top apps")
+
+1. You can also see the app usage details by directly selecting the app usage icon from the list of apps as shown  screenshot:
+
+   > [!div class="mx-imgBorder"]
+   > ![Usage icon](media/isv-select-app-to-see-details.png "Usage icon")
+
+## Overview of the usage dashboard
+
+The usage dashboard shows the following metrics:
+
+- **Monthly active users**: Tracks the information about the number of unique users who used the app within the last month.
+- **Daily active users**: Tracks the information about the number of daily unique users who used the app within the last 24 hours.
+- **Weekly active users**: Tracks the information about the number of daily unique users who used the app within the last 7 hours.
+- **Usage over time**: Tracks the information about the number of monthly, weekly, and daily active users over time.
+- **Monthly active users by component type**: Tracks the information about the number of monthly active users filtered by component type.
+- **Monthly active users by component name**: Tracks the information about the number of monthly active users filtered by component name.
+
+If ISV is looking at the metrics at a solution level, all the components are rolled up to the solution level. Similarly, all the solution metrics are rolled up to package and all package metrics are rolled up to an app. 
+
+### Filtering the usage dashboard
+
+ISVs can filter the usage dashboard using the filters available. For example, an ISV can filter to see the metrics at app, package, solution, and component level. If ISVs want to see the metrics at solution level, ISVs can select all the components of the solution in the filter.  
+
+### See also
+
+[Home page](isv-app-management-homepage.md)  
+[App page](isv-app-management-apppage.md)<br/> 
+[Tenant page](isv-app-management-tenantpage.md)<br/>
+[AppSource checker](isv-app-management-appsource-checker.md)<br/>
+[Connector Certification](isv-app-management-certification.md)

powerapps-docs/developer/common-data-service/media/Picture2.png

@@ -32,6 +32,8 @@
       href: query-data-web-api.md
     - name: Retrieve related entities with query
       href: retrieve-related-entities-query.md
+    - name: Relevance search, suggestions, and autocomplete
+      href: relevance-search.md
   - name: Retrieve and execute predefined queries
     href: retrieve-and-execute-predefined-queries.md
   - name: Create an entity

powerapps-docs/developer/common-data-service/media/isv-app-usage-analytics-report.png

@@ -873,6 +873,7 @@ More information: [Use column comparison in queries](../column-comparison.md)
 
 ### See also
 
+[Search across entity data using relevance search](relevance-search.md)  
 [Work with Quick Find’s search item limit](../quick-find-limit.md)  
 [Web API Query Data Sample (C#)](samples/cdswebapiservice-query-data.md)<br />
 [Web API Query Data Sample (Client-side JavaScript)](samples/query-data-client-side-javascript.md)<br />