Skip to content

Commit 2727714

Browse files
Merge pull request #5707 from MicrosoftDocs/main
Auto Publish – main to live - 2025-08-21 14:51 UTC
2 parents af83ac8 + 4eedb38 commit 2727714

File tree

196 files changed

+3693
-2570
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

196 files changed

+3693
-2570
lines changed

.openpublishing.redirection.json

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7736,8 +7736,8 @@
77367736
"redirect_document_id": false
77377737
},
77387738
{
7739-
"source_path": "uwp/publish/app-management-and-services.md",
7740-
"redirect_url": "/windows/apps/publish/app-management-and-services",
7739+
"source_path": "uwp/publish/product-management.md",
7740+
"redirect_url": "/windows/apps/publish/product-management",
77417741
"redirect_document_id": false
77427742
},
77437743
{
@@ -7835,11 +7835,6 @@
78357835
"redirect_url": "/windows/apps/publish/make-your-app-easier-to-promote",
78367836
"redirect_document_id": false
78377837
},
7838-
{
7839-
"source_path": "uwp/publish/organizational-licensing.md",
7840-
"redirect_url": "/windows/apps/publish/organizational-licensing",
7841-
"redirect_document_id": false
7842-
},
78437838
{
78447839
"source_path": "uwp/publish/package-flights.md",
78457840
"redirect_url": "/windows/apps/publish/package-flights",

hub/apps/publish/analyze-app-performance/msix.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,16 @@ ms.localizationpriority: medium
1212
View detailed analytics for your apps and games in [Partner Center](https://partner.microsoft.com/dashboard/insights/analytics/overview). Statistics and charts let you know how your apps are performing in the Store, from how many customers you've reached to how they're using your app and what they have to say about it. You can also find metrics on app install, app health, app usage, and more.
1313
You can view analytic reports right in Partner Center or [download the reports you need](/partner-center/download-analytic-reports) to analyze your data offline. We also provide several ways for you to [access your analytics data outside of Partner Center](/partner-center/analyze-app-performance#access-analytics-data-outside-of-partner-center).
1414

15+
</br>
16+
You can watch the following video to understand how to use Analytic APIs.
17+
</br>
18+
19+
>[!VIDEO https://learn-video.azurefd.net/vod/player?id=b20faae2-278a-4983-83c5-8078f06cd727]
20+
21+
22+
You can watch the following video to understand how to use Download Hub.
23+
<br>
24+
>[!VIDEO https://learn-video.azurefd.net/vod/player?id=f9b54070-72ea-4f17-afac-a1e580bac716]
1525
1626
### View key analytics for all your apps
1727

hub/apps/publish/app-marketing-guidelines.md

Lines changed: 0 additions & 52 deletions
This file was deleted.

hub/apps/publish/attract-customers-and-promote-your-apps.md

Lines changed: 51 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -10,80 +10,81 @@ ms.localizationpriority: medium
1010

1111
Once your app is in the Microsoft Store, it's time to get it in front of as many customers as possible. [Partner Center](https://partner.microsoft.com/dashboard) offers many features that help you promote your products and grow your customer base, including ad campaigns, promo codes, sale pricing, and more.
1212

13-
## App promotion campaigns
13+
## Generate promotional codes
14+
Promotional codes in Partner Center allow developers and publishers to offer free access to apps or add-ons published in the Microsoft Store. These codes can be used for marketing, customer support, beta testing, or transitioning users from legacy desktop apps to Microsoft Store apps.
1415

15-
:::row:::
16-
:::column:::
17-
![Paid campaigns](images/ads-paid-campaign.png)
18-
:::column-end:::
19-
:::column span="2":::
20-
**Paid campaigns**
16+
Each code is associated with a unique redeemable URL that enables customers to install your app or add-on at no charge. Developers can choose between single-use or multiple-use codes, configure activation and expiration dates, and track code usage directly from the Partner Center dashboard.
2117

22-
These campaigns will run ads in any other app that matches your app’s device and category. You can also choose a universal campaign, where the ads will also appear within MSN.com, Outlook.com, Skype, and other Microsoft premium properties.
18+
### Key capabilities
2319

24-
[EXPLORE MORE >](/windows/uwp/monetize/index)
25-
:::column-end:::
26-
:::row-end:::
20+
- Generate single-use or multiple-use promotional codes.
2721

28-
:::row:::
29-
:::column:::
30-
![Free house campaigns](images/ads-house-campaign.png)
31-
:::column-end:::
32-
:::column span="2":::
33-
**Free house campaigns**
22+
- Customize code activation and expiration windows.
3423

35-
These campaigns will run ads only in your other apps, free of charge.
24+
- Download and manage code orders in TSV format.
3625

37-
[EXPLORE MORE >](/windows/uwp/monetize/index)
38-
:::column-end:::
39-
:::row-end:::
26+
- Distribute codes using your preferred communication method.
4027

41-
:::row:::
42-
:::column:::
43-
![Free community campaigns](images/ads-community-campaign.png)
44-
:::column-end:::
45-
:::column span="2":::
46-
47-
**Free community campaigns**
28+
- Review redemption metrics and availability for each order.
4829

49-
These campaigns will run ads in apps published by other developers who also participate in community ad campaigns, free of charge.
30+
### Ideal use cases
5031

51-
[EXPLORE MORE >](/windows/uwp/monetize/index)
52-
:::column-end:::
53-
:::row-end:::
32+
- Rewarding early adopters or influencers.
5433

55-
## Learn more about app promotion campaigns
34+
- Resolving customer service issues with free access.
5635

57-
![Learn more about app promotion campaigns](images/app-promotion-campaigns.png)
36+
- Running beta programs for apps or add-ons.
5837

59-
[Create an ad campaign in the dashboard](/windows/uwp/monetize/index)
38+
- Encouraging migration to MSIX-packaged apps.
6039

61-
[Create an ad campaign using our REST API](/windows/uwp/monetize/run-ad-campaigns-using-windows-store-services)
40+
> [!NOTE]
41+
> Your app must be fully published to the Microsoft Store before customers can redeem promotional codes.
6242
63-
[Review campaign performance data in the dashboard](advertising-performance-report.md)
43+
For more info, see [Generate promotional codes](generate-promotional-codes.md).
6444

65-
[Get campaign performance data using our REST API](/windows/uwp/monetize/index)
45+
## Custom app promotion campaign
6646

67-
## Promotion analytics
47+
Custom app promotion campaigns in Partner Center allow you to track user engagement and conversions by adding unique campaign identifiers (CIDs) to your app’s Microsoft Store URLs. These identifiers help measure the effectiveness of different marketing efforts, such as social media posts, ads, newsletters, or other outreach channels.
6848

69-
![Promotion analytics](images/ads-promotion-analytics.png)
49+
By appending a CID to your app’s web or protocol-based Store link, you can see how many users viewed the page and how many installed the app as a result of each campaign. Campaign data is available in acquisition reports within Partner Center.
7050

71-
[Acquisitions report](acquisitions-report.md)
51+
### Key capabilities
7252

73-
[Get analytics data using our REST API](/windows/uwp/monetize/access-analytics-data-using-windows-store-services)
53+
- Append unique campaign IDs (CIDs) to your app’s Store URL.
54+
55+
- Track page views and conversions per campaign.
56+
57+
- Use HTML or protocol-style URLs for different platforms.
58+
59+
- Access campaign performance in Partner Center reports.
60+
61+
- Retrieve CID programmatically in your UWP app (Windows SDK support).
62+
63+
### Ideal use cases
7464

75-
## Other ways to promote your app
65+
- Measuring social media campaign effectiveness.
7666

77-
[Promotional codes](generate-promotional-codes.md)
67+
- Tracking installs from email newsletters or blog posts.
7868

79-
[Sale pricing](put-apps-and-add-ons-on-sale.md)
69+
- Evaluating results of paid ad placements.
8070

81-
[Microsoft store badges](https://developer.microsoft.com/store/badges)
71+
- Identifying high-performing marketing sources.
8272

83-
[Custom promotion campaigns](create-a-custom-app-promotion-campaign.md)
73+
- Monitoring cross-platform promotion impact.
8474

85-
[Microsoft Store marketing guidelines for apps](app-marketing-guidelines.md)
75+
For more info, see [Custom app promotion campaing](create-a-custom-app-promotion-campaign.md).
8676

87-
[Link to your app](link-to-your-app.md)
77+
## Put apps and add ons on sale
78+
You can promote your app or add-on in the Microsoft Store by offering it at a reduced price for a limited time. Sales can be configured with either a lower price tier or a percentage-based discount and targeted to specific customer groups or markets. Sale pricing appears with strikethrough formatting in the Store to highlight the promotional offer.
8879

89-
[Make your app easier to promote](make-your-app-easier-to-promote.md)
80+
All sale settings are managed through the Pricing and availability section during an app submission and require a new submission to edit or cancel.
81+
82+
For more info, see [Put apps and add ons on sale](put-apps-and-add-ons-on-sale.md).
83+
84+
## Promotion analytics
85+
86+
![Promotion analytics](images/ads-promotion-analytics.png)
87+
88+
[Acquisitions report](acquisitions-report.md)
89+
90+
[Get analytics data using our REST API](/windows/uwp/monetize/access-analytics-data-using-windows-store-services)

hub/apps/publish/beta-testing-and-targeted-distribution.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,6 @@ Partner Center gives you several options to let testers try out your app before
1616
Whichever method you choose, here are some things to keep in mind as you beta test your app.
1717

1818
- You can’t revoke access to the app after a tester has downloaded it. Once they have downloaded the app, they can continue to use it, and they’ll get any updates that you subsequently publish.
19-
- You will need to determine how you’d like to collect feedback from your testers. Consider providing a link that lets your testers easily give feedback via email (or via [Feedback Hub](/windows/uwp/monetize/launch-feedback-hub-from-your-app), if confidentiality is not a concern).
2019
- You can review [analytic reports](analytics.md) for your app, including usage and health reports and any ratings or reviews left by your testers.
2120
- You can include add-ons when you distribute your app to testers. Since you probably don’t want to charge them money for an add-on, you can [generate promotional codes](generate-promotional-codes.md) and distribute them to your testers to let them get the add-on for free, or you can set the price for the add-on to **Free** during testing (then before you make the app available to other customers, create a new submission for the add-on to change its price). Note that each add-on can only be purchased once per Microsoft account, so the same tester won't be able to test the add-on acquisition process more than one time.
2221
- You can give your testers an updated version of your app at any time by creating a new submission with new packages. Your testers will get the update after it goes through the certification process, just like they got the original package, but no one else will be able to get it (unless you make additional changes, such as moving an app from **Private audience** to **Public audience** or changing the membership of groups who can get it).
@@ -57,6 +56,6 @@ With this, no customers will be able to find the app by searching or browsing th
5756

5857
To use this option:
5958
- In the **Visibility** section of the **Pricing and availability** page, under [Discoverability](publish-your-app/msix/visibility-options.md#discoverability), select **Make this product available but not discoverable in the Store**. Choose the option for **Direct link only: Any customer with a direct link to the product’s listing can download it, except on Windows 8.x.**.
60-
- After your product has been published, distribute the link (the **URL** on the [App identity page](view-app-identity-details.md)) to your testers so they can try it out.
59+
- After your product has been published, distribute the link (the **URL** on the [Product identity page](view-app-identity-details.md)) to your testers so they can try it out.
6160
- When you're ready to make your app available to the public, create a new submission and change the **Visibility** option to **Make this product available and discoverable in the Store** (along with any other changes you'd like).
6261

hub/apps/publish/create-a-custom-app-promotion-campaign.md

Lines changed: 5 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,17 @@
11
---
2-
description: In addition to creating an ad campaign for your app that will run in Windows apps, you can promote your app using other channels.
2+
description: How to promote your app using other channels.
33
title: Create a custom app promotion campaign
44
ms.assetid: 7C9BF73E-B811-4FC7-B1DD-4A0C2E17E95D
5-
ms.date: 10/30/2022
5+
ms.date: 07/27/2025
66
ms.topic: how-to
7-
keywords: windows 10, uwp, custom, app, promotion, campaign
7+
keywords: windows 10, windows 11, uwp, custom, app, promotion, campaign
88
ms.localizationpriority: medium
99
---
1010
# Create a custom app promotion campaign
1111

12-
In addition to creating an [ad campaign for your app](/windows/uwp/monetize/index) that will run in Windows apps, you can also promote your app using other channels. For example, you can promote your app using a third-party app marketing provider, or you might post links to your app on social media sites. These activities are called *custom campaigns*.
12+
To track the performance of each custom campaign, create a unique URL with a different campaign ID. When a Windows 10 user clicks one of these URLs, Microsoft links the click to that campaign and provides the data in [Partner Center](https://partner.microsoft.com/dashboard).
1313

14-
If you run custom campaigns for your app, you can track the relative performance of each campaign by creating a different URL for each custom campaign, where each URL contains a different *campaign ID*. When a customer running Windows 10 clicks a URL that contains a campaign ID, Microsoft associates the click with the corresponding custom campaign and makes this data available to you in [Partner Center](https://partner.microsoft.com/dashboard).
15-
16-
> [!IMPORTANT]
17-
> This data is only tracked for customers on Windows 10. Customers using other operating systems can still follow the link to your app's listing, but data about those customers' activities will not be included.
18-
19-
There are two main types of data associated with custom campaigns: *page views* for your app's Store listing, and *conversions*. A conversion is an app acquisition that results from a customer viewing your app's Store listing page from a URL that includes a custom campaign ID. For more details about conversions, see [Understanding how app acquisitions qualify as conversions](#understanding-how-acquisitions-qualify-as-conversions) in this topic.
14+
Custom campaign data includes page views of your app’s Store listing and conversions. A conversion occurs when a user acquires your app after viewing its Store page via a campaign-specific URL. For more on conversions, see [Understanding how app acquisitions qualify as conversions](#understanding-how-acquisitions-qualify-as-conversions) in this topic.
2015

2116
You can retrieve custom campaign performance data for your app in the following ways:
2217

0 commit comments

Comments
 (0)