Skip to content

Where do your iOS app downloads come from?

Which post, site or newsletter sent your iOS app's downloads? How to make App Store campaign links, where to read them, and why the numbers come up short.

On this page
  1. What can App Store Connect tell you about where downloads come from?
  2. What is a campaign link?
  3. Why can't you make a campaign link before launch?
  4. How do you make a campaign link?
  5. What should you call your campaigns?
  6. Where do you read campaign numbers?
  7. Why does App Store Connect show less than you expected?
  8. What do your launch week numbers mean?
  9. Can you use campaign links on your own website?
  10. When is a custom product page better than a campaign link?
  11. Where Launch Indie Apps fits
  12. Do this today
  13. Common questions
  14. Sources

The short answer

Give every place you post its own App Store campaign link. App Store Connect makes them under Analytics, Acquisition, Campaigns: your App Store link plus a provider token and a campaign name. A day later, Analytics shows page views and first-time downloads for each one, once at least five people have downloaded through it.

Launch week ends with one number in App Store Connect. Downloads went up on Tuesday.

Was it the Reddit post? The directory? The friend who shared it? The graph doesn't say.

Campaign links answer that, as long as you know where they stop. Apple rebuilt Analytics in App Store Connect in March 2026, so this is how they work now.

What can App Store Connect tell you about where downloads come from?

More than most makers think, and less than they hope. Here's what each part answers:

Your questionWhere to lookWhat it won't tell you
Did people find me in the App Store or outside it?Analytics, Acquisition, SourcesWhich post or site sent the outside ones
Which app sent them, such as Reddit or X?Sources, App referrerWhich post or which subreddit
Which website sent them?Sources, Web referrerTaps from Chrome on iOS, which count as the Chrome app
Which post, listing or newsletter sent them?A campaign link per placeAnyone who downloaded more than 24 hours after tapping
Did they keep using the app?The same campaign, with usage metricsPeople who don't share usage data with developers

The first three rows cost nothing to set up. Apple sorts every download into a source type:

  • App Store search and App Store browse. People who found you inside the App Store, ads in search results included.
  • App referrer. A tap on a link inside another app, such as Reddit, X or Messages.
  • Web referrer. A tap on a link on a website in Safari. If the link went through redirects, the last address in the chain gets the credit.

So you can see "Reddit". You can't see which of your three Reddit posts it was. And Apple shows referrers and campaigns only above a minimum amount of data, so a small launch may see nothing in those rows at all.

That gap is what campaign links are for.

Your App Store link with three extra parameters. This is Apple's own example:

https://apps.apple.com/app/apple-store/id123456789?pt=123456&ct=test1234&mt=8

  • pt is your provider token. It identifies your developer account, not an ad network, and it's the same on every campaign link you make.
  • ct is the campaign token. The name you give the campaign, up to 30 characters.
  • mt is the media type. Leave it as Apple makes it.

Someone who taps it lands on your normal product page, in their own country's store. Nothing on the page changes. Only the counting does.

Because Apple won't let you yet. The add button next to Campaigns appears only once your app has analytics data. Apple says to check back after the app has been live and getting downloads for at least 24 hours.

You can't get around it by typing a provider token yourself, either. It comes with your first campaign link.

For a first app, that rules out the usual advice to have every link ready weeks ahead. Two things work instead:

  • Release quietly first. Set the version to release manually, release it a few days before you tell anyone, and ask a few friends or testers to download it. Once the button appears, make your links. Then announce.
  • Start with your second place. Post in the first place with a plain App Store link and use campaign links from day two.

I'd pick the quiet release. Your launch day is the day you tell people, and nobody can tell the version went live three days earlier.

Once the button is there, it takes a minute (Apple's steps):

  1. In App Store Connect, open Apps and select your app.
  2. Click the Analytics tab.
  3. In the Acquisition section, click Campaigns.
  4. Click the add button (+) next to Campaigns.
  5. Type a campaign name. That name becomes the ct token.
  6. Copy the link.

After the first one, Apple's advice is to keep the same provider token and change only the campaign token. So once you know your pt, the next links are just a new name at the end.

What should you call your campaigns?

One name per place, and a new one each time you post there again. Pick names you'll still understand in a month:

Where you postCampaign name
Your launch post on Xx-launch
A reply under someone else's thread on Xx-reply-nov
A post in r/iosappsreddit-iosapps
A second post there, after an updatereddit-iosapps-v2
Product Huntproducthunt
A directory listingdir-name-of-site
A newsletter that features younews-name-issue-12
The download button on your own sitesite-button

Keep each name within 30 characters, with no space at the start or end. And keep a note of what each one means. Apple doesn't ask, and in six weeks you won't remember what "test2" was.

Where do you read campaign numbers?

In the Analytics tab, click Metrics in the sidebar, then Add Filter, then Campaign, and pick one from the menu. Apple tracks impressions, product page views, downloads, usage, sales and subscriptions for each campaign.

In launch week, three of them matter (Apple's definitions):

  • Product page views. People who opened your page from that link.
  • First-time downloads. People who got the app for the first time. Judge each place by this one.
  • Redownloads. People who had the app before. Mostly noise in launch week.

New campaigns show up at least 24 hours after their launch. Check the next morning, not the next hour.

Why does App Store Connect show less than you expected?

Because campaign data is built to protect privacy, and it leaves people out on purpose:

  • Five is the floor. Each metric shows only if it reaches at least 5 in the date range you picked, and a campaign appears once five people have downloaded through it for the first time. If you see "not enough data", widen the date range.
  • 24 hours to decide. A first download counts for the campaign only if it happens within 24 hours of tapping the link. Someone who taps on Monday and downloads on Friday doesn't count for it.
  • The last link wins. Someone who taps two of your campaign links gives the credit to the most recent one.
  • Usage needs consent. Sessions and other usage numbers come only from people who agreed to share their diagnostics and usage information with developers.
  • Promo codes have no source. A download through a promo code or gift card shows as Unavailable. That includes the codes you send to writers.
  • Redownloads start over. When someone deletes the app and downloads it again from the App Store, the new download gets the new source.

So read campaign numbers as a floor, and as a comparison between places. Not as a total.

What do your launch week numbers mean?

Put each place in a row, then look at the pattern rather than the size:

What you seeWhat it usually meansWhat to do
Page views, almost no first-time downloadsThe post worked; the product page didn't convinceFix the first screenshot and the first line of the description
First-time downloads close to page viewsThe people there were already looking for an app like yoursPost there again after your next update
Nothing at all for a campaignFewer than 5 first-time downloads, or less than a day has passedWait a day, then widen the date range
A jump under App referrer or Web referrer, not under your campaignSomeone shared a plain App Store linkFind where it came from and say thanks
Downloads but almost no sessions laterEither few people share usage data, or they didn't come backLook at retention before blaming the place

Then look at time. Say one place took ten minutes and brought six first-time downloads, and another took a whole day for twenty. With nine more places to try, the first one won. That's why free places to promote an iOS app are worth a campaign link each: a month later you know which ones earned a second post.

Yes, and you should. Put one on every "Download on the App Store" button on your site, with a name like site-button. If your site shows a Smart App Banner in Safari, Apple says to add your campaign and provider tokens to it too.

The same goes for anything you post: your X launch post, your Reddit posts, your email signature. A plain App Store link anywhere is a download you can't place.

When a place needs a different pitch, not just a different count.

A custom product page has its own screenshots, promotional text and address, and Apple now lets you publish up to 70 of them per app. Each one gets its own metrics after five first-time downloads, under Acquisition, Product Pages.

For launch week, campaign links are enough. Later, when one place keeps sending people, give it its own page, with screenshots that answer the question those people keep asking. The 30-day launch plan puts that in week three.

Where Launch Indie Apps fits

On Launch Indie Apps, a listing's Launch Reports at day 7 and day 30 count the step before the download: views of your listing, clicks to the App Store, and where those visitors came from. A click isn't a download, and we never call it one. For downloads, App Store Connect is the only honest source, and campaign links are how you read it.

Do this today

Open App Store Connect, go to your app's Analytics tab and look for Campaigns under Acquisition. If the add button is there, make links for the next two places you'll post and write down what each name means. If it isn't, plan a quiet release a few days before your launch day.

Common questions

How do I track where my iOS app downloads come from?

App Store Connect sorts downloads by source under Analytics, Acquisition, Sources: App Store search, App Store browse, app referrers and web referrers. To see which post or site sent them, give each place its own campaign link and filter Analytics by campaign.

Why can't I create a campaign link in App Store Connect?

The add button next to Campaigns appears only once your app has analytics data. Apple says to check again after the app has been live and getting downloads for at least 24 hours.

Why does App Store Connect analytics say there isn't enough data?

Campaigns, app referrers and web referrers need a minimum amount of data before Apple shows them. For campaigns, each metric needs at least 5 in the date range you picked, so a wider date range often fixes it.

What do pt and ct mean in an App Store link?

pt is your provider token, which identifies your developer account and stays the same on every campaign link. ct is the campaign token, the name you gave the campaign, up to 30 characters.

Sources

A note from Rashem

Our Launch Reports stop at the App Store click, because that's as far as a website can honestly see. Campaign links are how you see the rest. If the Campaigns button still hasn't appeared a week after your release, write to me at hello@launchindieapps.com and we'll work out why.

For iOS app makers

Launch your app here

  • Reviewed by a person
  • Launch posts written for you
  • App Store clicks counted for 30 days
Launch your app

Not approved? Refunded.

Read next

Launching

How to launch an iOS app: the first 30 days after approval

The first 30 days after App Review says yes: when to release, where to post first, what to measure and what to do when the launch goes quiet.

October 16, 2026 · 5 min read
Where to promote

Where can you promote an iOS app for free?

Free places to promote an indie iOS app, from Apple's featuring nomination to subreddits, launch platforms, directories and press. With the catch for each.

October 16, 2026 · 4 min read
Where to promote

How do you pitch your iOS app to the press?

What goes in an iOS app press kit, who covers indie apps and how each wants a pitch, how to let writers try a paid app, and why to skip the press release.

November 3, 2026 · 9 min read

A few great apps. Every week.

Handpicked indie iOS apps in your inbox. Free, and one click to unsubscribe.

No spam. Just great apps.