play install referrer api что это такое
Play install referrer api что это такое
Play Install Referrer Library wrapper for Unity
| Supported platforms: |  |
| Current version: | 3.0.0 |
| Unity IDE support: | 2017.4.39f1 and later |
| Latest release: | Download |
| Troubles? | Report an issue |
play-install-referrer is a simple wrapper around Google’s Play Install Referrer Library which offers basic functionality of obtaining Android referrer information from Unity app.
More information about Play Install Referrer API can be found in official Google documentation.
Version of native Play Install Referrer Library which is being used inside of latest play-install-referrer plugin version is 2.1.
In order to obtain install referrer details, call GetInstallReferrerInfo static method of PlayInstallReferrer class:
Instance of PlayInstallReferrerDetails object will be delivered into callback method. From that instance, you can get following install referrer details:
You should first check if Error property is null or not. If not, for some reason reading of install referrer details failed and those properties will be null. In case no error is reported, install referrer detail properties should reflect the values obtained from native Install Referrer Library response.
Important thing to notice is that in order to work properly, Play Install Referrer Library requires following permission to be added to your app’s AndroidManifest.xml :
Play Install Referrer Library is added to play-install-referrer plugin as an AAR library and it will automatically make sure that manifest file ends up with above mentioned permission added to it upon building your app.
List of tasks to be done in this repository can be found in here.
Static method for getting install referrer details.
| Parameters | Description |
|---|---|
| callback | Action : Callback to which install referrer information will be delivered. |
Public property containing information about install referrer string value.
Public property containing information about timestamp of when user clicked on URL which redirected him/her to Play Store.
Public property containing information about timestamp of when app installation on device begun.
Public property containing information about server timestamp of when user clicked on URL which redirected him/her to Play Store.
Public property containing information about server timestamp of when app installation on device begun.
Public property containing information about original app version which was installed.
Public property containing information if app’s instant version was launched in past 7 days.
Public property containing information about error which might have occured during attempt to read install referrer details.
Public property containing information about one of the error response codes which native Install Referrer Library might return. Full list of potential response codes can be found in here ( OK will never be reported in this property, since it’s a success status code).
Public property containing information about potential exception which might have occurred during attempt to read install referrer details.
About
Play Install Referrer Library ported to Unity
Install referrer
An install referrer is a unique, anonymous string of numbers specific to Android devices.
What is an install referrer?
An install referrer, otherwise known as a Google install referrer, is an identifier unique to Android devices which enables marketers to attribute ad activity to media sources for Google Play Store apps (also supported for some other stores, such as the Huawei Store).
The install referrer is essentially a string of code that the attribution provider uses to send parameters to the Google Play Store when an ad is clicked.
Once this occurs, they are then passed back to the source when the app is downloaded.
Why are install referrers important to attribution?
Install referrers are one of the most accurate methods of measuring user engagement with ads, especially compared to fingerprinting.
In fact, an install referrer guarantees as close to 100 percent accuracy as is possible, considering bugs or other potential issues that may arise.
Overall, install referrer, along with ID matching, gives Android not just one, but two highly accurate options for attribution, a clear advantage in understanding the full story of an app install.
In the install referrer matching, a custom attribution ID, which cannot be reset, is automatically added to the referrer string by the attribution provider before being sent to the Google Play Store. In turn, it removes the need for a network configuration, leaving the attribution provider dependent only on itself.
In addition, the newly released Google Referrer API, developed jointly by AppsFlyer and Google, significantly reduces the amount of install hijacking fraud that occurs with the install referrer. This gap is closed by authenticating referrer data and actively blocking referrer injection. In other words, the new install referrer allows marketers to understand what users are doing between a click on an install referrer ad and install. In turn, marketers are better prepared to combat install hijacking fraud, as well as to make better product and marketing decisions.
The data included in the new Google install referrer includes:
Play install referrer api что это такое
Play Install Referrer Library wrapper for Cordova
cordova-play-install-referrer is a simple wrapper around Google’s Play Install Referrer Library which offers basic functionality of obtaining Android referrer information from Cordova app.
More information about Play Install Referrer API can be found in official Google documentation.
Version of native Play Install Referrer Library which is being used inside of latest cordova-play-install-referrer plugin version is 2.1.
Add plugin to your app
cordova-play-install-referrer plugin is hosted on npm repo and can be added from there.
In order to obtain install referrer details, call getInstallReferrerInfo static method of PlayInstallReferrer class:
If successfully obtained, map with content of install referrer information will be delivered into callback method. From that map, you can get following install referrer details:
Remaining two fields are indicators of error which might have occurred. If error happened, error message is guaranteed that it will be available, so you should first check if error message is null or not before trying to read above mentioned fields. Remaining error related fields are:
In case error is reported, you can get following information about the error:
Important thing to notice is that in order to work properly, Play Install Referrer Library requires following permission to be added to your app’s AndroidManifest.xml :
Play Install Referrer Library is added to cordova-play-install-referrer plugin as an Gradle dependency and it will automatically make sure that manifest file ends up with above mentioned permission added to it upon building your app.
List of tasks to be done in this repository can be found in here.
Play install referrer api что это такое
Play Install Referrer Library wrapper for React Native
react-native-play-install-referrer is a simple wrapper around Google’s Play Install Referrer Library which offers basic functionality of obtaining Android referrer information from React Native app.
More information about Play Install Referrer API can be found in official Google documentation.
Version of native Play Install Referrer Library which is being used inside of latest react-native-play-install-referrer plugin version is 2.2.
Add plugin to your app
react-native-play-install-referrer plugin is hosted on npm repo and can be added from there.
Yarn:
In order to obtain install referrer details, call getInstallReferrerInfo static method of PlayInstallReferrer class:
If successfully obtained, map with content of install referrer information will be delivered into callback method as first parameter. From that map, you can get following install referrer details:
In case error is reported, you can get following information about the error:
Important thing to notice is that in order to work properly, Play Install Referrer Library requires following permission to be added to your app’s AndroidManifest.xml :
Play Install Referrer Library is added to react-native-play-install-referrer plugin as an Gradle dependency and it will automatically make sure that manifest file ends up with above mentioned permission added to it upon building your app.
You can find example app using react-native-play-install-referrer plugin inside app folder of this repository. In case you want to run the app (with re-adding plugin), you can run this command inside app folder:
List of tasks to be done in this repository can be found in here.
About
Play Install Referrer Library ported to React Native
Play install referrer api что это такое
Install Referrer is an Open Source application that allows you to test the referrer attribute on the Google Play Store.
You can test referrer attribute using these links below:
Market url scheme
market://details?id=fr.simon.marquis.installreferrer&referrer=myReferrerValue
Chrome Intent
intent:#Intent;package=fr.simon.marquis.installreferrer;S.market_referrer=myReferrerValue;end
The referrer attribute will be broadcasted by the Play Store to your app after the first launch only.
Feel free to contribute to InstallReferrer.
Either you found a bug or have created a new and awesome feature, just create a pull request.
If you want to start to create a new feature or have any other questions regarding InstallReferrer, file an issue.