Класс AMAAppMetricaConfiguration

Класс содержит расширенную стартовую конфигурацию библиотеки.

Параметры расширенной конфигурации применяются с момента инициализации библиотеки.

Методы экземпляра

Свойства

Описание методов

-initWithAPIKey:

- (instancetype)initWithAPIKey:(NSString *)APIKey

Инициализирует экземпляр класса AMAAppMetricaConfiguration с указанным API key.

Параметры:

Возвращает:

Объект класса AMAAppMetricaConfiguration.

Описание свойств

APIKey

@property (nonatomic, copy, readonly) NSString *APIKey;

API key приложения.

accurateLocationTracking

@property (nonatomic, assign) BOOL accurateLocationTracking;

Включить/отключить точный поиск местоположения для внутреннего диспетчера местоположений. По умолчанию отключено.

Действует только в том случае, если включено отслеживание местоположения YES и местоположение не задано вручную.

allowsBackgroundLocationUpdates

@property (nonatomic, assign) BOOL allowsBackgroundLocationUpdates;

Включить/отключить отслеживание фоновых обновлений местоположения. По умолчанию отключено.

Чтобы включить отслеживание фоновых обновлений местоположения, установите для свойства значение YES.

appBuildNumber

@property (nonatomic, copy, nullable) NSString *appBuildNumber;

Установите произвольный номер сборки приложения для отчета AppMetrica.

Если он не задан, AppMetrica будет использовать номер сборки приложения, указанный в файле конфигурации приложения Info.plist (CFBundleVersion). Значение номера сборки должно быть числовой строкой, которая может быть преобразована в положительное целое число.

appEnvironment

@property (nonatomic, copy, nullable) NSDictionary<NSString *, NSString *> *appEnvironment;

Устанавливает окружение приложения для всех событий с момента активации.

appOpenTrackingEnabled

@property (nonatomic, assign) BOOL appOpenTrackingEnabled;

Включает/выключает автоматический сбор и отправку информации о запуске приложения через deeplink.

По умолчанию опция включена.

Возможные значения:

• YES — режим автоматического сбора и отправки данных о запуске приложения через deeplink включен.
• NO — режим автоматического сбора и отправки данных о запуске приложения через deeplink выключен.

appVersion

@property (nonatomic, copy, nullable) NSString *appVersion;

Версия приложения.

customHosts

@property (nonatomic, copy, nullable) NSArray *customHosts;

Установите URL-адреса прокси-серверов для AppMetrica, которые будут использоваться для startup запросов.

customLocation

@property (nonatomic, strong, nullable) CLLocation *customLocation;

dataSendingEnabled

@property (nonatomic, assign) BOOL dataSendingEnabled;

Устанавливает собственную информацию о местоположении устройства.

dispatchPeriod

@property (nonatomic, assign) NSUInteger dispatchPeriod;

Установите пользовательский период отправки. Интервал в секундах между отправкой событий на сервер.

По умолчанию 90 секунд. Установка значения 0 секунд предотвращает автоматическую отправку событий библиотекой с использованием таймера.

handleActivationAsSessionStart

@property (nonatomic, assign) BOOL handleActivationAsSessionStart;

Определяет инициализацию AppMetrica как начало пользовательской сессии.

По умолчанию опция отключена.

Возможные значения:

• YES — пользовательская сессия создается в момент инициализации библиотеки.
• NO — в момент инициализации библиотеки создается фоновая сессия, а пользовательская сессия создается после системного события UIApplicationDidBecomeActiveNotification.

handleFirstActivationAsUpdate

@property (nonatomic, assign) BOOL handleFirstActivationAsUpdate;

Определяет первый запуск приложения как обновление.

Возможные значения:

• YES — первый запуск определяется как обновление.
• NO — первый запуск определяется как новая установка.

locationTracking

@property (nonatomic, assign) BOOL locationTracking;

Включает/отключает отправку информации о местоположении устройства.

По умолчанию отправка включена.

logsEnabled

@property (nonatomic, assign, getter=areLogsEnabled) BOOL logsEnabled;

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

По умолчанию логирование выключено.

maxReportsCount

@property (nonatomic, assign) NSUInteger maxReportsCount;

Установите максимальное количество сохраненных событий. Минимальное количество кэшированных событий, которое приводит к автоматической отправке отчетов.

По умолчанию события отправляются автоматически, когда в хранилище имеется не менее 7 элементов.

Установка значения 0 предотвращает автоматическую отправку событий библиотекой при достижении заданного количества событий в хранилище.

maxReportsInDatabaseCount

@property (nonatomic, assign) NSUInteger maxReportsInDatabaseCount;

Максимальное число отчетов об ошибках, которое хранится во внутренней БД.

Допускаются значения в интервале [100; 10000]. Значения, не попадающие в данный интервал, будут автоматически заменены на значение ближайшей границы интервала.

Значение по умолчанию — 1000.

preloadInfo

@property (nonatomic, copy, nullable) AMAAppMetricaPreloadInfo *preloadInfo;

Устанавливает объект класса AMAAppMetricaPreloadInfo для отслеживания предустановленных приложений.

Подробнее в разделе Трекинг предустановленных приложений.

revenueAutoTrackingEnabled

@property (nonatomic, assign) BOOL revenueAutoTrackingEnabled;

Включает/выключает автоматический сбор информации об In-App покупках.

По умолчанию опция включена.

Возможные значения:

• YES — режим автоматического сбора и отправки информации об In-App покупках включен.
• NO — режим автоматического сбора и отправки информации об In-App покупках выключен.

sessionTimeout

@property (nonatomic, assign) NSUInteger sessionTimeout;

Задает длительность таймаута сессии в секундах. Значение по умолчанию — 10 (минимально допустимое значение).

Подробнее о сессиях в разделе Отслеживание активности пользователей.

sessionsAutoTracking

@property (nonatomic, assign) BOOL sessionsAutoTracking;

Включает/отключает автоматическое отслеживание жизненного цикла приложений.

По умолчанию опция включена.

Если опция выключена, необходимо вручную настроить контроль продолжительности сессии с использованием методов +pauseSession: и +resumeSession:. Подробнее в разделе Отслеживание сессий вручную.

Для отслеживания сессий AppMetrica использует UIApplicationDidBecomeActiveNotification и UIApplicationWillResignActiveNotification. Максимальная длительность сессии — 24 часа. Чтобы продлить сессию после 24 часов, необходимо вызвать метод +resumeSession: вручную.

userProfileID

@property (nonatomic, copy, nullable) NSString *userProfileID;

Задает идентификатор пользовательского профиля (ProfileID) при активации.