Класс AppMetricaConfiguration

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

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

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

Свойства

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

init?(apiKey:)

public init?(apiKey: String)

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

Параметры:

Возвращает:

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

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

accurateLocationTracking

var accurateLocationTracking: Bool { get; set; }

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

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

allowsBackgroundLocationUpdates

var allowsBackgroundLocationUpdates: Bool { get; set; }

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

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

apiKey

var apiKey: String { get; }

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

appBuildNumber

var appBuildNumber: String? { get; set; }

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

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

appEnvironment

var appEnvironment: [String : String]? { get; set; }

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

appOpenTrackingEnabled

var appOpenTrackingEnabled: Bool { get; set; }

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

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

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

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

appVersion

var appVersion: String? { get; set; }

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

areLogsEnabled

var areLogsEnabled: Bool { get; set; }

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

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

customHosts

var customHosts: [Any]? { get; set; }

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

customLocation

var customLocation: CLLocation? { get; set; }

dataSendingEnabled

var dataSendingEnabled: Bool { get; set; }

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

dispatchPeriod

var dispatchPeriod: UInt { get; set; }

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

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

handleActivationAsSessionStart

vat handleActivationAsSessionStart: Bool { get; set; }

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

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

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

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

handleFirstActivationAsUpdate

var handleFirstActivationAsUpdate: Bool { get; set; }

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

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

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

locationTracking

var locationTracking: Bool { get; set; }

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

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

maxReportsCount

var maxReportsCount: UInt { get; set; }

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

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

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

maxReportsInDatabaseCount

var maxReportsInDatabaseCount: UInt { get; set; }

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

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

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

preloadInfo

var preloadInfo: AppMetricaPreloadInfo? { get; set; }

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

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

revenueAutoTrackingEnabled

var revenueAutoTrackingEnabled: Bool { get; set; }

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

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

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

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

sessionTimeout

var sessionTimeout: UInt

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

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

sessionsAutoTracking

var sessionsAutoTracking: Bool { get; set; }

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

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

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

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

userProfileID

var userProfileID: String? { get; set; }

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