---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.3
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/sdk/ios/changelog-ios.md
  - https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/changelog-ios.md
  - href: en/analytics/content/sdk/ios/changelog-ios.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/en/llms.txt

# Changelog

## AppMetrica SDK {#sdk}

### Version 6.6.0 {#v-6-6-0}

Release July 29, 2026

- Added support for setting `customHosts` through `AnalyticsLibraryAdapter`.
- Fixed crash reporting in certain scenarios.
- Added error environment support for a secondary reporter through `AMAAppMetricaCrashReporting.setErrorEnvironmentValue:forKey:`.
- Fixed the initialization order of `AMAModulesController` to prevent race conditions when activating modules.
- Fixed a crash that occurred while sending a non-fatal error during loaded binary image information retrieval.
- Added the `initializeCrashMonitoringWithConfiguration:` API for early native crash monitoring initialization.

### Version 6.5.1 {#v-6-5-1}

Release July 23, 2026

- Crash reporting in individual scenarios has been fixed.
- Fixed crash when sending non-fatal error during extraction of information about uploaded binary images.

### Version 6.4.2 {#v-6-4-2}

Release July 23, 2026

- Crash reporting in individual scenarios has been fixed.

### Version 6.4.1 {#v-6-4-1}

Release July 17, 2026

- Fixed crash when sending non-fatal error during extraction of information about uploaded binary images.

### Version 6.5.0 {#v-6-5-0}

Release July 16, 2026

- Added the `AppMetricaProductFlow` module and API for [tracking product scenarios and offer events](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-product-flow.md). For more details about the approach, see [Offer events in product scenarios](https://boost.yandex.com/doc/en/analytics/content/data-collection/offers.md).
- Fixed incorrect identifier generation.
- Added an API to append values to errorEnvironment during crash report recording.
- Added the appEnvironment property to ReporterConfiguration/MutableReporterConfiguration: values set via this property are now applied to the secondary reporter immediately after its activation.

### Version 6.4.0 {#v-6-4-0}

Release June 26, 2026

- Added `AMAAppMetricaEvent` protocol for sending events.
- Added [auto-collection of Ad Revenue from AppLovin](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#send-adrevenue) in `AppMetricaCore`.
- Added [auto-collection of Ad Revenue from IronSource](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#send-adrevenue) in `AppMetricaCore`.
- Added crash filtering support after activation.
- Optimized pre-main initialization: moved logger initialization from `+load`/`+initialize` to `willActivateWithConfiguration:`, made `AMAHostStateProvider` initialization lazy.
- Fixed session update logic bugs that could cause incorrect behavior on resume and pause.
- Fixed data race in `AMAStartupController`.
- Fixed duplication of Open(16) events in the anonymous-then-regular activation scenario.
- Fixed [`profileId`](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#send-profile-id) not being applied when AppMetrica is activated simultaneously with Yandex Ads SDK.

### Version 6.3.0 {#v-6-3-0}

Release May 7, 2026

- Added `app_version_name` and `app_build_number` parameters to the `startup` request.
- Added `is_main` parameter to the `/report` request to indicate which `apiKey` was used to activate SDK AppMetrica.
- Removed dynamic framework loading.
- Fixed a crash when processing a configuration containing `NSNull` in JSON.

### Version 6.2.1 {#v-6-2-1}

Released April 25, 2026

- Fixed crashes on launch when stale configuration.json from older SDK is present.

### Version 6.2.0 {#v-6-2-0}

Release April 3, 2026

- Added SPM target `AppMetricaAnalytics`, equivalent to the existing CocoaPods module. For more details, see [SDK integration](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/quick-start.md).
- Updated error codes: new codes added to `AMAAppMetricaEventErrorCode`, constants renamed for style consistency, backward-compatible aliases added.
- Fixed identifier migration from AppMetrica 4.
- Updated `KSCrash` dependency to version `>= 2.5.1, < 2.6.0`.

### Version 6.1.0 {#v-6-1-0}

Released February 17, 2026

- Introduced API for [crash](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-crash.md) and [ANR](https://boost.yandex.com/doc/en/analytics/content/mobile-reports/anr.md) monitoring.

### Version 6.0.0 {#v-6-0-0}

Released February 4, 2026

- The order of selecting the value of `advertisingIdentifiersTrackingEnabled` from `AnalyticsLibraryAdapter` has been changed: the flag value has default value and it override AppMetrica default value.
- The `userContentController` field has been removed from the `AMAJSControlling` protocol.
- AppMetricalibraryAdapter API change. To avoid Swift limitations, the following have been renamed:
   `AppMetricaLibraryAdapter` → `AnalyticsLibraryAdapter`
   `LibraryAdapterConfig` → `AnalyticsLibraryAdapterConfig`
   `LibraryAdapterConfiguration` → `AnalyticsLibraryAdapterConfiguration`
   `MutableLibraryAdapterConfiguration` → `MutableAnalyticsLibraryAdapterConfiguration`

  For more details, see the [migration instructions](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/migration-io-6-0-0.md).
- Compatibility with Swift 6 has been added.
- Minimum Swift version has been raised to 5.9.0.

### Version 5.16.1 {#v-5-16-1}

Released April 25, 2026

- Fixed crashes on launch when stale configuration.json from older SDK is present.


### Version 5.16.0 {#v-5-16-0}

Released December 29, 2025

- Added [support for sending First Party Data via user attributes](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#send-attribute-profile-1pd).
- Added real-time delivery of synchronization results with anonymous identifier providers.
- Fixed a crash that occurred when access to the App Group was unavailable (`NSInvalidArgumentException caused by a nil path passed to initFileURLWithPath:`).
- Database errors now use the `AppMetricaDatabaseErrorDomain` domain instead of `AppMetricaInternalErrorDomain`.

### Version 5.15.0 {#v-5-15-0}

Released November 10, 2025

- Fixed a compilation issue in `AMAANRWatchdog` within `AppMetricaCrashes`.
- Fixed a bug where a crash could be assigned to an incorrect session when calling `setErrorEnvironmentValue:` after activation.

### Version 5.14.0 {#v-5-14-0}

Released October 17, 2025

- Added `AppMetricaIDSync` which provides an infrastructure for working with multiple user identifier providers, enabling anonymous audience targeting and identifier merging while preserving user privacy.
- Fixed deadlock in `CLLocationManager`.
- Improved ANR detection performance.
- Using `journal_mode=wal` for databases to reduce I/O.
- ANR tracking disabled for iOS extensions. For more details about working in extensions, see [Work in App Extensions](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-appgroup.md).

### Version 5.13.0 {#v-5-13-0}

Released September 25, 2025

- Fixed an issue where a crash could be added to the next session.
- The `advertisingIdentifierTrackingEnabled` flag has been added to `AMAAppMetricaConfiguration` and `AMAAppMetrica`. This setting allows disabling IDFA sending, even if the `AppMetricaAdSupport` module was enabled. For more details, see [SDK integration](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/quick-start.md) and [Tracking in iOS 14.5+](https://boost.yandex.com/doc/en/analytics/content/mobile-tracking/ios-tracking.md).

### Version 5.12.1 {#v-5-12-1}

Released August 20, 2025

- Restored `LibraryAdapterConfiguration`/`MutableLibraryAdapterConfiguration` to fix a crash in YandexAds within the `MobileAds.initializeSDK` method.

### Version 5.12.0 {#v-5-12-0}

Released August 14, 2025

- Added methods to manage IDFA and [Location](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#track-location) via `LibraryAdapter`.
- Fixed an issue where crashes occurring during an app update were sent with an incorrect app version.
- Fixed a crash caused by an active file lock (flock) when the app entered suspend.
- Updated `KSCrash` to 2.1.1.
- Added deferred anonymous activation triggered on first reporter access.
- Added Accessibility info reporting.
- Fixed a migration issue that could overwrite identifiers.

### Version 5.11.2 {#v-5-11-2}

Released July 14, 2025

- [Disabling data sending](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#stat) through `AppMetricaConfiguration.setDataSendingEnabled(Boolean)` or `AppMetrica.setDataSendingEnabled(Boolean)` prevents the SDK from making any network calls.

### Version 5.11.1 {#v-5-11-1}

Released June 10, 2025

- Technical release.

### Version 5.11.0 {#v-5-11-0}

Released May 22, 2025

- Added support for double-escaping in reattribution parameters.
- Added support for future auto-collection of ad revenue data from plugins.
- Custom location passed via `AppMetrica.setCustomLocation(Location)` is now sent with events even if location tracking is disabled via `AppMetrica.setLocationTrackingEnabled(Boolean)` or `AppMetricaConfiguration.setLocationTracking(Boolean)`. For more details, see [Setting device location manually](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#location-manual).

### Version 5.10.0 {#v-5-10-0}

Released April 21, 2025

- Added the ability to disable IDFA usage in `AppMetricaLibraryAdapter`. For more details about IDFA, see [Tracking in iOS 14.5+](https://boost.yandex.com/doc/en/analytics/content/mobile-tracking/ios-tracking.md).
- Updated KSCrash dependency to version 2.0.0.
- Added the module `AppMetricaScreenshot` to detect when a user takes a screenshot.
- Migrated hashing algorithm from MD5 to SHA256.
- Fixed an issue that caused session counter rollback during consecutive migration to version 5.0 and then to 5.8.0+.
- Fixed a bug in sending internal TransactionFailure events and improved crash delivery reliability.
- Increased deployment_target for iOS and tvOS to version 13.0.

### Version 5.9.0 {#v-5-9-0}

Released December 12, 2024

- Implemented [identifier sharing between the application and its extension](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-appgroup.md).
- Resolved a conflict between `AppMetricaProtobuf` and other libraries using `protobuf-c`.
- Enhanced internal error reporting with more detailed information.
- Improved validation of the application environment.

### Version 5.8.2 {#v-5-8-2}

Released October 25, 2024

- Technical release.

### Version 5.8.1 {#v-5-8-1}

Released October 3, 2024

- Fixed sending `EVENT_UPDATE` instead of `EVENT_INIT` for API key 42.

### Version 5.8.0 {#v-5-8-0}

Released September 12, 2024

- Updated `KSCrash` to version `2.0.0-rc.1`.
- Removed domains from NSPrivacyTrackingDomains in the privacy manifest of the AppMetricaCore dependency to comply with Apple's privacy guidelines.
- Added `AppMetricaLibraryAdapter` for integration with third-party libraries.
- Adding forced sending of certain types of events to the server (attributions from external SDKs, e-commerce, revenue, ad revenue (Impression Level Revenue Data), apple privacy).

### Version 5.7.1 {#v-5-7-1}

Released November 7, 2024

- Removed domains from NSPrivacyTrackingDomains in the privacy manifest of the AppMetricaCore dependency to comply with Apple's privacy guidelines.

### Version 5.7.0 {#v-5-7-0}

Released August 3, 2024

- Removed iAd support and references to this library.
- Added event parameters logging.

### Version 5.6.0 {#v-5-6-0}

Released June 27, 2024

- `AppMetricaConfiguration` now includes the `appEnvironment` property, which sets the app environment for all events from the moment of activation.

### Version 5.5.0 {#v-5-5-0}

Released June 26, 2024

- Extensions now use a background session by default. For more details, see [Work in App Extensions](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-appgroup.md).
- Added a [dSYM upload](https://boost.yandex.com/doc/en/analytics/content/data-collection/upload-dsym.md) tool to AppMetricaCrashes.

### Version 5.4.0 {#v-5-4-0}

Released May 24, 2024

- Fixed an error related to sending IDFA. IDFA was not always sent immediately after obtaining user consent for tracking. This could have affected the sending of test push notifications via IDFA. For more details, see [Tracking in iOS 14.5+](https://boost.yandex.com/doc/en/analytics/content/mobile-tracking/ios-tracking.md).

### Version 5.3.2 {#v-5-3-2}

Released May 13, 2024

- Fixed a crash in `[AMAReportersContainer restartPrivacyTimer]`.
- File logging is disabled by default to prevent potential crashes caused by insufficient disk space.

### Version 5.3.1 {#v-5-3-1}

Released May 6, 2024

- Fixed module validation error for AppMetrica_FMDB, AppMetrica_Protobuf in the App Store when delivering data via SPM.

### Version 5.3.0 {#v-5-3-0}

Released April 26, 2024

- Singular support for external attributions: Added the functionality to send attributions from Singular:
   ```
   AppMetrica.reportExternalAttribution(attributionData, from: .singular) { error in
       print("AppMetrica reporting error: \(error)")
   }
   ```

  For more details, see [Importing attributions from other SDKs](https://boost.yandex.com/doc/en/analytics/content/data-collection/attribution-integration.md).
- Assert correction: Removed internal asserts to optimize the code and prevent potential errors at development stage.
- KSCrash update: Changed the dependency on KSCrash version from a strict setting to a flexible range: ~> 1.17.0.

### Version 5.2.0 {#v-5-2-0}

Released April 16, 2024

- You can now [import attributions from other SDKs](https://boost.yandex.com/doc/en/analytics/content/data-collection/attribution-integration.md) for iOS in AppMetrica.
- Added the following for operations with external attributions: a method named `AppMetrica.reportExternalAttribution(_:from:onFailure:)` ([Swift](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/swift/AppMetrica.md#method_reportexternalattribution__from__onfailure), [Objective-C](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/objectivec/AMAAppMetrica.md#method_reportexternalattribution__source__onfailure)), struct/typedef `AttributionSource` ([Swift](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/swift/AttributionSource.md), [Objective-C](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/objectivec/AMAAttributionSource.md)).

### Version 5.1.0 {#v-5-1-0}

Released March 6, 2024

- Added support for the [Privacy Manifest](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files).

### Version 5.0.0 {#v-5-0-0}

Released February 13, 2024

- Updated the library ID and API. For more information, see the [migration instructions](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/migration-io-5-0-0.md).

### Version 4.5.2 {#v-4-5-2}

Released May 22, 2023

- Fixed `posix_spawn` Xcode crash with sanitizer enabled.

### Version 4.5.0 {#v-4-5-0}

Released March 21, 2023

- Fixed the `locationServicesEnabled invoked on the main thread` error on iOS 16.

### Version 4.4.0 {#v-4-4-0}

Released September 19, 2022

- Added the AdRevenue API for transmitting advertising monetization revenue at the impression level (Impression-Level Revenue Data):
   - The `YMMAdRevenueInfo` and `YMMMutableAdRevenueInfo` classes.
   - The `reportAdRevenue` method in the `YMMYandexMetrica`, `reportAdRevenue` class in the `YMMYandexMetricaReporting` protocol.
   - The `YMMAdType` enumeration.

  For more details, see [Sending Ad Revenue](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#send-adrevenue) and [Ad Revenue](https://boost.yandex.com/doc/en/analytics/content/data-collection/about-adrevenue.md).

### Version 4.2.0 {#v-4-2-0}

Released February 18, 2022

- Added a new API to track crashes and errors from random plugins.

   Protocols:
   - `YMMYandexMetricaPlugins`.
   - `YMMYandexMetricaPluginReporting`.

   Classes:
   - `YMMPluginErrorDetails`.
   - `YMMStackTraceElement`.

- Added the API for the correct SDK functioning in the context of session auto-tracking if activated from plugins: `YMMYandexMetricaPlugins.handlePluginInitFinished`.
- Added the ability to send errors from reporters without activating the master key. In this case, meta information from KSCrash (system data) will be missing.

### Versions 4.0.0 — 3.0.0

{% cut "4.0.0 — 3.0.0" %}

#### Version 4.0.0 {#v-4-0-0}

Released September 20, 2021

- Supported the option to set the [user profile ID](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#send-profile-id) when activating (`[YMMYandexMetricaConfiguration userProfileID]`) or before activating (`[YMMYandexMetrica setUserProfileID]`) the master key, as well as when activating the reporter (`[YMMReporterConfiguration userProfileID]`).
- Added the `appOpenTrackingEnabled` property for [automatic tracking of app openings via a deeplink](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#deeplink). For more details, see [Deeplink tracking](https://boost.yandex.com/doc/en/analytics/content/data-collection/deeplinks.md).
- Added the `revenueAutoTrackingEnabled` property for the [automatic collection of data on In-App purchases](https://boost.yandex.com/doc/en/analytics/content/data-collection/about-revenue.md).
- Added [managing the Conversion Value](https://boost.yandex.com/doc/en/analytics/content/mobile-tracking/conversion-value.md).

#### Version 3.17.0 {#v-3-17-0}

Released June 8, 2021

- Fixed a possible bug
   ```
   Main Thread Checker: UI API called on a background thread: -[WKUserScript initWithSource:injectionTime:forMainFrameOnly:]
   ```
- Added a library version for iOS simulators that are run on Apple Silicon M1 Macs (`ios-arm64-simulator`).
- The library is now delivered only as an XCFramework, which caused the following changes:
   - The minimum supported version of CocoaPods is 1.10 and Carthage is 0.38. These versions now support XCFrameworks.
   - The AppMetrica SDK is now connected on tvOS the same way as on iOS: the `YandexMobileMetrica/Dynamic-TV` and `YandexMobileMetrica/Static-TV` subspecs are no longer available.

#### Version 3.16.0 {#v-3-16-0}

Released May 27, 2021

- Added the `initWebViewReporting` method for [sending events from the WebView's JS code](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#js-event).
- Fixed errors and improved stability.

#### Version 3.15.1 {#v-3-15-1}

Released April 20, 2021

- Improved Apple Search Ads attribution via AdServices Framework. Upgrade to this version to keep Apple Search Ads tracking on iOS 14.5+. For more details, see [Tracking Apple Search Ads campaigns](https://boost.yandex.com/doc/en/analytics/content/mobile-tracking/searchads-settings.md).

#### Version 3.15.0 {#v-3-15-0}

Released March 30, 2021

- Added support for attributing installs on devices running iOS version 14.5+ via [SKAdNetwork](https://developer.apple.com/documentation/storekit/skadnetwork). Upcoming versions of the SDK will make it possible to transmit conversion values. See also [managing the Conversion Value](https://boost.yandex.com/doc/en/analytics/content/mobile-tracking/conversion-value.md) and [Tracking in iOS 15](https://boost.yandex.com/doc/en/analytics/content/mobile-tracking/ios15-tracking.md).
- Data can now be received for attributing installs from Apple Search Ads via [AdServices Framework](https://developer.apple.com/documentation/adservices) (for devices running iOS 14.3+). Attribution is implemented in the AppMetrica backend and doesn't require further updates. For more details, see [Tracking Apple Search Ads campaigns](https://boost.yandex.com/doc/en/analytics/content/mobile-tracking/searchads-settings.md).
- Operator and Connection type collection is disabled.

#### Version 3.14.0 {#v-3-14-0}

Released 29 December 2020.

- Added AppMetrica distribution using Swift Package Manager. For more information, see [Installation and initialization](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/quick-start.md).
- The minimum supported iOS version is 9.0 or later.
- Fixed an issue in linking crashes to sessions.

#### Version 3.12.0 {#v-3-12-0}

Released 14 October 2020

- Added a new API for sending E-Commerce events:
   - Added the `+reportECommerce:onFailure:` method to the `YMMYandexMetrica` class and the `YMMYandexMetricaReporting` protocol.
   - Added new classes:
      - `YMMECommerce`.
      - `YMMECommerceAmount`.
      - `YMMECommerceCartItem`.
      - `YMMECommerceOrder`.
      - `YMMECommercePrice`.
      - `YMMECommerceProduct`.
      - `YMMECommerceReferrer`.
      - `YMMECommerceScreen`.

   For more information about E-Commerce events, see [E-commerce](https://boost.yandex.com/doc/en/analytics/content/data-collection/about-ecommerce.md).

- Improved the performance of the library and the quality of statistical data.

#### Version 3.11.1 {#v-3-11-1}

Released 8 July 2020

- Added a new API for sending crashes and errors:
   - The `YMMError` class.
   - The `YMMErrorRepresentable` protocol.
   - The `YMMErrorReportingOptions` enumeration.
   - The `YMMBacktraceErrorKey` constant.
   - Added the following methods to the `YMMYandexMetrica` class and `YMMYandexMetricaReporting` protocol:
      - `+reportError:onFailure:`.
      - `+reportError:options:onFailure:`.
      - `+reportNSError:onFailure:`.
      - `+reportNSError:options:onFailure:`.
      - `+setErrorEnvironmentValue:forKey:`.
   - Added the `maxReportsInDatabaseCount` property to the `YMMYandexMetricaConfiguration`, `YMMReporterConfiguration`, and `YMMMutableReporterConfiguration` classes.

  For more details, see [Sending a custom error message](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#send-report-error).
- Stopped supporting the `+reportError:exception:onFailure` method. Use the new `+reportError:onFailure:`, `+reportError:options:onFailure:`, `+reportNSError:onFailure:`, or `+reportNSError:options:onFailure:` methods instead.
- Added support for children's apps. Use the `appForKids` property of the `YMMYandexMetricaConfiguration` configuration. 
- Fixed support for tvOS.
- Improved the performance of the library and the quality of statistical data.

#### Version 3.9.4 {#v-3-9-4}

Released 3 February 2020

- Fixed possible crashes in AppMetrica SDK 3.9.1 and 3.9.2.

#### Version 3.9.2 {#v-3-9-2}

Released 27 December 2019

- Fixed incorrect `appmetrica_device_id` generation process.
- Fixed possible deadlock during the activation.
- The `reportReferralUrl` method is no longer deprecated.
- Fixed getting information about `code` and `sudcode` for Mach exceptions.
- Fixed framework for tvOS.
- Improved the performance of the library and the quality of statistical data.

#### Version 3.8.2 {#v-3-8-2}

Released 4 October 2019

- Fixed a `priceDecimal` serialization error that caused negative Revenue values.

#### Version 3.8.1 {#v-3-8-1}

Released 30 September 2019

- Fixed an issue in the dynamic framework.
- Fixed collection of information on location. When you set your own location, automatic detection is disabled.

#### Version 3.8.0 {#v-3-8-0}

Released 25 September 2019

- Added the `helper` command-line tool for [Uploading dSYM files on iOS](https://boost.yandex.com/doc/en/analytics/content/data-collection/upload-dsym.md).

#### Version 3.7.1 {#v-3-7-1}

Released 11 July 2019

- Added to the `YMMRevenueInfo` class:
   - The `-initWithPriceDecimal:currency:` method. Use it instead of the deprecated `‑initWithPrice:currency:` method.
   - The `-initWithPriceDecimal:currency:quantity:productID:transactionID:receiptData:payload:` method. Use it instead of the deprecated `-initWithPrice:currency:quantity:productID:transactionID:receiptData:payload:` method.
   - The `priceDecimal` property. Use it instead of the deprecated `price` property.

- Added methods for manual control of sessions to the `YMMYandexMetrica` class:
   - The `+pauseSession:` method.
   - The `+resumeSession:` method.

- Added properties for control of sessions to the `YMMYandexMetricaConfiguration` class:
   - The `handleActivationAsSessionStart` property.
   - The `sessionsAutoTracking` property.

  For more details about [tracking user activity](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-listen.md).
- Stopped supporting the `+reportReferralUrl:` method. Deprecated method.
- Fixed the issue with additional information in crash logs: `active_time_since_launch`, `active_time_since_last_crash`, and others.

#### Version 3.6.0 {#v-3-6-0}

Released 18 February 2019

- Fixed possible loss of crash reports on devices with a 32-bit processor.
- Fixed possible crashes which affected the AppMetrica SDK versions 3.1.0 to 3.5.0.
- Improved the performance of the library and the quality of statistical data.

#### Version 3.5.0 {#v-3-5-0}

Released 25 December 2018

- Added support for tvOS 9 and higher.
- Improved the performance of the library and the quality of statistical data.

#### Version 3.4.1 {#v-3-4-1}

Released 15 November 2018

- Fixed the [issue](https://github.com/yandexmobile/metrica-sdk-ios/issues/76) when enabling the static framework in a project using Swift.

#### Version 3.4.0 {#v-3-4-0}

Released 2 November 2018

- Separated the library into two frameworks: core and crash-handling. For more information, see [Installation and initialization](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/quick-start.md).
- Fixed the `+sendEventsBuffer:` method to work correctly in the background.
- Improved the performance of the library and the quality of statistical data.

#### Version 3.3.0 {#v-3-3-0}

Released 6 September 2018

- Improved processing of information transmitted by the `+reportUserProfile:onFailure:` and `+reportRevenue:onFailure:` methods. For more details, see [Sending profile attributes](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#send-attribute-profile) and [Sending Revenue](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#send-revenue).
- Improved the performance of the library and the quality of statistical data.

#### Version 3.2.0 {#v-3-2-0}

Released 20 July 2018

- Added the `+setStatisticsSending:` method to [disable statistics sending](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#stat).
- Added the `+requestAppMetricaDeviceIDWithCompletionQueue:block:` method to [retrieve the AppMetrica device ID](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#get-ids) (`appmetrica_device_id)`.
- Added the `+sendEventsBuffer:` method to [force sending stored events from the buffer](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#send-events-buffer).
- Improved the performance of the library and the quality of statistical data.

#### Version 3.1.2 {#v-3-1-2}

Released 2 July 2018

- Changed the SDK to meet the requirements of the Apple App Store Review Team. Update the AppMetrica SDK to avoid any issues during the App Store moderation process.

   {% note alert %}

   Previous versions of iOS SDK (2.8.0–3.1.1) are not available for download. If you're using library version 2.9.x, update the SDK to version 2.9.8.

   {% endnote %}

#### Version 3.1.1 {#v-3-1-1}

Released 13 June 2018

- Fixed an issue in the AppMetrica SDK 3.1.0 related to internal data loss.

#### Version 3.1.0 {#v-3-1-0}

Released 8 June 2018

- Added deeplink attribution (Re-engagement). For more details, see [Tracking app opens using deeplinks](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#deeplink) and [Deeplink tracking](https://boost.yandex.com/doc/en/analytics/content/data-collection/deeplinks.md).
- Fixed a possible deadlock affecting AppMetrica SDK versions 3.0.0 and 3.0.1.
- Improved the performance of the library and the quality of statistical data.

#### Version 3.0.1 {#v-3-0-1}

Released 21 May 2018

- Improved the stability of the library.

#### Version 3.0.0 {#v-3-0-0}

Released 18 April 2018

- Added methods for creating [user profiles](https://boost.yandex.com/doc/en/analytics/content/data-collection/about-profiles.md).
- Added [revenue tracking](https://boost.yandex.com/doc/en/analytics/content/data-collection/about-revenue.md).
- Unified and revised the API.
- Changed the app version and build number order in crash reports to match the Apple format.
- Extended logging of events flow.
- Stopped supporting iOS 6 and iOS 7.
- Improved the performance of the library and the quality of statistical data.

{% endcut %}

## AppMetrica IronSource Adapter {#ironsource}

For more details about sending Ad Revenue, see [Sending Ad Revenue](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#send-adrevenue) and [Ad Revenue](https://boost.yandex.com/doc/en/analytics/content/data-collection/about-adrevenue.md).

### Version 3.0.0 {#v-ironsource-3-0-0}

Released Feb 18, 2026

- Updated dependency: AppMetrica-6.x.x.
- Renamed `AppMetricaIronSourceAdapter` -> `AnalyticsIronSourceAdapter` due to Swift limitation.

### Version 2.0.0 {#v-ironsource-2-0-0}

Released Dec 13, 2025

- Updated dependency: IronSource-9.x.x.

### Version 1.2.0 {#v-ironsource-1-2-0}

Released Dec 8, 2025

- Extended collected data.

### Version 1.1.0 {#v-ironsource-1-1-0}

Released July 4, 2025

- Extended collected data.

### Version 1.0.1 {#v-ironsource-1-0-1}

Released December 3, 2024

- Added `static_framework = true` to podspec.


### Version 1.0.0 {#v-ironsource-1-0-0}

Released November 28, 2024

- Created adapter.


## AppMetrica AppHud Adapter {#apphud}

For more details, see [Boost and Apphud](https://boost.yandex.com/doc/en/analytics/content/data-collection/apphud/apphud-about.md).

### Версия 1.1.2 {#v-apphud-1-1-2}

Released Feb 18, 2026

- Updated dependency: AppMetrica-6.x.x.

### Version 1.0.0 {#v-apphud-1-0-0}

Released October 3, 2024

- Created adapter.


## Push SDK {#push}

For more details about setup, see [Installation and initialization](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/push/quick-start.md).

### Версия 3.3.0 {#v-push-3-3-0}

Released Mar 10, 2026

- Dependency updated: AppMetrica-6.x.x.

### Version 3.2.0 {#v-push-3-2-0}

Released Aug 26, 2025

- Sent url in open event.

### Version 3.1.0 {#v-push-3-1-0}

Released May 15, 2025

- Deployment target updated to iOS 13.

### Version 3.0.2 {#v-push-3-0-2}

Released February 27, 2025

- Fixed opening url.

### Version 3.0.0 {#v-push-3-0-0}

Released January 17, 2025

- The mode with storing notifications in shared App Group has been removed. Only the mode of operation in which events are sent directly to AppMetrica is supported (requires [setup](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-appgroup.md)). For more details, see the [migration instructions](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/push/migration-io-push-3-0-0.md).
- Dependency version updated: AppMetrica-5.9.0.

### Version 2.2.1 {#v-push-2-2-1}

Released November 1, 2024

- Technical release.

### Version 2.2.0 {#v-push-2-2-0}

Released October 10, 2024

- Added removal of delivered notifications via silent push.

### Version 2.1.0 {#v-push-2-1-0}

Released September 23, 2024

- Increased frequency of sending push delivery events.

### Version 2.0.0 {#v-push-2-0-0}

Released April 15, 2024

- Library ID and API updated. The library's been split into modules. For more information, see the [migration instructions](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/push/migration-io-push-2-0-0.md).
- Added support for the [Privacy Manifest](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files).

### Version 1.3.0 {#v-push-1-3-0}

Released July 1, 2022

- Added the `YMPYandexMetricaPush.handleSceneWillConnectToSession` method to work with [UIScene](https://developer.apple.com/documentation/uikit/uiscene) (with iOS 13 or higher).

### Version 1.1.1 {#v-push-1-1-1}

Released September 29, 2021

- Added support for AppMetrica SDK [4.0.0](#v-4-0-0).

### Versions 1.0.0 — 0.3.0

{% cut "1.0.0 — 0.3.0" %}

#### Version 1.0.0 {#v-push-1-0-0}

Released 13 July 2021

- The minimum supported iOS version is 9.0 or later.
- The library is now delivered only as an XCFramework, which caused the following changes:
   - The minimum supported version of CocoaPods is 1.10 and Carthage is 0.38. These versions now support XCFrameworks.
- Added a library version for iOS simulators that are run on Apple Silicon M1 Macs (`ios-arm64-simulator`).
- Added Push SDK distribution using Swift Package Manager. For more information, see [Installation and initialization](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/push/quick-start.md).

#### Version 0.9.2 {#v-push--0-9-2}

Released 12 July 2021

- Added the feature to upload attached files in push notifications using the `downloadAttachmentsForNotificationRequest` method for iOS 10 and higher. See an example of integration in the article [Uploading attached files](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/push/ios-push-download-file.md).

#### Version 0.8.0 {#v-push-0-8-0}

Released 26 April 2019

- Added the feature for push notification tracking with the custom [UNUserNotificationCenterDelegate](https://developer.apple.com/documentation/usernotifications/unusernotificationcenterdelegate?language=objc) implementation:
   - Added the `+userNotificationCenterHandler` method.
   - Added the `YMPUserNotificationCenterHandling` protocol.

#### Version 0.7.2 {#v-push-0-7-2}

Released 27 November 2018

- Fixed an issue in the dynamic framework.

#### Version 0.7.1 {#v-push-0-7-1}

Released 19 November 2018

- Added a proxy delegate for [userNotificationCenter:openSettingsForNotification:](https://developer.apple.com/documentation/usernotifications/unusernotificationcenterdelegate/2981869-usernotificationcenter?language=objc) (`YMPUserNotificationCenterDelegate`).
- Fixed crash on setting a `nil` token to the `+setDeviceTokenFromData:` method.
- Added support for [AppMetrica SDK 3.4.0](#v3-4-0).

#### Version 0.7.0 {#v-push-0-7-0}

Released 31 August 2018

- Added the tracking of the [shows/dismisses of the push notifications](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/push/ios-settings.md) for iOS 10 and higher.

#### Version 0.6.0 {#v-push-0-6-0}

Released 20 April 2018

- Added support for [AppMetrica SDK 3.0.0](#v-3-0-0).

#### Version 0.5.1 {#v-push-0-5-1}

Released 21 March 2018

- Fixed crash when opening URL from push notification.
- Fixed a bug that occurs when a URL of the same push notification is opened more than once.

#### Version 0.5.0 {#v-push-0-5-0}

Released 26 October 2017

- Added the in-app notifications support for iOS 10 and higher. Requires [additional integration](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/push/quick-start.md#opening).
- Added a method for identification of push notifications related to [AppMetrica Push SDK](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/push/quick-start.md).
- Added a method for sending an APNs (Apple Push Notifications service) environment with a [device token](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/push/quick-start.md#apns).

#### Version 0.4.0 {#v-push-0-4-0}

Released 24 November 2016

- Links from push notifications are now opened.
- Added a dynamic framework.
- The DynamicDependencies framework has been changed to Dynamic.
- The StaticDependencies framework has been changed to Static.

#### Version 0.3.0 {#v-push-0-3-0}

Released 10 October 2016

- Integrated with the AppMetrica Mobile SDK library.

{% endcut %}