Integration Journey at a Glance

1. Customize SDK Configuration — Capture your first live session.
2. Tag Screens — Enable heat-maps & screen analytics.
3. Mask Sensitive Data — Hide passwords and other GDPR/CCPA data.
4. Identify Users & Set Properties — Unify sessions, power funnels & cohorts.
5. Track Custom Events — Measure key actions & run final QA.

Step 1: Get your App Key

1.1: Find your app key

If you don't already have it, find it in App Settings -> App Key on your UXCam Dashboard.

1.2: Keep it out of source control:

Put the key in an ignored .xcconfig file or pass it in as an environment variable from your CI, then reference it via a build-setting placeholder (e.g. $(UXCAM_APP_KEY)) so the value is injected at compile-time and never hard-coded in source.

Quick Start: Only a Couple of Lines of Code

Let's get you started with the basics. With just a few lines of code, you'll be on your way to capturing user sessions in your test app.

Adding the Dependencies

Cocoapods

• Add UXCam to your Podfile:

pod 'UXCam'

• Run pod install in the project directory to download dependency.

Swift Package Manager

• If you prefer Swift Package Manager, you can add UXCam using the following URL:

https://github.com/uxcam/uxcam-ios-sdk

Specify the exact version to ensure compatibility.

Initializing UXCam

1. Imports:

import UXCam

2. Configuration

Add the following initialisation to application:didFinishLaunchingWithOptions: in your AppDelegate:

let configuration = UXCamConfiguration(appKey: "YOUR_APP_KEY")

Replace "YourAppKey" with the app key available on your UXCam dashboard.

3. Then, start the SDK with your configuration object

import UXCam

func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    let config = UXCamConfiguration(appKey: "YOUR_APP_KEY")

    UXCam.optIntoVideoRecordings()

    #if DEBUG
    // 🔍 Enable verbose integration logs in Debug builds only
    config.enableIntegrationLogging = true
    #endif

    UXCam.start(with: config)
    return true
}

Available Configuration Options:

enableAutomaticScreenNameTagging

enableAdvancedGestureRecognition

enableCrashHandling

enableMultiSessionRecord

enableIntegrationLogging

enableNetworkLogging

occlusion

environment

Build & Test

Run the app on a simulator or device, navigate a few screens, then send it to the background. Your first session replay will appear on the UXCam dashboard within seconds.

We recommend that after you've set this up and have reviewed some sessions from your tests, get to the customisation features UXCam offers, let's go to the next steps!

Video Tutorial:

Next Steps ➡️

You’ve successfully integrated UXCam and sent some sessions, great job! 🎉 But there's so much more you can do. Now, let’s go further into setting things up.