Merge branch 'release/iOS-3.15.1' into develop

# Conflicts:
#	versioned_docs/version-3.0/adapty-user-acquisition.md
#	versioned_docs/version-3.0/android-present-paywall-builder-paywalls-in-observer-mode.md
#	versioned_docs/version-3.0/android-web-paywall.md
#	versioned_docs/version-3.0/sdk-installation-react-native-expo.md
#	versioned_docs/version-3.0/sdk-installation-react-native-pure.md
#	versioned_docs/version-3.0/user-acquisition.md
#	versioned_docs/version-3.0/web-paywall.md

Author: eandreeva-twr

versioned_docs/version-3.0/adapty-ads-manager-get-started.md

@@ -13,6 +13,12 @@ In this guide, you will learn how to start working with Apple Ads Manager in two
 1. Install the Adapty SDK and let it track your purchase data.
 2. Connect Apple Ads Manager to your Apple Ads account to import your historical data and start tracking real-time updates.
 
+:::note
+Apple Ads Manager does not use the [Apple Ads integration](apple-search-ads.md) from **App settings**.
+
+To use Apple Ads Manager, you only need to complete the setup described in this guide.
+:::
+
 ## 1. Install the Adapty SDK
 
 :::important

versioned_docs/version-3.0/adapty-user-acquisition.md

@@ -1,6 +1,6 @@
 ---
 title: "User Acquisition (Adapty UA)"
-description: "Eliminate the need of MMPs and calculate the whole app economy in one place."
+description: "Eliminate the need for MMPs and calculate the whole app economy in one place."
 metadataTitle: "Using Adapty User Acquisition | Adapty Docs"
 keywords: ['adapty ua', 'user acquisition']
 ---
@@ -9,11 +9,12 @@ import ZoomImage from '@site/src/components/ZoomImage';
 
 <CustomDocCardList ids={['user-acquisition', 'ua-analytics', 'ua-integrations', 'ua-tracking-links', 'ua-deferred-data']} />
 
-Adapty User Acquisition is a web-to-app attribution solution that connects ad campaigns with app installs and subscription revenue by combining data from ad platforms, tracking links, and your app.
+Adapty User Acquisition is an attribution solution that connects ad campaigns with app installs and subscription revenue by combining data from ad platforms, tracking links, and your app. It provides a unified marketing analytics dashboard that consolidates all your acquisition data in one place.
 
 - Calculate ROAS (return on ad spend) across all your channels
 - See your entire app economy in one place
 - Get accurate attribution data for better decisions
+- Analyze cohort performance and user behavior over time
 
 :::tip
 Want to learn more about the way Adapty User Acquisition might be useful to you? [Book a call](https://calendly.com/tnurutdinov-adapty/30min) with us.
@@ -23,7 +24,7 @@ Want to learn more about the way Adapty User Acquisition might be useful to you?
 
 Measuring user acquisition performance is challenging. Data is often scattered across platforms, attribution becomes difficult due to privacy changes, and building custom solutions takes significant time.
 
-Adapty UA provides built-in attribution and unified analytics. You can focus on growing your app instead of managing data systems.
+Adapty UA provides built-in attribution and unified analytics in a single marketing dashboard. All your acquisition metrics—from ad spend to installs to subscription revenue—are automatically consolidated and updated in real-time. No more reconciling data across spreadsheets or switching between multiple tools. You can focus on growing your app instead of managing data systems.
 
 ## How it works
 
@@ -48,7 +49,7 @@ The attribution flow works as follows:
 
 5. **Ad spend and revenue are connected.** Adapty pulls ad spend data from supported ad platforms (currently – Meta Ads and TikTok for Business) and links subscription and purchase events to the attributed installs.
 
-As a result, Adapty provides campaign-level metrics such as installs, revenue, LTV, and ROAS in a single dashboard.
+As a result, Adapty provides campaign-level metrics such as installs, revenue, LTV, and ROAS in a unified analytics dashboard. You can analyze cohorts, track performance over time, and make data-driven optimization decisions—all without manually reconciling data from different sources.
 
 :::tip
 Tracking links can also include custom parameters, allowing your app to handle [deferred deep links](ua-deferred-data.md) and react to campaign data when processing the install event.

versioned_docs/version-3.0/ads-manager.md

@@ -8,7 +8,7 @@ import ZoomImage from '@site/src/components/ZoomImage';
 import CustomDocCardList from '@site/src/components/CustomDocCardList';
 
 :::important
-Before you start using the Ads Manager, ensure you have completed the steps from [this guide](ads-manager.md).
+Before you start using the Ads Manager, ensure you have completed the steps from [this guide](adapty-ads-manager-get-started.md).
 :::
 
 Apple Ads Manager lets you do three important things in one place:

versioned_docs/version-3.0/android-present-paywall-builder-paywalls-in-observer-mode.md

@@ -137,12 +137,12 @@ The `onPurchaseInitiated` event will inform you that the user has initiated a pu
 
    Remember to invoke the following callbacks to notify AdaptyUI about the purchase or restore process. This is necessary for proper paywall behavior, such as showing the loader:
 
-   | Callback           | Description                                                                       |
-   | :----------------- | :-------------------------------------------------------------------------------- |
-   | onStartPurchase()  | The callback should be invoked to notify AdaptyUI that the purchase is started.   |
-   | onFinishPurchase() | The callback should be invoked to notify AdaptyUI that the purchase is finished.  |
-   | onStartRestore()   | The callback should be invoked to notify AdaptyUI that the restore is started.    |
-   | onFinishRestore()  | The callback should be invoked to notify AdaptyUI that the restore is finished.   |
+   | Callback           | Description                                                                            |
+   | :----------------- |:---------------------------------------------------------------------------------------|
+   | onStartPurchase()  | The callback should be invoked to notify AdaptyUI that the purchase is started.        |
+   | onFinishPurchase() | The callback should be invoked to notify AdaptyUI that the purchase is finished.       |
+   | onStartRestore()   | Optional. The callback can be invoked to notify AdaptyUI that the restore is started.  |
+   | onFinishRestore()  | Optional. The callback can be invoked to notify AdaptyUI that the restore is finished. |
 
 2. In order to display the visual paywall on the device screen, you must first configure it.
 

versioned_docs/version-3.0/android-web-paywall.md

@@ -33,7 +33,6 @@ Adapty.openWebPaywall(
         // the web paywall was opened successfully
     } else {
         // handle the error
-        val adaptyError = error
     }
 }
 ```

versioned_docs/version-3.0/apple-search-ads.md

@@ -1,16 +1,23 @@
 ---
-title: "Apple Search Ads (ASA)"
-description: "Integrate Apple Search Ads with Adapty to optimize subscription conversions."
-metadataTitle: "Apple Search Ads Integration | Adapty Docs"
-keywords: ['apple ads', 'asa', 'apple search ads']
+title: "Apple Ads"
+description: "Integrate Apple Ads with Adapty to optimize subscription conversions."
+metadataTitle: "Apple Ads Integration | Adapty Docs"
+keywords: ['apple ads', 'asa', 'Apple Ads']
 ---
 
 import Zoom from 'react-medium-image-zoom';
 import 'react-medium-image-zoom/dist/styles.css';
 
-Adapty can help you get attribution data from Apple Search Ads and analyze your metrics with campaign and keyword segmentation. Adapty collects the attribution data for Apple Search Ads automatically through its SDK and AdServices Framework.
+:::important
+The Apple Ads integration in **App settings** is used only for basic analytics and for SplitMetrics Acquire and Asapty integrations.
 
-Once you've set up the Apple Search Ads integration, Adapty will start receiving attribution data from Apple Search Ads. You can easily access and view this data on the profiles page.
+[Apple Ads Manager](adapty-ads-manager.md) uses a separate connection. Connect your Apple Ads account in the [Apple Ads Manager settings](adapty-ads-manager-get-started.md).
+:::
+
+
+Adapty can help you get attribution data from Apple Ads and analyze your metrics with campaign and keyword segmentation. Adapty collects the attribution data for Apple Ads automatically through its SDK and AdServices Framework.
+
+Once you've set up the Apple Ads integration, Adapty will start receiving attribution data from Apple Ads. You can easily access and view this data on the profiles page.
 
 
 <Zoom>
@@ -32,15 +39,15 @@ There are two ways to get attribution: with the old iAd framework and the modern
 
 ## AdServices framework
 
-Apple Search Ads via [AdServices](https://developer.apple.com/documentation/ad_services) does require some configuration in Adapty Dashboard, and you will also need to enable it on the app side. To set up Apple Search Ads using the AdServices framework through Adapty, follow these steps:
+Apple Ads via [AdServices](https://developer.apple.com/documentation/ad_services) does require some configuration in Adapty Dashboard, and you will also need to enable it on the app side. To set up Apple Ads using the AdServices framework through Adapty, follow these steps:
 
 ### Step 1: Configure Info.plist
 
 Add `AdaptyAppleSearchAdsAttributionCollectionEnabled` to the app’s `Info.plist` file and set it to `YES` (boolean value).
 
 ### Step 2: Obtain Public Key
 
-In the Adapty Dashboard, navigate to [Settings -> Apple Search Ads.](https://app.adapty.io/settings/apple-search-ads)  
+In the Adapty Dashboard, navigate to [Settings -> Apple Ads.](https://app.adapty.io/settings/apple-search-ads)  
 Locate the pre-generated public key (Adapty provides a key pair for you) and copy it.
 
 <Zoom>
@@ -55,12 +62,12 @@ Locate the pre-generated public key (Adapty provides a key pair for you) and cop
 </Zoom>
 
 :::note
-If you're using an alternative service or your own solution for Apple Search Ads attribution, you can upload your own private key.
+If you're using an alternative service or your own solution for Apple Ads attribution, you can upload your own private key.
 :::
 
-### Step 3: Configure User Management on Apple Search Ads
+### Step 3: Configure User Management on Apple Ads
 
-In your [Apple Search Ads account](https://searchads.apple.com/) go to Settings > User Management page. In order for Adapty to fetch attribution data you need to invite another Apple ID account and grant it API Account Manager access.
+In your [Apple Ads account](https://searchads.apple.com/) go to **Settings > User Management** page. In order for Adapty to fetch attribution data you need to invite another Apple ID account and grant it API Account Manager access. You can use any account you have access to or create a new one just for this purpose. The important thing is that you must be able to log into Apple Ads using this Apple ID.
 
 <Zoom>
   <img src={require('./img/ec183b2-kdjsfldsfjkdsfdfd.webp').default}
@@ -75,11 +82,11 @@ In your [Apple Search Ads account](https://searchads.apple.com/) go to Settings
 
 ### Step 4: Generate API Credentials
 
-As a next step, log in to the newly added account in Apple Search Ads. Navigate to Settings -> API in the Apple Search Ads interface. Paste the previously copied public key into the designated field. Generate new API credentials.
+As a next step, log in to the newly added account in Apple Ads. Navigate to Settings -> API in the Apple Ads interface. Paste the previously copied public key into the designated field. Generate new API credentials.
 
-### Step 5: Configure Adapty with Apple Search Ads Credentials
+### Step 5: Configure Adapty with Apple Ads Credentials
 
-Copy the Client ID, Team ID, and Key ID fields from the Apple Search Ads settings. In the Adapty Dashboard, paste these credentials into the corresponding fields.
+Copy the Client ID, Team ID, and Key ID fields from the Apple Ads settings. In the Adapty Dashboard, paste these credentials into the corresponding fields.
 
 <Zoom>
   <img src={require('./img/7356113-CleanShot_2023-08-21_at_15.08.512x.webp').default}
@@ -97,7 +104,7 @@ Copy the Client ID, Team ID, and Key ID fields from the Apple Search Ads setting
 :::note
 Optional
 
-These steps are not required for Apple Search Ads attribution, only for working with other services like Asapty or your own solution.
+These steps are not required for Apple Ads attribution, only for working with other services like Asapty or your own solution.
 :::
 
 You can use your own public-private key pair if you are using other services or own solution for ASA attribution.
@@ -110,7 +117,7 @@ Generate private key in Terminal
 openssl ecparam -genkey -name prime256v1 -noout -out private-key.pem
 ```
 
-Upload it in Adapty Settings -> Apple Search Ads (Upload private key button)
+Upload it in Adapty Settings -> Apple Ads (Upload private key button)
 
 ### Step 2
 
@@ -120,15 +127,15 @@ Generate public key in Terminal
 openssl ec -in private-key.pem -pubout -out public-key.pem
 ```
 
-You can use this public key in your Apple Search Ads settings of account with API Account Manager role. So you can use generated Client ID, Team ID, and Key ID values for Adapty and other services.
+You can use this public key in your Apple Ads settings of account with API Account Manager role. So you can use generated Client ID, Team ID, and Key ID values for Adapty and other services.
 
-## Disabling Apple Search Ads attribution
+## Disabling Apple Ads attribution
 
 Adapty can use attribution data in analytics from only one source at a time. If multiple attribution sources are enabled, the system will decide which attribution to use for each device based on the source that provides more fields. 
 
-For iOS devices, this means non-organic Apple Search Ads attribution will always take priority if it's enabled. 
+For iOS devices, this means non-organic Apple Ads attribution will always take priority if it's enabled. 
 
-You can disable Apple Search Ads attribution receiving by toggling off the **Receive Apple Search Ads attribution in Adapty** in the [**App Settings** -> **Apple Search Ads** tab](https://app.adapty.io/settings/apple-search-ads).
+You can disable Apple Ads attribution receiving by toggling off the **Receive Apple Ads attribution in Adapty** in the [**App Settings** -> **Apple Ads** tab](https://app.adapty.io/settings/apple-search-ads).
 
 <Zoom>
   <img src={require('./img/asa-disable.webp').default}

versioned_docs/version-3.0/flutter-identifying-users.md

@@ -68,4 +68,63 @@ try {
 }
 ```
 
-You can then login the user using `.identify()` method.
+You can then login the user using `.identify()` method.
+
+## Assign `appAccountToken` (iOS)
+
+[`appAccountToken`](https://developer.apple.com/documentation/storekit/product/purchaseoption/appaccounttoken(_:)) is a **UUID** that lets you link App Store transactions to your internal user identity.  
+StoreKit associates this token with every transaction, so your backend can match App Store data to your users.
+
+Use a stable UUID generated per user and reuse it for the same account across devices.
+This ensures that purchases and App Store notifications stay correctly linked.
+
+You can set the token in two ways – during the SDK activation or when identifying the user.
+
+:::important
+You must always pass `appAccountToken` together with `customerUserId`.
+If you pass only the token, it will not be included in the transaction.
+:::
+
+```dart showLineNumbers
+// During configuration:
+try {
+   await Adapty().activate(
+       configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
+         ..withCustomerUserId(YOUR_CUSTOMER_USER_ID, iosAppAccountToken: "YOUR_APP_ACCOUNT_TOKEN")
+   );
+} catch (e) {
+   // handle the error
+}
+// Or when identifying users
+try {
+    await Adapty().identify(customerUserId, iosAppAccountToken: "YOUR_APP_ACCOUNT_TOKEN");
+} on AdaptyError catch (adaptyError) {
+    // handle the error
+} catch (e) {
+}
+```
+
+### Set obfuscated account IDs (Android)
+
+Google Play requires obfuscated account IDs for certain use cases to enhance user privacy and security. These IDs help Google Play identify purchases while keeping user information anonymous, which is particularly important for fraud prevention and analytics.
+
+You may need to set these IDs if your app handles sensitive user data or if you're required to comply with specific privacy regulations. The obfuscated IDs allow Google Play to track purchases without exposing actual user identifiers.
+
+```dart showLineNumbers
+// During configuration:
+try {
+   await Adapty().activate(
+       configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
+         ..withCustomerUserId(YOUR_CUSTOMER_USER_ID, androidObfuscatedAccountId: "OBFUSCATED_ACCOUNT_ID")
+   );
+} catch (e) {
+   // handle the error
+}
+// Or when identifying users
+try {
+    await Adapty().identify(customerUserId, androidObfuscatedAccountId: "OBFUSCATED_ACCOUNT_ID");
+} on AdaptyError catch (adaptyError) {
+    // handle the error
+} catch (e) {
+}
+```

versioned_docs/version-3.0/flutter-making-purchases.md

@@ -33,8 +33,6 @@ Make sure you've [done the initial configuration](quickstart) without skipping a
 In paywalls built with [Paywall Builder](adapty-paywall-builder) purchases are processed automatically with no additional code. If that's your case — you can skip this step.
 :::
 
-This snippet is valid for v.2.0 or later.
-
 ```dart showLineNumbers
 try {
   final purchaseResult = await Adapty().makePurchase(product: product);
@@ -133,4 +131,15 @@ Based on our observations, the Offer Code Redemption sheet in some apps may not
 
 In order to do this, you need to open the url of the following format:
 `https://apps.apple.com/redeem?ctx=offercodes&id={apple_app_id}&code={code}`
-:::
+:::
+
+### Manage prepaid plans (Android)
+
+If your app users can purchase [prepaid plans](https://developer.android.com/google/play/billing/subscriptions#prepaid-plans) (e.g., buy a non-renewable subscription for several months), you can enable [pending transactions](https://developer.android.com/google/play/billing/subscriptions#pending) for prepaid plans.
+
+```dart showLineNumbers title="main.dart"
+await Adapty().activate(
+  configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY')
+    ..withGoogleEnablePendingPrepaidPlans(true),
+);
+```