Skip to main content

Link to Your Game

Getting the URL of your game​

Once your game is live on Microsoft Start, you can get a Microsoft Start URL of your game by going to our main product site.

From there, you should be able to discover your game, and click on it to get to its page where the URL can be then seen. The URL follows the pattern: https://www.msn.com/en-us/play/game-name/cg-game-id. For example, the game Microsoft Solitaire Collection with ID mssolitairecollection, its URL would be https://www.msn.com/en-us/play/microsoft-solitaire-collection/cg-mssolitairecollection.

By promoting the URL from Microsoft Start instead of your game's PWA URL directly, you will get the full benefit of all the functionality from our SDK as well as the Microsoft Start product.

Passing custom URL parameters into your game​

When promoting a Microsoft Start game URL, sometimes you might want to pass custom URL parameters all the way into your game's PWA page being loaded by our iframe for analytics purposes.

To enable this use case, we provide a special URL parameter "msstart3pp" (3rd party payload) that will get passed through into the iframe URL.

For example, if users visit https://www.msn.com/en-us/play/microsoft-solitaire-collection/cg-mssolitairecollection?msstart3pp=custom_value, this "msstart3pp=custom_value" parameter will be applied to the game URL being loaded in the iframe so that the game can detect and use it for analytics.