Skip to Content
Platform.Ontology

Install referrer

The Play Store hands the app the campaign link that led to its install, readable for 90 days.

Used to track youAds and install trackingInstall attributionAndroid and iPhoneWhen the app opensBefore you install

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

AndroidiPhone
StatusSupportedNot supported
First versionAndroid 4.0 (API 9)Not available
Permission or entitlementNone (Play Install Referrer library)Not listed
Protection levelnonenone
How access is grantednonenot-exposed
What the user seesNoneNone
How long it lastsAvailable for 90 days after installn/a
How to take it backn/aNot listed
Store policyPlay: part of Play Services; referrer must be user safeNone listed
APIInstallReferrerClient, ReferrerDetails (referrer URL, click and install timestamps, instant experience flag)Not listed
NotesClick and install timestamps; 90 day read window; Meta and Huawei have their own referrersiOS 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

FieldTypeUnitRangePrecision
referrerstringNoneUTM styleNot listed
window_daysintegerdays90system

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

TypeExampleApps
gamesA game reads the referrer and gives you the free gems from the ad you tapped.Subway Surfers, Roblox
shoppingA store app lands you on the sale page promised in the ad.Zalando, Temu
adsAn ad network proves the install came from its ad and gets paid.Meta, Google Ads
securityFraud tools compare click and install times to catch click injection.Adjust, AppsFlyer
socialA friend invite link opens the right group after you install.Telegram
analyticsA 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

Good uses and abuse

Legitimate uses

  • Measure ad spend

Known abuse

  • Cross app identity joins

Scores

ScoreValueMeaning
Sensitivity2 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits2Rough 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

Same idea on the web

Sources

How well checked: Based on official documentation.

On this page