App stores
What is a custom store listing on Google Play?
Short answer
A custom store listing is an alternative version of your Google Play store page, shown to a chosen audience instead of the default listing. You can create up to 50. Each can be targeted by country, by ad traffic, by user state or by a unique URL that ends in a listing parameter you name yourself.
What you can change
Each custom store listing can have its own app name, icon, descriptions and graphics, including screenshots. Contact details, the privacy policy and the app category stay shared across all versions.
Your existing page becomes the default listing. People see it whenever no custom listing applies to them. Custom listings are not translated automatically, so add the languages your audience reads.
How a listing is targeted
Google Play offers several ways to decide who sees a listing. Country targeting shows it to people in the places you pick, and a country can belong to only one custom listing at a time. Ads traffic shows it to people who arrive from a Google ad. User state options cover people who can pre-register, people who uninstalled the app and people who stopped opening it. A listing can also target specific search keywords.
The option that matters for links is the custom store listing URL. You type a parameter value when you create the listing, and Google Play serves that listing to anyone who opens the app’s link with listing= and that value on the end.
The listing URL
The format is play.google.com/store/apps/details?id= plus the package name, then &listing= plus your value. The value has to be unique among your listings and can contain lowercase letters, digits, periods, hyphens, underscores and tildes.
This is Google Play’s counterpart to the custom product page on the App Store. The difference is in the ID: Apple generates a ppid for each page, while on Google Play you choose a readable value such as yoga or spring-sale.
A campaign that runs on both platforms needs both URLs behind one link. Create a smart link for the campaign, set the custom product page URL as the iPhone destination and the custom store listing URL as the Android destination. Appy accepts both and keeps ppid and listing as you pasted them.
If you also pass an install referrer, add it to the same URL as a separate referrer parameter. The two do different jobs: listing picks the page, referrer tells your app where the install came from.
https://play.google.com/store/apps/details?id=com.example.app&listing=yogaTry it here
Build a store campaign link
Paste your App Store or Google Play link and add the campaign details. You get links that show up in App Store Connect and Play Console reports.
App Store campaign link
Three values: your app, your provider token (pt) and a campaign name (ct). The builder adds mt=8 and encodes the rest.
Your App Store page, or just the number after “id”. A link that already has pt= fills in the token too.
Paste the custom product page URL from App Store Connect, or just its ppid. Leave empty for your default page.
Digits only. One number for your whole developer account.
This is the name you will see in App Store Connect.
No provider token yet?
- 01In App Store Connect, open Apps, pick your app and go to Analytics. Under Acquisition, choose Campaigns and press +.
- 02Make one campaign link there and copy the number after pt=. That is your provider token.
- 03It stays the same for every campaign, so from now on you can build the links here.
Your App Store campaign link
Fill in all three fields to get the link.
The campaign shows up in App Store Connect at least 24 hours after launch, and only once five or more people have downloaded the app through it for the first time.
Google Play referrer link
Google Play reads campaign tags from one place: the referrer parameter. Fill in the UTMs and the builder encodes them into it.
Your Play Store listing, or the id value from it.
The URL parameter you gave the listing in Play Console. Leave empty for your main store listing.
Where the click comes from.
The kind of traffic.
Use the same name as your ct and the two reports line up.
Your Google Play link
Add the app and the three required UTM fields to get the link.
One link for both
Put both behind one smart link
Share one short link instead of two. iPhones get the App Store campaign link, Android phones get the Google Play link, and the clicks are counted in one place.
- iPhone and iPadNot set yet
- AndroidNot set yet
- ComputerNot set yet
Every Appy link comes with a QR code, so the same campaign works on a poster too.
Free plan. No credit card.
What happens next
- 01Sign up free with Google or email
- 02We create the link with both stores
- 03Share the link or download its QR code
Frequently asked questions
What is the listing parameter in a Google Play URL?
It selects a custom store listing. A link that ends in &listing=yoga opens the listing whose URL parameter is yoga. You choose the value in Play Console when you create the listing, and it must be unique across your custom store listings.
How many custom store listings can an app have?
Up to 50 on Google Play. The App Store’s equivalent, the custom product page, allows up to 70 per app. On both stores the default page stays in place for everyone who is not sent to a custom version.
What is the difference between a custom store listing and a custom product page?
They are the same idea on different stores. A custom store listing is Google Play’s version and is chosen by a listing value you name. A custom product page is the App Store’s version and is chosen by a ppid that Apple generates.
Related terms
- Custom product page
A custom product page is an extra version of your App Store product page with its own screenshots, promotional text and app previews. You can create up to 70 of them. Each has a unique URL with a product page ID, so ads and links can send people to the version that matches the campaign.
- App Store campaign link
An App Store campaign link is an App Store URL with three extra parameters, pt (provider token), ct (campaign token) and mt=8, so App Store Connect can report impressions, product page views, downloads and sales for each campaign. The numbers are aggregate: they show how a campaign did, not who installed.
- App store link
An app store link is the address of an app’s page in a store. On the App Store it looks like apps.apple.com/<country>/app/<name>/id<number>; on Google Play, play.google.com/store/apps/details?id=<package>. The scheme versions, itms-apps:// and market://, open the store app itself instead of a web page.
One link for every phone
Create a free smart link and QR code that sends iPhones to the App Store, Android phones to Google Play and desktops to your website.