Campaign Link Inspector
Try Interactive Test Examples
Includes Provider Token (pt), Campaign Token (ct), and Media Type (mt=8).
Plain App Store link without any attribution tokens.
Contains modern SKAN / AdAttributionKit parameters.
The Complete Guide to iOS App Store Campaign Tracking & Attribution
Tracking mobile app installs on iOS requires a completely different approach than standard website analytics. If you try to use standard Google Analytics UTM parameters (like utm_source and utm_medium) on an Apple App Store link, the parameters will be completely ignored.
Instead, Apple provides its own native attribution framework within App Store Connect Analytics. This framework relies on specific query parameters—most importantly the Provider Token (pt) and Campaign Token (ct)—to track where your app installs are coming from. Our iOS Campaign Validator ensures that your tracking links are properly constructed using this exact Apple-mandated syntax.
The Core Apple Analytics Parameters
To successfully measure your iOS marketing campaigns, you need to append specific parameters to your App Store URLs. Here is a detailed breakdown of the parameters you must use:
- Provider Token (pt): This is your unique developer identifier. You can generate or find your Provider Token by logging into App Store Connect, navigating to "App Analytics", clicking on your app, and selecting "Campaigns". Without the
ptparameter, Apple cannot link the campaign data to your specific developer account. - Campaign Token (ct): This is the name of your specific marketing campaign (e.g.,
spring_launchorfacebook_ad_v2). Warning: Apple strictly limits the Campaign Token to a maximum of 40 characters. If yourctexceeds this length, it will be truncated, leading to fragmented or missing data. - Media Type (mt): This parameter tells the Apple ecosystem what type of content the link resolves to. For iOS apps, you should always set
mt=8. (For context,mt=1is for music, andmt=11is for podcasts). While the App Store app can often infer the content type from the URL path, explicitly definingmt=8ensures a smooth, uninterrupted redirect for the user. - Affiliate Token (at): This parameter is only necessary if you participate in the Apple Services Performance Partner Program. It tracks referral commissions. For standard marketing attribution, it is not required.
Example of a Perfect iOS Campaign URL
https://apps.apple.com/app/id123456789?pt=118431040&ct=summer_campaign_2026&mt=8This link directs to an app, links the click to provider 118431040, tags the install as summer_campaign_2026, and specifies the media type is a software app.
Native App Analytics vs. Third-Party MMPs
It's crucial to understand that the pt and ct parameters discussed above only populate data in Apple's App Store Connect Analytics.
If you are using a third-party Mobile Measurement Partner (MMP) such as AppsFlyer, Adjust, Branch, or Kochava, you do not use these Apple-native parameters. Instead, you must use the proprietary tracking links generated by your MMP (e.g., https://app.appsflyer.com/id123456789?pid=facebook_int).
The Impact of SKAdNetwork (SKAN) and ATT
Since the introduction of iOS 14.5 and the App Tracking Transparency (ATT) framework, mobile marketing has changed dramatically. Apple severely restricted access to the IDFA (Identifier for Advertisers).
Support ValidateURL
Find this tool useful?
ValidateURL is completely free. If our tools saved you some time today, consider buying us a coffee to help keep the servers running! ☕
Support Us on Ko-fiFrequently Asked Questions
Learn more about campaign tracking and how to get the most out of your data.