Skip to content

Update Leverage developer tools section #5467

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 15 commits into
base: docs
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 2 additions & 7 deletions .openpublishing.redirection.json
Original file line number Diff line number Diff line change
Expand Up @@ -7691,8 +7691,8 @@
"redirect_document_id": false
},
{
"source_path": "uwp/publish/app-management-and-services.md",
"redirect_url": "/windows/apps/publish/app-management-and-services",
"source_path": "uwp/publish/product-management.md",
"redirect_url": "/windows/apps/publish/product-management",
"redirect_document_id": false
},
{
Expand Down Expand Up @@ -7790,11 +7790,6 @@
"redirect_url": "/windows/apps/publish/make-your-app-easier-to-promote",
"redirect_document_id": false
},
{
"source_path": "uwp/publish/organizational-licensing.md",
"redirect_url": "/windows/apps/publish/organizational-licensing",
"redirect_document_id": false
},
{
"source_path": "uwp/publish/package-flights.md",
"redirect_url": "/windows/apps/publish/package-flights",
Expand Down
62 changes: 0 additions & 62 deletions hub/apps/publish/beta-testing-and-targeted-distribution.md

This file was deleted.

8 changes: 3 additions & 5 deletions hub/apps/publish/create-a-custom-app-promotion-campaign.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
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.
description: How to promote your app using other channels.
title: Create a custom app promotion campaign
ms.assetid: 7C9BF73E-B811-4FC7-B1DD-4A0C2E17E95D
ms.date: 10/30/2022
Expand All @@ -9,14 +9,12 @@ ms.localizationpriority: medium
---
# Create a custom app promotion campaign

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*.

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).
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).

> [!IMPORTANT]
> 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.

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.
Custom campaign data includes page views of your apps 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.

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

Expand Down
48 changes: 45 additions & 3 deletions hub/apps/publish/create-customer-groups.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,49 @@ You can create *customer groups* that include a subset of your app's customers.

To view and create customer groups, expand **Engage** in the left navigation menu of [Partner Center](https://partner.microsoft.com/dashboard), then select **Customer groups**.

Currently, two types of customer groups are supported:
- **Known user groups.** These are groups of specific customers, created from the email addresses associated with their Microsoft accounts. Known user groups are most often used with [package flighting](package-and-distribution.md#package-flights) in order to deliver specific packages to customers in that group, or for distribution of a submission to a [private audience](publish-your-app/msix/visibility-options.md#audience). For more info, see [Create known user groups](#create-known-user-groups).

- **Segments.** These are dynamically-created groups of Windows 10 or Windows 11 customers who meet the demographic or revenue criteria that you choose. Segments are typically used with [push notifications](send-push-notifications-to-your-apps-customers.md) or [targeted offers](use-targeted-offers-to-maximize-engagement-and-conversions.md). For more info, see [Create customer segments](create-customer-segments.md).
- **Known user groups.** These are groups of specific customers, created from the email addresses associated with their Microsoft accounts. Known user groups are most often used with [package flighting](package-flights.md) in order to deliver specific packages to customers in that group, or for distribution of a submission to a [private audience](publish-your-app/msix/visibility-options.md#audience). For more info, see [Create known user groups](create-known-user-groups.md).
## App statistics

The **App statistics** section on the segment provides some info about your app, as well as the size of the segment you just created.

Note that **Available app customers** does not reflect the actual number of customers who have acquired your app, but only the number of customers that are available to be included in segments (that is, customers that we can determine meet age requirements, have acquired your app on Windows 10 or Windows 11, and who are associated with a valid Microsoft account).

If you view the results and **Customers in this segment** says **Small**, the segment doesn't include enough customers and the segment is marked as inactive. Inactive segments can't be used for notifications or other features. You might be able to activate and use a segment by doing one of the following:

- In the **Define inclusion conditions** section, adjust the filter criteria so the segment includes more customers.
- On the **Customer groups** page, in the **Inactive segments** section, select **Refresh** to see if the segment now contains enough customers (for example, if more customers who meet your segment criteria have downloaded your app since you first created the segment, or if more existing customers now meet your segment criteria).

## Create known user groups

Known user groups let you add specific people to a group, using the email address associated with their Microsoft account. These known user groups are most often used to distribute specific packages to a selected group of people with [package flights](package-and-distribution.md#package-flights), or for distribution of a submission to a [private audience](publish-your-app/msix/visibility-options.md#audience). They can also be used for engagement campaigns, such as sending [targeted offers](use-targeted-offers-to-maximize-engagement-and-conversions.md) to a group of specific customers.

In order to be counted as a member of the group, each person must be authenticated with the Store using the Microsoft account associated with the email address you provide. To download the app with package flighting, group members must be using a version of Windows 10 or Windows 11 that supports package flights (Windows.Desktop build 10586 or later or Xbox One). With private audience submissions, group members must be using Windows 10, version 1607 or later (including Xbox One).

## To create a known user group

1. In [Partner Center](https://partner.microsoft.com/dashboard), expand **Engage** in the left navigation menu and then select **Customer groups**.
2. In the **My customer groups** section, select **Create new group**.
3. On the next page, enter a name for your group in the **Group name** box.
4. Ensure that the **Known user group** radio button is selected.
5. Enter the email addresses of the people you'd like to add to the group. You must include at least one email address, with a maximum of 10,000. You can enter email addresses directly into the field (separated by spaces, commas, semicolons, or line breaks), or you can click the **Import .csv** link to create the flight group from a list of email addresses in a .csv file.
6. Select **Save**.

The group will now be available for you to use.

You can also create a known user group by selecting **Create a flight group** from the [package flight](package-and-distribution.md#package-flights) creation page. Note that you'll need to re-enter any info you've already provided in the package flight creation page if you do this.

> [!IMPORTANT]
> When using known user groups with package flighting, be sure that you have obtained any necessary consent from people that you add to your group, and that they understand that they will be getting packages that are different from your non-flighted submission.

## To edit a known user group

You cannot remove a known user group from Partner Center (or change its name) after it's been created, but you can edit its membership at any time.

To review and edit your known user groups, expand the **Engage** menu in the left navigation menu and select **Customer groups**. Under **My customer groups**, select the name of the group you want to edit. You can also edit a known user group from the package flight creation page by selecting **View and manage existing groups** when creating a new flight, or by selecting the group's name from a package flight's overview page.

After you've selected the group you want to edit, you can add or remove email addresses directly in the field.

For larger changes, select **Export .csv** to save your group membership info to a .csv file. Make your changes in this file, then click **Import .csv** to use the new version to update the group membership.

Note that it may take up to 30 minutes for membership changes to be implemented. You don't need to publish a new submission in order for new group members to be able to access your submission through package flights or private audience; they will have access as soon as the changes are implemented.
Loading