Updates for SDK

Author: eandreeva-twr

src/content/docs/ios/ios-sdk-call-order.mdx

@@ -25,7 +25,7 @@ If you have the customer user ID at app launch, pass it into `activate()` direct
 | 1    | Initialize your MMP or analytics SDK (AppsFlyer, Adjust, PostHog, Branch)                                     | App launch, first                                                                      | Wait for the MMP's UID callback, for example `getAppsFlyerUID`.                                |
 | 2a   | `Adapty.activate(with: config)` with `customerUserId` set on the config                                       | App launch, after step 1, if you have the customer user ID                             | Recommended. No anonymous profile is ever created.                                             |
 | 2b   | `Adapty.activate(with: config)` without `customerUserId`                                                      | App launch, after step 1, if you don't have the customer user ID (or never collect one) | Adapty creates an anonymous profile.                                                           |
-| 3    | `Adapty.setIntegrationIdentifier(key:value:)` for each MMP                                                    | After step 2, before any user-action call                                              | Required so MMP IDs land on the correct profile.                                               |
+| 3    | `Adapty.setIntegrationIdentifier(...)` for each MMP                                                           | After step 2, before any user-action call                                              | Required so MMP IDs land on the correct profile.                                               |
 | 4    | `try await Adapty.identify("YOUR_USER_ID")`                                                                   | After step 3 (or step 2 if no MMP), before step 5 — only on path 2b with authentication | Always `await`. Concurrent calls during `identify` produce `#3006 profileWasChanged`.          |
 | 5    | `getPaywall`, `getPaywallProducts`, `restorePurchases`, `makePurchase`, `updateAttribution`, `updateProfile`  | After step 4 if you call `identify`; otherwise after step 3 (or step 2 if no MMP)      | These calls need a stable profile.                                                             |
 

src/content/docs/ios/migration-to-ios-sdk-v4.mdx

@@ -20,6 +20,14 @@ Adapty iOS SDK 4.0 (beta) introduces flows and renames the paywall APIs accordin
 | `.paywall()` (SwiftUI modifier) | `.flow()` |
 | `AdaptyPaywallView` | `AdaptyFlowView` |
 | `didFailRenderingWith:` / `didFailRendering:` | `didReceiveError:` |
+| `Adapty.updateAttribution(_:source:)` (`source: String`) | `Adapty.updateAttribution(_:source:)` (`source: AdaptyAttributionSource`) |
+| `Adapty.setIntegrationIdentifier(key:value:)` | `Adapty.setIntegrationIdentifier(_:)` (`AdaptyIntegrationIdentifier`) |
+
+## Installation: CocoaPods no longer supported
+
+Adapty iOS SDK 4.0 drops CocoaPods support. Install the SDK with [Swift Package Manager](sdk-installation-ios#install-adapty-sdk).
+
+If your project still uses CocoaPods, remove the `Adapty` and `AdaptyUI` pods from your `Podfile`, run `pod install` to clean them up, then add the package in Xcode via **File → Add Package Dependency** using `https://github.com/adaptyteam/AdaptySDK-iOS.git`.
 
 ## Removed APIs
 
@@ -221,3 +229,55 @@ Two changes affect every existing call site:
 + case remote(url: URL, preview: AdaptyUICustomImageAsset?, resolution: CGSize?)
 + case player(item: AVPlayerItem, player: AVPlayer, preview: AdaptyUICustomImageAsset?, resolution: CGSize?)
 ```
+
+## Attribution and integration identifiers
+
+### updateAttribution(_:source:)
+
+The `source` parameter changes from `String` to the new `AdaptyAttributionSource` type, and the previously nested `AdaptyProfile.AttributionSource` is renamed to the top-level `AdaptyAttributionSource`. Use one of the predefined sources, or pass a string literal for any other source — `AdaptyAttributionSource` conforms to `ExpressibleByStringLiteral`, so existing string-literal calls keep compiling.
+
+```diff showLineNumbers
+- try await Adapty.updateAttribution(attribution, source: "adjust")
++ try await Adapty.updateAttribution(attribution, source: .adjust)
+```
+
+Predefined sources: `.appleAds`, `.adjust`, `.appsflyer`, `.branch`, `.tenjin`. If you keep the source in a `String` variable, wrap it: `AdaptyAttributionSource(rawValue: yourSource)`.
+
+### setIntegrationIdentifier(_:)
+
+`setIntegrationIdentifier(key:value:)` is replaced by a variadic method that takes one or more `AdaptyIntegrationIdentifier` values. Use the predefined factory methods instead of raw string keys:
+
+```diff showLineNumbers
+- try await Adapty.setIntegrationIdentifier(key: "appsflyer_id", value: uid)
++ try await Adapty.setIntegrationIdentifier(.appsflyerId(uid))
+```
+
+You can set several identifiers in a single call:
+
+```swift showLineNumbers
+try await Adapty.setIntegrationIdentifier(
+    .appsflyerId(uid),
+    .adjustDeviceId(adid)
+)
+```
+
+Replace each old key string with its factory method:
+
+| v3 key | v4 factory |
+|---|---|
+| `"adjust_device_id"` | `.adjustDeviceId(_:)` |
+| `"airbridge_device_id"` | `.airbridgeDeviceId(_:)` |
+| `"amplitude_user_id"` | `.amplitudeUserId(_:)` |
+| `"amplitude_device_id"` | `.amplitudeDeviceId(_:)` |
+| `"appmetrica_device_id"` | `.appmetricaDeviceId(_:)` |
+| `"appmetrica_profile_id"` | `.appmetricaProfileId(_:)` |
+| `"appsflyer_id"` | `.appsflyerId(_:)` |
+| `"branch_id"` | `.branchId(_:)` |
+| `"facebook_anonymous_id"` | `.facebookAnonymousId(_:)` |
+| `"firebase_app_instance_id"` | `.firebaseAppInstanceId(_:)` |
+| `"mixpanel_user_id"` | `.mixpanelUserId(_:)` |
+| `"one_signal_subscription_id"` | `.oneSignalSubscriptionId(_:)` |
+| `"one_signal_player_id"` | `.oneSignalPlayerId(_:)` |
+| `"posthog_distinct_user_id"` | `.posthogDistinctUserId(_:)` |
+| `"pushwoosh_hwid"` | `.pushwooshHWID(_:)` |
+| `"tenjin_analytics_installation_id"` | `.tenjinAnalyticsInstallationId(_:)` |

src/content/docs/version-3.0/adjust.mdx

@@ -141,20 +141,24 @@ For Adjust version 5.0 or later, use the following example:
 
 ```swift showLineNumbers
 class AdjustModuleImplementation {
-
-func updateAdjustAdid() {
-    Adjust.adid { adid in
-        guard let adid else { return }
-        Adapty.setIntegrationIdentifier(key: "adjust_device_id", value: adid)
+    func updateAdjustAdid() {
+        Adjust.adid { adid in
+            guard let adid else { return }
+            // Adapty SDK 4.x
+            Adapty.setIntegrationIdentifier(.adjustDeviceId(adid))
+            // Adapty SDK 3.x
+            Adapty.setIntegrationIdentifier(key: "adjust_device_id", value: adid)
+        }
     }
-}
-func updateAdjustAttribution() {
-    Adjust.attribution { attribution in
-        guard let attribution = attribution?.dictionary() else { 
-            return
+
+    func updateAdjustAttribution() {
+        Adjust.attribution { attribution in
+            guard let attribution = attribution?.dictionary() else { return }
+            // Adapty SDK 4.x
+            Adapty.updateAttribution(attribution, source: .adjust)
+            // Adapty SDK 3.x
+            Adapty.updateAttribution(attribution, source: "adjust")
         }
-        
-        Adapty.updateAttribution(attribution, source: "adjust")
     }
 }
 ```

src/content/docs/version-3.0/appsflyer.mdx

@@ -181,6 +181,10 @@ class YourAppsFlyerLibDelegateImplementation {
     // and update onConversionDataSuccess method:
     func onConversionDataSuccess(_ conversionInfo: [AnyHashable : Any]) {
         let uid = AppsFlyerLib.shared().getAppsFlyerUID()
+        // Adapty SDK 4.x
+        Adapty.setIntegrationIdentifier(.appsflyerId(uid))
+        Adapty.updateAttribution(conversionInfo, source: .appsflyer)
+        // Adapty SDK 3.x
         Adapty.setIntegrationIdentifier(key: "appsflyer_id", value: uid)
         Adapty.updateAttribution(conversionInfo, source: "appsflyer")
     }

src/content/docs/version-3.0/branch.mdx

@@ -94,6 +94,9 @@ Adapty will send subscription events to Branch using a server-to-server integrat
 
   ```swift showLineNumbers
   do {
+      // Adapty SDK 4.x
+      try await Adapty.setIntegrationIdentifier(.branchId(<BRANCH_IDENTITY_ID>))
+      // Adapty SDK 3.x
       try await Adapty.setIntegrationIdentifier(
           key: "branch_id", 
           value: <BRANCH_IDENTITY_ID>
@@ -156,12 +159,14 @@ Adapty will send subscription events to Branch using a server-to-server integrat
           // Pass the attribution you receive from the initializing method of Branch iOS SDK to Adapty.
           Branch.getInstance().initSession(launchOptions: launchOptions) { (data, error) in
               if let data {
+                  // Adapty SDK 4.x
                   Adapty.updateAttribution(data, source: .branch)
+                  // Adapty SDK 3.x
+                  Adapty.updateAttribution(data, source: "branch")
               }
           }
       }
   }
-
   ```
   </TabItem>
   <TabItem value="kotlin" label="Android (Kotlin)" default>

src/content/docs/version-3.0/onesignal.mdx

@@ -147,6 +147,9 @@ Make sure to send `playerId` (for OneSignal SDK pre-v5) or `subscriptionId` (for
 // SubscriptionID
 OneSignal.Notifications.requestPermission({ accepted in
     Task {
+        // Adapty SDK 4.x
+        try await Adapty.setIntegrationIdentifier(.oneSignalSubscriptionId(OneSignal.User.pushSubscription.id))
+        // Adapty SDK 3.x
         try await Adapty.setIntegrationIdentifier(
             key: "one_signal_subscription_id", 
             value: OneSignal.User.pushSubscription.id
@@ -255,6 +258,9 @@ OneSignal.User.pushSubscription.addEventListener('change', (subscription) => {
 func onOSSubscriptionChanged(_ stateChanges: OSSubscriptionStateChanges) {
     if let playerId = stateChanges.to.userId {
         Task {
+            // Adapty SDK 4.x
+            try await Adapty.setIntegrationIdentifier(.oneSignalPlayerId(playerId))
+            // Adapty SDK 3.x
             try await Adapty.setIntegrationIdentifier(
                 key: "one_signal_player_id", 
                 value: playerId

src/content/docs/version-3.0/sdk-installation-ios.mdx

@@ -56,9 +56,7 @@ Adapty SDK 3.15.7+ is required when building with Xcode 26.4 or later.
 
 [![Release](https://img.shields.io/github/v/release/adaptyteam/AdaptySDK-iOS.svg?style=flat&logo=apple)](https://github.com/adaptyteam/AdaptySDK-iOS/releases)
 
-<Tabs>
-<TabItem value="spm" label="Swift Package Manager (recommended)" default>
-In Xcode, go to **File** -> **Add Package Dependency...**. Note that the steps to add package dependencies may vary between Xcode versions, so refer to Xcode documentation if needed.
+Adapty SDK is installed via Swift Package Manager. In Xcode, go to **File** -> **Add Package Dependency...**. Note that the steps to add package dependencies may vary between Xcode versions, so refer to Xcode documentation if needed.
 
 1. Enter the repository URL:
    ```
@@ -76,36 +74,10 @@ In Xcode, go to **File** -> **Add Package Dependency...**. Note that the steps t
 4. Click **Add Package** to complete the installation.
 5. **Verify installation:** In your project navigator, you should see "Adapty" (and "AdaptyUI" if selected) under **Package Dependencies**.
 
-</TabItem>
-
-<TabItem value="cocoapods" label="CocoaPods (legacy)" default>
-
-:::info
-
-CocoaPods is now in maintenance mode, with development officially stopped. We recommend switching to [Swift Package Manager](sdk-installation-ios#install-adapty-sdk).
-
+:::important
+Adapty iOS SDK 4.0 is a pre-release. Swift Package Manager does not resolve beta versions through the **Up to Next Major Version** (`from:`) rule, so you must pin the exact version. In Xcode, set the **Dependency Rule** to **Exact Version** and enter `4.0.0-beta.1`. In `Package.swift`, use `.exact("4.0.0-beta.1")`. See [Migrate Adapty iOS SDK to v4](migration-to-ios-sdk-v4).
 :::
 
-1. Add Adapty to your `Podfile`. Choose the modules you need:
-
-    1. **Adapty** is the mandatory module.
-    2. **AdaptyUI** is an optional module you need if you plan to use the [Adapty Paywall Builder](adapty-paywall-builder).
-
-   ```shell showLineNumbers title="Podfile"
-   pod 'Adapty'
-   pod 'AdaptyUI'  # optional module needed only for Paywall Builder
-   ```
-
-2. Run:
-
-   ```sh showLineNumbers title="Shell"
-   pod install
-   ```
-
-This will create a `.xcworkspace` file for your app. Use this file for all future development.
-</TabItem>
-</Tabs>
-
 ## Activate Adapty module of Adapty SDK
 
 Activate the Adapty SDK in your app code.
@@ -401,38 +373,3 @@ targetSettings: [
   "AdaptyUIBuilder": .init().swiftVersion("6"),
 ]
 ```
-
-#### Swift 6 build errors caused by Podfile SWIFT_VERSION override
-
-When building for iOS with [CocoaPods](sdk-installation-ios#install-adapty-sdk), you may see Swift 6 compilation errors on Adapty pod targets. Typical symptoms include `@Sendable` mismatches in `AdaptyUIBuilderLogic`, missing `Sendable` conformance on Adapty types, or actor isolation errors.
-
-The Adapty pods declare `s.swift_version = '6.0'` and require Swift 6 to build. Your own app code can stay on Swift 5 — only the Adapty pod targets (`Adapty`, `AdaptyUI`, `AdaptyUIBuilder`, `AdaptyLogger`) need to build with Swift 6.
-
-The most common cause is a `post_install` hook in your `Podfile` that rewrites `SWIFT_VERSION` for every pod target:
-
-```ruby showLineNumbers title="Podfile"
-post_install do |installer|
-  installer.pods_project.targets.each do |target|
-    target.build_configurations.each do |config|
-      config.build_settings['SWIFT_VERSION'] = '5.9'
-    end
-  end
-end
-```
-
-**Fix**: Exclude the Adapty pod targets from the override:
-
-```ruby showLineNumbers title="Podfile"
-post_install do |installer|
-  installer.pods_project.targets.each do |target|
-    next if %w[Adapty AdaptyUI AdaptyUIBuilder AdaptyLogger].include?(target.name)
-    target.build_configurations.each do |config|
-      config.build_settings['SWIFT_VERSION'] = '5.9'
-    end
-  end
-end
-```
-
-Then run `pod install` and rebuild.
-
-To verify, open `Pods.xcodeproj`, select the `Adapty` pod target → **Build Settings** → **Swift Language Version**. It should be **Swift 6**.

src/content/docs/version-3.0/tenjin.mdx

@@ -134,6 +134,9 @@ func updateTenjinId() {
     guard let tenjinId = TenjinSDK.getAnalyticsInstallationId() else { return }
 
     do {
+        // Adapty SDK 4.x
+        try await Adapty.setIntegrationIdentifier(.tenjinAnalyticsInstallationId(tenjinId))
+        // Adapty SDK 3.x
         try await Adapty.setIntegrationIdentifier(
             key: "tenjin_analytics_installation_id",
             value: tenjinId
@@ -151,6 +154,9 @@ func updateTenjinAttribution() {
 
         Task {
             do {
+                // Adapty SDK 4.x
+                try await Adapty.updateAttribution(info, source: .tenjin)
+                // Adapty SDK 3.x
                 try await Adapty.updateAttribution(info, source: "tenjin")
             } catch {
                 // handle the error