История изменений

Релиз 22 мая 2023 г.

• Исправлен posix_spawn крэш Xcode с включенным санитайзером.

Релиз 21 марта 2023 г.

• Исправлена ошибка locationServicesEnabled invoked on the main thread на iOS 16.

Релиз 19 сентября 2022 г.

• Добавлен API AdRevenue для передачи доходов рекламной монетизации на уровне показа (Impression-Level Revenue Data):

  • классы YMMAdRevenueInfo, YMMMutableAdRevenueInfo;
  • методы reportAdRevenue в классе YMMYandexMetrica, reportAdRevenue в протоколе YMMYandexMetricaReporting.
  • перечисление YMMAdType.

Релиз 18 февраля 2022 г.

• Добавлен новый API для отслеживания крэшей и ошибок из произвольных плагинов.

  Протоколы:

  • YMMYandexMetricaPlugins;
  • YMMYandexMetricaPluginReporting.

  Классы:

  • YMMPluginErrorDetails;
  • YMMStackTraceElement.
• Добавлен API для полноценной работы SDK в контексте автотрекинга сессий при условии активации из плагинов: YMMYandexMetricaPlugins.handlePluginInitFinished.
• Добавлена возможность отправлять ошибки из репортеров без активации главного ключа. В этом случае будет отсутствовать мета-инфоромация из KSCrash (данные о системе).

Релиз 20 сентября 2021 г.

• Поддержана возможность задавать идентификатор пользовательского профиля при активации ([YMMYandexMetricaConfiguration userProfileID]) или до активации ([YMMYandexMetrica setUserProfileID]) главного ключа, а также при активации репортера ([YMMReporterConfiguration userProfileID]).
• Добавлено свойство appOpenTrackingEnabled для автоматического трекинга открытия приложения по deeplink (Objective-C | Swift).
• Добавлено свойство revenueAutoTrackingEnabled для автоматического сбора данных по in-app покупкам (Objective-C | Swift).
• Добавлено управление Conversion Value.

Релиз 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 больше недоступны.

Релиз 27 мая 2021 г.

• Добавлен метод initWebViewReporting(Objective-C, Swift) для отправки событий из JS-кода WebView.
• Исправлены ошибки и повышена стабильность.

Релиз 20 апреля 2021 г.

• Доработана атрибуция Apple Search Ads через AdServices Framework. Обновитесь на эту версию, чтобы сохранить трекинг Apple Search Ads на iOS 14.5+.

Релиз 30 марта 2021 г.

• Добавлена поддержка атрибуции установок на устройствах с версией iOS 14.5+ через SKAdNetwork. Передача ценности конверсии будет реализована в следующих версиях SDK.
• Добавлено получение данных, необходимых для атрибуции установок из Apple Search Ads через AdServices Framework (для устройств с версией iOS 14.3+). Атрибуция реализуется в серверной части AppMetrica и не потребует повторного обновления.
• Отключен сбор Оператора и Типа соединений.

Релиз 29 декабря 2020 г.

• Добавлена дистрибуция AppMetrica с помощью Swift Package Manager. Подробности можно узнать в статье Подключение и инициализация.
• Минимальная поддерживаемая версия iOS 9.0.
• Исправлена проблема привязки крэша к сессии.

Релиз 14 октября 2020 г.

• Добавлен новый API отправки E-Commerce событий:

  • В класс YMMYandexMetrica и протокол YMMYandexMetricaReporting добавлен метод +reportECommerce:onFailure:.
  • Добавлены новые классы:

    • YMMECommerce;
    • YMMECommerceAmount;
    • YMMECommerceCartItem;
    • YMMECommerceOrder;
    • YMMECommercePrice;
    • YMMECommerceProduct;
    • YMMECommerceReferrer;
    • YMMECommerceScreen.

  Подробнее о E-Commerce событиях в разделе ECommerce.

• Повышены производительность и качество статистических данных.

Релиз 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 февраля 2020 г.

• Исправлены крэши, которые могли возникать в AppMetrica SDK 3.9.1 и 3.9.2.

Релиз 27 декабря 2019 г.

• Исправлена генерация неправильного appmetrica_device_id.
• Исправлен возможный дэдлок при активации.
• Возобновлена поддержка метода reportReferralUrl (Objective-C | Swift).
• Исправлена ошибка с получением информации о code и sudcode для Mach-крэшей.
• Исправлена ошибка фреймворка для tvOS.
• Повышены производительность и качество статистических данных.

Релиз 4 октября 2019 г.

• Исправлена ошибка сериализации priceDecimal, которая приводила к появлению отрицательных значений Revenue.

Релиз 30 сентября 2019 г.

• Исправлена ошибка в динамическом фреймворке.
• Исправлен сбор информации о местоположении. При установке собственного местоположения отключается автоматическое определение.

Релиз 25 сентября 2019 г.

• Добавлен инструмент командной строки helper для Загрузка dSYM-файлов на iOS.

Релиз 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 и т. д.

Релиз 18 февраля 2019 г.

• Исправлена потенциальная потеря сообщений о крэшах на устройствах с 32-разрядным процессором.
• Исправлена ошибка, которая влияла на работу AppMetrica SDK версий 3.1.0–3.5.0.
• Повышены производительность и качество статистических данных.

Релиз 25 декабря 2018 г.

• Добавлена поддержка tvOS 9 и выше.
• Повышены производительность и качество статистических данных.

Релиз 15 ноября 2018 г.

• Исправлена проблема с подключением статического фреймворка в проект на Swift.

Релиз 2 ноября 2018 г.

• Библиотека разделена на два фреймворка: один содержит основной функционал SDK, другой — обработку крэшей. Подробнее в разделе Подключение и инициализация.
• Исправлена работа метода +sendEventsBuffer: в фоне.
• Повышены производительность и качество статистических данных.

Релиз 6 сентября 2018 г.

• Улучшена обработка информации, которая передается методами +reportUserProfile:onFailure: и +reportRevenue:onFailure:.
• Повышены производительность и качество статистических данных.

Релиз 20 июля 2018 г.

• Добавлен метод +setStatisticsSending: для отключения отправки статистики.
• Добавлен метод +requestAppMetricaDeviceIDWithCompletionQueue:block: для получения уникального идентификатора AppMetrica (appmetrica_device_id).
• Добавлен метод +sendEventsBuffer: для принудительной отправки событий из буфера.
• Повышены производительность и качество статистических данных.

Релиз 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.

Релиз 13 июня 2018 г.

• Исправлена проблема в AppMetrica SDK 3.1.0, связанная с потерей внутренних данных.

Релиз 8 июня 2018 г.

• Добавлена возможность атрибуции через deeplink (Re-engagement).
• Исправлен возможный дэдлок, затронувший версии AppMetrica SDK 3.0.0 и 3.0.1
• Повышены производительность и качество статистических данных.

Релиз 21 мая 2018 г.

• Повышена стабильность работы библиотеки.

Релиз 18 апреля 2018 г.

• Добавлена возможность создания пользовательских профилей.
• Добавлен трекинг покупок в приложении.
• Изменены методы API. Подробности в руководстве по переходу на iOS SDK 3.0.0.
• Изменен порядок представления информации в отчетах по крэшам (для соответствия формату Apple).
• Расширено логирование для событий.
• Прекращена поддержка iOS 6 и iOS 7.
• Повышены производительность и качество статистических данных.

Релиз 2 июля 2018 г.

• Внесены изменения в SDK для соответствия требованиям Apple App Store Review Team. Загрузите AppMetrica SDK 2.9.8 и обновите ее в приложении для прохождения модерации в App Store. .

  Внимание. Предыдущие версии iOS SDK (2.8.0–3.1.1) недоступны для скачивания.

Релиз 12 января 2018 г.

• Повышены производительность и качество статистических данных.

Релиз 4 ноября 2017 г.

• Исправлены возможные ошибки на симуляторе.
• Добавлена поддержка трекинга Apple Search Ads.
• Повышены производительность и качество статистических данных.

Релиз 14 августа 2017 г.

• Добавлен метод +reportReferralUrl: задающий referral URL установки приложения.

Релиз 18 июля 2017 г.

• Добавлена возможность отправки сведений на дополнительный API key приложения.
• Повышены производительность и качество статистических данных.

Релиз 19 июня 2017 г.

• Исправлены ошибки с bitcode в Xcode 8.2.1.

Релиз 12 июня 2017 г.

• Повышены производительность и качество статистических данных.

Релиз 4 апреля 2017 г.

• Исправлено неточное отображение версии приложения в отчетах о крэшах.
• Исправлены ошибки при установке местоположения устройства вручную.
• Повышены производительность и качество статистических данных.

Релиз 16 декабря 2016 г.

• Добавлено отслеживание открытий приложения через deeplink.
• Добавлена возможность сообщить AppMetrica, что приложение было установлено на устройство до подключения библиотеки AppMetrica SDK. Это позволит AppMetrica отличать первый запуск приложения после интеграции с SDK от первого запуска приложения в его истории. Такой запуск не будет являться признаком нового пользователя. Подробно в разделе Примеры использования.
• Повышена стабильность работы библиотеки.

Релиз 17 ноября 2016 г.

• Исправлена мета-информация динамического фреймворка.

Релиз 10 октября 2016 г.

• Повышены производительность и качество статистических данных.

Релиз 30 сентября 2016 г.

• Улучшена поддержка iOS 6.

Релиз 20 сентября 2016 г.

• Улучшена поддержка Swift.
• Улучшена поддержка iOS 10.
• В библиотеку добавлен динамический фреймворк.

Релиз 11 июля 2016 г.

• Оптимизация для повышения качества статистики.
• Исправлена ошибка, которая приводила к аварийной остановке приложения.

Релиз 24 мая 2016 г.

• Оптимизация для повышения качества статистики.

Релиз 25 апреля 2016 г.

• Оптимизация для повышения качества статистики.

Релиз 23 марта 2016 г.

• Добавлена технология Referrer-based Tracking.
• Оптимизация для повышения качества статистики.

Релиз 25 февраля 2016 г.

• Устранены внешние зависимости.
• Добавлена модель распространения с помощью статического фреймворка.
• Оптимизация для повышения качества статистики.

Релиз 16 декабря 2015 г.

• Добавлена возможность инициализации библиотеки с помощью расширенной конфигурации, которая гарантирует, что все параметры конфигурации будут применены при отправке первого события.
• Добавлена возможность задавать информацию для отслеживания предустановленных приложений.
• Оптимизация для повышения качества статистики.

Релиз 1 октября 2015 г.

• Добавлена поддержка расширений.
• Добавлена поддержка технологии Bitcode.
• Улучшены сообщения об ошибках.

Релиз 27 августа 2015 г.

• Изменен формат Api key. Идентификатор приложения в новом формате доступен в веб-интерфейсе AppMetrica в режиме редактирования приложения.

  Где найти Api key

  

• Метод инициализации библиотеки в приложении переименован c [YMMYandexMetrica startWithAPIKey:(NSString *)apiKey]; на [YMMYandexMetrica activateWithApiKey:(NSString *)apiKey];.
• Изменена длительность тайм-аута сессии. По умолчанию значение составляет 10 секунд.
• Библиотека адаптирована к iOS 9.
• Улучшено качество подсчета установок приложения и идентификации устройств для трекинга.
• Повышена производительность и снижено энергопотребление.
• Улучшены сообщения об ошибках.
• Удалены устаревшие методы.

  Нажмите, чтобы посмотреть список

  • +(void)setLogLevel:(NSUInteger)level; — позволяет задать уровень логирования.
  • +(void)setReportsEnabled:(BOOL)enabled; — позволяет включить и отключить отправку отчетов.
  • +(void)setDispatchPeriod(NSUInteger)dispatchPeriodSeconds; — позволяет задать интервал в секундах между отправками накопившихся событий на сервер.
  • +(void)setMaxReportsCount(NSUInteger)maxReportsCount; — позволяет задать число событий в хранилище, при достижении которого происходит отправка всех накопившихся событий на сервер.
  • +(void)startNewSessionManually; — позволяет запустить новую сессию вручную.
  • +(void)sendEventsBuffer; — позволяет отправить все накопившиеся события, не дожидаясь автоматической отправки на сервер.
  • +(BOOL)isReportsEnabled; — определяет отправляются ли отчеты.
  • +(BOOL)isReportCrashesEnabled; — определяет отслеживаются ли аварийные остановки приложения.
  • +(BOOL)isTrackLocationEnabled; — определяет передаются ли данные о местоположении.
  • +(NSUInteger)sessionTimeoutSeconds; — определяет какая продолжительность сессии (в секундах) задана.
  • +(NSUInteger)maxReportsCount; — определяет какое число событий в хранилище задано. При достижении этого числа происходит отправка всех накопившихся событий на сервер.
  • +(NSUInteger)dispatchPeriod; — определяет какой интервал в секундах между отправками накопившихся событий на сервер задан.

Релиз 18 июня 2015 г.

• Повышено качество подсчета статистики сессий и установок приложения.

Релиз 12 ноября 2014 г.

• Добавлена бесплатная поддержка трекинга установок приложений.
• Повышена стабильность и улучшено быстродействие.
• Изменена работа с idfa — значение берется библиотекой самостоятельно.
• Добавлена отправка событий с дополнительными параметрами.
• Переименован главный класс библиотеки YMMCounter в YMMYandexMetrica.
• Изменен тип ApiKey с NSUInteger на NSString.
• Библиотека адаптирована к XCode6 и iOS 8.
• Повышена минимальная поддерживаемая версия iOS 6.
• Улучшена работа с локацией. Возможно отключать отправку локации.
• Изменился принцип обработки ошибок при отправке событий с синхронного на асинхронный.
• Ускорен запуск библиотеки.