Unity SDK 4.1

[eandreeva-twr]

Documents the Unity SDK 4.1 release — the first stable release of the 4.x line (4.0 shipped as beta only, so 3.x users migrate straight to 4.1).

Migration guide

migration-to-unity-sdk-v4.mdx is repurposed to cover the whole 3.x → 4.1 migration in one guide (filename and URL unchanged for SEO; title, hub label, and sidebar label now say v4.1). New on top of the existing flows content:

• 4.1 rows in the quick-reference table
• Installation via the #4.1.0 tag / adapty-unity-plugin-4.1.0.unitypackage, with a pointer for 4.0-beta users to move off the pinned beta tag
• Renamed external attribution APIs: UpdateAttribution → UpdateExternalAttribution (source → provider), AppliedAttributionSources → AppliedExternalAttributionProviders; no deprecated aliases. The provider stays a plain string in C# and both the dictionary and JSON-string overloads remain — deliberately different from the iOS guide.
• Adapty Attribution is disabled by default — opt-in via SetAdaptyAttributionEnabled(true), with the silent-break warning
• New required listener method OnReceivePromotedPurchase (plain-interface convention: compile break)
• Fallback files: re-download both the iOS and Android files and replace them in Assets/StreamingAssets; skipping surfaces as DecodingFailed (2006) at runtime

Other articles

• sdk-installation-unity: the "SDK 4.0 (beta)" install section becomes "SDK 4.1" (stable), and optional setup gains an "Enable Adapty Attribution" section
• unity-making-purchases: new "In-app purchases from the App Store" section — promoted purchases complete automatically; the required listener method and MakePromotedPurchase are documented with a note that the SDK doesn't deliver promoted purchases to the C# callback yet (drop the note when the native pin moves past 4.1.0)
• IAdaptyEventListener notes updated in unity-check-subscription-status, unity-listen-subscription-changes, implement-observer-mode-unity, and the installation article
• Unity C# tabs renamed to UpdateExternalAttribution in the Adjust, AppsFlyer, Branch, and Tenjin integration articles
• unity-sdk-call-order row 5, and remaining "4.0 (beta)" phrasings swept to 4.1

Deliberately not rolled out from iOS 4.1

Verified against the Unity 4.1 public API surface: no preloadFlows/preloadOnboardings, no customLayoutId parameter, no AdaptySubscriptionOfferType enum→struct change, and the JSON-string attribution overload stays public — none of the corresponding iOS doc changes apply to Unity.

Notes for review

• ⚠️ Merge at release: the install links target the 4.1.0 GitHub release, which 404s until the release is cut.
• whats-new is left for the release-day update.
• MDX parse, lint, and the link checker pass; the only new external 404 is the not-yet-existing 4.1.0 release URL.