Apple replacing the LinkShare and DGM networks of their Affiliate Program with (the much superior and real-time) Performance Horizon provided an excellent excuse to dig deeper into the components of iTunes, App Store and Mac App Store links. These are my findings and open questions.
Dissecting a link
This is how a link generated with iTunes Link Maker looks (plus campaign tracking):
The components and parameters of this link are:
- Country code, optional. E.g.,
- Action, mandatory. Indicates which store holds the linked item. E.g.,
- Description, optional. For descriptive purposes only. E.g.,
- Primary ID, mandatory. Uniquely identifies the linked item.E.g.,
uo=4, optional. Meaning unknown.
- Media type, optional. E.g.,
- Affiliate ID, optional. E.g.,
- Campaign text, optional. E.g.,
All these components are shared by iTunes, App Store and Mac App Store links. We’ll talk about some of them in more detail below.
The country code is optional but Apple recommends to keep it. They say:
If you are dealing with a link that does not have a country code (for example, most EPF links are not tied to a country), you should insert one that is appropriate for your users. The country code serves as a hint to the store. If the specific content is not available in the user’s storefront, iTunes prompts the user to switch storefronts to view the requested content.
The country code also serves as a hint for the default language of the page requested when the user’s preferred language is unknown. If no country code exists on the link, iTunes defaults to the U.S. storefront.
In other words, keep the country code to let Apple know which localized version of the item it should display to the user.
mt parameter (mostly known for
mt=8) indicates the media type of the linked item, and gives the OS another hint of which store it should open. Over StackOverflow user Ted has compiled its various known values:
4 TV Shows
5 Music Videos
7 iPod Games
8 Mobile Software Applications
10 iTunes U
12 Desktop Apps
Many developers are tempted to remove this seemingly useless parameter, but it is not recommended. On Mac, it will open the Mac App Store when linking to a Mac app. On iOS, it will reduce the number of redirects when linking apps. And it might have future uses.
After signing up for the Performance Horizons affiliate program you will receive your affiliate ID, which is indicated by the
at parameter. Including the affiliate ID on your links will not only give you a commission from sales but also provide precious download/sales/conversion rate information.
While Apple states “add this to the end of any iTunes, App Store or iBooks Store URL to be eligible for commissions“, this is not exactly true. As shown below, not all links work affiliates tracking:
ct parameter allows you to differentiate between campaigns. From Apple’s documentation:
The “ct” value is campaign text that you can optionally add to any link in order to track sales from a specific marketing campaign. By using a campaign value, you will see in the reporting dashboard all clicks and sales related to that specific campaign.
For example, the link below has added a campaign tracking parameter for a newsletter link. You can name the campaigns anything you choose, but the “ct” value may not be longer than 45 characters:
To those familiar with Google Analytics campaigns,
ct is the equivalent of
utm_source (Campaign Source).
- What does the
uoparameter mean? What is the effect of removing it?
- Is it possible to add affiliate and campaign tracking to
appstore.comshort URLs (e.g.,