Android google play referrer

How to Use Google Play Install Referrer API in Android?

Google Play Install Referrer is the API that is used in most of the applications but it is not been seen in the app. This functionality works under the hood and is used to check the sources from where the app is getting most of the downloads. Google Play Install Referrer API tells us that from where the app has to go installs and the sources. This will helps us to improve the presence of our apps on different platforms.

What is the use of Google Play Referrer API?

Google Play Referrer API provides us information from where our app has been installed whether it may be play store or any other platform. With the help of this API, we can track the actions which are taken by the user to download our App. Below are some of the important data which we can gather using this API.

Attention reader! Don’t stop learning now. Get hold of all the important Java Foundation and Collections concepts with the Fundamentals of Java and Java Collections Course at a student-friendly price and become industry ready. To complete your preparation from learning a language to DS Algo and many more, please refer Complete Interview Preparation Course.

• With the help of this API, we can track from where the user has installed our application. We can get the URL from which our app has been downloaded.
• We can get the timestamp when the user clicks on the referrer URL.
• We can get the timestamp of the user when the user downloads our app from a specific URL.
• We can get the app version when our app was first installed.
• We can track whether the user has used the app’s instant experience with the previous 7 days.

What we are going to build in this article?

We will be building a simple application in which we will be adding our Google Play Referrer API and we will be displaying the data which is tracked by this API in a simple text view. Note that as we have not published our App to Google Play. So we will only get the source from which our app installed as organic. Below is the screenshot in which we will get to see what we are going to build in this article. Note that we are going to implement this project using the Java language.

Step by Step Implementation

Step 1: Create a New Project

To create a new project in Android Studio please refer to How to Create/Start a New Project in Android Studio. Note that select Java as the programming language.

Step 2: Add the dependency for Google Play Referrer API in the build.gradle file

Navigate to Gradle scripts and then to build.gradle(Module) level. Add below line in build.gradle file in the dependencies section.

// below is the dependency for referer

Источник

Как пользоваться Google Play Install Referrer

Понимание того, как люди находят ваше приложение и что они делают, когда его устанавливают, очень важно для хорошего маркетинга. Особенно в том случае, если вы проводите свою рекламную компанию. Сегодня многие компании и рекламные сети предлагают решения на основе реферальных данных, которые позволяют определить, сколько было переход по ссылкам на приложение и откуда.

С этой целью Google выпустил новый API под названием Google Play Install Referrer, с помощью которого ваше приложение получит точную и безопасную информацию о содержимом реферала прямо из Google Play. В частности, вы можете узнать следующие данные:

• URL-адрес реферала
• Временная отметка в секундах, когда произошёл клик по реферальной ссылке
• Временная отметка в секундах, когда началась установка приложения

Новый API работает на любых устройствах, однако для его работы требуется версия Google Play 8.3.73 и выше. Также должна иметься учётная запись в Developer Console для использования Google Play Install Referrer.

Добавление Google Play Install Referrer в своё приложение

Для того, чтобы начать работу с API, вам нужно будет добавить в зависимости проекта бибилотеку InstallReferrerLibrary. Библиотека доступна на репозитории Maven, чтобы использовать её, откройте файл build.gradle модуля приложения и добавьте следующую строчку в блок dependencies.

Теперь вам нужно установить связь между приложением и Google Play, поскольку приложение и магазин общаются через сервис. Для этого в коде активности, например MainAcivity, нужно создать экземпляр класса InstallReferrerClient и вызвать метод startConnection().

В качестве параметра в метод startConnection() нужно передать слушатель InstallReferrerStateListener, который будет отлавливать результат выполнения операции. В данном примере мы объявили слушатель отдельно и передали его в параметры, однако можно сделать это и иначе, используя implements.

Затем нужно обработать результаты выполнения операций, для этого нужно переопределить метод onInstallReferrerSetupFinished(). Это нужно также для того, чтобы отслеживать потерю соединения с Google Play, например, когда он обновляется в фоновом режиме.

Код слушателя выглядит следующим образом:

В методе onInstallReferrerSetupFinished() приходит результат выполнения операции соединения. Если соединение установлено, мы можем получить данные о реферале, вызвав метод клиента getInstallReferrer() и передав в экземпляр класса ReferrerDetails. С помощью этого объекта мы уже может получить конкретные данные, о которых говорили в начале статьи (url-адрес и временные отметки).

После получения данных не забудьте вызвать метод endConnection() для закрытия соединения, чтобы избежать утечек памяти и производительности.

Полученную информацию уже можно обрабатывать так, как вам угодно. Например, выводить всплывающее сообщение, в котором будет указано, откуда пользователь перешёл в Google Play.

К примеру, добавим реферальную ссылку для приложения Фонарик. При переходе по этой ссылке вы попадёте в Google Play, затем, установив приложение и запустив его, увидите во всплывающем сообщении, что в источнике указан наш сайт.

На этом всё. Если хотите, вы также можете изучить официальную документацию для дополнительных сведений.

Как пользоваться Google Play Install Referrer : 1 комментарий

Спасибо конечно, но ваш пример не будет ничего показывать пользователю. для того чтобы это сделать, надо как минимум добавить в пример вызов тост уведомления.

Источник

Техническое руководство по прямым ссылкам в Android: Реферер Google Play

Alex Austin

30 октября, 2017

Это четвертая, заключительная, часть технического руководства по прямым ссылкам в Android. В предыдущих публикациях мы рассмотрели схемы URI, намерения в Chrome, и ссылки приложений.

Использование реферера Google Play для прямых ссылок

Одна из методик прямых ссылок предназначена для ситуации, когда приложение не установлено. При этом разработчик может передать настраиваемый параметр через магазин приложений Google Play. Этот параметр будет получен вашим приложением, когда пользователь впервые откроет его. Эта методика дает возможность узнавать, откуда появился новый пользователь, если управлять этим параметром нужным образом. Можно создавать настраиваемые целевые страницы или использовать прямые ссылки в процессе установки.

Требования для реферера установок Android

• Приложение не должно быть установлено.
• Невозможно использовать с намерениями Chrome, поскольку требуется структуризация URL-адресов Play Store.

Настройка реферера установок Android

Чтобы ваше приложение получало реферер установки Android, необходимо зарегистрировать ваше приложение для получения: com.android.vending.INSTALL_REFERRERbroadcast. Вставьте следующий код между тегами в вашем манифесте.

В этом случае io.branch.testbed.InstallListener — имя настраиваемого класса, который будет получать вещание. Это простой подкласс BroadcastReceiver. Вот шаблон кода, который потребуется для этого класса.

Обработка в приложении

После настройки BroadcastReceiver согласно приведенному выше описанию остается обработать намерение, что совсем несложно. Этот механизм очень близок к обработке намерений схемы URI , но он работает в пределах вызова onReceive. Вот пример.

Использование реферера Google Play на практике

Для правильного использования этой методики у вас должна быть возможность управлять ссылкой на Google Play, с которой работает пользователь. Предположим, что пакет нашего приложения называется io.branch.testbed. В этом случае Google Play можно открыть по любой из следующих ссылок.

Чтобы присоединить реферер, нужно просто добавить &referrer=specialparam к любой из этих ссылок. Для этого вам потребуется контроль над самой ссылкой. Примечание. Как вы могли заметить при чтении раздела, посвященного намерениям Chrome , раздела, посвященного намерениям Chrome, у вас нет контроля над ссылками Play Store, то есть вы не сможете использовать этот метод.

Чтобы управлять параметром referrer, рекомендуем встроить его в код JS на стороне клиента (описание см. в методе URI). Вот фрагмент кода, показывающий, как добавить реферер к ссылке на магазин приложений в функции, выполняемой после попытки открыть приложение.

Заключение

Если после прочтения этой публикации у вас загорелись глаза, это понятно. Прямые ссылки в Google устроены очень сложно, граничные случаи попадаются на каждом шагу. Если же вы воспользуетесь инструментом Branch, то будете уверены в том, что ссылки будут правильно работать всегда и везде.

Источник

Technical Guide to Google Play Referrer

Alex Austin

November 3rd, 2015

This is part four of a four-part technical guide on deep linking on Android. The previous posts covered URI schemes, Chrome Intents, and App Links.

Using Google Play Referrer for Deep Linking

One deep linking technique is for a niche use case where the app is not installed. As the developer, you have the option to pass in a custom parameter through the Google Play store that is then received in your app after the user opens it for the first time. This technique allows you to know where this new user came from if you manage this parameter appropriately, and you can create custom landing pages or deep link through the install process. To learn more, keep reading or request a Branch demo.

Requirements for Android Install Referrer

• App must not be installed
• Cannot be used with Chrome intents since you need to structure the Play Store URL

Configuring the Android Install Referrer

In order to configure your app to receive the Android install referrer, you must register your application to receive the com.android.vending.INSTALL_REFERRER broadcast. Insert the following in between the tags in your manifest.

In this case, io.branch.testbed.InstallListener is the name of your custom class that will receive the broadcasts. This is a simple subclass of BroadcastReceiver. Here’s the boilerplate code that you’ll need for this class:

Handling in the App

Once you’ve configured your BroadcastReceiver as described above, handling the intent is easy! It’s a very similar mechanism to handling the URI scheme intents , but it happens from within the onReceive call. You can see an example here:

Practical use for Google Play Referrer

In order to properly use this technique, you must be able to control the link to the Google Play Store that the user interacts with. Let’s say our app package name is io.branch.testbed , then we know that Google Play can be opened with either of the following:

To append a referrer, you’ll simply need to append &referrer=specialparam to either of those links. To do this, you’ll need to control the link itself. Note: As you may have noticed reading through the Chrome intent section , you have no control over the Play Store link, meaning that you will not be able to leverage this method.

In order to control the referrer parameter, we’d recommend that you embed it within the client side JS described in the URI method. Here’s a snippet of code that shows how the referrer is added to the market link fallback function that is executed after trying to open the app:

Conclusion

If your eyes are glazing over while reading this, we get it. Google deep linking is incredibly complicated and there are edge cases everywhere. If you use Branch’s tool, you can be confident that your links will just work everywhere.

Источник

Google разрешила сторонним разработчикам отслеживать установки приложений

Авторизуйтесь

Google разрешила сторонним разработчикам отслеживать установки приложений

По мнению компании Google, понимание того, как именно пользователи находят ваше приложение в магазине и что они делают после его установки, является неотъемлемой частью принятия правильных решений в отношении популяризации и маркетинга продукта. Подобное знание позволит разработчиками найти стратегию продвижения продукта, установить нужный бюджет для его рекламы. Кроме того, необходимо точно знать, какие именно реферальные ссылки имеют большую популярность среди пользователей.

Google Play Referrer API

Для того, чтобы помочь разработчикам приложений получить более точные и надёжные данные об установках, Google разработала Google Play Referrer API. Используя этот API, любая копия вашего приложения получит точную информацию из магазина приложений Play Store, включая:

• URL-реферер установленного пакета;
• временную метку (в секундах) перехода по реферальной ссылке;
• временную метку (в секундах) начала установки.

Google Play Referrer API работает с приложением Play Store версий 8.3.73 и выше и доступен абсолютно всем разработчикам. Для лёгкой интеграции нового API программисты Google подготовили также Install Referrer Library 1.0 для Android. Эта библиотека доступна в репозитории Maven.

Начало работу

Чтобы начать использование нового API, добавьте следующую зависимость в файл build.gradle :

Вся коммуникация с приложением Play Store происходит через Service . Поэтому первым делом необходимо установить связь между ними. Кроме того, для получения результата подключения и обновлений необходимо реализовать слушатель InstallReferrerStateListener . Он может быть описан в вашем текущем Activity , либо в любом другом классе, который вы используете:

Теперь всё готово для установки связи между вашим приложением и магазином. Для этого создайте экземпляр InstallReferrerClient и вызовите метод startConnection() :

Затем обработайте результат соединения методом onInstallReferrerSetupFinished() . Если соединение в порядке, приложение может получить информацию об источнике установки, вызвав метод getInstallReferrer() :

Узнать больше

Познакомиться поближе с функциональностью нового API можно, посетив официальную страницу библиотеки Install Referrer Client и прочитав документацию. Также, если вы столкнулись с проблемами использования нового API, Google советует использовать AIDL-интерфейс (Android Interface Definition Language) для установления связи с Play Store. Подробная информация доступна на странице сервиса.

Источник