Search packages, repositories and app categories

GitHub repositorylschmierer/android_play_install_referrer

android_play_install_referrer

A Flutter plugin for the Android Play Install Referrer API.

android_play_install_referrer project cover
Stars
21
Forks
46
Last push (UTC)
Oct 4, 2025
Project status
Archived

Original README

English project snapshot. Visit GitHub for the latest content.

Deprecation!

This project was forked and is maintained by ChunkyTofuStudios. Please use their project instead https://github.com/ChunkyTofuStudios/play_install_referrer

android_play_install_referrer

pub package

A Flutter plugin for the Android Play Install Referrer API. The plugins throws an exception on iOS and on Android if Google Play Services are not available.

Usage

Get Google Play Install Referrer Details:

ReferrerDetails referrerDetails = await AndroidPlayInstallReferrer.installReferrer;

Passing Data Through Google Play Stroe Link

Pass Data With referrer URL query parameter:

Assuming, links could look like this (replace com.example.myapp with real application ID):

https://play.google.com/store/apps/details?id=com.example.myapp&referrer=someKey%3DsomeValue

Explanation

URL Components: ⤵️

Base URL for the app’s Google Play Store page https://play.google.com/store/apps/details?id=

Application ID: com.example.myapp

URL parameter: &referrer=

Custom Key-Value Data: Allows custom key-value pairs, such as someKey as the key and someValue as the value (%3D represents = in URL encoding):

someKey%3DsomeValue

Testing Referral

To test a referral link, release a version of the app on the Play Store. Referral links cannot be tracked through a debug APK, but they will work in testing phases (internal, open, closed) and in production.

Anyone who installs the app by clicking the referral link can be tracked.

For more information see https://developer.android.com/google/play/installreferrer/library.html

Lukas Schmierer GitHub avatar
GitHub author

Lukas Schmierer ↗

DAMEDIC GmbHCologne
LanguagesDartKotlinSwiftObjective-C

Dependencies used

Dependency list 2 items

  • flutter{"sdk":"flutter"}
  • flutter_testDevelopment{"sdk":"flutter"}

How do I choose a repository?

Start with your use case, compare repository activity, and check the original project before adopting it.

  1. Search by repository name, owner or description, then narrow the results by topic.
  2. Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
  3. Read the README, license and issues on GitHub before using a project.

Sources and maintenance

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗