Руководство по переходу на ветку 3.x.x

Руководство содержит примеры, демонстрирующие различия между версиями SDK версий 2.80 и 3.0.0. В разделе рассматриваются только те методы, в которых нарушена обратная совместимость.

  1. Добавлено
  2. Переименовано
  3. Удалено

Добавлено

Активация репортеров
Вызывается до первого обращения к репортеру. Если обращение к репортеру уже было, активация не изменит параметры. Пример:
YandexMetrica.activateReporter(this, ReporterConfig.newConfigBuilder(API_KEY)
              .withSessionTimeout(100)
              .build());
Профили
Добавлены следующие классы для работы с пользовательскими профилями:

В класс YandexMetrica добавлены следующие методы по работе с профилями:

В интерфейс IReporter добавлены следующие методы по работе с профилями:

Revenue
Добавлены следующие классы для трекинга выручки:

В класс YandexMetrica добавлен следующий метод:

В интерфейс IReporter добавлен следующий метод:

Переименовано

Класс YandexMetrica.

Версия 2.80Версия 3.0.0
onResumeActivity(Activity activity)
// Возобновляет сессию.
resumeSession(Activity activity)
onPauseActivity(Activity activity)
// Приостанавливает сессию.
pauseSession(Activity activity)
setTrackLocationEnabled(boolean enabled)
// Включает отправку данных о местоположении устройства.
setLocationTracking(boolean enabled)

Класс YandexMetricaConfig.

Версия 2.80Версия 3.0.0
getApiKey()
// API-ключ приложения.
public final String apiKey
getAppVersion()
// Версия приложения.
public final String appVersion
getSessionTimeout()
// Тайм-аут сессии.
public final Integer sessionTimeout
isReportCrashEnabled()
// Отслеживание аварийных остановок приложений.
public final Boolean crashReporting
isReportNativeCrashEnabled()
// Отслеживание нативных аварийных остановок приложений.
public final Boolean nativeCrashReporting
getLocation()
// Задаваемые пользователем данные о местоположении устройства.
public final Location location
isTrackLocationEnabled()
// Отправка данных о местоположении устройства.
public final Boolean locationTracking
isCollectInstalledApps()
// Отправка сведений об установленных приложениях.
public final Boolean installedAppCollecting
isLogEnabled
// Вывод логов библиотекой.
public final Boolean logs
getPreloadInfo()
// Сведения для отслеживания предустановленных приложений.
public final PreloadInfo preloadInfo
handleFirstActivationAsUpdate()
// Первый запуск приложения с AppMetrica SDK следует трактовать как первый запуск обновленной версии приложения, а не как установку.
public final Boolean firstActivationAsUpdate;

Класс YandexMetricaConfig.Builder.

Версия 2.80Версия 3.0.0
setAppVersion()
// Задает версию приложения.
withAppVersion()
setSessionTimeout()
// Задает тайм-аут сессии.
withSessionTimeout()
setReportCrashEnabled()
// Включает отслеживание аварийных остановок приложений.
withCrashReporting()
setReportNativeCrashesEnabled()
// Включает отслеживание нативных аварийных остановок приложений.
withNativeCrashReporting()
setLocation()
// Задает данные о местоположении устройства.
withLocation()
setTrackLocationEnabled()
// Включает отправку данных о местоположении устройства.
withLocationTracking()
setCollectInstalledApps()
// Включает отправку сведений об установленных приложениях.
withInstalledAppCollecting()
setLogEnabled
// Включает вывод логов библиотекой.
withLogs()
setPreloadInfo()
// Устанавливает сведения для отслеживания предустановленных приложений.
withPreloadInfo()

Удалено

Версия 2.80Версия 3.0.0
Активация библиотеки с API-ключом.
YandexMetrica.activate(getApplicationContext(), API_KEY);
YandexMetricaConfig.Builder configBuilder = YandexMetricaConfig.newConfigBuilder(API_KEY);
YandexMetrica.activate(getApplicationContext(), сonfigBuilder.build());

Активировать библиотеку можно только через расширенную конфигурацию YandexMetricaConfig.

Установка продолжительности сессии.
YandexMetrica.setSessionTimeout(30);

Настроить таймаут сессии можно только через расширенную конфигурацию YandexMetricaConfig.

Включение сбора аварийных остановок приложения.
YandexMetrica.setReportCrashesEnabled(true);
YandexMetrica.setReportNativeCrashesEnabled(true);

Включить сбор крэшей (аварийных остановок приложения) можно только через расширенную конфигурацию YandexMetricaConfig.

Установка версии приложения
YandexMetrica.setCustomAppVersion("1.0.5");

Установить пользовательскую версию приложения можно только через расширенную конфигурацию YandexMetricaConfig.

Включение логирования
YandexMetrica.setLogEnabled();

Включить логирование можно только через расширенную конфигурацию YandexMetricaConfig.

Включение отправки сведений об установленных на устройстве приложениях.
YandexMetrica.setCollectInstalledApps(boolean collect);
YandexMetrica.isCollectInstalledApps();

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

Установка параметров окружения событий.
YandexMetrica.setEnvironmentValue(String key, String value);
Удален.