Skip to content

6.3.0

Latest

Choose a tag to compare

@EPIKorial EPIKorial released this 19 Nov 17:01

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, .expired or .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_purchasedSubscription is 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.experimentAssigned and PLYEvent.experimentExposed, with the properties experimentId and experimentVariantId.
  • New built-in attributes: ply_experiments and ply_holdout.
  • An arm with no screen returns to the app. display() on such a presentation no longer fails: no screen is shown, and onDismissed is called once with an empty outcome. You can recognise this case with presentation.type == .deactivated.
  • presentation.exposed() records the exposure when your app fetches such a presentation and does not call display(). 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 calls onCloseRequested and your app removes the view. onDismissed follows the actual removal. Removing a view twice must be safe. If your app does not set onCloseRequested, onDismissed is 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 switch over PLYEvent or PLYEventProperty with no default must handle the new experiment cases.
  • A type of your app that conforms to PLYPresentation must add exposed(). Apps normally read presentations from the SDK and are not concerned.

Behaviour changes

  • Consent, same rules as Android. Revoking analytics also revokes identifiedAnalytics. .allNonEssentials also revokes identifiedAnalytics and supportInvestigation. The ids of your third-party integrations (Adjust, AppsFlyer, Firebase…) are cleared only when you revoke thirdPartyIntegrations. Before, every call to revokeDataProcessingConsent cleared 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() and restore() before start() 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