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

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

Добавлено

Активация репортеров

Вызывается до первого обращения к репортеру. Если обращение к репортеру уже было, активация не изменит параметры. Пример:

YMMMutableReporterConfiguration *configuration = [[YMMMutableReporterConfiguration alloc] initWithApiKey:reporter_API_key];
configuration.sessionTimeout = 32; // Session timeout of the reporter.
configuration.logs = YES; // Enabling reporter logging.
[YMMYandexMetrica activateReporterWithConfiguration:[configuration copy]];
Скопировано

Профили

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

YMMUserProfile.
YMMProfileAttribute.
YMMUserProfileUpdate.

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

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

Revenue

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

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

+(void)reportRevenue:(YMMRevenueInfo *)revenueInfo onFailure:(nullable void (^)(NSError *error))onFailure;.

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

- (void)reportRevenue:(YMMRevenueInfo *)revenueInfo onFailure:(nullable void (^)(NSError *error))onFailure;.

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


Версия 2.9.6	Версия 3.0.0
`setTrackLocationEnabled`	`// Enables device location sending. setLocationTracking` Класс `YMMYandexMetrica`.
`handleFirstActivationAsUpdateEnabled`	`// The first app launch with the AppMetrica SDK // should be treated as the first launch of the updated app version, // and not as an install. handleFirstActivationAsUpdate` Класс `YMMYandexMetricaConfiguration`.
`trackLocationEnabled`	`// Enables device location sending. locationTracking` Класс `YMMYandexMetricaConfiguration`.
`reportCrashesEnabled`	`// Enables application crashes reporting. crashReporting` Класс `YMMYandexMetricaConfiguration`.
`customAppVersion`	`// Sets the app version. appVersion` Класс `YMMYandexMetricaConfiguration`.
`loggingEnabled`	`// Enables logging. logs` Класс `YMMYandexMetricaConfiguration`.


Версия 2.9.6	Версия 3.0.0
`setTrackLocationEnabled`	`// Enables device location sending. setLocationTracking` Класс `YMMYandexMetrica`.
`handleFirstActivationAsUpdateEnabled`	`// The first app launch with the AppMetrica SDK // should be treated as the first launch of the updated app version, // and not as an install. handleFirstActivationAsUpdate` Класс `YMMYandexMetricaConfiguration`.
`trackLocationEnabled`	`// Enables device location sending. locationTracking` Класс `YMMYandexMetricaConfiguration`.
`reportCrashesEnabled`	`// Enables application crashes reporting. crashReporting` Класс `YMMYandexMetricaConfiguration`.
`customAppVersion`	`// Sets the app version. appVersion` Класс `YMMYandexMetricaConfiguration`.
`loggingEnabled`	`// Enables logging. 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];`	Удален.


Версия 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];`	Удален.

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