InstallReferrer Extension - Play Install Referrer Library (2.2)

InstallReferrer - Play Install Referrer Library (2.2)

You can use the Google Play Store's Install Referrer API to securely retrieve referral content from Google Play. The Play Install Referrer API Client Library is written in the Java programming language and is a wrapper for the Android Interface Definition Language (AIDL) file that defines the interface to the Install Referrer service. You can use the Play Install Referrer API Client Library to simplify your development process.

This guide covers the basics of retrieving referral information from Google Play using the Play Install Referrer Library.


Start Connecton

Before you can use the Play Install Referrer API Library, you must establish a connection to the Play Store app. Call the StartConnection to establish a connection to Google Play.

blocks (8)

End Connection

After getting referrer information, call the EndConnection to close the connection. Closing the connection will help you avoid leaks and performance problems.

blocks (9)


Connection established.

blocks (10)


Try to restart the connection on the next request to Google Play by calling the StartConnection method.

blocks (11)


Read the message param to know about the error.

blocks (12)


After you have established a connection to the Play Store app, get the details from the install referrer.

Caution: The install referrer information will be available for 90 days and won't change unless the application is reinstalled. To avoid unnecessary API calls in your app, you should invoke the API only once during the first execution after install.

blocks (14)


referrerUrl: The referrer URL of the installed package.
referrerClickTime: The timestamp in seconds when referrer click happens.
appInstallTime: The timestamp in seconds when installation begins.
googlePlayInstant: Boolean indicating if the user has interacted with the app's instant experience in the past 7 days.

blocks (13)


This event will be triggered when the extension failed to get referrer details.

blocks (15)

Extension specifications:


Could do with having a blocks example with inputs / outputs shown?

1 Like