Migration guide to branch 3.x.x

Added

Reporter activation

Called before any actions with the reporter. If you already get the reporter, activation cannot change the parameters. Example:

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]];
Copied to clipboard

Profiles

Added the following classes to work with user profiles:

• YMMUserProfile.
• YMMProfileAttribute.
• YMMUserProfileUpdate.

Added the following methods to the YMMYandexMetrica class for user profiles:

• + (void)setUserProfileID:(nullable NSString *)userProfileID;.
• + (void)reportUserProfile:(YMMUserProfile *)userProfile onFailure:(nullable void (^)(NSError *error))onFailure;.

Added the following methods to the YMMYandexMetricaReporting class for user profiles:

• - (void)setUserProfileID:(nullable NSString *)userProfileID;.
• - (void)reportUserProfile:(YMMUserProfile *)userProfile onFailure:(nullable void (^)(NSError *error))onFailure;.

Revenue

Added the YMMRevenueInfo class for revenue tracking.

Added the following method to the YMMYandexMetrica class:

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

Added the following method to the YMMYandexMetricaReporting protocol:

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

Renamed

setTrackLocationEnabled

// Enables device location sending.
setLocationTracking

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

trackLocationEnabled

// Enables device location sending.
locationTracking

reportCrashesEnabled

// Enables application crashes reporting.
crashReporting

customAppVersion

// Sets the app version.
appVersion

loggingEnabled

// Enables logging.
logs

setTrackLocationEnabled

// Enables device location sending.
setLocationTracking

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

trackLocationEnabled

// Enables device location sending.
locationTracking

reportCrashesEnabled

// Enables application crashes reporting.
crashReporting

customAppVersion

// Sets the app version.
appVersion

loggingEnabled

// Enables logging.
logs

Deleted

[YMMYandexMetrica activateWithApiKey:API_key];

YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:API_key];
[YMMYandexMetrica activateWithConfiguration:configuration];

[YMMYandexMetrica setSessionTimeout:30];

[YMMYandexMetrica setReportCrashesEnabled:YES];

[YMMYandexMetrica setCustomAppVersion:@"1.0.5"];

[YMMYandexMetrica setLoggingEnabled:YES];

[YMMYandexMetrica setEnvironmentValue:@"bar" forKey:@"foo"];

[YMMYandexMetrica enableTrackingWithURLScheme:urlScheme];

[YMMYandexMetrica startWithAPIKey:13];

[YMMYandexMetrica activateWithApiKey:API_key];

YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:API_key];
[YMMYandexMetrica activateWithConfiguration:configuration];

[YMMYandexMetrica setSessionTimeout:30];

[YMMYandexMetrica setReportCrashesEnabled:YES];

[YMMYandexMetrica setCustomAppVersion:@"1.0.5"];

[YMMYandexMetrica setLoggingEnabled:YES];

[YMMYandexMetrica setEnvironmentValue:@"bar" forKey:@"foo"];

[YMMYandexMetrica enableTrackingWithURLScheme:urlScheme];

[YMMYandexMetrica startWithAPIKey:13];