Releases: appmetrica/appmetrica-sdk-ios
5.3.1
What’s New:
- Fixed an error validating the
AppMetrica_FMDB
,AppMetrica_Protobuf
modules in the AppStore when published via SPM.
Full Changelog: 5.3.0...5.3.1
5.3.0
What’s New:
-
Singular Attributions: Support Singular for external attributions:
AppMetrica.reportExternalAttribution(attributionData, from: .singular) { error in print("AppMetrica reporting error: \(error)") }
-
Assert fixes: Internal asserts were removed for code optimization and preventing potential errors during development.
-
KSCrash update: the strict dependency on the KSCrash library has been changed to the version range
~> 1.17.0
.
Full Changelog: 5.2.0...5.3.0
5.2.0: External Attributions
What’s New:
-
External Attributions Support: Compatibility with leading attribution sources including AppsFlyer, Adjust, Kochava, Tenjin, and Airbridge has been added, facilitating seamless integration of external data and simplifying the analysis of marketing campaign impacts.
As an example, you can easily forward attribution data from AppsFlyer to AppMetrica with just a simple block of code:
extension AppDelegate: AppsFlyerLibDelegate { func onConversionDataSuccess(_ installData: [AnyHashable: Any]) { AppMetrica.reportExternalAttribution(installData, from: .appsflyer) { error in print("AppMetrica reporting error: \(error)") } } }
Enhancements and Corrections:
- CocoaPods Submodules Issue: Corrected an inconsistency with podspec versioning in submodules.
- Swift Package Manager Adaptations: Improved SDK's backward compatibility with Swift 5.7 and 5.8 in the SPM manifest.
- tvOS Compilation Enhancements: Implemented targeted adjustments for tvOS compilation processes.
- Deadlock Prevention: Fixed a potential deadlock scenario that could arise when AppMetrica startup identifiers were accessed from a different thread than the one used for activation.
- KSCrash Library Update: The KSCrash dependency has been updated to version 1.17.0, incorporating an Apple Privacy manifest.
Full Changelog: 5.1.0...5.2.0
5.1.0: Privacy Manifest
What's New:
- Module-Specific Privacy Manifests: In line with Apple's guidelines, the AppMetrica SDK has introduced Privacy Manifests for each module. This update ensures precise privacy declarations, reflecting only the Privacy-related APIs and data types your app actually uses, thus maintaining accuracy in privacy compliance.
- Dedicated Hosting for IDFA Data: In compliance with Apple's guidelines, IDFA data is now handled through a dedicated host. This adjustment ensures IDFA data is managed properly, respecting user consent and privacy settings. This enhancement is part of our ongoing efforts to align with Apple's privacy framework, ensuring user data is treated with the utmost care and in accordance with the latest standards.
Note:
The integration of AppMetrica SDK and its compliance with Apple's privacy requirements remains seamless, with no extra actions required on your part. These module-specific Privacy Manifests are automatically configured to ensure that your app's integration does not inadvertently declare unused Privacy-related APIs and data types.
For developers looking to assess the privacy implications of their integrated AppMetrica SDK modules, generating an aggregated privacy report is straightforward:
- Archive your app project via "Product -> Archive" in Xcode.
- In the Organizer window, control-click the Archive and select "Generate Privacy Report."
Full Changelog: 5.0.0...5.1.0
5.0.0: 🚀 Open Source & Modular 🚀
In the latest release of the AppMetrica SDK version 5.0.0, we're bringing a wealth of improvements and changes, all designed to streamline the migration process and enhance the capabilities of your app analytics.
What's Included in This Release
- Open Source Initiative: The entire SDK is now open-source, offering unprecedented access to its inner workings and fostering a community-driven development approach.
- Modular Design: Reflecting our commitment to flexibility, the SDK has been rearchitected into distinct modules. This allows for a more tailored integration, enabling you to incorporate only the components you need.
- New Modules Introduction: Beyond the foundational
AppMetricaCore
andAppMetricaCrashes
, we're introducingAppMetricaAdSupport
andAppMetricaWebKit
. These modules expand your toolkit, providing advanced features for ad support and web content interaction without adding unnecessary bulk to your app. - Smooth Transition Path: Ensuring a seamless migration from
YandexMobileMetrica
toAppMetrica
, we've carefully preserved all essential identifiers and data. This meticulous approach guarantees the integrity of your reporting data throughout the upgrade process.
Highlights for Developers
- Renamed Dependencies: For CocoaPods, replace
YandexMobileMetrica
withAppMetricaAnalytics
. Swift Package Manager users should transition from YandexMobileMetrica to the new AppMetrica repository. These changes simplify the integration process across different package managers and development environments. - Updated API for Clarity and Ease of Use: Significant renaming within the API streamlines interaction with the SDK. For instance,
YMMYandexMetrica
becomesAppMetrica
, accompanied by method name updates to enhance clarity and usability. - Advanced Error and Crash Reporting: The introduction of
AppMetricaCrashes
centralizes and enhances error reporting capabilities, providing detailed insights into application stability. - WebView Integration Simplified: Event reporting from WebView content has been refined, now requiring
AppMetricaWebKit
and the utilization ofJSController
for improved interaction. - Apps for Kids Compliance: The modular structure facilitates the exclusion of
AppMetricaAdSupport
when targeting younger audiences, ensuring compliance with child protection regulations.
Migration Guide Overview
This update requires attention to several key areas during migration:
- Verify the absence of concurrent SDK versions to maintain data accuracy.
- Update your project's dependencies according to the new guidelines for CocoaPods, SPM, or manual setups.
- Refactor your codebase to align with the updated API names and structures, including adjusting import statements and method calls.
- Utilize the
AppMetricaCrashes
module for all crash and error reporting needs, taking advantage of its enhanced capabilities. - For seamless event reporting within WebView, integrate
AppMetricaWebKit
to leverage theJSController
, facilitating effective data collection from web content.
We urge all developers to consult the comprehensive migration guide provided in the SDK documentation for a detailed walkthrough of these steps. This release paves the way for more robust and flexible app analytics, enabling developers to leverage a wider array of tools for monitoring and optimizing app performance.
Should you need further assistance or wish to share feedback, our support team is readily available to help.
5.0.0-beta.2
Add event environment to extended reporting api, rename errorEnvironm…
5.0.0-beta.1
Cleanup revenue deprecated api