Link to Amazon from within Your App
One way that you can promote your apps is to provide a link directly to the Amazon Appstore or Amazon retail website from within your app. This type of link is called a "deep link" and can be used for several purposes:
- Linking to the paid version of your app in the Amazon Appstore.
- Linking to another one of your apps or all of your apps in the Amazon Appstore.
- Linking customers to the Amazon Appstore or retail website to write a review.
Types of Links and Base URLs
You have two options for providing a deep link to an Amazon client within your app. Each of these options requires a slightly different format for the link's base URL.
The following table describes the two link options and gives the base URL for each for the US-based Amazon website:
|Link to the Amazon Retail Website||This type of link will be picked up by both the Amazon client app and any installed browsers on the device.||http://www.amazon.com/gp/mas/dl/android?|
|Link directly to an Amazon Appstore app||This specially formatted link is the preferred method and will directly open the Amazon Appstore app.||amzn://apps/android?|
Both link formats accept parameters to customize the final URL. The following table lists and describes the available parameters for linking to Amazon.
Note: Your app will not have an ASIN until the app is live on the Amazon Appstore. To add a deep link within your app before the app is live, use the p= parameter and specify the package name.
|Parameter||Description||Amazon Appstore Example||Amazon Retail Web Example|
|s=||Add a search term. Use URL Encoding for special characters, such as spaces ( ).||amzn://apps/android?s=amazon mp3||http://www.amazon.com/gp/mas/dl/android?s=amazon mp3|
|p=||Link to the detail page for a specific package name.||amzn://apps/android?p=com.amazon.mp3||http://www.amazon.com/gp/mas/dl/android?p=com.amazon.mp3|
|asin=||All apps in the catalog have a unique identifier known as an ASIN. Use this identifier to link directly to an app by its ASIN. The ASIN for an app can be found on its detail page.||amzn://apps/android?asin=B004FRX0MY||http://www.amazon.com/gp/mas/dl/android?asin=B004FRX0MY|
|showAll=1||Show all apps by the developer of the app corresponding to the specified package name or ASIN (requires "p" or "asin" arg)||amzn://apps/android?p=com.amazon.mp3&showAll=1||http://www.amazon.com/gp/mas/dl/android?p=com.amazon.mp3&showAll=1|
If you are using a URL for linking, you might need to implement some logic to handle different sites, such as international sites, to reference the proper Amazon domain. For example, for the US, a link like http://www.amazon.com/gp/mas/dl/android?p=com.example.myapp.apk would work in the US, but not in France. In France, the equivalent link might be: http://www.amazon.fr/gp/mas/dl/android?p=com.example.myapp.apk.
To view the full list of countries with their own Appstores, the domains for those countries, and where else residents of those countries may shop for apps, see Countries and Territories Eligible to Shop for Apps.