Класс AppMetrica
- Методы экземпляра
- Свойства
- Описание методов
- activate(with:)
- activateReporter(with:)
- clearAppEnvironment()
- pauseSession()
- reportAdRevenue(_:onFailure:)
- reportECommerce(_:onFailure:)
- reportEvent(name:onFailure)
- reportEvent(name:parameters:onFailure)
- reportExternalAttribution(_:from:onFailure:)
- reportRevenue(_:onFailure:)
- reportUserProfile(_:onFailure:)
- reporter(for:)
- requestStartupIdentifiers(for:on:completion:)
- requestStartupIdentifiers(on:completion:)
- resumeSession()
- sendEventsBuffer()
- setAppEnvironment(_:forKey:)
- setDataSendingEnabled(_:)
- setupWebViewReporting(with:onFailure:)
- trackOpeningURL(_:)
- Описание свойств
Методы класса используются для настройки работы библиотеки.
Методы экземпляра
Инициализирует библиотеку в приложении с расширенной стартовой конфигурацией. |
|
Инициализирует репортер с расширенной конфигурацией. |
|
Удаление всех данных ключ-значение, связанных со всеми будущими событиями. |
|
Приостанавливает сессию. |
|
Отправляет информацию о рекламной выручке на сервер AppMetrica. |
|
Отправляет сообщение о ecommerce-событии. |
|
Отправляет сообщение о событии. |
|
Отправляет сообщение о событии с дополнительными параметрами. |
|
Отправляет данные о внешней атрибуции в AppMetrica. |
|
Отправляет информацию о покупке на сервер AppMetrica. |
|
Отправляет информацию об обновлении пользовательского профиля. |
|
Создает репортер для отправки событий на дополнительный API key. |
|
Запрашивает идентификаторы для определенных ключей. |
|
Запрашивает все предопределенные идентификаторы. |
|
Возобновляет сессию или создает новую, если тайм-аут сессии истек. |
|
Отправляет сохраненные события из буфера. |
|
Устанавливает пару ключ-значение, которая ассоциирована со всеми будущими событиями. |
|
Включает/отключает отправку статистики на сервер AppMetrica. |
|
Добавляет для указанной вебвью JavaScript-интерфейс с названием AppMetrica в window. Это позволяет отправлять клиентские события из JavaScript-кода. |
|
Обрабатывает URL, который открыл приложение. |
Свойства
Включить/отключить фоновое отслеживание обновлений местоположения. |
|
Устанавливает собственную информацию о местоположении устройства. |
|
Текущий appmetrica_device_id_hash. |
|
Текущий appmetrica_device_id. |
|
Контролирует точность отслеживания местоположения, используемого внутренним менеджером местоположения. |
|
Указывает, была ли активирована AppMetrica. |
|
Включает/отключает отправку информации о местоположении устройства. |
|
Текущая версию библиотеки AppMetrica. |
|
Устанавливает ID для пользовательского профиля. |
|
Текущий UUID. |
Описание методов
activate(with:)
class func activate(with: AppMetricaConfiguration)
Инициализирует библиотеку в приложении с расширенной стартовой конфигурацией.
Параметры:
|
Объект класса AppMetricaConfiguration, который содержит расширенную стартовую конфигурацию библиотеки. |
activateReporter(with:)
class func activateReporter(with: ReporterConfiguration)
Инициализирует репортер с расширенной конфигурацией.
Конфигурация репортера должна быть инициализирована до первого обращения к репортеру. Иначе конфигурация репортера игнорируется.
Репортер должен быть инициализирован с конфигурацией, которая содержит API key, отличный от API key приложения.
Параметры:
|
Объект класса ReporterConfiguration, который содержит расширенную конфигурацию репортера. |
clearAppEnvironment()
class func clearAppEnvironment()
Очистка среды приложения, например, удаление всех данных ключ - значение, связанных со всеми будущими событиями.
pauseSession()
class func pauseSession()
Приостанавливает сессию.
Примечание
Длительность сессии зависит от заданного таймаута. Если интервал между приостановкой и возобновлением сессии меньше заданного времени тайм-аута, то текущая сессия будет возобновлена, если больше — будет создана новая.
Подробнее о сессиях в разделе Отслеживание активности пользователей.
reportAdRevenue(_:onFailure:)
class func reportAdRevenue(_ adRevenue: AdRevenueInfo, onFailure: ((Error) -> Void)?)
Отправляет информацию о рекламной выручке на сервер AppMetrica.
Параметры:
|
Объект класса AdRevenueInfo, который содержит информацию о рекламной выручке. |
|
Callback-метод, который будет вызван в случае ошибки. |
reportECommerce(_:onFailure:)
class func reportECommerce(_ eCommerce: ECommerce, onFailure: ((Error) -> Void)?)
Отправляет сообщение о ecommerce-событии.
Параметры:
|
Объект класса ECommerce. |
|
Callback-метод, который будет вызван в случае ошибки. |
reportEvent(name:onFailure)
class func reportEvent(name: String, onFailure: ((Error) -> Void)?)
Отправляет сообщение о событии.
Параметры:
|
Короткое название или описание события. |
|
Блок, который выполняется при возникновении ошибки. Ошибка передается как блок-аргумент. |
reportEvent(name:parameters:onFailure)
class func reportEvent(name: String, parameters: [AnyHashable : Any]?, onFailure: ((Error) -> Void)?)
Отправляет сообщение о событии с дополнительными параметрами.
Параметры:
|
Короткое название или описание события. |
|
Параметры в виде пар |
|
Callback-метод, который будет вызван в случае ошибки. |
reportExternalAttribution(_:from:onFailure:)
class func reportExternalAttribution(_ attribution: [AnyHashable : Any], from source: AttributionSource, onFailure: ((any Error) -> Void)? = nil)
Отправляет данные о внешней атрибуции в AppMetrica.
|
Словарь содержит данные об атрибуции. Должен быть конвертируемым в JSON, иначе метод завершится запуском блока с ошибкой — |
|
Источник с данными об атрибуции. Список источников. |
|
Callback-метод, который будет вызван в случае ошибки. Ошибка передается в качестве аргумента. |
reportRevenue(_:onFailure:)
class func reportRevenue(_ revenueInfo: RevenueInfo, onFailure: ((Error) -> Void)?)
Отправляет информацию о покупке на сервер AppMetrica.
Параметры:
|
Объект класса RevenueInfo, который содержит информацию о покупке. |
|
Callback-метод, который будет вызван в случае ошибки. |
reportUserProfile(_:onFailure:)
class func reportUserProfile(_ userProfile: UserProfile, onFailure: ((Error) -> Void)?)
Отправляет информацию об обновлении пользовательского профиля.
Параметры:
|
Объект класса UserProfile, который содержит информацию о пользовательском профиле. |
|
Callback-метод, который будет вызван в случае ошибки. |
reporter(for:)
class func reporter(for: String) -> AppMetricaReporting
Создает репортер для отправки событий на дополнительный API key.
Чтобы инициализировать репортер с расширенной конфигурацией, используйте метод activateReporter(with:). Конфигурация репортера должна быть инициализирована до первого обращения к репортеру. Иначе, конфигурация репортера игнорируется.
Параметры:
|
API key, отличный от API key приложения. |
Возвращает:
Объект, реализующий протокол AppMetricaReporting для заданного API key приложения.
requestStartupIdentifiers(for:on:completion:)
class func requestStartupIdentifiers(for: [StartupKey], on: dispatch_queue_t?, completion: ([StartupKey : Any]?, Error?) -> Void)
Получение идентификаторов для определенных ключей
Параметры:
|
Массив идентификационных ключей для запроса. Смотрите |
|
Очередь для отправки блока. Если значение равно нулю, используется основная очередь. |
|
Блок будет отправлен при появлении доступных идентификаторов или в случае ошибки. Если они доступны на момент вызова - блок отправляется немедленно. Смотрите определение |
requestStartupIdentifiers(on:completion:)
class func requestStartupIdentifiers(on: dispatch_queue_t?, completion: ([StartupKey : Any]?, Error?) -> Void)
Получение всех предопределенных идентификаторов
Параметры:
|
Очередь для отправки блока. Если значение равно нулю, используется основная очередь. |
|
Блок будет отправлен при появлении доступных идентификаторов или в случае ошибки. Предопределенными идентификаторами являются:
Если они доступны на момент вызова - блок отправляется немедленно. Смотрите определение |
resumeSession()
class func resumeSession()
Возобновляет сессию или создает новую, если таймаут сессии истек.
Примечание
Длительность сессии зависит от заданного таймаута. Если интервал между приостановкой и возобновлением сессии меньше заданного времени тайм-аута, то текущая сессия будет возобновлена, если больше — будет создана новая.
Подробнее о сессиях в разделе Отслеживание активности пользователей.
sendEventsBuffer()
class func sendEventsBuffer()
Отправляет сохраненные события из буфера.
AppMetrica SDK не отправляет события сразу после того, как оно произошло. Библиотека хранит данные о событиях в буфере. Метод sendEventsBuffer()
отправляет данные из буфера и очищает его. Используйте этот метод для принудительной отправки сохраненных событий после прохождения важных сценариев пользователя.
Внимание
Частое использование метода может привести к повышению энергопотребления и расходу исходящего интернет-трафика.
setAppEnvironment(_:forKey:)
class func setAppEnvironment(_ value: String?, forKey: String)
Установка данных ключ - значение, которые будут использоваться в качестве дополнительной информации, связанной со всеми будущими событиями.
Если значение равно нулю, ранее установленное значение ключа удаляется. Ничего не делает, если ключ не был добавлен.
Параметры:
|
Значение. |
|
Ключ. |
setDataSendingEnabled(_:)
class func setDataSendingEnabled(_ enabled: Bool)
Включает/отключает отправку статистики на сервер AppMetrica.
Подробнее об использовании метода в разделе Отключение и включение отправки статистики.
Примечание
Отключение отправки для главного API key также отключает отправку данных со всех репортеров, которые были инициализированы с другим API key.
Параметры:
|
Признак отправки статистики. Значение по умолчанию — Возможные значения:
|
setupWebViewReporting(with:onFailure:)
class func setupWebViewReporting(with: JSControlling, onFailure: ((Error) -> Void)?)
Добавляет для указанной вебвью JavaScript-интерфейс с названием AppMetrica в window. Это позволяет отправлять клиентские события из JavaScript-кода.
Замечания:
- Метод должен вызываться из главной очереди.
- Метод недоступен на tvOS.
- Метод необходимо вызывать до загрузки любого контента. Рекомендуется вызывать метод до создания вебвью и до добавления своих скриптов в WKUserContentController. Подробнее см. в разделе Примеры использования методов.
Параметры:
|
Объект |
|
Callback-метод, который будет вызван в случае ошибки. |
trackOpeningURL(_:)
class func trackOpeningURL(_ URL: URL)
Обрабатывает URL, который открыл приложение.
Используется для регистрации открытия приложения с помощью deeplink
Параметры:
|
URL, который открыл приложение. |
Описание свойств
allowsBackgroundLocationUpdates
var allowsBackgroundLocationUpdates: Bool { get; set; }
Включить/отключить фоновое отслеживание обновлений местоположения. По умолчанию отключен.
customLocation
var customLocation: CLLocation? { get; set; }
Устанавливает собственную информацию о местоположении устройства.
deviceIDHash
var deviceIDHash: String? { get; }
Извлекает appmetrica_device_id_hash.
deviceID
var deviceID: String? { get; }
Извлекает appmetrica_device_id.
isAccurateLocationTrackingEnabled
var isAccurateLocationTrackingEnabled: Bool { get; set; }
Контролирует точность отслеживания местоположения, используемого внутренним менеджером местоположения.
Если установлено значение true
, диспетчер местоположений пытается использовать наиболее точные доступные данные о местоположении.
Это свойство вступает в силу только в том случае, если для параметра isLocationTrackingEnabled
установлено значение true
и местоположение
не было задано вручную с помощью свойства customLocation
.
isActivated
var isActivated: Bool { get; }
Указывает, была ли активирована AppMetrica.
Примечание
Используйте это свойство, чтобы проверить, была ли AppMetrica уже активирована, как правило, чтобы избежать избыточных вызовов активации или убедиться, что сбор статистики запущен.
isLocationTrackingEnabled
var isLocationTrackingEnabled: Bool { get; set; }
Включает/отключает отправку информации о местоположении устройства.
libraryVersion
var libraryVersion: String { get; }
Возвращает текущую версию библиотеки AppMetrica.
userProfileID
var userProfileID: String? { get; set; }
Устанавливает ID для пользовательского профиля. Если отправка ProfileId
не настроена, предопределенные атрибуты не отображаются в веб-интерфейсе.
uuid
var uuid: String { get; }
Извлекает текущий UUID.