iOS Swift SDK

Use the Swift SDK to add PNLight to a native iOS app.

Requirements

iOS 13.0+
Swift 5.7+
Swift Package Manager

Install with Swift Package Manager

Package repository: pnlight-dev/sdk-swift.

Add it in Xcode:

Open package settings

In Xcode, click File and then Add Packages….

Enter the repository URL

Enter https://github.com/pnlight-dev/sdk-swift.git.

Add the package

Add the package to your app target.

Initialize the SDK

Initialize the SDK during app startup.

import PNLightSDK

await PNLightSDK.shared.initialize(apiKey: "pnlight_sdk_token")

If you use Remote Config, provide local defaults during initialization:

let config = PNLightConfig(remoteConfigDefaults: [
    "paywall_enabled": .boolean(false),
    "welcome_title": .string("Welcome"),
])

await PNLightSDK.shared.initialize(apiKey: "pnlight_sdk_token", config: config)

Common calls

let userId = PNLightSDK.shared.getUserId()

await PNLightSDK.shared.addAttribution(
    provider: .appsFlyer,
    data: ["af_status": "Non-organic"],
    identifier: "appsFlyerCustomerId"
)

await PNLightSDK.shared.logEvent("paywall_viewed", eventArgs: [
    "placement": "paywall"
])

logEvent sends optional in-app events to PNLight. You can review them in Analytics → App Events, on the Events page, and in customer timelines.

Remote Config

Fetch Remote Config after initialization. Read values with typed getters and fallbacks your app owns.

let result = await PNLightSDK.shared.fetchAndActivate()

let paywallEnabled = PNLightSDK.shared.remoteConfigBoolean(
    forKey: "paywall_enabled",
    fallback: false
)

By default, fetchAndActivate waits briefly for AppsFlyer attribution and uses a 15-minute minimum fetch interval. See Remote Config for fetch results, local defaults, and all supported value types.

IDFA after ATT

If PNLight initializes before the App Tracking Transparency prompt completes, call updateIdfa() after authorization so PNLight receives the granted IDFA.

import AppTrackingTransparency
import PNLightSDK

await ATTrackingManager.requestTrackingAuthorization()
await PNLightSDK.shared.updateIdfa()

Remote UI

Use RemoteUiView in SwiftUI when you want PNLight to render a placement you configured in the dashboard.

import PNLightSDK
import SwiftUI

struct PaywallScreen: View {
    var body: some View {
        RemoteUiView(
            placement: "paywall",
            cardId: "paywall_card",
            onPurchased: { productId in
                Task {
                    await refreshEntitlements()
                    unlockPurchasedContent(for: productId)
                }
            },
            onAction: { action in
                if action.logId == "close_button" {
                    closePaywall()
                }
            }
        )
        .frame(maxWidth: .infinity, maxHeight: .infinity)
    }
}

If you need to fetch the placement config yourself, use getUIConfig. On the first app launch, wait 4-5 seconds after AppsFlyer initialization when attribution is required. The SDK also waits for attribution internally when attributionRequired is true.

try? await Task.sleep(nanoseconds: 5_000_000_000)

let config = await PNLightSDK.shared.getUIConfig(placement: "paywall")

Use getUIConfigResult when your app needs to tell the difference between no UI for a placement and a loading error.

let result = await PNLightSDK.shared.getUIConfigResult(
    placement: "paywall",
    ignoreCache: true
)

Use onPurchased when a schema v3 or v4 Remote UI document starts a purchase with pnlight.purchase and the app needs to refresh entitlements after StoreKit verifies it. See Remote UI for placement and action guidance.

Start here

SDK integration

Dashboard

Troubleshooting

Changelog

Requirements

Install with Swift Package Manager

Initialize the SDK

Common calls

Remote Config

IDFA after ATT

Remote UI

​Requirements

​Install with Swift Package Manager

​Initialize the SDK

​Common calls

​Remote Config

​IDFA after ATT

​Remote UI

Requirements

Install with Swift Package Manager

Initialize the SDK

Common calls

Remote Config

IDFA after ATT

Remote UI