iOS (Swift)

ProductLense is a Swift package with no dependencies. It sends screen views, goals and identify from your iOS app to ProductLense, needs no device identifiers, and reports app traffic next to your website: the Hostname breakdown shows your bundle id beside your domain.

1. Add your app ID#

In ProductLense, open Settings → General → App IDs and add your bundle identifier, for example com.example.app. Events from any other app id are rejected.

2. Install#

In Xcode, choose File → Add Package Dependencies, enter https://github.com/productlense/productlense-swift, and add the ProductLense library to your app target. With a Package.swift:

.package(url: "https://github.com/productlense/productlense-swift", from: "0.1.0"),

iOS 15 or later.

3. Start ProductLense and track screens#

import ProductLense
import SwiftUI

@main
struct ExampleApp: App {
    init() { ProductLense.configure(siteId: "YOUR_SITE_ID", appId: Bundle.main.bundleIdentifier!) }

    var body: some Scene {
        WindowGroup {
            ContentView()
                .onOpenURL { ProductLense.openURL($0) }
        }
    }
}

// in each screen
.onAppear { ProductLense.screen("Settings") }

siteId is on Settings → Snippet. In UIKit, call ProductLense.configure in application(_:didFinishLaunchingWithOptions:), ProductLense.screen in viewDidAppear, and ProductLense.openURL from scene(_:openURLContexts:) and scene(_:continue:).

ProductLense keeps the install id, the opt-out choice and unsent events in UserDefaults, sends them every 10 seconds, and sends what is left when the app goes to the background.

4. Goals and users#

ProductLense.track("signup", props: ["plan": "pro"])
ProductLense.identify(user.id, name: user.name, email: user.email)

Call identify after sign-in with the user id your billing provider stores on the customer, so app visits, web visits and payments join up. See how payments are attributed.

In-app purchases#

Connect RevenueCat and pass the install id once after configuring both SDKs:

Purchases.shared.attribution.setAttributes(await ProductLense.revenueCatAttributes())

Each purchase then lands on the channel that brought the install.

Attribution#

• Universal links and URL schemes: pass every URL the app opens with to ProductLense.openURL. Only utm_*, ref, via, source and click ids leave the device; tokens and ids in the link stay on it.
• App Store: Apple shares no referrer, so App Store installs count as Direct unless the first screen opens through a tagged link.

Privacy#

• The SDK creates a random install id on first launch. It is not the advertising id (IDFA), so no App Tracking Transparency prompt is needed for ProductLense. ProductLense stores only a hash of it.
• ProductLense.optOut() stops collection, deletes unsent events and forgets the install id; ProductLense.optIn() resumes with a new one.
• App Store privacy label: Product Interaction, used for Analytics, not used for tracking.

Verify your installation#

1. Run the app on a device or simulator and open a few screens.
2. Open the Live page in the ProductLense dashboard. Your device appears within a few seconds.
3. Open Events: each screen is a pageview row with your bundle id as the hostname and iOS app as the browser.
4. Pass debug: true to ProductLense.configure to print dropped events and failed sends.

If nothing appears, check the app id in Settings and follow Verify your installation.