Install referrer
The Play Store hands the app the campaign link that led to its install, readable for 90 days.
In one line
Can learn which ad or link led to your install, for 90 days after
The Play Store hands the app the campaign link that led to its install, readable for 90 days.
Tells an app which ad or link produced the install, with click and install timestamps. No permission is needed, so it is the standard Android attribution signal.
What it can and can't do
What the user does: Nothing. It happens when you first open the app after installing from Google Play
It can
- Find the campaign link that led to your install
- See the click and install times
- Check it any time for 90 days
- Use the Meta and Huawei versions on top of Google's
It cannot
- Work on iPhone; Apple has delayed anonymous reports instead
- Give your name or contact details
- Check it after 90 days
How it differs between platforms: Android only. iPhone uses delayed reports, and some apps use clipboard or fingerprint tricks Apple discourages.
On Android and iPhone
| Android | iPhone | |
|---|---|---|
| Status | Supported | Not supported |
| First version | Android 4.0 (API 9) | Not available |
| Permission or entitlement | None (Play Install Referrer library) | Not listed |
| Protection level | none | none |
| How access is granted | none | not-exposed |
| What the user sees | None | None |
| How long it lasts | Available for 90 days after install | n/a |
| How to take it back | n/a | Not listed |
| Store policy | Play: part of Play Services; referrer must be user safe | None listed |
| API | InstallReferrerClient, ReferrerDetails (referrer URL, click and install timestamps, instant experience flag) | Not listed |
| Notes | Click and install timestamps; 90 day read window; Meta and Huawei have their own referrers | iOS uses SKAdNetwork or AdAttributionKit with coarse postbacks, and deferred deep links via clipboard or fingerprinting (discouraged) |
Data you get
What comes back: Referrer
Shape: object
How often: Once per install
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
referrer | string | None | UTM style | Not listed |
window_days | integer | days | 90 | system |
Technical limits
- Play Store installs only
- Readable only for 90 days
- Valid only for Play installs
- About 90 days of data
- Developer sets the referrer string through the Play URL
The story
What it is
Google Play hands an app the link that led to its install, so it knows which ad worked.
For you
You tap an ad, go to Play and install. The app wakes up and already knows which ad brought you, so it may show a welcome bonus.
For makers
It needs no permission, includes click and install times, and stays readable for 90 days. It is the standard Android way to credit an ad and to power deferred deep links.
Where you see it
| Type | Example | Apps |
|---|---|---|
| games | A game reads the referrer and gives you the free gems from the ad you tapped. | Subway Surfers, Roblox |
| shopping | A store app lands you on the sale page promised in the ad. | Zalando, Temu |
| ads | An ad network proves the install came from its ad and gets paid. | Meta, Google Ads |
| security | Fraud tools compare click and install times to catch click injection. | Adjust, AppsFlyer |
| social | A friend invite link opens the right group after you install. | Telegram |
| analytics | A growth team counts which referral campaign brings the best retention. | Firebase |
Risks
- No permission needed
- Ties your install to an ad click
Android and iPhone in short
- Android: Android only. Available for 90 days after install.
- iPhone: iOS has no equal. SKAdNetwork and AdAttributionKit fill the gap.
What the platform says
- Google: Play Install Referrer API. Securely retrieve the referral content from Google Play, such as which campaign led to the install.
Good uses and abuse
Legitimate uses
- Measure ad spend
Known abuse
- Cross app identity joins
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 2 of 5 | How revealing the data is |
| Utility | 4 of 5 | How useful it is to honest apps |
| Friction | 0 of 5 | How much the user has to do |
| Fingerprint bits | 2 | Rough identifying entropy, when known |
History
- 2017-09, Android Play Install Referrer 1.0: API replaces INSTALL_REFERRER broadcast
- 2017-11, Android Play: Install Referrer API introduced (replaces the broadcast)
- 2019-03, Android Play Services: Broadcast deprecated; library v2 adds click-time fields
- 2020-03, Android Play: Broadcast based referrer deprecated
- 2020-03, Android Library 2.2: Server timestamps added for fraud detection
Related capabilities
Related
- App Clips and Instant Apps. Can run a tiny part of an app from a link or tag, iPhone only
- SKAdNetwork and AdAttributionKit. Can tell an ad network an ad led to an install, in a delayed report
- Deferred deep links. Can send you to the right screen after install, using how you reached the store
- AppsFlyer SDK. Can link your install to an ad and watch what you do in the app
Same idea on the web
- Ad click IDs (gclid, fbclid, msclkid and more). Can tag your ad click so a later purchase links back to that exact ad
Sources
- Android: Play Install Referrer
- Android: InstallReferrerClient
- Android: Play Install Referrer library
How well checked: Based on official documentation.