Merge branch 'main' into debug-apps-in-Teams-desktop-client

msteams-platform/TOC.yml

@@ -280,7 +280,7 @@
  items:
  - name: Overview
  href: concepts/build-and-test/teams-developer-portal.md
- displayName: App Studio, Changelog for Developer Portal
+ displayName: App Studio, Changelog for Developer Portal, Import an existing app, Import published app
  - name: Manage your apps in Developer Portal
  href: concepts/build-and-test/manage-your-apps-in-developer-portal.md
  displayName: AppID, app validation, validate your app, Microsoft's test cases, add owners to bot
@@ -289,7 +289,7 @@
  displayName: visual studio code, visual studio, teams toolkit, react web app, publish react app, debug
  - name: Analyze your apps usage in Developer Portal
  href: concepts/build-and-test/analyze-your-apps-usage-in-developer-portal.md 
- displayName: dashboard
+ displayName: App usage, metrics, usage, analytics, insights, telemetry, Import an existing app
  - name: Adaptive Card Previewer for Visual Studio Code
  items:
  - name: Overview

msteams-platform/concepts/build-and-test/manage-your-apps-in-developer-portal.md

@@ -25,12 +25,12 @@ In the **Overview** section, you can see the following components to manage your
 
  * In the **Dashboard** under **Overview** section, you can see the following components for your app:
  * **Teams store validation**: App validation tool checks your app package against the test cases Microsoft uses when reviewing your app.
- * **Announcement**: Latest updates of your apps on Developer Portal for Teams.
+ * **Announcement**: Latest updates of your apps on Developer Portal.
  * **Active users (Preview)**: Shows you the active user count.
  * **Basic information**: Shows you the **App ID**, **Version**, **Manifest version**, and other basic information.
  * **Upgrade to 1.17**: Upgrade your app manifest to the latest version 1.17, which enables support for extending Teams apps to Outlook and Office.
 
- :::image type="content" source="../../assets/images/tdp/dashboard-page_1.png" alt-text="The screenshot is an example that shows the Overview page of the app you created in Developer Portal for Teams." lightbox="../../assets/images/tdp/dashboard-page_1.PNG":::
+ :::image type="content" source="../../assets/images/tdp/dashboard-page_1.png" alt-text="The screenshot is an example that shows the Overview page of the app you created in Developer Portal." lightbox="../../assets/images/tdp/dashboard-page_1.PNG":::
 
 * **Analytics**
 

msteams-platform/concepts/build-and-test/teams-developer-portal.md

@@ -1,6 +1,6 @@
 ---
 title: Know about Developer Portal for Teams
-description: In this article, learn how to create a brand new app and import an existing app in Teams Developer Portal. Also, learn about the Changelog for Developer Portal.
+description: Learn how to create a brand new app, import an existing or published app in Developer Portal, and changelog for Developer Portal.
 ms.localizationpriority: medium
 ms.topic: overview
 ms.author: surbhigupta
@@ -11,7 +11,7 @@ ms.date: 02/27/2023
 
 <a href="https://dev.teams.microsoft.com" target="_blank">Developer Portal for Teams</a> (previously known as App Studio) is the primary tool for configuring, distributing, and managing your Microsoft Teams apps. With Developer Portal, you can collaborate with colleagues on your app, set up runtime environments, and much more.
 
-:::image type="content" source="../../assets/images/tdp/tdp-home.png" alt-text="Screenshot shows the home page of Developer Portal for Teams." lightbox="../../assets/images/tdp/tdp-home.png":::
+:::image type="content" source="../../assets/images/tdp/tdp-home.png" alt-text="Screenshot shows the home page of Developer Portal." lightbox="../../assets/images/tdp/tdp-home.png":::
 
 > [!NOTE]
 >
@@ -31,19 +31,19 @@ Developer Portal allows you to create a brand new app:
 
 1. Sign in to [Developer Portal](https://dev.teams.microsoft.com) and select **Apps** from the left pane.
 
- :::image type="content" source="../../assets/images/tdp/home-page.png" alt-text="Screenshot shows the home page of Developer Portal for Teams with the Apps option highlighted in red." lightbox="../../assets/images/tdp/home-page.png":::
+ :::image type="content" source="../../assets/images/tdp/home-page.png" alt-text="Screenshot shows the home page of Developer Portal with the Apps option highlighted in red." lightbox="../../assets/images/tdp/home-page.png":::
 
 1. Select **+ New app**.
 
- :::image type="content" source="../../assets/images/tdp/enter-app-name-tdp.png" alt-text="Screenshot shows how to create a brand new app in Developer Portal for Teams." lightbox="../../assets/images/tdp/create-new-app-in-tdp.png":::
+ :::image type="content" source="../../assets/images/tdp/enter-app-name-tdp.png" alt-text="Screenshot shows how to create a brand new app in Developer Portal." lightbox="../../assets/images/tdp/create-new-app-in-tdp.png":::
 
 1. Enter app name and select **Add**.
 
- :::image type="content" source="../../assets/images/tdp/enter-app-name-tdp.png" alt-text="The screenshot shows how to create a brand new app in Developer Portal for Teams." lightbox="../../assets/images/tdp/enter-app-name-tdp.png":::
+ :::image type="content" source="../../assets/images/tdp/enter-app-name-tdp.png" alt-text="The screenshot shows how to create a brand new app in Developer Portal." lightbox="../../assets/images/tdp/enter-app-name-tdp.png":::
 
 Now you've successfully created a brand new app and you can see all the basic information of the new app.
 
-:::image type="content" source="../../assets/images/tdp/basic-information-app-tdp.png" alt-text="Screenshot shows the basic information of the app you created in Developer Portal for Teams." lightbox="../../assets/images/tdp/basic-information-app-tdp.png":::
+:::image type="content" source="../../assets/images/tdp/basic-information-app-tdp.png" alt-text="Screenshot shows the basic information of the app you created in Developer Portal." lightbox="../../assets/images/tdp/basic-information-app-tdp.png":::
 
 ### Import an existing app
 
@@ -52,7 +52,7 @@ Follow the steps to import and manage your existing app in Developer Portal:
 1. In Developer Portal, select **Apps** from the left pane.
 1. Select **Import app**.
 
- :::image type="content" source="../../assets/images/tdp/import-app.png" alt-text="Screenshot shows how to import your existing app in Developer Portal for Teams to manage your apps." lightbox="../../assets/images/tdp/import-app.png":::
+ :::image type="content" source="../../assets/images/tdp/import-app.png" alt-text="Screenshot shows how to import your existing app in Developer Portal to manage your apps." lightbox="../../assets/images/tdp/import-app.png":::
 
 1. Select the app manifest file, and then select **Open**.
 
@@ -67,6 +67,21 @@ Follow the steps to import and manage your existing app in Developer Portal:
 
  :::image type="content" source="../../assets/images/tdp/change-ownership-app-teams-global-admin.png" alt-text="Screenshot shows an example of a tenant admin taking ownership of an app in Teams Developer Portal.":::
 
+#### Steps to import a published app that's not registered in Developer Portal
+
+You might have published apps in Teams Store that wasn't registered in Developer Portal. If you want to monitor app analytics or validate your app, you must import your app into Developer Portal. While importing your published app, you might face the following error:
+
+:::image type="content" source="../../assets/images/tdp/error-message.png" alt-text="Screenshot shows an example of error message when you import an existing app in Teams Developer Portal."::: 
+
+To resolve this error, we recommend that you raise a [support ticket](../../feedback.md) to Microsoft with the following details:
+
+* App ID
+* Tenant ID
+* Your email ID
+* Screenshot of the email from Partner Center when the app was published.
+
+This information is required to verify the app owner's identity, who raises the ticket and to allow them to import an app.
+
 ## Changelog for Developer Portal
 
 Changelog for Developer Portal allows you to stay engaged with the latest updates in Teams. You can view the updates about features, recent changes in APIs, and important bug fixes.

msteams-platform/mstdd-landing.yml

@@ -61,6 +61,8 @@ landingContent:
  linkLists:
  - linkListType: whats-new
  links:
+ - text: Analyze your third-party app usage metrics in Developer Portal
+ url: concepts/build-and-test/analyze-your-apps-usage-in-developer-portal.md
  - text: Single sign-on (SSO) authentication for nested apps (Developer preview)
  url: concepts/authentication/nested-authentication.md
  - text: New purchase experience for Teams app subscriptions bought from Teams Store
@@ -79,8 +81,6 @@ landingContent:
  url: graph-api/rsc/preapproval-instruction-docs.md
  - text: 32x32 color icon for your app running in Outlook and Microsoft 365
  url: concepts/build-and-test/apps-package.md#outline-icon
- - text: Authentication in API-based message extension
- url: messaging-extensions/build-api-based-message-extension.md#authentication
 
  - linkListType: reference
  links:

msteams-platform/whats-new.md

@@ -32,7 +32,7 @@ Teams platform features that are available to all app developers.
 
 **2024 September**
 
-***September 17, 2024***: [Microsoft Teams Toolkit helps you to debug and preview your Microsoft Teams app in desktop client.](toolkit/debug-apps-in-teams-desktop-client.md)
+***September 13, 2024***: [Use app analytics in Developer Portal to analyze your app usage metrics to gain valuable insights into how users interact with your app.](concepts/build-and-test/analyze-your-apps-usage-in-developer-portal.md)
 
 :::column-end:::
 :::row-end:::