История изменений
AppMetrica SDK
Версия 5.8.1
Релиз 3 Октября 2024 г.
- Исправлена ошибка отправки
EVENT_UPDATE
вместоEVENT_INIT
на 42 API key.
Версия 5.8.0
Релиз 3 Сентября 2024 г.
- Обновлена зависимость KSCrash до версии
2.0.0-rc.1
. - Удалены домены из NSPrivacyTrackingDomains в privacy манифесте AppMetricaCore.
- Добавлен адаптер AppMetricaLibraryAdapter для интеграции со сторонними библиотеками.
- Добавлена форсированная отправка определенных типов событий на сервер (external SDKs attribution, e-commerce, revenue, ad revenue (Impression Level Revenue Data), apple privacy).
Версия 5.7.0
Релиз 3 Августа 2024 г.
- Удалена поддержка работы iAd и ссылки на эту библиотеку.
- Добавлено логирование параметров события.
Версия 5.6.0
Релиз 27 Июня 2024 г.
- В
AppMetricaConfiguration
добавлено свойствоappEnvironment
, позволяющее установить окружение приложения для всех событий с момента активации.
Версия 5.5.0
Релиз 26 Июня 2024 г.
- В Extensions теперь по умолчанию используется background сессия.
- В AppMetricaCrashes добавлена утилита для загрузки dSYM файлов.
Версия 5.4.0
Релиз 24 мая 2024 г.
- Исправлена ошибка, связанная с отправкой IDFA. IDFA не всегда отправлялся сразу после получения согласия пользователя на трекинг. Это могло повлиять на отправку тестовых пушей по IDFA.
Версия 5.3.2
Релиз 13 мая 2024 г.
- Исправлен крэш в
[AMAReportersContainer restartPrivacyTimer]
. - По умолчанию отключены логи в файл из-за возможности крэша при нехватке места на диске.
Версия 5.3.1
Релиз 6 мая 2024 г.
- Исправлена ошибка валидации модулей AppMetrica_FMDB , AppMetrica_Protobuf в AppStore при поставке через SPM.
Версия 5.3.0
Релиз 26 апреля 2024 г.
- Поддержка Singular для внешних атрибуций: добавлена возможность отправки атрибуции из Singular:
AppMetrica.reportExternalAttribution(attributionData, from: .singular) { error in print("AppMetrica reporting error: \(error)") }
- Исправление assert: Удаление внутренних assert для оптимизации кода и предотвращения возможных ошибок во время разработки.
- Обновление KSCrash: строгая зависимость от библиотеки KSCrash изменена на диапазон версий ~> 1.17.0.
Версия 5.2.0
Релиз 16 апреля 2024 г.
- В AppMetrica появилась возможность импорта атрибуций из других SDK для iOS.
- Для работы с внешней атрибуцией добавлены: метод
AppMetrica.reportExternalAttribution(_:from:onFailure:)
(Swift, Objective-C), struct/typedefAttributionSource
(Swift, Objective-C).
Версия 5.1.0
Релиз 6 марта 2024 г.
- Добавлена поддержка Privacy Manifest.
Версия 5.0.0
Релиз 13 февраля 2024 г.
- Обновлены идентификатор библиотеки и API. Подробнее в инструкции по миграции.
Версия 4.5.2
Релиз 22 мая 2023 г.
- Исправлен
posix_spawn
крэш Xcode с включенным санитайзером.
Версия 4.5.0
Релиз 21 марта 2023 г.
- Исправлена ошибка
locationServicesEnabled invoked on the main thread
на iOS 16.
Версия 4.4.0
Релиз 19 сентября 2022 г.
- Добавлен API AdRevenue для передачи доходов рекламной монетизации на уровне показа (Impression-Level Revenue Data):
- классы
YMMAdRevenueInfo
,YMMMutableAdRevenueInfo
. - методы
reportAdRevenue
в классеYMMYandexMetrica
,reportAdRevenue
в протоколеYMMYandexMetricaReporting
. - перечисление
YMMAdType
.
- классы
Версия 4.2.0
Релиз 18 февраля 2022 г.
-
Добавлен новый API для отслеживания крэшей и ошибок из произвольных плагинов.
Протоколы:
YMMYandexMetricaPlugins
.YMMYandexMetricaPluginReporting
.
Классы:
YMMPluginErrorDetails
.YMMStackTraceElement
.
-
Добавлен API для полноценной работы SDK в контексте автотрекинга сессий при условии активации из плагинов:
YMMYandexMetricaPlugins.handlePluginInitFinished
. -
Добавлена возможность отправлять ошибки из репортеров без активации главного ключа. В этом случае будет отсутствовать мета-инфоромация из KSCrash (данные о системе).
Версии 4.0.0 — 3.0.0
4.0.0 — 3.0.0
Версия 4.0.0
Релиз 20 сентября 2021 г.
- Поддержана возможность задавать идентификатор пользовательского профиля при активации (
[YMMYandexMetricaConfiguration userProfileID]
) или до активации ([YMMYandexMetrica setUserProfileID]
) главного ключа, а также при активации репортера ([YMMReporterConfiguration userProfileID]
). - Добавлено свойство
appOpenTrackingEnabled
для автоматического трекинга открытия приложения по deeplink. - Добавлено свойство
revenueAutoTrackingEnabled
для автоматического сбора данных по in-app покупкам. - Добавлено управление Conversion Value.
Версия 3.17.0
Релиз 8 июня 2021 г.
- Исправлена возможная ошибка
Main Thread Checker: UI API called on a background thread: -[WKUserScript initWithSource:injectionTime:forMainFrameOnly:]
- Добавлена версия библиотеки для симуляторов iOS, запускаемых на Mac c процессорами Apple Silicon M1 (
ios-arm64-simulator
). - Библиотека поставляется теперь только в виде XCFramework, что повлекло следующие изменения:
- Минимальные поддерживаемые версии CocoaPods — 1.10, Carthage — 0.38. В этих версиях добавлена поддержка XCFramework.
- Подключение AppMetrica SDK на tvOS теперь выполняется также, как на iOS: сабспеки
YandexMobileMetrica/Dynamic-TV
иYandexMobileMetrica/Static-TV
больше недоступны.
Версия 3.16.0
Релиз 27 мая 2021 г.
- Добавлен метод
initWebViewReporting
для отправки событий из JS-кода WebView. - Исправлены ошибки и повышена стабильность.
Версия 3.15.1
Релиз 20 апреля 2021 г.
- Доработана атрибуция Apple Search Ads через AdServices Framework. Обновитесь на эту версию, чтобы сохранить трекинг Apple Search Ads на iOS 14.5+.
Версия 3.15.0
Релиз 30 марта 2021 г.
- Добавлена поддержка атрибуции установок на устройствах с версией iOS 14.5+ через SKAdNetwork. Передача ценности конверсии будет реализована в следующих версиях SDK.
- Добавлено получение данных, необходимых для атрибуции установок из Apple Search Ads через AdServices Framework (для устройств с версией iOS 14.3+). Атрибуция реализуется в серверной части AppMetrica и не потребует повторного обновления.
- Отключен сбор Оператора и Типа соединений.
Версия 3.14.0
Релиз 29 декабря 2020 г.
- Добавлена дистрибуция AppMetrica с помощью Swift Package Manager. Подробности можно узнать в статье Подключение и инициализация.
- Минимальная поддерживаемая версия iOS 9.0.
- Исправлена проблема привязки крэша к сессии.
Версия 3.12.0
Релиз 14 октября 2020 г.
-
Добавлен новый API отправки E-Commerce событий:
- В класс
YMMYandexMetrica
и протоколYMMYandexMetricaReporting
добавлен метод+reportECommerce:onFailure:
. - Добавлены новые классы:
YMMECommerce
.YMMECommerceAmount
.YMMECommerceCartItem
.YMMECommerceOrder
.YMMECommercePrice
.YMMECommerceProduct
.YMMECommerceReferrer
.YMMECommerceScreen
.
Подробнее о E-Commerce событиях в разделе ECommerce.
- В класс
-
Повышены производительность и качество статистических данных.
Версия 3.11.1
Релиз 8 июля 2020 г.
- Добавлен новый API отправки крэшей и ошибок:
- класс
YMMError
. - протокол
YMMErrorRepresentable
. - перечисление
YMMErrorReportingOptions
. - константа
YMMBacktraceErrorKey
. - в класс
YMMYandexMetrica
и протоколYMMYandexMetricaReporting
добавлены методы:+reportError:onFailure:
.+reportError:options:onFailure:
.+reportNSError:onFailure:
.+reportNSError:options:onFailure:
.+setErrorEnvironmentValue:forKey:
.
- В классы
YMMYandexMetricaConfiguration
,YMMReporterConfiguration
иYMMMutableReporterConfiguration
добавлено свойствоmaxReportsInDatabaseCount
.
- класс
- Прекращена поддержка метода
+reportError:exception:onFailure:
. Используйте вместо него новые методы+reportError:onFailure:
,+reportError:options:onFailure:
,+reportNSError:onFailure:
или+reportNSError:options:onFailure:
. - Добавлена поддержка детских приложений. Для этого используйте свойство
appForKids
конфигурацииYMMYandexMetricaConfiguration
. Подробнее в разделе Примеры использования. - Исправлена поддержка tvOS.
- Повышены производительность и качество статистических данных.
Версия 3.9.4
Релиз 3 февраля 2020 г.
- Исправлены крэши, которые могли возникать в AppMetrica SDK 3.9.1 и 3.9.2.
Версия 3.9.2
Релиз 27 декабря 2019 г.
- Исправлена генерация неправильного
appmetrica_device_id
. - Исправлен возможный дэдлок при активации.
- Возобновлена поддержка метода
reportReferralUrl
. - Исправлена ошибка с получением информации о
code
иsudcode
для Mach-крэшей. - Исправлена ошибка фреймворка для tvOS.
- Повышены производительность и качество статистических данных.
Версия 3.8.2
Релиз 4 октября 2019 г.
- Исправлена ошибка сериализации
priceDecimal
, которая приводила к появлению отрицательных значений Revenue.
Версия 3.8.1
Релиз 30 сентября 2019 г.
- Исправлена ошибка в динамическом фреймворке.
- Исправлен сбор информации о местоположении. При установке собственного местоположения отключается автоматическое определение.
Версия 3.8.0
Релиз 25 сентября 2019 г.
- Добавлен инструмент командной строки
helper
для Загрузка dSYM-файлов на iOS.
Версия 3.7.1
Релиз 11 июля 2019 г.
-
В класс
YMMRevenueInfo
добавлены:- Метод
-initWithPriceDecimal:currency:
. Используйте его вместо устаревшего‑initWithPrice:currency:
. - Метод
-initWithPriceDecimal:currency:quantity:productID:transactionID:receiptData:payload:
. Используйте его вместо устаревшего-initWithPrice:currency:quantity:productID:transactionID:receiptData:payload:
. - Свойство
priceDecimal
. Используйте его вместо устаревшегоprice
.
- Метод
-
В класс
YMMYandexMetrica
добавлены методы для ручного контроля сессий:- Метод
+pauseSession:
. - Метод
+resumeSession:
.
- Метод
-
В класс
YMMYandexMetricaConfiguration
добавлены свойства для контроля сессий:- Свойство
handleActivationAsSessionStart
. - Свойство
sessionsAutoTracking
.
- Свойство
-
Прекращена поддержка метода
+reportReferralUrl:
. Метод устарел. -
Исправлена ошибка с дополнительной информацией в крэш-логах:
active_time_since_launch
,active_time_since_last_crash
и т. д.
Версия 3.6.0
Релиз 18 февраля 2019 г.
- Исправлена потенциальная потеря сообщений о крэшах на устройствах с 32-разрядным процессором.
- Исправлена ошибка, которая влияла на работу AppMetrica SDK версий 3.1.0–3.5.0.
- Повышены производительность и качество статистических данных.
Версия 3.5.0
Релиз 25 декабря 2018 г.
- Добавлена поддержка tvOS 9 и выше.
- Повышены производительность и качество статистических данных.
Версия 3.4.1
Релиз 15 ноября 2018 г.
- Исправлена проблема с подключением статического фреймворка в проект на Swift.
Версия 3.4.0
Релиз 2 ноября 2018 г.
- Библиотека разделена на два фреймворка: один содержит основной функционал SDK, другой — обработку крэшей. Подробнее в разделе Подключение и инициализация.
- Исправлена работа метода
+sendEventsBuffer:
в фоне. - Повышены производительность и качество статистических данных.
Версия 3.3.0
Релиз 6 сентября 2018 г.
- Улучшена обработка информации, которая передается методами
+reportUserProfile:onFailure:
и+reportRevenue:onFailure:
. - Повышены производительность и качество статистических данных.
Версия 3.2.0
Релиз 20 июля 2018 г.
- Добавлен метод
+setStatisticsSending:
для отключения отправки статистики. - Добавлен метод
+requestAppMetricaDeviceIDWithCompletionQueue:block:
для получения уникального идентификатора AppMetrica (appmetrica_device_id
). - Добавлен метод
+sendEventsBuffer:
для принудительной отправки событий из буфера. - Повышены производительность и качество статистических данных.
Версия 3.1.2
Релиз 2 июля 2018 г.
-
Внесены изменения в SDK для соответствия требованиям Apple App Store Review Team. Обновите AppMetrica SDK для прохождения модерации в App Store.
Внимание
Предыдущие версии iOS SDK (2.8.0–3.1.1) недоступны для скачивания. Если вы используете библиотеку версии 2.9.х, обновите SDK до версии 2.9.8.
Версия 3.1.1
Релиз 13 июня 2018 г.
- Исправлена проблема в AppMetrica SDK 3.1.0, связанная с потерей внутренних данных.
Версия 3.1.0
Релиз 8 июня 2018 г.
- Добавлена возможность атрибуции через deeplink (Re-engagement).
- Исправлен возможный дэдлок, затронувший версии AppMetrica SDK 3.0.0 и 3.0.1.
- Повышены производительность и качество статистических данных.
Версия 3.0.1
Релиз 21 мая 2018 г.
- Повышена стабильность работы библиотеки.
Версия 3.0.0
Релиз 18 апреля 2018 г.
- Добавлена возможность создания пользовательских профилей.
- Добавлен трекинг покупок в приложении.
- Изменены методы API.
- Изменен порядок представления информации в отчетах по крэшам (для соответствия формату Apple).
- Расширено логирование для событий.
- Прекращена поддержка iOS 6 и iOS 7.
- Повышены производительность и качество статистических данных.
Push SDK
Версия 2.0.0
Релиз 15 апреля 2024 г.
- Обновлены идентификатор библиотеки и API. Библиотека разделена на модули. Подробнее в инструкции по миграции.
- Добавлена поддержка Privacy Manifest.
Версия 1.3.0
Релиз 1 июля 2022 г.
- Добавлен метод
YMPYandexMetricaPush.handleSceneWillConnectToSession
для работы с UIScene (с iOS версии 13 и выше).
Версия 1.1.1
Релиз 29 сентября 2021 г.
- Добавлена поддержка AppMetrica SDK 4.0.0.
Версии 1.0.0 — 0.3.0
1.0.0 — 0.3.0
Версия 1.0.0
Релиз 13 июля 2021 г.
- Минимальная поддерживаемая версия iOS 9.0.
- Библиотека поставляется теперь только в виде XCFramework, что повлекло следующие изменения:
- Минимальные поддерживаемые версии CocoaPods — 1.10, Carthage — 0.38. В этих версиях добавлена поддержка XCFramework.
- Добавлена версия библиотеки для симуляторов iOS, запускаемых на Mac c процессорами Apple Silicon M1 (
ios-arm64-simulator
). - Добавлена дистрибуция Push SDK с помощью Swift Package Manager. Подробности можно узнать в статье Подключение и инициализация.
Версия 0.9.2
Релиз 12 июля 2021 г.
- Добавлена возможность загрузки прикрепленных файлов в push-уведомлениях с помощью метода
downloadAttachmentsForNotificationRequest
для iOS 10 и выше. С примером интеграции можно ознакомиться в статье Загрузка прикрепленных файлов.
Версия 0.8.0
Релиз 26 апреля 2019 г.
- Добавлена возможность отслеживания push-уведомлений с собственной реализацией UNUserNotificationCenterDelegate:
- Добавлен метод
+userNotificationCenterHandler
. - Добавлен протокол
YMPUserNotificationCenterHandling
.
- Добавлен метод
Версия 0.7.2
Релиз 27 ноября 2018 г.
- Исправлена ошибка в динамическом фреймворке.
Версия 0.7.1
Релиз 19 ноября 2018 г.
- Добавлено проксирование userNotificationCenter:openSettingsForNotification: в
YMPUserNotificationCenterDelegate
. - Исправлена ошибка, которая возникает при передаче
nil
в метод+setDeviceTokenFromData:
- Добавлена поддержка AppMetrica SDK 3.4.0.
Версия 0.7.0
Релиз 31 августа 2018 г.
- Добавлена возможность отслеживать cбор статистики показов/отклонений push-уведомлений для iOS 10 и выше.
Версия 0.6.0
Релиз 20 апреля 2018 г.
- Добавлена поддержка AppMetrica SDK 3.0.0.
Версия 0.5.1
Релиз 21 марта 2018 г.
- Исправлен крэш при открытии URL из push-уведомления.
- Исправлена ошибка, которая возникает при открытии URL одного и того же push-уведомления более одного раза.
Версия 0.5.0
Релиз 26 октября 2017 г.
- Добавлена поддержка отображения push-уведомлений в iOS 10 и выше. Требует дополнительной интеграции.
- Добавлен механизм отслеживания push-уведомлений, которые отправлены в AppMetrica Push SDK.
- Добавлена возможность отправлять окружение APNs (Apple Push Notifications Service) вместе с device token.
Версия 0.4.0
Релиз 24 ноября 2016 г.
- Добавлено открытие ссылки из push-уведомления.
- Добавлен динамический фреймворк.
- Динамический фреймворк DynamicDependencies заменен на Dynamic.
- Статический фреймворк StaticDependencies заменен на Static.
Версия 0.3.0
Релиз 10 октября 2016 г.
- Произведена интеграция с библиотекой AppMetrica Mobile SDK.