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

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

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

Шаг 1. Сбор данных
Для Play Market и App Gallery данные об установках собираются автоматически через зависимости:

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

Для Google, Huawei и их комбинации используются зависимости:

  • googleImplementation "ru.mts.analytics:android-sdk-google-v2:$mts_analytics_version"
  • huaweiImplementation "ru.mts.analytics:android-sdk-huawei-v2:$mts_analytics_version"
  • allservImplementation "ru.mts.analytics:android-sdk-allserv-v2:$mts_analytics_version"

Для RuStore, Galaxy store, MIUI store сбор данных настраивается вручную:

  • Добавьте зависимости в 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 установите minSdk 23.

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

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

  1. Подписаться на installReferrerFlow и обработать данные в потоке.
  2. Использовать callback в subscribeForInstallReferrer при инициализации SDK.

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

Шаг 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()
)