В этой документации содержится техническая информация по использованию API Play Install Referrer. API-интерфейс Play Install Referrer — это сервисный интерфейс AIDL, который в основном используется программистами, не использующими Java.
Примечание. Библиотека Play Install Referrer представляет собой оболочку API Play Install Referrer и предназначена для помощи Java-программистам в использовании API.
Метод getInstallReferrer()
Этот метод возвращает информацию о реферере установки приложения, соответствующую заданному имени пакета, отправленную через Bundle (ключ, сопоставленный в таблице 1). В ответном Bundle отправленном Google Play, реферальная информация хранится в полях, сопоставленных с ключами, указанными в таблице 2.
Таблица 1. Запрос данных пакета getInstallReferrer() .
| Параметр | Тип | Описание |
|---|---|---|
package_name | String | Имя пакета вызывающей стороны, используемое для устранения неоднозначности. |
Таблица 2. Данные ответа на запрос getInstallReferrer() .
| Ключ | Тип | Описание |
|---|---|---|
install_referrer | String | URL-адрес реферера установленного пакета. |
referrer_click_timestamp_seconds | long | Временная метка на стороне клиента в секундах, когда произошел клик реферера. |
install_begin_timestamp_seconds | long | Временная метка на стороне клиента в секундах, когда началась установка приложения. |
referrer_click_timestamp_server_seconds | long | Временная метка на стороне сервера в секундах, когда произошел клик реферера. |
install_begin_timestamp_server_seconds | long | Временная метка на стороне сервера в секундах, когда началась установка приложения. |
install_version | string | Версия приложения на момент его первой установки. |
google_play_instant | boolean | Указывает, был ли запущен мгновенный интерфейс вашего приложения в течение последних 7 дней. |
Внимание: информация об источнике установки будет доступна в течение 90 дней и не изменится , пока приложение не будет переустановлено. Чтобы избежать ненужных вызовов API в вашем приложении, вам следует вызывать API только один раз во время первого выполнения после установки.