YMMYandexMetricaConfiguration class

This class contains the extended startup configuration for the library.

The parameters of the extended configuration are applied from the time of library initialization.

Instance methods

-initWithApiKey:

Initializes the instance of the YMMYandexMetricaConfiguration class with the specified API key.

Properties

apiKey

The API key of the application.

appVersion

App version.

crashReporting

Enables/disables collecting and sending information about app crashes.

handleActivationAsSessionStart

Defines the AppMetrica SDK initialization as the beginning of a session.

handleFirstActivationAsUpdate

Defines the first launch of the app as an update.

location

Sets custom location of the device.

locationTracking

Enables/disables sending location of the device.

logs

Enables/disables logging the activity of the library.

preloadInfo

Sets the instance of the YMMYandexMetricaPreloadInfo class for tracking pre-installed apps.

sessionsAutoTracking

Enables/disables automatic tracking of the application lifecycle.

sessionTimeout

Sets the session timeout in seconds.

statisticsSending

Enables/disables sending statistics to the AppMetrica server.

Method descriptions

-initWithApiKey:

- (instancetype)initWithApiKey:(NSString *)apiKey

Initializes the instance of the YMMYandexMetricaConfiguration class with the specified API key.

Parameters:
apiKey

The API key of the application.

Returns:

The instance of the YMMYandexMetricaConfiguration class.

Property descriptions

apiKey

(nonatomic, copy, readonly) NSString *apiKey

The API key of the application.

appVersion

(nonatomic, copy) NSString *appVersion

App version.

crashReporting

(nonatomic, assign) BOOL crashReporting

Enables/disables collecting and sending information about app crashes.

Possible values:
  • YES — Sending information about crashes is enabled.
  • NO — Sending information about crashes is disabled.

handleActivationAsSessionStart

(nonatomic, assign) BOOL handleActivationAsSessionStart

Defines the AppMetrica SDK initialization as the beginning of a session.

This option is disabled by default.

Possible values:

handleFirstActivationAsUpdate

(nonatomic, assign) BOOL handleFirstActivationAsUpdate

Defines the first launch of the app as an update.

Attention. If the first launch of the app is defined as an update, the installation is not shown as a new installation in reports, and is not attributed to partners.
Possible values:
  • YES — The first launch is defined as an update.
  • NO — The first launch is defined as a new installation.

location

(nonatomic, strong, nullable) CLLocation *location

Sets custom location of the device.

locationTracking

(nonatomic, assign) BOOL locationTracking

Enables/disables sending location of the device.

By default, sending is enabled.

logs

(nonatomic, assign) BOOL logs

Enables/disables logging the activity of the library.

Logging is disabled by default.

preloadInfo

(nonatomic, copy) YMMYandexMetricaPreloadInfo *preloadInfo

Sets the instance of the YMMYandexMetricaPreloadInfo class for tracking pre-installed apps.

For more information, see Tracking pre-installed apps.

sessionsAutoTracking

(nonatomic, assign) BOOL sessionsAutoTracking

Enables/disables automatic tracking of the application lifecycle.

The option is enabled by default.

If the option is disabled, you should manually set up session control using the methods +pauseSession: and +resumeSession:. For more information, see Manual session tracking.

AppMetrica uses UIApplicationDidBecomeActiveNotification and UIApplicationWillResignActiveNotification to track sessions. The maximum session length is 24 hours. To extend the session after 24 hours, invoke the +resumeSession: method manually.

sessionTimeout

(nonatomic, assign) NSUInteger sessionTimeout

Sets the session timeout in seconds.

The default value is 10 (minimum allowed value).

For more information about sessions, see Tracking user activity.

statisticsSending

(nonatomic, assign) BOOL statisticsSending

Enables/disables sending statistics to the AppMetrica server.

Note. Disabling sending also turns off sending data from all reporters that initialized with a different apiKey.