Linking to your app

You can help customers discover your app by linking to your app's web-based listing page. If the user is on Windows 8 or Windows 8.1, you can provide a link directly to your app's listing page in the Windows Store.

Getting a web link to your app

When your app is published into the Windows Store, a web version of your app listing page is automatically created in all markets where your app is available, and in all languages in which you've provided localized description content. These web-based listings provide an opportunity for users on any platform to learn more about your app. They are the best way to share a link to your app through email or social networks, even if you don’t know what platform your audience is on.

The web listing surfaces the content you submitted for your app's listing, including its description, screenshots, price, and average star rating. This makes the data available to be indexed by web search engines and makes your app easier for users to discover.

In most cases, if a customer running Windows 8 or Windows 8.1 clicks a link to a web-based listing page, the Windows Store will launch and display the app's listing in the Store. The web page will also launch in the customer's browser, with a View in Windows Store button displayed.

Hh974767.wedge(en-us,WIN.10).gifTo access the web link to your app

  1. Sign in to your Windows Store Dashboard.
  2. Click the Details link on the app tile under the Apps in the Store section.
  3. Scroll down to the section entitled Link to yourappname.

Connecting to your app using Internet Explorer

Internet Explorer provides additional ways to connect your web site to your app. To learn more, read:

Linking directly to your app in the Windows Store

You can create a link that goes directly to your app's listing page in the Windows Store. These links are useful if you know your user is on Windows 8 or Windows 8.1 and you want them to arrive directly at the listing page in the Store. For example, after checking user agent strings in a browser to ensure the user is running Windows 8 or Windows 8.1, or when you are already communicating via a Windows Store app, you’ll know you can apply this protocol. Up-to-date versions of Internet Explorer, Safari, and Firefox all support these protocols.

To create the Windows Store protocol link, append the Package Family Name of your app to the URL:

ms-windows-store:PDP?PFN=

You can retrieve the Package Family Name for your app either from Microsoft Visual Studio, or by visiting your app’s web-based listing page and viewing the page source.

You can also link to your Publisher page by using the following syntax:

ms-windows-store:Publisher?name=[your publisher display name]

Note  Any spaces in your publisher name should be rendered as %20.

When the Store receives a protocol request, it displays the appropriate page of the Store. The Store maintains navigation history and state, just as it does for a user action.

The Store will reject protocol requests that don’t match one of the supported actions or that have invalid or missing parameters. For requests that are properly formatted but result in an inaccessible page, the Store will display an error page.

Protocol actions

Here are the actions you can use with the Windows Store protocol.

ActionDescriptionParameters
PDPOpens an app's listing page.PFN: the Package Family Name of the application
ReviewOpens the "Write a review" page of an app's listing.PFN: the Package Family Name of the application
PublisherOpens the page displaying all apps from a publisher.name: the publisher display name
SearchExecutes a search query and displays the results.query: the query to issue to the Store
UpdatesOpens the Store's updates page.None

 

 

 

Show:
© 2014 Microsoft. All rights reserved.