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

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

Добавлено

Активация репортеров
Вызывается до первого обращения к репортеру. Если обращение к репортеру уже было, активация не изменит параметры. Пример:
YMMMutableReporterConfiguration *configuration = [[YMMMutableReporterConfiguration alloc] initWithApiKey:reporter_API_key];
configuration.sessionTimeout = 32; // Таймаут сессий репортера
configuration.logs = YES; // Включение логов событий репортера
[YMMYandexMetrica activateReporterWithConfiguration:[configuration copy]];
Профили
Добавлены следующие классы для работы с пользовательскими профилями:

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

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

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

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

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

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

Версия 2.9.6Версия 3.0.0
setTrackLocationEnabled
// Включает/отключает отправку данных о местоположении устройства.
setLocationTracking

Класс YMMYandexMetrica.

handleFirstActivationAsUpdateEnabled
// Первый запуск приложения с AppMetrica SDK следует трактовать как обновление.
handleFirstActivationAsUpdate

Класс YMMYandexMetricaConfiguration.

trackLocationEnabled
// Включает/отключает отправку данных о местоположении устройства.
locationTracking

Класс YMMYandexMetricaConfiguration.

reportCrashesEnabled
// Включает отслеживание аварийных остановок приложения.
crashReporting

Класс YMMYandexMetricaConfiguration.

customAppVersion
// Задает версию приложения.
appVersion

Класс YMMYandexMetricaConfiguration.

loggingEnabled
// Включает/отключает логирование.
logs

Класс YMMYandexMetricaConfiguration.

Удалено

Версия 2.9.6Версия 3.0.0
Активация библиотеки с API-ключом.
[YMMYandexMetrica activateWithApiKey:API_key];
YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:API_key];
[YMMYandexMetrica activateWithConfiguration:configuration];

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

Установка продолжительности сессии.
[YMMYandexMetrica setSessionTimeout:30];

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

Включение сбора аварийных остановок приложения.
[YMMYandexMetrica setReportCrashesEnabled:YES];

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

Установка версии приложения
[YMMYandexMetrica setCustomAppVersion:@"1.0.5"];

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

Включение логирования
[YMMYandexMetrica setLoggingEnabled:YES];

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

Установка параметров окружения событий.
[YMMYandexMetrica setEnvironmentValue:@"bar" forKey:@"foo"];
Удален.
Включение трекинга передаваемой на вход deeplink-схемы приложения.
[YMMYandexMetrica enableTrackingWithURLScheme:urlScheme];
Удален. Данный метод атрибуции больше не поддерживается.
Активация с числовым ключом.
[YMMYandexMetrica startWithAPIKey:13];
Удален.