Repository navigation
Purchasely iOS SDK 6.3.0
6.3.0 adds a subscription status delegate and experiments in campaigns, and fixes a crash on iPad rotation. Most integrations build without code changes. Read Changes that can need code if your app embeds an inline paywall, has a Swift switch over PLYEvent, or has its own type that conforms to PLYPresentation.
Highlights
🔔 Know when the user's subscription status changes
A new delegate tells your app whether the user has an active subscription, and why it changed:
final class SubscriptionObserver: NSObject, PLYUserSubscriptionStatusDelegate {
func userSubscriptionStatusUpdated(_ status: PLYUserSubscriptionStatus) {
// status.isActive, status.reason, status.subscription
}
}
Purchasely.addUserSubscriptionStatusDelegate(observer)- You get the status at start, when a delegate is added, and when the user logs in or out.
- You get the reason of each change:
.purchased,.restored,.expiredor.webRedeemed. - It works in Observer mode too, including for web checkout and web-to-app redemptions.
- Remove a delegate with
Purchasely.removeUserSubscriptionStatusDelegate(_:). Notification.Name.ply_purchasedSubscriptionis deprecated. It is still posted in 6.3.0.
The new purchasely://ply/restore deeplink starts a restore.
🧪 Experiments in campaigns
Campaigns can now run experiments, including an arm that shows no screen and a holdout group.
- New events:
PLYEvent.experimentAssignedandPLYEvent.experimentExposed, with the propertiesexperimentIdandexperimentVariantId. - New built-in attributes:
ply_experimentsandply_holdout. - An arm with no screen returns to the app.
display()on such a presentation no longer fails: no screen is shown, andonDismissedis called once with an empty outcome. You can recognise this case withpresentation.type == .deactivated. presentation.exposed()records the exposure when your app fetches such a presentation and does not calldisplay(). Call it where the user would have seen the screen.
🔐 New consent purpose: supportInvestigation
PLYDataProcessingPurpose.supportInvestigation lets you record that the user objects to user-level support investigations. It is part of .allNonEssentials.
🔠 Font scaling can be turned off per screen
A screen can now opt out of Dynamic Type scaling from the Console.
Changes that can need code
- Inline paywalls: remove the paywall in
onCloseRequested. When an inline paywall asks to close, the SDK callsonCloseRequestedand your app removes the view.onDismissedfollows the actual removal. Removing a view twice must be safe. If your app does not setonCloseRequested,onDismissedis called at once as in 6.2, but the SDK no longer navigates your screen. The React Native and Flutter SDKs need their matching release. - A Swift
switchoverPLYEventorPLYEventPropertywith nodefaultmust handle the new experiment cases. - A type of your app that conforms to
PLYPresentationmust addexposed(). Apps normally read presentations from the SDK and are not concerned.
Behaviour changes
- Consent, same rules as Android. Revoking
analyticsalso revokesidentifiedAnalytics..allNonEssentialsalso revokesidentifiedAnalyticsandsupportInvestigation. The ids of your third-party integrations (Adjust, AppsFlyer, Firebase…) are cleared only when you revokethirdPartyIntegrations. Before, every call torevokeDataProcessingConsentcleared them. - Screens opened from a screen appear when they are ready. A button that opens another placement or screen shows it once it is loaded, with no loading screen in between.
- Intro offers on monthly-billed annual commitments. A 12-month commitment billed monthly, with an intro offer on the monthly term, is now eligible (iOS 26.4 and later).
- Purchases in a flow are attributed to the step that converted. Before, they were attributed to the previous step.
- Events carry the user attributes of the moment they happened, not of the moment they were sent.
- Screen display timings are more accurate. Scrolling in your app is no longer counted as rendering time, so latency dashboards can show a drop.
- Close and back buttons stay inside the safe area on every edge.
Fixes
- No more crash after iPad rotations. A displayed paywall could crash the app after a few rotations or window resizes (seen on 6.1.1 and 6.1.2).
- Labels no longer disappear after a rotation. In a centred row of short labels, such as a struck price, a price and a period, one label could vanish.
- A screen opened while another one closes stays on screen. Before, it could appear and then fade out.
- Events keep the campaign and placement of their own screen. Before, they could carry those of another screen shown in the same session.
synchronize()andrestore()beforestart()return an error instead of crashing.- A fullscreen display that iOS would reject is skipped and logged, instead of crashing.
- A web-to-app redemption is no longer reported as expired a second after it succeeds.
- Product getters return complete results, and subscriptions are returned even when the App Store products cannot be loaded.
Internal improvements (no code changes required)
- Large requests to Purchasely are compressed.
- Paywall rendering does less work for labels that show no user data.
- The SDK compiles in apps built with Xcode 27.
- Crash and hang diagnostics available to Purchasely are more precise.
Full list of the changes: docs.purchasely.com/changelog