Перейти к основному содержимому

Отправка событий об установках приложения для Android

Краткое содержание

Шаг 1. Сбор данных
Для Play Market и App Gallery данные об установках собираются автоматически из указанных библиотек. Для Google, Huawei и их комбинации необходимо добавить соответствующие зависимости в build.gradle. Для RuStore, Galaxy store, MIUI store требуется ручная настройка: добавить зависимости и настроить минимальную версию Android SDK (23) для ru.rustore.sdk:installreferrer:6.1.0.

Шаг 2. Отправка событий
Собранные данные отправляются автоматически вместе с событием первого запуска после первой инициализации SDK.

Получение установок из SDK Аналитики
Данные install_referrer можно получить двумя способами:

  • Подписаться на installReferrerFlow и обрабатывать данные в потоке.
  • Использовать callback в конфигурации MtsAnalyticsApi для получения данных один раз при инициализации.

В Аналитике есть возможность собирать данные об установках приложения из магазина приложений.

Шаг 1. Сбор данных​

Данные об установках собираются автоматически из:

"com.android.installreferrer:installreferrer"
"com.huawei.hms:ads-installreferrer"

Если вы используете сборки:

googleImplementation "ru.mts.analytics:android-sdk-google-v2:$mts_analytics_version"

Для RuStore, Galaxy store, MIUI store​

Настройте сбор данных вручную, если:

  1. Приложение размещается в RuStore, Galaxy store, MIUI store.
  2. Проводится рекламная компании по установке приложения из этих магазинов.

Для этого добавьте в build.gradle модуля, к которому подключается аналитика, одну или несколько зависимостей

implementation "ru.rustore.sdk:installreferrer:6.1.0"
implementation "com.miui.referrer:homereferrer:1.0.0.6"
implementation "store.galaxy.samsung.installreferrer:samsung_galaxystore_install_referrer:4.0.0"

Для ru.rustore.sdk:installreferrer:6.1.0 поднимите минимальную версию Android SDK до 23

android {
    defaultConfig {
        minSdk 23
    }
}

Шаг 2. Отправка событий​

Собранные данные об установках отправляются автоматически вместе с событием первого запуска после первой инициализации SDK.

Получение установок из SDK Аналитики​

Получить данные об установках install_referrer можно двумя способами.

Способ 1​

Подписаться на публичное поле installReferrerFlow типа Flow<Map<String, String>>. Например

val mtsAnalytics: MtsAnalyticsApi = MTSAnalytics.getInstance(
    context = this,
    config = config
)

mtsAnalytics.installReferrerFlow.collect { installReferrer ->
val installReferrerGoogle = installReferrer["Google"]
    // Handle install referrer
}

Способ 2​

Важно

Этим способом install_referrer можно получить только один раз при инициализации SDK Аналитики.

С помощью callback, переданного в функцию subscribeForInstallReferrer при конфигурации MtsAnalyticsApi. Например

val mtsAnalytics: MtsAnalyticsApi = MTSAnalytics.getInstance(
    context = this,
    config = MtsAnalyticsConfig.Builder(flowId = flowId)
        .subscribeForInstallReferrer { installReferrer ->
            // Handle installReferrer
        }
        .build()
)