Export (0) Print
Expand All

Update, Unpublish, and Track Your Apps with Metrics in the Microsoft Seller Dashboard

Published: March 27, 2014

noteNote
This topic applies to the following marketplaces: Office Store and Microsoft Azure Marketplace.

Once you have apps in the Microsoft Seller Dashboard, you may want to update your apps, unpublish (remove) them from marketplace listings, delete them, or track how well they are doing.

  • Update your apps: If you want to update your apps, you can edit them in the Seller Dashboard. After you edit and submit them, they will go through an approval process.

  • Remove your app from marketplace listings: If an app is listed in marketplaces, you may want to remove your app from those listings. When you unpublish an app, it removes your app from marketplace listings within a few days.

  • Delete your app from the Seller Dashboard: In time, you may have some apps that are no longer relevant or required. Draft apps or apps that have been unpublished can be deleted.

  • Track your apps for Office with metrics: After your apps are approved and listed in the Office Store, you can track how well your apps are doing with metrics. You might want to track customer ratings and reviews, browser hits, and trial downloads.

In this topic

Edit your app

You can edit your saved draft apps and your approved apps. You cannot edit an app that has been submitted for approval and still has a pending approval status. If you edit an approved app and submit it, the app will go through the approval process again. For more information, see the following section.

Edit your apps when:

  • You want to improve your marketplace listing.

  • Your app has a changes requested status in the Seller Dashboard. On the APPS tab, under manage, your app status appears under the app name. For more details, you can click the app, and on the app summary page, click View the app report for details about the recommended changes.

    For more information about requirements for Office Store apps, including apps for Office or SharePoint, see Validation policies for the apps submitted to the Office Store.

    For help with Azure apps, see Support for the Azure Marketplace.

  • You are submitting apps for Office or SharePoint, and you want to add multiple languages.

  • You have an OAuth Client ID and client secret associated with your app, and your client secret is expiring. For more information, see Create Client IDs and Secrets in the Microsoft Seller Dashboard.

  • You have any other situations where you need to make changes to your app.

To edit your app, follow these steps:

  1. Sign in to the Seller Dashboard with your Microsoft account.

  2. On the APPS tab, under manage, click the app you want to edit.

  3. On the app summary page, if you want to edit a draft app, click EDIT DRAFT. If you are editing an approved app, click EDIT LISTING.

    noteNote
    If you edit an approved app and submit it, it will go through the approval process again. For more information, see the following section.

  4. In the EDIT APP wizard, make the changes to your app.

    noteNote
    If you are editing apps for Office or SharePoint, and:

    • You are editing a language you previously added; on the details page, under language, click the name of the language to edit details for that language.

    • You are adding another language; on the details page, click the ADD A LANGUAGE button to add details for that language.

    • You want to delete the details for a language you previously added; on the details page, under language, click delete next to the language you want to remove, and then click REMOVE LANGUAGE.

  5. After you have made your changes, click SAVE AS DRAFT if you are not ready to submit your app, or click SUBMIT FOR APPROVAL.

    noteNote
    • You can submit your free apps for approval only after your Seller Dashboard account is approved. You can submit apps for purchase once your account is approved and your payout and tax information are validated. For more information, see Add payout and tax information and submit it for validation.

Understand the app approval process

You can submit apps for approval after your account is approved. You can make changes to your app at any point before you submit it for approval. During the approval process, you cannot make changes to your app. If you make changes to an approved app, it must go through the approval process again.

Some of the requirements for approval are:

  • Your app must be free of viruses. If you need virus detection software, see the Microsoft Safety & Security Center.

  • Your app must not contain any inadmissible or offensive material.

  • Your app must be stable and functional.

  • Any material that you associate with your app, such as descriptions and support documentation, must be accurate. This associated material must use correct spelling, capitalization, punctuation, and grammar.

  • If you are submitting apps for Office or SharePoint, and your app supports multiple languages, you must add localized metadata for each language. Apps with web services and functionality that support these additional languages provide the best customer experience. You must also provide app descriptions in the languages your app is localized to.

noteNote
For more information about requirements for Office Store apps, including apps for Office and SharePoint, see Validation policies for the apps submitted to the Office Store.

Check your app approval status

You will receive an email message when the validation process is complete, alerting you if your app was approved or if your app needs changes to be approved. You can also follow these steps to check the status in the Seller Dashboard:

  1. Sign in to the Seller Dashboard with your Microsoft account.

  2. On the APPS tab, under manage, your app status appears under the app name.

    • If the status is pending approval, your app is still being verified. When the status is pending approval, you can’t edit your app.

    • If the status is approved, your app is approved to be listed in the appropriate marketplaces.

      noteNote
      Once your app is approved in the Seller Dashboard, there may be a delay before it is published in a marketplace. After approval, apps for Office and SharePoint typically appear in the Office Store within 24 hours. If you have questions or issues with the approval process, see Support Resources.

    • If the status is changes requested, your app needs changes in order to be approved. Click the app, and then on the app summary page, click View the app report for details about the recommended changes.

Unpublish your app to remove it from marketplace listings

Here are some situations in which you may want to remove your app from marketplace listings:

  • You have developed a new version of your app, and you no longer want to offer the previous version.

  • You have an issue with your app, and you want to remove your app from marketplace listings until you have resolved the issue.

noteNote
When you unpublish an app, the system removes the app from marketplace listings within a few days.

To unpublish an app, follow these steps:

  1. Sign in to the Seller Dashboard with your Microsoft account.

  2. On the APPS tab, under manage, click the app you want to unpublish.

  3. On the app summary page, click UNPUBLISH.

Delete your app from the Seller Dashboard

Draft apps or apps that have been unpublished can be deleted. Any app that is published in a marketplace or that has a pending approval status in the Seller Dashboard cannot be deleted. For a published app, unpublish it first, and then you can delete it. See the previous section to unpublish your app.

ImportantImportant
  • Once you delete an app, you can no longer see, edit, or publish it.

  • If there is a Client ID associated with the app, it will also be deleted.

To delete an app, follow these steps:

  1. Sign in to the Seller Dashboard with your Microsoft account.

  2. On the APPS tab, under manage, click the app you want to delete.

  3. On the app summary page, click DELETE.

    noteNote
    If your app is published, you will not see the DELETE button. After you unpublish your app, you will see the DELETE button.

  4. To confirm that you want to delete your app, click YES, DELETE THIS APP.

Track your apps for Office with metrics

After your apps are approved and listed in the Office Store, you can track how well your apps are doing. On the metrics page, you can:

  • View up to four weeks of data.

    noteNote
    • It may take a few days for the latest values to populate on the metrics page.

    • The most recent week of data may be a partial week through the UPDATED date on the metrics page.

  • Download the data if you want to keep historical information about your app.

  • View information including customer ratings and reviews, browser hits, and trial downloads.

Information about metrics

The metrics page includes the following information for apps for Office and apps for SharePoint:

noteNote
All purchase-related information reflects the initial purchase. It may not take into account a purchase transaction that does not complete, is cancelled, is refunded, or is declined. Because of this, it may not reflect the total app revenue.

  • Browser hits: Number of times your app’s listing has been viewed in the Office Store.

  • Downloads: Number of times the app has been acquired from the Office Store.

  • Trial downloads: Number of times your app has been acquired as a free trial from the Office Store.

  • Trial conversions: Number of times a customer who acquired a trial of your app has purchased your app.

  • Purchased seats: Number of seats that have been purchased for your app.

  • Purchased site licenses: Number of site licenses that have been purchased for your app.

Additional information for apps for SharePoint

The metrics page includes the following app usage information for apps for SharePoint installed on Microsoft SharePoint Online:

noteNote
If the app for SharePoint is installed on an on-premises version of Microsoft SharePoint, rather than SharePoint Online, the app usage information is not available.

  • Installs: Number of install attempts.

  • Launches: Number of times the app has been launched.

  • Daily unique users: Sum of daily unique users during the time period of the graph you are viewing.

  • Uninstalls: Number of uninstall attempts.

  • Failed installs: Number of failed installs, including retries.

  • Runtime errors: Number of errors that SharePoint Online and the app logged while the app is being used. This also includes errors logged through the LogCustomAppError API and the LogCustomRemoteAppError API.

  • Failed upgrades: Number of failed upgrades, including retries.

View metrics for your apps for Office

You can view metrics for your apps in the Seller Dashboard and you can view your sales.

To view metrics for your apps, follow these steps:

  1. Sign in to the Seller Dashboard with your Microsoft account.

  2. On the APPS tab, click metrics.

  3. Click an app for Office to see more details about the metrics for that app.

    noteNote
    You can only see metrics for approved apps that are listed in the Office Store. If you don’t have any approved apps yet, you won’t see any metrics.

To view the sales that your apps generated on a per country (or region) per currency basis, follow these steps:

  1. Sign in to the Seller Dashboard with your Microsoft account.

  2. On the APPS tab, click metrics.

  3. Click View Sales and Tax Data to open the Sales Report.

ImportantImportant
This report only displays total transaction revenue. It does not take into account any of the following, if they apply to the revenue for your app: Taxes withheld, bank charges, currency conversion charges, or the share of the revenue from your app that is paid to Microsoft.

See Also

Show:
© 2014 Microsoft