iOS Swift SDK

Use the Swift SDK for native iOS apps.

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

Call initialization during app startup.

import PNLightSDK

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

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.

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 configured placement.

import PNLightSDK
import SwiftUI

struct PaywallScreen: View {
    var body: some View {
        RemoteUiView(placement: "paywall", cardId: "paywall_card") { action in
            if action.logId == "purchase_button" {
                let productId = action.params["id"] ?? ""
                Task {
                    let success = await purchase(productId)
                    if success {
                        showMainScreen()
                    }
                }
            }
        }
        .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
)

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

IDFA after ATT

Remote UI

​Requirements

​Install with Swift Package Manager

​Initialize the SDK

​Common calls

​IDFA after ATT

​Remote UI

Requirements

Install with Swift Package Manager

Initialize the SDK

Common calls

IDFA after ATT

Remote UI