Use a Superwall’s delegate to extend our SDK’s functionality across several surface areas by assigning to the delegate property:

Some common use cases for using the Superwall delegate include:

Below are some commonly used implementations when using the delegate.

Superwall Events

Most of what occurs in Superwall can be viewed using the delegate method to respond to events:

class SWDelegate: SuperwallDelegate {
    func handleSuperwallEvent(withInfo eventInfo: SuperwallEventInfo) {
        switch eventInfo.event {
        case .transactionComplete(let transaction, let product, let paywallInfo):
            print("Converted from paywall originalTransactionIdentifier: \(transaction?.originalTransactionIdentifier ?? "")")
            print("Converted from paywall storeTransactionId: \(transaction?.storeTransactionId ?? "")")
            print("Converted from paywall productIdentifier: \(product.productIdentifier)")
            print("Converted from paywall paywallInfo: \(paywallInfo.identifier)")
        case .transactionRestore(let restoreType, let paywallInfo):
            print("transactionRestore restoreType \(restoreType)")
        case let .customPlacement(name, params, paywallInfo):
            // Forward Mixpanel/Ampltiude/etc
            print("\(name) - \(params) - \(paywallInfo)")
        default:
            // And several more events to use...
            print("Default event: \(eventInfo.event.description)")
        }
    }
}

Paywall Custom Actions

Using the custom tap action, you can respond to any arbitrary event from a paywall:

class SWDelegate: SuperwallDelegate {
    func handleCustomPaywallAction(withName name: String) {
        if name == "showHelpCenter" {
            DispatchQueue.main.asyncAfter(deadline: .now() + 0.33) {
                self.showHelpCenter.toggle()
            }
        }
    }
}

Subscription status changes

You can be informed of subscription status changes using the delegate. If you need to set or handle the status on your own, use a purchase controller — this function is only for informational, tracking or similar purposes:

class SWDelegate: SuperwallDelegate {
    func subscriptionStatusDidChange(to newValue: SubscriptionStatus) {
        // Log or handle subscription change in your Ui
    }
}

Paywall events

The delegate also has callbacks for several paywall events, such dismissing, presenting, and more. Here’s an example:

class SWDelegate: SuperwallDelegate {
    func didPresentPaywall(withInfo paywallInfo: PaywallInfo) {
        // paywallInfo will contain all of the presented paywall's info
    }
}