Merge branch 'release/iOS-3.15.2' into develop

Author: eandreeva-twr

versioned_docs/version-3.0/ios-quickstart-identify.md

@@ -41,6 +41,10 @@ If you don't have backend authentication, **you don't need to handle authenticat
 3. When the user **re-installs** the app or installs it from a **new device**, Adapty **creates a new anonymous profile on activation**.
 4. If the user has previously made purchases in your app, by default, their purchases are automatically synced from the App Store on the SDK activation.
 
+:::note
+Backup restores behave differently from reinstalls. By default, when a user restores from a backup, the SDK preserves cached data and does not create a new profile. You can configure this behavior using the `clearDataOnBackup` setting. [Learn more](sdk-installation-ios#clear-data-on-backup-restore).
+:::
+
 So, with anonymous users, new profiles will be created on each installation, but that's not a problem because, in the Adapty analytics, you can [configure what will be considered a new installation](general#4-installs-definition-for-analytics).
 
 For anonymous users, you need to count installs by **device IDs**. In this case, each app installation on a device is counted as an install, including reinstalls.

versioned_docs/version-3.0/sdk-installation-ios.md

@@ -352,3 +352,21 @@ let configurationBuilder = AdaptyConfiguration
 ```
 
 See more details on how to finish transactions in the [guide](ios-transaction-management).
+
+### Clear data on backup restore
+
+When a user restores their app from an iOS backup, the Adapty SDK can detect this and automatically clear its cached data to start fresh. This prevents potential issues with duplicate profiles and ensures clean analytics data.
+
+Enable this if you want to ensure a fresh SDK state after backup restoration. Keep it disabled (default) if you want to preserve SDK data when users restore from backups.
+
+To enable automatic data clearing on backup restore, set `clearDataOnBackup` to `true`.
+
+:::note
+This only clears the SDK's local cache. The user's actual purchases and subscriptions remain safe and are stored with Apple and in Adapty's servers.
+:::
+
+```swift showLineNumbers
+let configurationBuilder = AdaptyConfiguration
+    .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
+    .with(clearDataOnBackup: true) // default – false
+```